Den Berechtigungsumfang eines Tokens festlegen

Ein gültiges Token sollte nicht alles freischalten. Mit Scopes kann ein Token nur die spezifischen Berechtigungen enthalten, die sein Besitzer tatsächlich benötigt. 🎯

Ein Scope ist eine benannte Berechtigung, etwa zum Lesen oder Schreiben. Tokens werden mit einer Menge von Scopes ausgestellt, die beschreiben, was sie dürfen.

Befolgen Sie das Prinzip der geringsten Berechtigung: Gewähren Sie nur die kleinste Menge an Scopes, mit der die Aufgabe erledigt werden kann, und nichts darüber hinaus.

Wenn OAuth ein Token ausstellt, werden die gewährten Scopes darin gespeichert. Der Server kann sie auslesen und entscheiden, was erlaubt ist.

Prüfen Sie vor der Ausführung eines sensiblen Tools, ob das Token den erforderlichen Scope enthält. Fehlt er, weisen Sie den Aufruf ab.

Trennen Sie einen Lese-Scope von einem Schreib-Scope, damit ein Token, das nur zum Betrachten von Daten gedacht ist, diese nicht unbemerkt ändern kann.

Sie können den Zugriff für jedes Tool einzeln begrenzen: Ein sicherer Taschenrechner kann für alle verfügbar sein, während ein delete-Tool durch einen strengeren Scope geschützt wird.

Scopes können festlegen, welche Ressourcen ein Token sehen darf, etwa einen Projektordner statt jeder Datei, auf die der Server zugreifen kann.

Eine Anfrage mit einem gültigen Token, aber dem falschen Scope ist zwar authentifiziert, jedoch nicht erlaubt. Die richtige Antwort lautet daher 403 Forbidden.

Führen Sie Buch darüber, welche Tokens welche Scopes besitzen. Ein Prüfprotokoll macht deutlich, wer im Problemfall was tun konnte.

Überprüfen Sie Scopes regelmäßig und widerrufen Sie nicht mehr benötigte. Durch das Einschränken von Berechtigungen verringern Sie Ihre Angriffsfläche stetig.

Scopes machen aus einem Token einen präzisen Schlüssel. Gewähren Sie die geringste erforderliche Berechtigung, prüfen Sie sie pro Tool und antworten Sie mit 403, wenn ein Scope fehlt. 🗝️