> For the complete documentation index, see [llms.txt](https://docs.dispel.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dispel.com/documentation/documentation-nl/integreren-en-beheren/integrations/asset-discovery/armis.md).
# Armis
Verbind je Armis-tenant om ontdekte beheerde en onbeheerde assets in Dispel binnen te halen, koppel Armis-locaties aan Wickets en houd apparaatgegevens en kwetsbaarheidsbevindingen synchroon.
## Overzicht
De Armis-integratie laat Dispel de assets ophalen die Armis in je omgeving heeft ontdekt — zowel beheerde als onbeheerde — en deze als Dispel-apparaten inbrengen. Je verbindt één keer met je Armis-tenant, koppelt elke Armis-site aan een Dispel-faciliteit en Wicket, en Dispel importeert de overeenkomende apparaten en houdt ze actueel tijdens een terugkerende synchronisatie.
Armis is cloud-native **assetdetectie** integratie. Er is geen on-premises appliance — Dispel verbindt met je Armis-tenant in de cloud en leest er alleen maar van.
#### Wat Dispel importeert
* Ontdekte assets (naam, IP-adres, MAC-adres, merk/model, besturingssysteem, apparaattype) als Dispel-apparaten.
* Waargenomen netwerkprotocollen en -poorten voor elk asset.
* Een link terug naar het asset in Armis, opgeslagen op het apparaat.
* **Kwetsbaarheidsbevindingen** voor elk geïmporteerd apparaat, vernieuwd bij elke synchronisatie.
{% hint style="info" %}
**Waar u het vindt.** Meld u aan als organisatiebeheerder en open **Instellingen → Integraties**. Armis verschijnt in de **Assetdetectie / netwerkzichtbaarheid** sectie. Klik op **Verbinden** op de Armis-kaart om te beginnen.
{% endhint %}
## Voordat u begint
Je hebt het volgende nodig uit je Armis-tenant:
* Een **API-sleutel** (geheime sleutel), aangemaakt in je Armis-console onder je API-instellingen.
* Je **Armis Tenant-URL** — bijvoorbeeld `https://acme.armis.com`.
{% hint style="warning" %}
**Zet het IP-adres van Dispel op de allowlist.** Wanneer u het verbindingsformulier opent, toont Dispel een **Whitelist-IP** waarde. Als je Armis-tenant API-toegang beperkt op basis van bron-IP, voeg dit adres dan toe aan de allowlist zodat Dispel kan verbinden.
{% endhint %}
## Armis verbinden
1. Ga naar **Instellingen → Integraties** en klik **Verbinden** op de Armis-kaart.
2. Stel optioneel een **Weergavenaam** om deze integratie te onderscheiden van andere (je kunt meer dan één Armis-tenant verbinden).
3. Vul de verbindingsvelden in:
| Veld | Type | Opmerkingen |
| -------------------- | ------------- | -------------------------------------------------------------------------------- |
| **Armis Tenant-URL** | Configuratie | De basis-URL van je Armis-tenant (bijv. `https://acme.armis.com`). |
| **API-sleutel** | Inloggegevens | Je Armis API-(geheime) sleutel. Versleuteld opgeslagen en nooit opnieuw getoond. |
4. Klik op **Verbinding testen** om te bevestigen dat Dispel zich kan authenticeren bij Armis. Los elke gemelde fout op vóór het opslaan.
5. Klik op **Opslaan**. Dispel slaat de integratie op en voert direct de eerste synchronisatie uit om je Armis-sites te ontdekken.
{% hint style="info" %}
**Uw inloggegevens zijn versleuteld.** De API-sleutel is in rust versleuteld en wordt na het opslaan nooit meer weergegeven. Laat bij later bewerken het referentieveld leeg om de opgeslagen waarde te behouden.
{% endhint %}
## Sites koppelen aan Wickets
Zodra de eerste synchronisatie is voltooid, opent u de integratie om de **Sitekoppeling** sectie. Armis toont de sites die in je tenant zijn geconfigureerd, en hier bepaal je welke Dispel-apparaten worden en waar ze terechtkomen.
> Koppel elke vendorsite aan een Dispel-facility en wicket. Apparaten van gekoppelde sites worden gesynchroniseerd naar Dispel.
Voor elke site die je wilt importeren:
1. Kies een **Facility**.
2. Kies een **Wicket**. Als de facility slechts één Wicket heeft, selecteert Dispel die voor u.
3. Klik op **Koppelingen opslaan en importeren**.
Dispel werkt elke toegewezen site af — je ziet de voortgang per site van wachten, naar ophalen, naar synchroniseren, naar voltooid — en meldt vervolgens hoeveel apparaten zijn geïmporteerd (bijvoorbeeld, **"12 apparaten geïmporteerd"** of een uitsplitsing van nieuwe versus al geïmporteerde apparaten). Geïmporteerde apparaten verschijnen in de gekoppelde Wicket naast eventuele apparaten die u handmatig hebt toegevoegd.
## Uw inventaris actueel houden
* Dispel **synchroniseert automatisch opnieuw** volgens een terugkerend schema, zodat nieuw ontdekte assets en gewijzigde details automatisch worden opgepakt zonder dat jij iets hoeft te doen.
* Om de nieuwste inventaris onmiddellijk op te halen, opent u de integratie en kiest u **Vernieuwen**.
* Om verbindingsgegevens te wijzigen of inloggegevens te roteren, bewerkt u de integratie en gebruikt u **Opslaan en synchroniseren**. Laat het referentieveld leeg om de huidige sleutel te behouden.
## Kwetsbaarheidsbevindingen
Armis meldt bekende kwetsbaarheden voor de assets die het bewaakt. Na elke geslaagde synchronisatie haalt Dispel de kwetsbaarheidsbevindingen voor je geïmporteerde apparaten op en voegt deze toe aan die apparaten, zodat je de bekende problemen van een apparaat kunt zien zonder Dispel te verlaten. Bevindingen worden bij elke synchronisatie vernieuwd, en opgeloste bevindingen verdwijnen automatisch.
## Verbindingsstatus
Elke integratie toont een status, zodat u altijd weet hoe het ervoor staat:
| Status | Betekenis |
| ------------------------------ | -------------------------------------------------------------------------------------------- |
| **Niet geïnitialiseerd** | Opgeslagen, maar de eerste synchronisatie is nog niet uitgevoerd. |
| **Initialiseren** | De eerste synchronisatie uitvoeren en sites ontdekken. |
| **Gereed** | Verbonden en gesynchroniseerd; toewijzingen zijn toegepast. |
| **Vernieuwing vereist** | Er zijn nieuwe leveranciersgegevens beschikbaar; voer een vernieuwing uit om ze op te halen. |
| **Bezig met vernieuwen** | Er loopt een synchronisatie. |
| **Wijzigingen in behandeling** | Wijzigingen in de koppeling zijn opgeslagen maar nog niet toegepast. |
| **Toepassen** | Apparaten importeren voor je opgeslagen toewijzingen. |
| **Mislukt** | De laatste bewerking is mislukt — zie de foutaanwijzingen. |
Een afzonderlijke **gezondheidsbadge** (Verbonden, Verminderd, Onbereikbaar) geeft weer of Dispel momenteel de Armis API kan bereiken.
## Probleemoplossing
Als een synchronisatie of verbindingstest mislukt, classificeert Dispel de fout en stelt het een oplossing voor:
| Fout | Wat het meestal betekent en hoe u het oplost |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| **Verificatie mislukt** | De API-sleutel werd geweigerd. De sleutel kan zijn gerouleerd, verlopen of ingetrokken — genereer een nieuwe en werk de integratie bij. |
| **Eindpunt onbereikbaar** | Dispel kon de API niet bereiken. Controleer de tenant-URL en of Dispel's IP op de allowlist staat als je tenant API-toegang beperkt. |
| **Verbindings-time-out** | Armis deed te lang over om te reageren — meestal tijdelijke netwerklatentie. |
| **Snelheidsbeperking** | Armis heeft verzoeken afgeremd. De volgende geplande synchronisatie zou moeten slagen. |
| **Configuratiefout** | De tenant-URL lijkt onjuist. Controleer nogmaals of deze naar je Armis-tenant verwijst. |
## Veelgestelde vragen
Kan ik meer dan één Armis-tenant verbinden?
Ja. Armis ondersteunt meerdere integraties, dus je kunt meerdere tenants naast elkaar verbinden. Geef elk een unieke **Weergavenaam** om ze van elkaar te onderscheiden.
Is er een on-premises optie voor Armis?
Nee. Armis is een cloudplatform, dus Dispel verbindt altijd via internet met je Armis-tenant. Er is geen appliance waarnaar je moet wijzen.
Verandert er iets in mijn Armis-tenant als ik Armis verbind?
Nee. Dispel leest alleen uit Armis. Het maakt, wijzigt of verwijdert nooit gegevens aan de Armis-kant.
Hoe snel verschijnen nieuwe assets?
Nieuwe assets verschijnen bij de volgende synchronisatie — automatisch volgens het terugkerende schema, of onmiddellijk als je kiest **Vernieuwen**.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.dispel.com/documentation/documentation-nl/integreren-en-beheren/integrations/asset-discovery/armis.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.