Operator-Scope

Was das bedeutet

Das Token, das du erzeugen wolltest, hat einen Scope aus der Operator-Hälfte des Vokabulars angefordert – mit dem Präfix operator:.

Beispiele für detail-Meldungen, die mit diesem Fehler zurückkommen:

• Scope {s} cannot be issued here.

Was du tun kannst

Entferne den operator:-Scope aus der Anfrage. Operator-Scopes sind für Kunden nicht erhältlich: Sie erlauben mandantenübergreifende Aktionen auf dem fremforge-Bestand selbst, nur Operatoren von fremverk haben sie, und keine Zugangsdaten eines Mandanten können einen tragen. Das wird an drei Stellen durchgesetzt, daher gibt es keine Form der Anfrage, die gelingt:

• die Wildcard * verleiht keinen Operator-Scope, anders als bei jedem Mandanten-Scope;
• die Token-Erzeugung lehnt sie rundweg ab;
• die Registrierung von OAuth-Clients weist sie zurück, sodass du keinen Client registrieren kannst, der später einen anfordert.

Wenn du glaubst, eine Operator-Aktion zu brauchen – zum Beispiel eine Erstattung –, ist das eine Anfrage an die Operator-Seite, nichts, wofür ein API-Token eine Berechtigung bekommen kann. Wende dich an den Support, statt nach einem Scope zu suchen, der sie erlaubt.

Form der Antwort

Alle Fehler der fremforge-API sind RFC 9457 problem+json:

{
  "type": "https://docs.frem.sh/reference/api/errors/operator-scope",
  "title": "Bad Request",
  "status": 400,
  "detail": "..."
}

Werte type aus, nicht title oder detail – diese sind für Menschen gedacht und können umformuliert werden.