> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wirespeed.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Admin By Request

> Sicherheitsereignisse zur Rechteverwaltung auf Endgeräten aus Admin By Request erfassen

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](https://www.adminbyrequest.com/en/docs/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](https://www.adminbyrequest.com/en/docs/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)

> [!WARNING]
>
> 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**](https://app.wirespeed.co/settings/integrations?tab=browse)
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

* [Übersicht über die Public API von Admin By Request](https://www.adminbyrequest.com/en/docs/api-overview)
* [Events API](https://www.adminbyrequest.com/en/docs/events-api)
* [Inventory API](https://www.adminbyrequest.com/en/docs/inventory-api)
* [Auditlog API](https://www.adminbyrequest.com/en/docs/auditlog-api)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.