Zum Inhalt springen

Single Sign-On

ReadyStackGo kann Benutzer über einen Identity Provider anmelden. WYSCH wird von Haus aus unterstützt: Ein geführter Einrichtungslauf verbindet die Installation mit WYSCH ID, ohne dass Adressen, Client-IDs oder Secrets abgetippt werden. Jeder andere OpenID-Connect-Anbieter (Keycloak, Entra ID, …) funktioniert über die Vorlage Generic OIDC.

Wer sich anmelden darf, ändert sich nicht: bestehende Benutzer und Personen mit offener Einladung (siehe Benutzerzugang). Rollen vergibt immer ReadyStackGo, nie der Anbieter.

Der Setup-Wizard beginnt mit How do you want to sign in?:

  • Built-in sign-in legt den ersten Administrator mit Benutzername und Passwort an, wie bisher.
  • WYSCH verbindet die Installation mit WYSCH und meldet Sie mit Ihrem WYSCH-Konto an. Dieses Konto wird erster Systemadministrator, ohne lokales Passwort.

Anmeldeart im Setup-Wizard

  1. Bestätigen Sie die Adresse dieser Installation. ReadyStackGo schlägt die Adresse aus dem Browser vor und speichert sie als Basis-Adresse.
  2. Klicken Sie Connect with WYSCH. Melden Sie sich bei WYSCH an und bestätigen Sie die Verbindung.
  3. Sie kommen automatisch zurück, ReadyStackGo meldet Sie mit WYSCH an und zeigt Signed in as …. Danach folgt wie gewohnt der E-Mail-Schritt.

Ist WYSCH nicht erreichbar oder wird die Verbindung abgebrochen, erklärt der Wizard den Grund und bietet Try again an und, solange das Zeitfenster des Setups offen ist, Use built-in sign-in instead (danach öffnet ein Neustart des Containers es wieder). Läuft der Anmeldelauf selbst ab, bietet der Wizard bei offenem Zeitfenster Start again an, sonst den Neustart des Containers. Ein Lauf, der im Zeitfenster des Setups beginnt, darf bis zu 15 Minuten dauern. Die Bestätigung bei WYSCH, samt dem Anlegen eines WYSCH-Kontos, muss aber binnen 10 Minuten zurückkommen; danach bietet der Wizard Try again an.

Unter Settings → Single Sign-On sehen Sie alle Provider mit Status und letztem Ergebnis und fügen mit Add provider neue hinzu.

Single-Sign-On-Provider

Der Einrichtungslauf geht in Schritten; welche erscheinen, hängt von der Vorlage ab:

SchrittWYSCHGeneric OIDC
TemplateWYSCH wählenGeneric OIDC wählen
Provider addressfest in der VorlageIssuer-URL eingeben; ReadyStackGo prüft sie sofort
This installationAdresse von ReadyStackGo und der Provider-Name (Teil der Redirect-URI)ebenso
Connect / RegisterConnect with WYSCH: bei WYSCH anmelden und bestätigen, Client-ID und Secret kommen automatischRedirect-URI zum Anbieter kopieren, dann Client-ID und Secret eintragen
TestPrüfungen und Test-AnmeldungPrüfungen und Test-Anmeldung
SaveAnzeigename, einschalten, unbestätigten E-Mail-Adressen vertrauenebenso

Der Provider-Name wird Teil der Redirect-URI https://<Ihre Adresse>/api/auth/oidc/<name>/callback und lässt sich später nicht ändern.

Der Test hat zwei Stufen:

  • Prüfungen ohne Anmeldung laufen vom Server aus: Discovery-Dokument erreichbar, Issuer passt zur Adresse des Anbieters, Endpunkte vorhanden, Pushed Authorization Requests (PAR), wo verlangt, sowie Client-ID und Secret (über einen PAR-Aufruf, wenn der Anbieter PAR anbietet). Jede fehlgeschlagene Prüfung sagt, was falsch ist und was zu tun ist.
  • Test-Anmeldung: Sie melden sich einmal beim Anbieter an. ReadyStackGo zeigt, welche Angaben angekommen sind (Subject, E-Mail und ob sie bestätigt ist, Benutzername, Anzeigename) und ob sie reichen. Die Test-Anmeldung meldet Sie nicht bei ReadyStackGo an und verknüpft kein Konto.

Test mit den Angaben der Test-Anmeldung

Einschalten lässt sich ein Provider erst nach bestandenen Prüfungen und einer erfolgreichen Test-Anmeldung. Ohne bestandenen Test können Sie ihn ausgeschaltet speichern und später mit Test in der Liste prüfen.

Wird die Verbindung in WYSCH gelöscht, scheitern Anmeldungen, und die Liste zeigt Reconnect needed. Reconnect koppelt die Installation neu und ersetzt Client-ID und Secret. WYSCH macht den alten Client ungültig, sobald dasselbe WYSCH-Konto eine neue Verbindung für dieselbe Adresse bestätigt. ReadyStackGo übernimmt die neuen Zugangsdaten deshalb sofort, sobald die Prüfung von Client-ID und Secret bestanden ist und die neue Verbindung zu der Adresse gehört, mit der sich die Installation anmeldet; eine Test-Anmeldung danach bestätigt die Anmeldung. Ändert sich die Adresse der Installation während des Reconnect, gelten die neuen Zugangsdaten erst nach einer erfolgreichen Test-Anmeldung.

Bei der Anmeldung sucht ReadyStackGo das Konto in dieser Reihenfolge:

  1. Ein Konto, das schon mit diesem Provider und Subject verknüpft ist.
  2. Sonst ein bestehender Benutzer oder eine offene Einladung mit derselben E-Mail-Adresse, aber nur, wenn der Anbieter die Adresse bestätigt hat (email_verified) oder Trust unverified email addresses eingeschaltet ist. Bei neuen Providern ist das aus; Provider, die es vor dieser Einstellung schon gab, behalten es an.
  3. Alle anderen werden abgewiesen.

Ein Benutzer, der mit diesem Provider unter einer anderen Identität verknüpft ist, wird abgewiesen statt neu verknüpft. Deaktivierte Konten können sich nicht anmelden.

  • Melden Sie sich nur über einen Provider an und haben kein lokales Passwort, lässt sich dieser Provider weder ausschalten noch entfernen, und eine geänderte Verbindung (Provider-Adresse, Client-ID, Secret, Scopes) gilt erst nach einer erfolgreichen Test-Anmeldung.
  • Unlink im Profil ist gesperrt, solange Sie kein lokales Passwort haben.
  • Solange kein Systemadministrator ein lokales Passwort hat, zeigen Settings › Single Sign-On und das Profil einen Hinweis. Setzen Sie ein Passwort unter Profile → Set a local password.

Ist der Anbieter nicht erreichbar und kann sich niemand anmelden, setzen Sie vom Server aus ein lokales Passwort:

Terminal-Fenster
docker compose exec readystackgo rsgo admin set-password <username>

Der Befehl fragt das Passwort zweimal ab (oder liest mit docker compose exec -T … eine Zeile von der Standardeingabe). --generate erzeugt ein Passwort und zeigt es einmal an. Bei gestopptem Container geht docker compose run --rm readystackgo admin set-password <username>. Jede Nutzung wird protokolliert.

Exit-Codes: 0 erledigt, 1 Benutzer unbekannt, 2 Passwort erfüllt die Regeln nicht, 3 Datenbank nicht erreichbar, 64 falsche Argumente.

Provider entstehen aus Vorlagen. Betreiber und Distributionen können Vorlagen ergänzen oder ersetzen, ohne ReadyStackGo zu ändern, siehe Identity-Provider-Vorlagen.