Anmelden

Dein erster Administrator

Setze admin_email: in operator.yaml, bevor du installierst. tc-operator install legt dann für diese Adresse einen Auth-Nutzer an und vergibt die Rolle operator_admin. Während des Laufs meldet es nur, dass das Konto angelegt wurde:

auth user created (temporary password is in the final summary)
operator_admin granted (with the peer kill switch) — log in at the node's admin app

Das Passwort selbst steht in der Zusammenfassung, die install am Ende ausgibt, in einer Zeile, die mit password: beginnt. Schau dort nach, nicht beim Schritt davor.

Dieses Passwort wird einmal ausgegeben und kann nicht wiederhergestellt werden. Bewahre es auf, bis du dich angemeldet hast, und ersetze es dann.

Install richtet außerdem die Plattformidentität dieses Administrators ein, damit er über den Knopf Invite User der Konsole Einladungen versenden kann. Kann das zur Installationszeit nicht laufen, wird die Identität beim ersten Versand einer Einladung angelegt. In beiden Fällen musst du nichts weiter tun.

Lässt du admin_email leer, überspringt install all das und gibt aus, wie du es von Hand nachholst.

Ein erneuter Lauf von install behält das bestehende Administratorkonto und vergibt die Rolle erneut. Er fragt dabei einmal, ob das Passwort dieses Kontos zurückgesetzt werden soll — antworte mit Nein, außer du hast es verloren, denn ein Zurücksetzen macht das Passwort ungültig, das du gerade verwendest. Antwortest du mit Ja, erscheint das neue temporäre Passwort an derselben Stelle in der Zusammenfassung. Ein nicht interaktiver erneuter Lauf fragt nie und setzt nie zurück.

Ändere das Passwort sofort

Melde dich an und öffne dann Account unten in der linken Seitenleiste. Gib ein neues Passwort mit mindestens 12 Zeichen ein, bestätige es und klicke auf Update password. Ein Kästchen Show passwords zeigt dir an, was du getippt hast, falls du es nachprüfen willst.

Erledige das, bevor du dich abmeldest. Das temporäre Passwort ist eine lange Zufallsfolge, die nur für eine einmalige Anmeldung gedacht ist.

Die Anmeldemethoden

Der Anmeldebildschirm erkennt, welche Methoden dein Knoten eingerichtet hat, und zeigt nur diese an. Es gibt drei.

Passwort ist immer verfügbar. Es ist deine erste Anmeldemethode und funktioniert auf einem blanken Knoten ganz ohne E-Mail und OAuth, weshalb es der garantierte Weg hinein ist.

Send magic link braucht SMTP. Trage den Block smtp: in operator.yaml ein und lass install erneut laufen. Ohne das kann der Knoten überhaupt keine E-Mail versenden, und die Option bleibt verborgen. Sobald SMTP eingerichtet ist, kann jeder Administrator mit einem Konto auf dem Knoten einen Anmeldelink per E-Mail anfordern.

Continue with Google und Continue with Apple benötigen Anbieteranmeldedaten in der Umgebung des Auth-Containers sowie den eigenen Callback des Knotens, /auth/v1/callback, als registrierte Weiterleitung in der Konsole des Anbieters. Der passende Knopf erscheint dann von selbst. Der Callback liegt auf deiner eigenen Domain, sodass bei Trusted Codes nichts zu registrieren ist.

Existieren passwortlose Methoden, sitzt darunter ein Link Sign in with password, der zum Passwortformular wechselt; Back to sign-in options wechselt zurück. Existiert keine, bekommst du nur das Passwortformular zu sehen.

Die Konsole bietet keine Umgebungswahl an. Das Backend deines Knotens steht fest, also gibt es nichts, zwischen dem gewechselt werden könnte.

Bevor dein Knoten zugelassen ist

Wurde dein Knoten bereits eingereicht, aber von Trusted Codes noch nicht zur Föderation zugelassen, kannst du dich zwar anmelden, doch die Konsole bleibt hinter einem Bildschirm mit der Überschrift Awaiting trusted.codes approval gesperrt. Er bietet Check again und einen Abmeldelink an. Er öffnet sich von selbst, sobald dein Server der Föderationsregistrierung beitritt.

Weitere Administratoren hinzufügen

Führe dies auf der Knotenmaschine aus. Es braucht kein eigenes Terminal und lässt sich gefahrlos erneut ausführen.

tc-operator add-admin --email someone@example.com

Um die Rolle wieder zu entziehen:

tc-operator add-admin --email someone@example.com --revoke

Das Konto muss auf dem Knoten bereits existieren — die Person muss sich mindestens einmal angemeldet haben. add-admin vergibt nur die Rolle, es legt kein Konto an. Der Weg über admin_email bei der Installation ist der, der ein Konto für dich anlegt.

Der Befehl ist fest an operator_admin gebunden und kann niemals die zentrale Rolle vergeben.

Wenn du nicht hineinkommst

Prüfe, in dieser Reihenfolge: dass die admin-Oberfläche aktiviert ist und ihr Host über HTTPS erreichbar ist; dass du admin_email mit dem einmaligen Passwort aus der Installationszusammenfassung verwendest oder mit einem Passwort, das du seither gesetzt hast; und dass das Konto wirklich operator_admin trägt. Eine Anmeldung mit jedem anderen Konto wird konstruktionsbedingt abgewiesen.

Die Option für den Magic Link erscheint erst, sobald SMTP eingerichtet ist.