Mit API-Tokens können Sie InfraNests vollständige REST API mit Ihren eigenen Skripten oder Tools verbinden, sodass Sie alles automatisieren können, was Sie normalerweise in der App tun. Dies richtet sich an alle, die ihre Infrastruktur programmatisch verwalten möchten, anstatt sich durch die App zu klicken.
Überblick
- API-Tokens sind die Methode, mit der Sie sich bei Aufrufen der InfraNest-API authentifizieren.
- Jedes Token kann so eingeschränkt werden, dass es nur auf die benötigten Bereiche und Aktionen zugreifen kann.
- Tokens werden über eine eigene Seite verwaltet, auf der Sie die Nutzung nachverfolgen und den Zugriff jederzeit widerrufen können.
Ein Token erstellen
- Gehen Sie zu API-Tokens und wählen Sie Erstellen.
- Geben Sie ihm einen Namen, wählen Sie die Berechtigungen (was es tun darf) und legen Sie optional ein Ablaufdatum fest.
- Wählen Sie Kopieren, um das Token sofort zu speichern — es wird nur einmal angezeigt. Danach sehen Sie nur noch einen Hinweis auf die letzten paar Zeichen.
WarningSobald Sie den Token-Bildschirm verlassen, können Sie das vollständige Token nicht mehr einsehen. Wenn Sie es verlieren, müssen Sie ein neues erstellen.
Berechtigungen verstehen
Berechtigungen legen genau fest, was ein Token tun darf:
- Wählen Sie Lese- oder Schreibzugriff für jeden Bereich — Zertifikate, DNS, Domains, Cloud und Monitoring.
- Verwenden Sie die Voreinstellung Nur Lesen für Tokens, die Daten nur anzeigen müssen.
- Verwenden Sie Vollzugriff für Tokens, die alles tun müssen.
TipGeben Sie jedem Token nur die Berechtigungen, die es tatsächlich benötigt. Ein Token mit eingeschränkterem Zugriff ist sicherer, falls es jemals offengelegt wird.
Tokens verwalten
- Gehen Sie zu API-Tokens, um Ihre vollständige Liste der Tokens anzuzeigen.
- Prüfen Sie die Spalte Status, um zu sehen, wann jedes Token zuletzt verwendet wurde.
- Wählen Sie Entfernen neben einem Token, um es sofort zu widerrufen.
TipFür Details zu jeder verfügbaren Aktion wählen Sie View full API documentation auf der Seite API-Tokens.
Fehlerbehebung
Einige Aktionen — wie manuelle Synchronisierungen oder Prüfen-Anfragen — sind pro Organisation ratenbegrenzt, um die Plattform zu schützen. Wenn Sie das Limit überschreiten, erhalten Sie eine Meldung, dass Sie es in Kürze erneut versuchen sollen.
War dieser Artikel hilfreich?