Zum Inhalt springen
DimensionKit
Try the app

Verbindungen verwalten

Jeder verbundene Assistent agiert in Ihrem Namen und kann auf sämtliche Scorecards und Einreichungen Ihres DimensionKit-Kontos zugreifen. Schreibberechtigungen erlauben Änderungen und Veröffentlichungen im gesamten Konto. Fremde Konten bleiben stets unzugänglich.

Unter Verbundene Apps in Ihrem Admin-Bereich sehen Sie alle aktiven Anwendungen mit deren Rechten und dem Verbindungszeitpunkt.

Klicken Sie in der entsprechenden Zeile auf Trennen. Der Zugriff erlischt sofort. Für eine erneute Verbindung muss der Autorisierungsprozess erneut durchlaufen werden.

Das Trennen einer Verbindung berührt weder Ihre Scorecards noch bereits erfasste Teilnehmer-Einreichungen.

Zwei Mechanismen greifen im Hintergrund:

Token Gültigkeit Funktion
Access Token 1 Stunde Wird bei jedem Aufruf des Assistenten mitgesendet
Refresh Token 30 Tage Wird im Hintergrund genutzt, um ein neues Access Token zu beziehen

Bei jedem Refresh wird ein neues Refresh-Token ausgestellt, sodass die 30-Tage-Frist von neuem beginnt:

  • Ein regelmäßig genutzter Assistent bleibt dauerhaft verbunden.
  • Wird ein Assistent 30 Tage lang nicht genutzt, erlischt die Verbindung automatisch.

Scopes sind an die jeweilige Verbindung gebunden. Um Berechtigungen zu erweitern oder einzuschränken, trennen Sie die Verbindung und verbinden Sie den Client mit den gewünschten Scopes neu. Siehe Client verbinden.

DimensionKit unterstützt den Token-Widerruf nach RFC 7009 unter /oauth/revoke:

POST /oauth/revoke
Content-Type: application/x-www-form-urlencoded
token=<access-oder-refresh-token>&token_type_hint=access_token&client_id=<ihre-client-id>
  • Der Widerruf eines der beiden Tokens entwertet die gesamte Autorisierung.
  • token_type_hint ist optional.
  • Ein unbekanntes oder bereits widerrufenes Token liefert 200.
  • Ein Client kann nur die für ihn selbst ausgestellten Tokens widerrufen.