> 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

Met de Armis-integratie kan Dispel de assets ophalen die Armis in je omgeving heeft ontdekt — zowel beheerde als onbeheerde — en deze als Dispel-apparaten toevoegen. Je maakt eenmalig verbinding met je Armis-tenant, koppelt elke Armis-site aan een Dispel-facility en Wicket, waarna Dispel de overeenkomende apparaten importeert en ze bij elke periodieke synchronisatie actueel houdt.

Armis is een cloud-native **asset discovery-** integratie. Er is geen on-premises appliance: Dispel maakt verbinding met je Armis-tenant in de cloud en leest daar uitsluitend gegevens uit.

#### Wat Dispel importeert

* Ontdekte assets (naam, IP-adres, MAC-adres, merk/model, besturingssysteem, apparaattype) als Dispel-apparaten.
* Waargenomen netwerkprotocollen en poorten voor elke asset.
* Een link naar de asset in Armis, opgeslagen op het apparaat.
* **Kwetsbaarheidsbevindingen** voor elk geïmporteerd apparaat, vernieuwd bij elke synchronisatie.

{% hint style="info" %}
**Waar je dit vindt.** Meld je aan als organisatiebeheerder en open **Instellingen → Integraties**. Armis staat in de sectie **Asset Discovery / Network Visibility** . Klik op **Verbinden** op de Armis-kaart om te beginnen.
{% endhint %}

## Voordat je begint

Je hebt de volgende gegevens van je Armis-tenant nodig:

* Een **API-sleutel** (geheime sleutel), aangemaakt in je Armis-console onder de API-instellingen.
* De **Armis Tenant-URL** — bijvoorbeeld `https://acme.armis.com`.

{% hint style="warning" %}
**Zet het IP-adres van Dispel op de allowlist.** Wanneer je het verbindingsformulier opent, toont Dispel een waarde voor **IP-adres voor de allowlist** . Als je Armis-tenant API-toegang beperkt op basis van het bron-IP-adres, voeg dit adres dan toe aan de allowlist zodat Dispel verbinding kan maken.
{% endhint %}

## Armis verbinden

1. Ga naar **Instellingen → Integraties** en klik op **Verbinden** op de Armis-kaart.
2. Je kunt desgewenst een **Weergavenaam** instellen om deze integratie te onderscheiden van andere (je kunt verbinding maken met meerdere Armis-tenants).
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**      | Referentie   | Je Armis API-geheime sleutel. Deze wordt versleuteld opgeslagen en wordt nooit opnieuw getoond. |

4. Klik op **Verbinding testen** om te controleren of Dispel zich kan aanmelden bij Armis. Los eventuele gemelde fouten op voordat je opslaat.
5. Klik op **Opslaan**. Dispel slaat de integratie op en voert meteen de eerste synchronisatie uit om je Armis-sites te ontdekken.

{% hint style="info" %}
**Je inloggegevens zijn versleuteld.** De API-sleutel is versleuteld wanneer deze is opgeslagen en wordt na het opslaan nooit meer weergegeven. Laat het veld voor inloggegevens leeg als je de opgeslagen waarde wilt behouden wanneer je de integratie later bewerkt.
{% endhint %}

## Sites aan Wickets koppelen

Zodra de eerste synchronisatie is voltooid, open je de integratie om de **Sitemapping** sectie. Armis stelt de sites beschikbaar die in je tenant zijn geconfigureerd. Hier bepaal je welke sites Dispel-apparaten worden en waar ze terechtkomen.

> Koppel elke leverancierssite aan een Dispel-faciliteit en Wicket. Apparaten van gekoppelde sites worden met Dispel gesynchroniseerd.

Voor elke site die je wilt importeren:

1. Kies een **Faciliteit**.
2. Kies een **Wicket**. Als de faciliteit maar één Wicket heeft, selecteert Dispel die automatisch.
3. Klik op **Toewijzingen opslaan en importeren**.

Dispel verwerkt elke toegewezen site. Je ziet de voortgang per site veranderen van wachten naar ophalen, synchroniseren en voltooid. Daarna wordt gemeld hoeveel apparaten zijn geïmporteerd (bijvoorbeeld: **"12 apparaten geïmporteerd"** of een uitsplitsing van nieuwe en al eerder geïmporteerde apparaten). Geïmporteerde apparaten verschijnen in de toegewezen Wicket, samen met apparaten die je handmatig hebt toegevoegd.

## Je inventaris up-to-date houden

* Dispel **synchroniseert automatisch opnieuw** volgens een terugkerend schema. Zo worden nieuw ontdekte assets en gewijzigde gegevens opgehaald zonder dat je iets hoeft te doen.
* Open de integratie en kies **Vernieuwen**.
* Als je de verbindingsgegevens wilt wijzigen of de inloggegevens wilt vernieuwen, bewerk je de integratie en gebruik je **Opslaan en synchroniseren**. Laat het veld voor de inloggegevens leeg om de huidige sleutel te behouden.

## Bevindingen over kwetsbaarheden

Armis meldt bekende kwetsbaarheden voor de assets die het bewaakt. Na elke geslaagde synchronisatie haalt Dispel de bevindingen over kwetsbaarheden op voor je geïmporteerde apparaten en koppelt deze aan die apparaten. Zo kun je de bekende problemen van een apparaat bekijken zonder Dispel te verlaten. De bevindingen worden bij elke synchronisatie vernieuwd en opgeloste bevindingen verdwijnen automatisch.

## Verbindingsstatus

Elke integratie heeft een status, zodat je altijd weet hoe het ervoor staat:

| Status                         | Betekenis                                                                                       |
| ------------------------------ | ----------------------------------------------------------------------------------------------- |
| **Niet geïnitialiseerd**       | Opgeslagen, maar de eerste synchronisatie is nog niet uitgevoerd.                               |
| **Initialiseren**              | De eerste synchronisatie wordt uitgevoerd en sites worden ontdekt.                              |
| **Gereed**                     | Verbonden en gesynchroniseerd; de toewijzingen zijn toegepast.                                  |
| **Vernieuwing nodig**          | Er zijn nieuwe gegevens van de leverancier beschikbaar; vernieuw de gegevens om ze op te halen. |
| **Vernieuwen**                 | Er wordt gesynchroniseerd.                                                                      |
| **Wijzigingen in behandeling** | Wijzigingen in de toewijzing zijn opgeslagen, maar nog niet toegepast.                          |
| **Toepassen**                  | Apparaten importeren voor je opgeslagen toewijzingen.                                           |
| **Mislukt**                    | De laatste bewerking is mislukt — bekijk de foutinstructies.                                    |

Een afzonderlijke **statusbadge** (Verbonden, Gedegradeerd, Onbereikbaar) geeft aan of Dispel momenteel de Armis-API kan bereiken.

## Problemen oplossen

Als een synchronisatie of verbindingstest mislukt, classificeert Dispel de fout en stelt het een oplossing voor:

| Fout                        | Wat dit meestal betekent en hoe je het oplost                                                                                                                          |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Verificatie mislukt**     | De API-sleutel is geweigerd. De sleutel is mogelijk vernieuwd, verlopen of ingetrokken. Genereer een nieuwe sleutel en werk de integratie bij.                         |
| **Eindpunt onbereikbaar**   | Dispel kon de API niet bereiken. Controleer de tenant-URL en zorg ervoor dat het IP-adres van Dispel op de toelatingslijst staat als je tenant de API-toegang beperkt. |
| **Verbindingstime-out**     | Armis deed er te lang over om te reageren. Meestal komt dit door tijdelijke netwerklatentie.                                                                           |
| **Snelheidslimiet bereikt** | Armis heeft het aantal verzoeken beperkt. De volgende geplande synchronisatie zou moeten slagen.                                                                       |
| **Configuratiefout**        | De tenant-URL lijkt onjuist. Controleer of deze naar je Armis-tenant verwijst.                                                                                         |

## Veelgestelde vragen

<details>

<summary>Kan ik meer dan één Armis-tenant verbinden?</summary>

Ja. Armis ondersteunt meerdere integraties, zodat je verschillende tenants naast elkaar kunt verbinden. Geef elke tenant een unieke **Weergavenaam** om ze van elkaar te onderscheiden.

</details>

<details>

<summary>Is er een lokale versie van Armis?</summary>

Nee. Armis is een cloudplatform, dus Dispel maakt altijd via internet verbinding met je Armis-tenant. Er is geen apparaat waarnaar je kunt verwijzen.

</details>

<details>

<summary>Verandert er iets in mijn Armis-tenant als ik Armis verbind?</summary>

Nee. Dispel leest alleen gegevens uit Armis. Het maakt, wijzigt of verwijdert nooit gegevens aan de Armis-kant.

</details>

<details>

<summary>Hoe snel worden nieuwe assets zichtbaar?</summary>

Nieuwe assets verschijnen bij de volgende synchronisatie: automatisch volgens het terugkerende schema, of direct als je **Vernieuwen kiest**.

</details>


---

# 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=<question>&goal=<user_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.
