Sitzungssteuerung

Die Konsole listet die Sitzungen auf, die Ihre Nutzer auf einer eigenen Login-Domain halten, und widerruft jede einzelne davon. Eine Anmeldung, die Tokens hält, endet, wenn ihr Refresh-Token widerrufen wird, wenn Sie die App deaktivieren oder wenn die Tokens ablaufen.

Die Sitzungsliste

Jede Anmelde-App hat in der Konsole eine Liste ihrer aktiven Sitzungen, auf der Seite der eigenen Domains der App. Eine Zeile zeigt die ID des Nutzers, wie er sich angemeldet hat und wann die Sitzung zuletzt gesehen wurde, mit einer Schaltfläche Widerrufen daneben. Das Auflisten erfordert die Berechtigung users:read und das Widerrufen users:write. Die Liste wird pro App geführt, und die eigene Seite eines Nutzers enthält keine Liste seiner Sitzungen.

Welche Anmeldungen erscheinen

Eine Sitzung dieser Art gibt es nur für eine Anmeldung, die auf einer verifizierten eigenen Login-Domain. Eine Anmeldung auf der Standarddomain von Fóir oder über die Token-API stellt Tokens aus und erzeugt keine Sitzung, erscheint also nie in der Liste.

Was das Widerrufen bewirkt

Das Widerrufen einer Sitzung meldet diesen Nutzer ab, und seine App kann daraus kein Zugriffs-Token mehr ausstellen. Das Widerrufen löst in derselben Transaktion ein Ereignis SESSION_REVOKED aus, das die Sitzungs- und Nutzer-IDs trägt, damit Ihre eigenen Systeme verwerfen können, was sie zwischengespeichert haben. Dasselbe Ereignis wird ausgelöst, wenn sich ein Nutzer abmeldet und wenn eine App deaktiviert wird.

Andere Anmeldungen beenden

Die eigene Abmeldung eines Nutzers beendet seine Sitzung auf der Login-Domain. Bei einer Token-Anmeldung beendet das Senden des Refresh-Tokens an den Revoke-Endpunkt diese Token-Familie. Das Deaktivieren einer Anmelde-App beendet alle Sitzungen und Tokens ihrer Nutzer auf einmal, und die API akzeptiert ihre Zugriffs-Tokens nicht mehr, ohne auf deren Ablauf zu warten. Ein Zurücksetzen des Passworts beendet die Sitzungen und Refresh-Tokens dieses Nutzers.

Laufzeiten

Ein Zugriffs-Token gilt 15 Minuten, ein Refresh-Token gilt 30 Tage und rotiert bei jeder Verwendung. Eine Sitzung endet nach 30 Tagen ohne Nutzung oder 90 Tage nach der ersten Anmeldung, und beide Fenster lassen sich pro Projekt festlegen.

Details nachlesen

Der Anmelde-Leitfaden behandelt Sitzungsfenster, Abmeldung und Token-Laufzeiten, und die Sitzungsliste der Konsole hat keine eigene Dokumentationsseite.