OAuth-Bereiche

Ein Scope ist eine Zeichenkette – beispielsweise read, orders:write oder openid –, die einen Zugriffsbereich definiert. Ein Client fordert die benötigten Scopes an, der Benutzer oder die Richtlinie gewährt einige oder alle davon, und das ausgestellte Token enthält die gewährten Berechtigungen. Ressourcenserver prüfen die Scopes des Tokens, bevor sie Aktionen ausführen. Ein Token, das zum Lesen ausgestellt wurde, kann daher nicht zum Löschen verwendet werden.

So funktioniert es

Die Scopes werden im Scope-Parameter der Autorisierungs- oder Token-Anfrage als durch Leerzeichen getrennte Liste übermittelt und in der Token-Antwort zurückgegeben – möglicherweise eingeschränkter als angefordert. Ein JWT-Zugriffstoken enthält sie üblicherweise in einem Scope- oder SCP-Claim; die Scopes eines undurchsichtigen Tokens werden durch Introspektion ermittelt.

Das Missverständnis

Das Token verfügt über die angeforderten Berechtigungen. Der Server kann weniger Berechtigungen gewähren, und ein Client, der dies annimmt, schlägt später fehl – weit entfernt von der eigentlichen Ursache. Lesen Sie das Feld „Scope“ in der Token-Antwort und testen Sie, was passiert, wenn ein Aufruf eine Berechtigung benötigt, die im Token fehlt.

Probieren Sie es hier aus

Die Token-Antwort von POST /auth/v1/oauth/token gibt den gewährten Bereich an – Lesezugriff für Client-Anmeldeinformationen, Lese- und Schreibzugriff für den Autorisierungscode-Flow – und POST /identity/v1/introspect meldet den Bereich eines Identity-API-Tokens.

Quellen

Weitere Begriffe

Diese Seite auf Englisch lesen

Alle Glossarbegriffe · Testtechniken · Alle 39 Mock-REST-APIs

Zuletzt aktualisiert