Authentik · Single Sign-on
Du richtest den SSO-Adapter in ZeitenSchleife unter Administration → Sicherheit → Authentik · Single Sign-on ein. In Authentik legst du dafür eine Anwendung mit einem OpenID-Connect-Provider an. Die Menünamen folgen der englischen Authentik-Oberfläche und der offiziellen Dokumentation, geprüft am 16. November 2026.
1. Adressen, Schlüssel und Lizenz vorbereiten
Für die Beispiele steht https://zeiten.example.org für deine ZeitenSchleife-Installation und https://sso.example.org für deine Authentik-Installation. Ersetze beide Hostnamen durch deine eigenen. Beide Seiten brauchen HTTPS. Der ZeitenSchleife-Server muss Authentik unter derselben HTTPS-Adresse erreichen können wie der Browser.
ZeitenSchleife verschlüsselt das Client-Secret mit DATA_SOURCE_KEY. Der Wert besteht aus 64 Hex-Zeichen und muss als Umgebungsvariable im ZeitenSchleife-Prozess beziehungsweise im App-Container gesetzt sein. Verwende einen vorhandenen Schlüssel weiter. Einen neuen kannst du bei der Ersteinrichtung mit dem Befehl aus .env.example erzeugen.
Lizenz in VaultiFy ausstellen
- Spiele das Authentik-Skript in der initialisierten SQLite-Datenbank von VaultiFy ein. Das Skript legt nur den Katalogeintrag für die Anwendung
zeitenschleifean. - Erstelle für den Kunden eine lizenzpflichtige Freigabe „Authentik · Single Sign-on“. Für einen Export ohne Hash wählst du „Ohne Hash“. Bei Hashprüfung verwende
node generateServiceHash.js authentikfür den ausgelieferten Stand. - Exportiere die Kundenlizenz der App
zeitenschleife. Öffne in ZeitenSchleife Administration → Lizenzen und importiere die Datei. Prüfe im Lizenzkatalog, observice.authentikdas Badge „Aktiv“ hat.
2. Anwendung und Provider in Authentik anlegen
- Öffne in Authentik die Admin interface und wähle Applications → Applications → New Application. Beim Auswahlpfeil neben der Schaltfläche erstellt with New Provider… das Paar aus Anwendung und Provider.
- Gib bei Name
ZeitenSchleifeund bei Slugzeitenschleifeein. Der Slug ist später Teil des Issuers. Wenn du eine Kachel zum Starten der App anbieten willst, kannst du in den UI-Einstellungen als Launch URL die öffentliche ZeitenSchleife-Adresse eintragen. - Wähle als Provider-Typ OAuth2/OIDC und fahre mit Next fort.
- Übernimm den vorgeschlagenen Provider Name. Wähle unter Authorization Flow beispielsweise
default-provider-authorization-explicit-consent. Damit bittet Authentik den Benutzer um Zustimmung. Lass unter Advanced flow settings → Invalidation Flow den voreingestelltendefault-provider-invalidation-flowstehen. -
Stelle unter Protocol settings den Provider ein.
- Client Type auf Confidential setzen. Kopiere die erzeugten Werte aus Client ID und Client Secret für ZeitenSchleife.
- Unter Grant Types genügt Authorization Code. Ist eine Auswahl vorhanden, aktiviere diesen Eintrag und lasse die übrigen Angebote abgewählt.
- Füge unter Redirect URIs/Origins (RegEx) eine Zeile mit den Optionen Strict und Authorization hinzu. Trage
https://zeiten.example.org/api/sso/authentik/callbackein. Kopiere nach Möglichkeit die URI aus dem Adapterformular. Protokoll, Host, Port und Pfad müssen übereinstimmen. Hintercallbacksteht kein Schrägstrich. - Wähle bei Signing Key ein RSA-Zertifikat mit privatem Schlüssel, beispielsweise das vorinstallierte
authentik Self-signed Certificate. ZeitenSchleife erwartet ein mitRS256signiertes ID-Token. Das Zertifikat zum Signieren von Tokens ist unabhängig vom HTTPS-Zertifikat der Authentik-Website.
-
Öffne Advanced protocol settings.
- ZeitenSchleife fordert den Scope
openidan. Die Anmeldung verwendet die Benutzerkennung aus dem signierten ID-Token. - Belasse Issuer mode bei der Option, die je Provider einen Issuer aus dem Slug der Anwendung bildet.
- Belasse Subject Mode beim Standard mit der gehashten Benutzer-ID. Die gleiche Authentik-Identität muss bei späteren Anmeldungen denselben Wert liefern.
- Lass Encryption Key leer. Die Verbindung verwendet HTTPS und Authentik signiert das ID-Token.
- ZeitenSchleife fordert den Scope
- Wenn der Zugriff auf eine Gruppe oder einen Testbenutzer begrenzt sein soll, füge bei Configure Bindings eine Bindung für diese Gruppe oder diesen Benutzer hinzu. Standardmäßig ist eine Authentik-Anwendung ohne Bindungen für alle dortigen Benutzer freigegeben. Schließe den Assistenten mit Create Application ab.
Authentik-Anleitung zum Provider-Assistenten · Protokoll, Redirect-URI und Signatur · Zugriff per Bindung
3. Provider in ZeitenSchleife eintragen
- Öffne das Authentik-Formular unter Administration → Sicherheit.
- Trage als Authentik-Issuer
https://sso.example.org/application/o/zeitenschleife/ein. Der Issuer besteht aus der Authentik-Adresse, dem Pfad und dem Slug der Anwendung. - Trage als Öffentliche App-Adresse
https://zeiten.example.orgohne zusätzlichen Pfad ein. Vergleiche den angezeigten Wert unter Redirect-URI für Authentik mit der Zeile im Provider. - Füge Client-ID und Client-Secret aus dem Provider ein. Aktiviere Authentik-Anmeldung aktivieren und speichere.
Zum Prüfen des Issuers kannst du im Browser https://sso.example.org/application/o/zeitenschleife/.well-known/openid-configuration öffnen. ZeitenSchleife verwendet daraus issuer, authorization_endpoint, token_endpoint und jwks_uri. Der Wert von issuer muss mit dem Formular übereinstimmen. ZeitenSchleife tauscht den Anmeldecode serverseitig mit client_secret_post aus.
4. Bestehendes Konto verbinden und SSO testen
- Melde dich mit dem Passwort eines persönlichen ZeitenSchleife-Testkontos an. Das lokale Administratorkonto für die Wiederherstellung wird separat verwaltet.
- Öffne Mein Konto → Authentik, gib das aktuelle ZeitenSchleife-Passwort ein und wähle Authentik verbinden.
- Melde dich auf der Authentik-Seite mit dem freigegebenen Testbenutzer an und bestätige gegebenenfalls den Zugriff. Öffne nach der Rückkehr wieder „Mein Konto“. Die Authentik-Karte zeigt dort die Verbindung an.
- Melde dich in ZeitenSchleife ab. Öffne die öffentliche App-Adresse in einem privaten Browserfenster und klicke auf Mit Authentik anmelden. Nach der Anmeldung bei Authentik solltest du im bereits vorhandenen ZeitenSchleife-Konto landen.
Die Zuordnung basiert auf dem Issuer und der von Authentik bestätigten Benutzer-ID. Sie braucht für ein bereits verknüpftes Konto keine E-Mail-Verifizierung. Gruppen und Rollen legst du weiterhin in ZeitenSchleife über RBAC fest. Eine Abmeldung in ZeitenSchleife beendet die Sitzung dieser App. Die Authentik-Sitzung kann noch aktiv sein.
5. Neue Benutzer registrieren
Neue Benutzer fordern auf der ZeitenSchleife-Anmeldeseite einen Registrierungslink an und senden das Formular ab. Sobald ein Admin die Registrierung freigegeben hat, melden sie sich in ZeitenSchleife an und verbinden ihr Authentik-Konto. Registrierung in ZeitenSchleife einrichten.
Wenn die Anmeldung nicht klappt
- „Mit Authentik anmelden“ fehlt oder SSO ist nicht verfügbar
- Prüfe Kerndatenbank, Lizenz und das gespeicherte Häkchen für die Anmeldung. Starte über die eingetragene öffentliche HTTPS-Adresse. Der Reverse Proxy vor ZeitenSchleife muss im Header
Hostden öffentlichen Hostnamen samt abweichendem Port weitergeben. - Authentik meldet eine unzulässige Redirect-URI
- Kopiere „Redirect-URI für Authentik“ aus der App in den Provider. Wähle Strict und Authorization und speichere.
- Authentik verweigert dem Benutzer den Zugriff
- Prüfe unter Applications → Applications → ZeitenSchleife die Bindungen. Für einen Gruppenzugriff muss das Testkonto Mitglied einer zugelassenen Gruppe sein.
- ZeitenSchleife bricht nach der Rückkehr ab
- Prüfe Client-ID und Client-Secret, den Issuer in der JSON-Konfiguration und den RSA-Signaturschlüssel. Discovery, Token-Endpunkt und öffentliche Signaturschlüssel müssen für den App-Server unter der Authentik-Adresse erreichbar sein. Wenn der Anmeldevorgang abgelaufen ist, starte ihn in demselben Browser neu.
- Das Authentik-Konto ist noch nicht verbunden
- Melde dich mit deinem ZeitenSchleife-Passwort an und verbinde das Konto unter „Mein Konto“. Als neuer Benutzer verwendest du zuerst deinen Registrierungslink.