← Hilfe

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

  1. Spiele das Authentik-Skript in der initialisierten SQLite-Datenbank von VaultiFy ein. Das Skript legt nur den Katalogeintrag für die Anwendung zeitenschleife an.
  2. 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 authentik für den ausgelieferten Stand.
  3. Exportiere die Kundenlizenz der App zeitenschleife. Öffne in ZeitenSchleife Administration → Lizenzen und importiere die Datei. Prüfe im Lizenzkatalog, ob service.authentik das Badge „Aktiv“ hat.

2. Anwendung und Provider in Authentik anlegen

  1. Ö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.
  2. Gib bei Name ZeitenSchleife und bei Slug zeitenschleife ein. 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.
  3. Wähle als Provider-Typ OAuth2/OIDC und fahre mit Next fort.
  4. Ü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 voreingestellten default-provider-invalidation-flow stehen.
  5. 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/callback ein. Kopiere nach Möglichkeit die URI aus dem Adapterformular. Protokoll, Host, Port und Pfad müssen übereinstimmen. Hinter callback steht 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 mit RS256 signiertes ID-Token. Das Zertifikat zum Signieren von Tokens ist unabhängig vom HTTPS-Zertifikat der Authentik-Website.
  6. Öffne Advanced protocol settings.
    • ZeitenSchleife fordert den Scope openid an. 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.
  7. 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

  1. Öffne das Authentik-Formular unter Administration → Sicherheit.
  2. 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.
  3. Trage als Öffentliche App-Adresse https://zeiten.example.org ohne zusätzlichen Pfad ein. Vergleiche den angezeigten Wert unter Redirect-URI für Authentik mit der Zeile im Provider.
  4. 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

  1. Melde dich mit dem Passwort eines persönlichen ZeitenSchleife-Testkontos an. Das lokale Administratorkonto für die Wiederherstellung wird separat verwaltet.
  2. Öffne Mein Konto → Authentik, gib das aktuelle ZeitenSchleife-Passwort ein und wähle Authentik verbinden.
  3. 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.
  4. 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 Host den ö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.

Authentik-Anleitung zur Proxy-Konfiguration