Referenz zur Defender for IoT-API
In diesem Abschnitt werden die öffentlichen APIs beschrieben, die von Microsoft Defender for IoT unterstützt werden. Defender für IoT-APIs unterliegen der Microsoft-API-Lizenz und den Nutzungsbedingungen.
Verwenden Sie Defender für IoT-APIs, um auf von Sensoren ermittelte Daten zuzugreifen und Aktionen mit diesen Daten auszuführen.
API-Verbindungen werden durch SSL geschützt.
Generieren eines API-Zugriffstokens
Viele Defender for IoT-APIs erfordern ein Zugriffstoken. Zugriffstoken sind für Authentifizierungs-APIs nicht erforderlich.
So generieren Sie ein Token:
Wählen Sie im Fenster Systemeinstellungen die Option Integrationen>Zugriffstoken aus.
Wählen Sie Generate token (Token generieren) aus.
Beschreiben Sie unter Beschreibung, wofür das neue Token vorgesehen ist, und wählen Sie Generieren aus.
Das Zugriffstoken wird angezeigt. Kopieren Sie das Token, da es nicht noch einmal angezeigt wird.
Wählen Sie Fertig stellen aus.
Die von Ihnen erstellten Token werden im Dialogfeld Zugriffstoken angezeigt. Verwendet gibt den letzten Zeitpunkt an, zu dem ein externer Aufruf mit diesem Token empfangen wurde.
N/V im Feld Verwendet gibt an, dass die Verbindung zwischen dem Sensor und dem verbundenen Server nicht funktioniert.
Fügen Sie nach dem Generieren des Tokens Ihrer Anforderung einen HTTP-Header mit dem Titel Autorisierung hinzu, und legen Sie den Wert auf das von Ihnen generierte Token fest.
Referenz zur Sensor-API-Version
| Version | Unterstützte APIs |
|---|---|
| Keine Version | Authentifizierung und Kennwortverwaltung: - set_password (Ihr Kennwort ändern) - set_password_by_admin (Ein Benutzerkennwort durch den Administrator aktualisieren) - validation (Benutzeranmeldeinformationen überprüfen) |
| Neu in Version 1 | Bestand: - connections (Geräteverbindungsinformationen abrufen) - cves (Informationen zu CVEs abrufen) - devices (Geräteinformationen abrufen) Warnungen: - alerts (Warnungsinformationen abrufen) - events (Zeitachsenereignisse abrufen) Sicherheitsrisiken: - operational (Sicherheitsrisiken bei Betrieb abrufen) - devices (Informationen zu Gerätesicherheitsrisiken abrufen) - mitigation (Schritte zur Risikominderung abrufen) - security (Sicherheitsrisiken abrufen) |
| Neu in Version 2 | Warnungen: – Aktualisierungen zu alerts (Warnungsinformationen abrufen) |
Hinweis
Integrations-APIs sollen kontinuierlich ausgeführt werden und einen ständig ausgeführten Datenstrom erstellen, z. B. zum Abfragen neuer Daten aus den letzten fünf Minuten. Integrations-APIs geben Daten mit einem Zeitstempel zurück.
Um einfach Daten abzufragen, verwenden Sie stattdessen die regulären NICHT-Integrations-APIs, damit ein bestimmter Sensor nur Geräte von diesem Sensor abfragt.
Epochenzeit
In allen Defender for IoT-Zeitstempelwerten ist der Wert für Epochenzeit gleich 01/01/1970.
Nächste Schritte
Weitere Informationen finden Sie unter