Zum Hauptinhalt springen
Die Admin-By-Request-Integration fragt Sicherheitsereignisse über die API Ihres Mandanten ab und synchronisiert das Inventar verwalteter Endgeräte in Wirespeed.

Was diese Integration leistet

  • Fragt die Events API von Admin By Request ab
  • Erfasst Rechteänderungen, Richtlinienblockierungen, Break-Glass-Anmeldungen und zugehörige Endgeräteereignisse
  • Synchronisiert verwaltete Arbeitsplatzrechner über die Inventory API
  • Wandelt Ereignisse in Wirespeed-Detektionen um, mit Host-, Benutzer- und Dateikontext, sofern verfügbar

Voraussetzungen

Stellen Sie vor der Einrichtung sicher, dass Sie über Folgendes verfügen:
  1. Einen Admin-By-Request-Mandanten mit aktiviertem API-Zugriff
  2. Einen API-Schlüssel aus Settings → Tenant Settings → Data → API Keys
  3. Das API-Rechenzentrumspräfix Ihres Mandanten (zum Beispiel dc1api, dc2api), das unter About API Keys angezeigt wird

Schritt 1: Die API aktivieren und einen Schlüssel erstellen

Im Admin-By-Request-Portal:
  1. Gehen Sie zu Settings → Tenant Settings → Data → API Keys
  2. Erstellen oder kopieren Sie einen API-Schlüssel
  3. Notieren Sie sich das Rechenzentrumspräfix Ihres Mandanten (zum Beispiel dc1api für EU West)
Verwenden Sie das richtige Rechenzentrumspräfix. Eine Verbindung zum falschen dc*api-Host führt zu API-Fehlern.

Schritt 2: Admin By Request in Wirespeed hinzufügen

  1. Gehen Sie zu Integrationen > Integration hinzufügen
  2. Suchen Sie nach Admin By Request
  3. Geben Sie Folgendes ein:
    • API-Rechenzentrum (zum Beispiel dc1api)
    • API-Schlüssel
    • Ereigniscode-Filter (optional; leer lassen für den standardmäßigen Satz aussagekräftiger Ereignisse)
  4. Klicken Sie auf Integrieren
Beim Onboarding validiert Wirespeed die Zugangsdaten mit GET /inventory?take=1.

Verhalten bei der Erfassung von Detektionen

  • Der Standardsatz für die Erfassung umfasst aussagekräftige Ereigniscodes (Rechteänderungen, Ausführungsblockierungen, Break Glass, abgelehnte Sitzungen)
  • Die Paginierung verwendet zwischen den Durchläufen monotone Ereignis-id-Cursor (startid)
  • Die erste Synchronisierung ist begrenzt, um bei großen Mandanten eine Flut rückwirkend geladener Daten zu vermeiden

Verhalten beim Endgeräteinventar

  • Vollständige Verzeichnissynchronisierung bei jedem Durchlauf über GET /inventory
  • Die Paginierung verwendet monotone Inventar-id-Cursor (startid) nur innerhalb eines Durchlaufs
  • Ordnet Hostname, Betriebssystem, IP-Adressen, Agentenversion und den Zeitstempel des letzten Inventars zu; der Live-Status verwendet inventoryAvailable, mit einem 4-Stunden-Fallback auf inventoryDate entsprechend dem Inventar-Aktualisierungsintervall von ABR

Fehlerbehebung

Authentifizierungsfehler

Prüfen Sie Folgendes:
  1. Der API-Schlüssel ist gültig und der API-Zugriff ist im Portal aktiviert
  2. API-Rechenzentrum entspricht dem unter About API Keys angezeigten Präfix
  3. Der Schlüssel hat das tägliche API-Kontingent des Herstellers (100.000 Aufrufe/Tag) nicht überschritten

Keine Detektionen sichtbar

Prüfen Sie Folgendes:
  1. Admin By Request erzeugt im Portal Ereignisse (zum Beispiel Richtlinienblockierungen oder Rechteänderungen)
  2. Ereigniscodes werden nicht durch einen benutzerdefinierten Ereigniscode-Filter ausgeschlossen
  3. Die erste Synchronisierung kann je nach Umfang des Rückstands einige Minuten dauern

Weitere Ressourcen