> 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-de/integrieren-and-administrieren/integrations/asset-discovery/armis.md).
# Armis
Verbinden Sie Ihren Armis-Mandanten, um erkannte verwaltete und nicht verwaltete Assets in Dispel zu übernehmen, Armis-Standorte den Wickets zuzuordnen und Gerätedaten sowie Schwachstellenbefunde synchron zu halten.
## Übersicht
Die Armis-Integration ermöglicht es Dispel, die von Armis in Ihrer Umgebung entdeckten Assets — sowohl verwaltete als auch nicht verwaltete — abzurufen und als Dispel-Geräte zu übernehmen. Sie verbinden sich einmal mit Ihrem Armis-Mandanten, ordnen jeden Armis-Standort einer Dispel-Einrichtung und einem Wicket zu, und Dispel importiert die passenden Geräte und hält sie bei einer wiederkehrenden Synchronisierung aktuell.
Armis ist cloud-nativ **Asset-Discovery** Integration. Es gibt keine On-Premises-Appliance — Dispel verbindet sich mit Ihrem Armis-Mandanten in der Cloud und liest nur daraus.
#### Was Dispel importiert
* Entdeckte Assets (Name, IP-Adresse, MAC-Adresse, Hersteller/Modell, Betriebssystem, Gerätetyp) als Dispel-Geräte.
* Beobachtete Netzwerkprotokolle und Ports für jedes Asset.
* Ein Verweis zurück zum Asset in Armis, auf dem Gerät gespeichert.
* **Schwachstellenbefunde** für jedes importierte Gerät, bei jeder Synchronisierung aktualisiert.
{% hint style="info" %}
**Wo Sie es finden.** Melden Sie sich als Organisationsadministrator an und öffnen Sie **Einstellungen → Integrationen**. Armis erscheint in der **Asset Discovery / Network Visibility** Bereich. Klicken Sie auf **Verbinden** auf der Armis-Karte, um zu beginnen.
{% endhint %}
## Bevor Sie beginnen
Sie benötigen Folgendes von Ihrem Armis-Mandanten:
* Einen **API-Schlüssel** (geheimer Schlüssel), erstellt in Ihrer Armis-Konsole unter Ihren API-Einstellungen.
* Ihre **Armis-Mandanten-URL** — zum Beispiel `https://acme.armis.com`.
{% hint style="warning" %}
**Nehmen Sie die IP von Dispel in die Allowlist auf.** Wenn Sie das Verbindungsformular öffnen, zeigt Dispel einen **Whitelist-IP** Wert. Wenn Ihr Armis-Mandant den API-Zugriff nach Quell-IP einschränkt, fügen Sie diese Adresse zur Zulassungsliste hinzu, damit Dispel eine Verbindung herstellen kann.
{% endhint %}
## Armis verbinden
1. Gehen Sie zu **Einstellungen → Integrationen** und klicken Sie **Verbinden** auf der Armis-Karte.
2. Optional können Sie einen **Anzeigenamen** um diese Integration von anderen zu unterscheiden (Sie können mehr als einen Armis-Mandanten verbinden).
3. Füllen Sie die Verbindungsfelder aus:
| Feld | Typ | Hinweise |
| ----------------------- | ------------- | ------------------------------------------------------------------------------------- |
| **Armis-Mandanten-URL** | Konfiguration | Die Basis-URL Ihres Armis-Mandanten (z. B. `https://acme.armis.com`). |
| **API-Schlüssel** | Anmeldedaten | Ihr Armis-API-(Geheim-)Schlüssel. Verschlüsselt gespeichert und nie wieder angezeigt. |
4. Klicken Sie auf **Verbindung testen** um zu bestätigen, dass Dispel sich bei Armis authentifizieren kann. Beheben Sie jeden gemeldeten Fehler vor dem Speichern.
5. Klicken Sie auf **Speichern**. Dispel speichert die Integration und führt sofort die erste Synchronisierung aus, um Ihre Armis-Standorte zu ermitteln.
{% hint style="info" %}
**Ihre Anmeldedaten sind verschlüsselt.** Der API-Schlüssel wird im Ruhezustand verschlüsselt und nach dem Speichern nie wieder angezeigt. Lassen Sie beim späteren Bearbeiten das Anmeldedatenfeld leer, um den gespeicherten Wert beizubehalten.
{% endhint %}
## Standorte Wickets zuordnen
Wenn die erste Synchronisierung abgeschlossen ist, öffnen Sie die Integration, um den **Bereich Standortzuordnung** Abschnitt. Armis stellt die in Ihrem Mandanten konfigurierten Standorte bereit, und hier entscheiden Sie, welche davon zu Dispel-Geräten werden und wo sie zugewiesen werden.
> Ordnen Sie jeden Herstellerstandort einer Dispel-Einrichtung und einem Wicket zu. Geräte aus zugeordneten Standorten werden in Dispel synchronisiert.
Für jeden Standort, den Sie importieren möchten:
1. Wählen Sie eine **Einrichtung**.
2. Wählen Sie eine **Wicket**. Wenn die Einrichtung nur ein Wicket hat, wählt Dispel es für Sie aus.
3. Klicken Sie auf **Zuordnungen speichern & importieren**.
Dispel arbeitet jeden zugeordneten Standort nacheinander ab — Sie sehen den Fortschritt pro Standort von „wartend“ über „abrufen“ und „synchronisieren“ bis „abgeschlossen“ — und meldet dann, wie viele Geräte importiert wurden (zum Beispiel, **"12 Geräte importiert"** oder eine Aufschlüsselung neuer gegenüber bereits importierter Geräte). Importierte Geräte erscheinen im zugeordneten Wicket zusammen mit allen Geräten, die Sie manuell hinzugefügt haben.
## Ihr Inventar aktuell halten
* Dispel **synchronisiert automatisch erneut** nach einem wiederkehrenden Zeitplan, sodass neu entdeckte Assets und geänderte Details ohne Ihr Zutun übernommen werden.
* Um das neueste Inventar sofort abzurufen, öffnen Sie die Integration und wählen Sie **Aktualisieren**.
* Um Verbindungsdetails zu ändern oder Anmeldedaten zu rotieren, bearbeiten Sie die Integration und verwenden Sie **Speichern & synchronisieren**. Lassen Sie das Anmeldedatenfeld leer, um den aktuellen Schlüssel beizubehalten.
## Schwachstellenbefunde
Armis meldet bekannte Schwachstellen für die Assets, die es überwacht. Nach jeder erfolgreichen Synchronisierung ruft Dispel die Schwachstellenbefunde für Ihre importierten Geräte ab und fügt sie diesen Geräten hinzu, sodass Sie bekannte Probleme eines Geräts sehen können, ohne Dispel zu verlassen. Befunde werden bei jeder Synchronisierung aktualisiert, und behobene Befunde verschwinden automatisch.
## Verbindungsstatus
Jede Integration zeigt einen Status an, damit Sie immer wissen, wo sie steht:
| Status | Bedeutung |
| ------------------------------- | ------------------------------------------------------------------------------------------ |
| **Nicht initialisiert** | Gespeichert, aber die erste Synchronisierung wurde noch nicht ausgeführt. |
| **Initialisierung** | Die erste Synchronisierung ausführen und Standorte ermitteln. |
| **Bereit** | Verbunden und synchronisiert; Zuordnungen werden angewendet. |
| **Aktualisierung erforderlich** | Neue Herstellerdaten sind verfügbar; führen Sie eine Aktualisierung aus, um sie abzurufen. |
| **Wird aktualisiert** | Eine Synchronisierung läuft. |
| **Ausstehende Änderungen** | Zuordnungsänderungen sind gespeichert, aber noch nicht angewendet. |
| **Wird angewendet** | Geräte für Ihre gespeicherten Zuordnungen importieren. |
| **Fehlgeschlagen** | Der letzte Vorgang ist fehlgeschlagen — siehe die Hinweise zum Fehler. |
Eine separate **Statusanzeige** (Verbunden, Eingeschränkt, Unerreichbar) gibt an, ob Dispel die Armis-API derzeit erreichen kann.
## Fehlerbehebung
Wenn eine Synchronisierung oder ein Verbindungs-Test fehlschlägt, klassifiziert Dispel den Fehler und schlägt eine Lösung vor:
| Fehler | Was er normalerweise bedeutet und wie man ihn behebt |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Authentifizierung fehlgeschlagen** | Der API-Schlüssel wurde abgelehnt. Der Schlüssel wurde möglicherweise geändert, ist abgelaufen oder wurde widerrufen — generieren Sie einen neuen und aktualisieren Sie die Integration. |
| **Endpunkt nicht erreichbar** | Dispel konnte die API nicht erreichen. Überprüfen Sie die Mandanten-URL und ob die IP von Dispel auf der Zulassungsliste steht, wenn Ihr Mandant den API-Zugriff einschränkt. |
| **Verbindungszeitüberschreitung** | Armis hat zu lange für eine Antwort gebraucht — meist eine vorübergehende Netzwerklatenz. |
| **Drosselung** | Armis hat Anfragen gedrosselt. Die nächste geplante Synchronisierung sollte erfolgreich sein. |
| **Konfigurationsfehler** | Die Mandanten-URL sieht falsch aus. Prüfen Sie erneut, ob sie auf Ihren Armis-Mandanten verweist. |
## Häufig gestellte Fragen
Kann ich mehr als einen Armis-Mandanten verbinden?
Ja. Armis unterstützt mehrere Integrationen, sodass Sie mehrere Mandanten nebeneinander verbinden können. Geben Sie jedem einen eindeutigen **Anzeigenamen** zur Unterscheidung.
Gibt es für Armis eine On-Premises-Option?
Nein. Armis ist eine Cloud-Plattform, daher verbindet sich Dispel immer über das Internet mit Ihrem Armis-Mandanten. Es gibt keine Appliance, auf die Sie verweisen könnten.
Ändert die Verbindung von Armis etwas in meinem Armis-Mandanten?
Nein. Dispel liest nur aus Armis. Es erstellt, ändert oder löscht niemals Daten auf der Armis-Seite.
Wie schnell erscheinen neue Assets?
Neue Assets erscheinen bei der nächsten Synchronisierung — automatisch nach dem wiederkehrenden Zeitplan oder sofort, wenn Sie wählen **Aktualisieren**.
---
# 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-de/integrieren-and-administrieren/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.