Authentifizierung

Bearer-Token senden#

Fügen Sie das Token bei jeder Anfrage im Header Authorization ein:

Authorization: Bearer YOUR_API_TOKEN

Verwenden Sie das API-Token aus Ihrem Benutzerkonto. Ihr IRIS Cloud-Passwort und die Anmeldesitzung im Browser sind keine API-Tokens.

Zugriff für Ihre Organisation#

Das Token ist mit der Organisation verknüpft, in der es erstellt wurde. Die API prüft das Token und den Organisationszugriff, bevor sie Daten zurückgibt. Die Kenntnis der ID einer anderen Maschine gewährt keinen Zugriff darauf.

Die dokumentierten Integrationsoperationen lesen Daten. Sie ändern keine Maschineneinstellungen und erstellen keine Produktionschargen.

In der API-Referenz authentifizieren#

1. Öffnen Sie die API-Referenz und prüfen Sie die Umgebung.
2. Wählen Sie Authorize.
3. Fügen Sie nur Ihr Token ein. Swagger ergänzt das Präfix Bearer.
4. Wählen Sie einen Endpunkt und dann Try it out. Füllen Sie die Parameter aus und wählen Sie Execute.
5. Wählen Sie zum Abschluss Logout im Autorisierungsdialog.

Tokens im Backend Ihrer Integration aufbewahren#

Speichern Sie Tokens in einem Secret-Manager oder in geschützten Umgebungsvariablen. Betten Sie sie nicht in öffentlich ausgelieferten Browsercode ein, übertragen Sie sie nicht in ein Repository und teilen Sie sie nicht über URLs.

Widerrufen Sie ein verlorenes oder offengelegtes Token in IRIS Cloud und aktualisieren Sie die Integration mit einem neuen Token. Informationen zu abgelaufenen, widerrufenen oder ungültigen Tokens finden Sie unter Authentifizierungsfehler.