Naar de hoofdinhoud

Operatorscope

typehttps://docs.frem.sh/reference/api/errors/operator-scope
HTTP-status400 Bad Request

Wat het betekent

Het token dat je wilde aanmaken, vroeg een scope uit het operatorgedeelte van de woordenlijst aan: het voorvoegsel operator:.

Voorbeelden van detail-berichten die met deze fout worden teruggegeven:

  • Scope {s} cannot be issued here.

Wat je kunt doen

Haal de scope operator: uit het verzoek. Operatorscopes zijn niet voor klanten verkrijgbaar: ze geven toestemming voor acties over tenants heen op de fremforge-omgeving zelf, ze worden alleen gehouden door operators van fremverk, en geen enkel inloggegeven van een tenant kan er een dragen. Dit wordt op drie plekken afgedwongen, dus er is geen vorm van verzoek die slaagt:

  • de wildcard * geeft geen operatorscope, anders dan bij elke tenantscope;
  • bij het aanmaken van tokens worden ze direct geweigerd;
  • bij het registreren van een OAuth-client worden ze afgewezen, dus je kunt geen client registreren die er later een aanvraagt.

Denk je een operatoractie nodig te hebben, bijvoorbeeld een terugbetaling, dan is dat een verzoek aan de operatorkant en niet iets wat een API-token kan krijgen. Neem contact op met support in plaats van te zoeken naar een scope die het toestaat.

Vorm van het antwoord

Alle API-fouten van fremforge zijn RFC 9457 problem+json:

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

Baseer je logica op type, niet op title of detail: die zijn bedoeld voor mensen en kunnen anders worden geformuleerd.