Ga naar inhoud
DimensionKit
Try the app

Verbindingen beheren

Elke gekoppelde assistent handelt uit jouw naam en heeft toegang tot alle scorekaarten en inzendingen binnen jouw DimensionKit-account. Met schrijfrechten kan hij scorekaarten bewerken en publiceren. Accounts van derden blijven te allen tijde ontoegankelijk.

Onder Gekoppelde apps in je beheerpaneel zie je een overzicht van alle actieve applicaties, inclusief hun rechten en de datum van autorisatie.

Klik op Verbinding verbreken bij de desbetreffende applicatie. De toegang vervalt direct. Om de applicatie opnieuw te gebruiken, moet het goedkeuringsproces opnieuw worden doorlopen.

Het verbreken van een verbinding tast je scorekaarten of opgeslagen inzendingen op geen enkele wijze aan.

Twee tokens regelen de authenticatie:

Token Geldigheid Doel
Access-token 1 uur Wordt bij elk verzoek van de assistent meegezonden
Refresh-token 30 dagen Wordt geruisloos gebruikt om een nieuw access-token op te halen

Elke vernieuwing levert een nieuw refresh-token op, waardoor de termijn van 30 dagen opnieuw ingaat:

  • Een regelmatig gebruikte assistent blijft onbeperkt verbonden.
  • Een assistent die 30 opeenvolgende dagen niet gebruikt wordt, vervalt automatisch.

Scopes liggen vast voor de duur van de koppeling. Wil je de bevoegdheden van een assistent wijzigen, verbreek dan de verbinding en koppel de client opnieuw met de gewenste rechten. Zie Een client verbinden.

DimensionKit ondersteunt tokenintrekking volgens RFC 7009 via /oauth/revoke:

POST /oauth/revoke
Content-Type: application/x-www-form-urlencoded
token=<access-of-refresh-token>&token_type_hint=access_token&client_id=<jouw-client-id>
  • Intrekking van één van de tokens maakt de volledige autorisatie ongeldig.
  • token_type_hint is optioneel.
  • Onbekende of reeds ingetrokken tokens retourneren een 200-statuscode.
  • Een client kan uitsluitend zijn eigen tokens intrekken.