Zum Inhalt springen
covey

Die Leute einer Firma melden sich bei Keycloak im Realm acme an. Für ihre KI-Agenten soll niemand ein zweites Passwort pflegen. Dafür muss jemand eine OIDC-App beim Anbieter anlegen, die Rücksprungadresse dort eintragen, die Werte der App in die Plattform übertragen und entscheiden, wer bei der ersten Anmeldung welche Rolle bekommt. Offen bleibt danach die schwierigere Frage, für welche Adressen der Anbieter überhaupt sprechen darf und was mit den Passwörtern geschieht, die es schon gibt.

In covey richtet der Org-Admin der Organisation das selbst ein. Eingebaut ist die Anmeldung mit Passwort über JWT und Argon2id. Single Sign-on kommt als OIDC-Anbindung hinzu, wobei covey der Client ist und der Anbieter der Server, etwa Keycloak, Entra ID, Google oder Okta.

Drei Werte und eine Rücksprungadresse reichen für die Anbindung

Der Org-Admin trägt zuerst die Issuer-URL ein, im Beispiel https://login.example.org/realms/acme. Dazu kommen Client-ID und Client-Secret der App sowie die Rolle für neue Personen. Beim Speichern lädt covey das Discovery-Dokument des Issuers, sodass eine falsche Adresse schon an dieser Stelle mit der Begründung des Anbieters scheitert. Das Secret liegt verschlüsselt in der Datenbank. Bei einer späteren Änderung darf sein Feld leer bleiben, und covey behält den gespeicherten Wert, solange die Client-ID gleich bleibt.

Die Rücksprungadresse, die beim Anbieter registriert werden muss, zeigt die Einstellungsseite gleich mit an. Sie lautet auf die Seitenadresse der Installation mit dem Pfad /api/sso/callback und setzt deshalb voraus, dass COVEY_SITE_URL oder die Einstellung site.url gesetzt ist. Meldet der Anbieter beim Rücksprung einen Fehler oder scheitert danach das Einlösen des Codes, die Prüfung des ID-Tokens oder die Zuordnung des Kontos, steht der letzte Fehler mit Zeitpunkt in derselben Ansicht, da das Serverprotokoll für den Org-Admin außer Reichweite liegt. Ist der Anbieter schon beim Start der Anmeldung nicht erreichbar, fehlt der Cookie des Ablaufs oder passt der State nicht, landet der Fehler allein im Serverprotokoll.

Der Anbieter spricht nur für bestätigte Domains

Eine Anbindung allein meldet noch niemanden an. Die Organisation beansprucht zusätzlich ihre E-Mail-Domain, im Beispiel example.org, und covey gibt dafür ein Token aus, das mit covey- beginnt. Dieses Token gehört als TXT-Eintrag unter _covey-challenge.example.org in das DNS, und covey schlägt den Eintrag auf Knopfdruck nach. Eine Domain, die bereits eine andere Organisation beansprucht, lehnt covey ab.

Diese Prüfung schützt die Konten anderer Organisationen auf derselben Installation. Meldet der Anbieter eine Adresse außerhalb der bestätigten Domains an, bricht covey die Anmeldung ab, sodass kein Anbieter Konten fremder Domains übernehmen kann. Lässt der DNS-Eintrag auf sich warten, darf allein ein Systemadmin der Installation die Domain von Hand bestätigen, und covey vermerkt, dass und durch wen das geschah.

Bei der ersten Anmeldung wird ein bestehendes Konto gebunden

Die Anmeldeseite fragt zuerst nach der E-Mail-Adresse und bietet jeder Adresse aus example.org Single Sign-on an. Der Ablauf zum Anbieter läuft mit PKCE, Nonce und einem versiegelten Cookie, der den Rücksprung an denselben Browser bindet und nach zehn Minuten verfällt. Die Adresse liest covey aus dem ID-Token. Erklärt der Anbieter ausdrücklich, dass er sie nicht geprüft hat, lehnt covey die Anmeldung ab.

Hat j.berg@example.org schon ein Konto mit Passwort, bindet covey dieses Konto bei der ersten Anmeldung an die Identität beim Anbieter, also an Issuer und Subject. Spätere Anmeldungen finden das Konto über diese Bindung, auch wenn sich die Adresse beim Anbieter inzwischen geändert hat. Wer noch kein Konto hat, bekommt eines ohne Passwort und einen Sitz in der Organisation mit der eingestellten Rolle.

Wer Single Sign-on verlangt, löscht die Passwörter dieser Konten

Solange Single Sign-on nur angeboten wird, kann sich jede Person weiter mit ihrem Passwort anmelden. Verlangen kann der Org-Admin Single Sign-on erst, nachdem sich das handelnde Konto selbst einmal über den Anbieter angemeldet hat, da sonst niemand weiß, ob der Weg funktioniert. Der Schalter fragt vor dem Umlegen nach und meldet danach, wie viele Konten umgestellt wurden, sofern es welche gab.

Mit dem Umlegen verlieren alle Konten der bestätigten Domains ihr covey-Passwort. Bereits versandte Links zum Zurücksetzen werden ungültig, und offene Sitzungen enden bis auf die des handelnden Admins. Anmeldung, Zurücksetzen und Ändern des Passworts lehnt covey für diese Adressen danach ab. Die Systemadmins der Installation behalten ihr Passwort, sodass der Zugang zur Installation über diese Konten auch dann offen bleibt, wenn der Anbieter gestört ist.

Der Preis dafür steht in der Oberfläche selbst: Wer sein Firmenkonto verliert, verliert auch den Zugang zu covey.

Das ist bei einem Austritt erwünscht, bindet die Anmeldung der Leute aus example.org aber an die Erreichbarkeit des Anbieters. Wird die Pflicht später wieder abgeschaltet, bekommt niemand sein altes Passwort zurück, sodass jede Person ein neues über das Zurücksetzen anfordern muss.

Zurück zur Übersicht