Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

API-Token verwalten

API-Token authentifizieren Benutzer, wenn sie versuchen, Informationen von Routing Director mithilfe von REST-APIs abzurufen. Durch die Verwendung von API-Token können Benutzer die Authentifizierung für jede Anforderung vermeiden, die sie stellen. Ein API-Token bietet Einblick in die Ressourcen, auf die ein Benutzer zugreift, und ermöglicht Ihnen eine bessere Kontrolle über den Zugriff auf Ressourcen.

Tabelle 1 listet die Parameter für die Konfiguration von API-Token auf.

Tabelle 1: Parameter zum Konfigurieren von API-Token
Feldbeschreibung
Name*

Name des API-Tokens.

Rolle*

Rolle, auf die das API-Token anwendbar ist:

  • Selbstständiger

  • Netzwerkadmin

    Sie müssen einer Netzwerkadministratorrolle mindestens ein Zugriffssteuerungsprofil zuweisen, um Zugriff auf Ressourcen zu gewähren. Weitere Informationen finden Sie unter Übersicht über Zugriffssteuerungsprofile.

  • Beobachter

  • Installationsprogramm

Schlüssel

Der automatisch generierte Schlüssel zur Identifizierung der Anwendung, die der Benutzer für den Zugriff auf die Ressourcen verwendet.

Schilder

Tags, die dem API-Token zugewiesen sind.

Wenn dem API-Token mehr als ein Tag zugewiesen ist, wird neben dem angezeigten Tag eine ganze Zahl angezeigt. +2 in der Spalte "Tags" gibt z. B. an, dass es zusätzlich zu dem, was derzeit aufgeführt ist, noch zwei weitere Tags gibt. Sie können den Mauszeiger über die ganze Zahl bewegen, um die zusätzlichen Tags anzuzeigen, die dem API-Token zugewiesen sind.

Um ein Tag zuzuweisen, bearbeiten Sie das API-Token. Weitere Informationen finden Sie unter Bearbeiten eines API-Tokens.

Profil für die Zugriffssteuerung

Weisen Sie ein oder mehrere Zugriffssteuerungsprofile zu, um Zugriff auf Ressourcen (Geräte, Dienstinstanzen und Ausführen von Tagging-Vorgängen) zu gewähren.

Wenn kein Zugriffsprofil vorhanden ist, klicken Sie auf den Link +Zugriffssteuerungsprofil hinzufügen , um ein neues Profil zu erstellen und es dem Netzwerkadministratorbenutzer zuzuweisen. Weitere Informationen finden Sie unter Hinzufügen von Zugriffssteuerungsprofilen.

Hinzufügen eines API-Tokens

So fügen Sie ein API-Token für eine Rolle hinzu:
  1. Klicken Sie auf dem Banner auf das Menü "Einstellungen" > "Systemeinstellungen".
    Die Seite "Organisationseinstellungen" wird angezeigt.
  2. Klicken Sie auf das Symbol Token erstellen (+).
    Die Seite Create API Tokens (API-Token erstellen) wird angezeigt.
  3. Geben Sie Werte ein, indem Sie den Richtlinien in Tabelle 1 folgen.

    Die mit * gekennzeichneten Felder sind Pflichtfelder.

  4. Klicken Sie auf Generieren.
    Das API-Token wird in das Feld Schlüssel eingetragen.
  5. Klicken Sie auf Schließen, um zur Seite Organisationseinstellungen zurückzukehren.

Bearbeiten eines API-Tokens

So bearbeiten Sie ein API-Token:
  1. Klicken Sie auf dem Banner auf das Menü "Einstellungen" > "Systemeinstellungen".
    Die Seite "Organisationseinstellungen" wird angezeigt.
  2. Klicken Sie auf das API-Token, das Sie bearbeiten möchten.
    Die Seite "API-Token bearbeiten" wird angezeigt.
  3. Fügen Sie ein vordefiniertes Tag hinzu und bearbeiten Sie den Namen, die Rolle und die zugewiesenen Tags. Wenn kein Tag vorhanden ist, klicken Sie auf den Link Neues Tag erstellen, um ein neues Tag zu erstellen, und weisen Sie das Tag dann dem API-Token zu.
  4. Klicken Sie auf Speichern.
    Sie kehren zur Seite Organisationseinstellungen zurück, auf der Sie die Änderungen in der Tabelle API-Token überprüfen können.

Löschen eines API-Tokens

So löschen Sie ein API-Token:
Anmerkung:

Benutzer, die API-Token für den Zugriff auf Routing Director-Ressourcen verwenden, können nach dem Löschen des API-Tokens nicht mehr auf die Ressourcen zugreifen.

  1. Klicken Sie auf dem Banner auf Einstellungen-Menü > Systemeinstellungen.
    Die Seite "Organisationseinstellungen" wird angezeigt.
  2. Klicken Sie auf das API-Token, das Sie löschen möchten.
    Die Seite API-Token bearbeiten wird angezeigt.
  3. Klicken Sie auf Löschen.
    Sie kehren zur Seite Organisationseinstellungen zurück, auf der Sie überprüfen können, ob das API-Token nicht in der Tabelle API-Token aufgeführt ist.