IRIS CloudEntwickler
API-ReferenzIRIS Cloud öffnen
DE

API-Token erstellen

Ihr API-Token verbindet eine Integration mit den Daten Ihrer Organisation. Erstellen und verwalten Sie es in Ihrem IRIS Cloud-Konto.

Token in IRIS Cloud erstellen#

  1. Bei IRIS Cloud anmelden

    Verwenden Sie Ihr bestehendes Konto in der Umgebung, mit der Sie sich verbinden möchten.

  2. Benutzerkonto öffnen (User Account)

    Öffnen Sie den Bereich IRIS Cloud API Tokens. Benutzerkonto in IRIS Cloud öffnen ↗

    IRIS-Cloud-Konto ohne API-Tokens.
    IRIS-Cloud-Konto ohne API-Tokens. Bild in Originalgröße öffnen ↗
  3. Create Token (Token erstellen) auswählen

    Geben Sie dem Token einen eindeutigen, gut erkennbaren Namen, etwa Produktionsintegration. Ergänzen Sie optional eine Beschreibung des Systems, das es verwenden wird.

    Dialog Create Token mit Feldern für Name, optionale Beschreibung und Ablaufdatum.
    Dialog Create Token mit Feldern für Name, optionale Beschreibung und Ablaufdatum. Bild in Originalgröße öffnen ↗
  4. Gültigkeitsdauer wählen und Token erstellen

    Wählen Sie 30, 90, 180 oder 365 Tage oder Never (Nie). Klicken Sie auf Create (Erstellen), um das Token zu erzeugen.

    Ablaufoptionen: Never, 30, 90, 180 oder 365 Tage.
    Ablaufoptionen: Never, 30, 90, 180 oder 365 Tage. Bild in Originalgröße öffnen ↗
    Ausgefülltes Formular, bereit zum Erstellen des Tokens.
    Ausgefülltes Formular, bereit zum Erstellen des Tokens. Bild in Originalgröße öffnen ↗

Vor dem Schließen kopieren#

Wählen Sie im Dialog Token Created (Token erstellt) die Option Copy Token (Token kopieren). Speichern Sie es im Secret-Manager oder in der geschützten Umgebungskonfiguration Ihrer Integration.

Dialog Token Created: Token vor dem Schließen kopieren.
Dialog Token Created: Token vor dem Schließen kopieren. Bild in Originalgröße öffnen ↗

Verwenden Sie Ihr Token im Schnellstart oder fügen Sie es unter Authorize in der API-Referenz ein.

Tokens verwalten#

Die Kontotabelle zeigt Name, Beschreibung, Erstellungszeit, letzte Verwendung, Ablaufdatum und Status jedes Tokens. Ihre Organisation kann bis zu drei aktive Tokens haben.

Token-Tabelle mit Nutzungsdaten, Ablaufdatum, Status und Aktionen zum Widerrufen.
Token-Tabelle mit Nutzungsdaten, Ablaufdatum, Status und Aktionen zum Widerrufen. Bild in Originalgröße öffnen ↗

Wenn das Limit erreicht ist, prüfen Sie Ihre Integrationen und widerrufen Sie ein nicht mehr benötigtes Token, bevor Sie ein neues erstellen. Ein Token mit Ablaufdatum funktioniert nach Ablauf nicht mehr.

Benachrichtigung beim Erreichen der Grenze von drei aktiven Tokens.
Benachrichtigung beim Erreichen der Grenze von drei aktiven Tokens. Bild in Originalgröße öffnen ↗

Token widerrufen oder ersetzen#

Wählen Sie in der API-Token-Tabelle die Widerrufsaktion für das Token, prüfen Sie die Bestätigung und wählen Sie Revoke Token (Token widerrufen). Der Widerruf kann nicht rückgängig gemacht werden. Integrationen mit diesem Token funktionieren danach nicht mehr.

Bestätigung Revoke Token mit Warnung, dass Integrationen nicht mehr funktionieren.
Bestätigung Revoke Token mit Warnung, dass Integrationen nicht mehr funktionieren. Bild in Originalgröße öffnen ↗

Erstellen Sie beim Ersetzen zuerst das neue Token, sofern noch ein aktiver Platz frei ist. Aktualisieren und prüfen Sie die Integration und widerrufen Sie anschließend das alte Token. Sind alle Plätze belegt, planen Sie den Austausch, bevor Sie ein noch verwendetes Token widerrufen.

WEITERLESENAuthentifizierung
IRIS Cloud · Connect APIAPI 1.0.0 · Produktion