Erläuterung des Authentifizierungssystems (Auth)

Erläuterung der Authentifizierungsmethoden und Berechtigungsstufen für Admin-Management-APIs

Erläuterung

Die Admin-Management-APIs verwenden einen mehrstufigen Authentifizierungsmechanismus. Übliche Stufen sind: Öffentlich, Benutzer, Administrator und Root.

Authentifizierungsmethode (eine von zwei)

Session

Session über die Login-API abrufen:

POST /api/user/login

Access Token (empfohlen)

Im Request-Header mitführen:

Authorization: Bearer {token}

Das Token kann unter „Persönliche Einstellungen - Sicherheitseinstellungen - System Access Token“ erstellt werden.

Erforderliche Request-Header

Einige APIs erfordern das Mitführen eines Request-Headers zur Benutzeridentifikation:

New-Api-User: {user_id}

Dabei muss {user_id} mit dem aktuell angemeldeten Benutzer übereinstimmen.

Berechtigungsstufen

Öffentlich (Public): Keine Authentifizierung erforderlich
Benutzer (User): Login oder Access Token erforderlich
Administrator (Admin): Administratorberechtigung erforderlich
Root: Höchste Berechtigungsstufe