Aanmelden

Je eerste beheerder

Stel admin_email: in operator.yaml in voordat je installeert. tc-operator install maakt dan voor dat adres een authgebruiker aan en kent hem de rol operator_admin toe. Tijdens de run meldt het alleen dat het account is aangemaakt:

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

Het wachtwoord zelf staat in het samenvattingsblok dat install aan het einde afdrukt, op een regel die begint met password:. Kijk daar, niet bij de stap hierboven.

Dat wachtwoord wordt één keer getoond en kan niet worden hersteld. Bewaar het tot je bent aangemeld, en vervang het dan.

Install voorziet ook de platformidentiteit van die beheerder, zodat de beheerder uitnodigingen kan versturen via de knop Invite User in de console. Kan dit niet tijdens de installatie, dan wordt de identiteit aangemaakt de eerste keer dat een uitnodiging wordt verstuurd. Er is in beide gevallen niets dat je zelf hoeft te doen.

Laat je admin_email ongezet, dan slaat install dit alles over en drukt af hoe je het handmatig doet.

Install opnieuw uitvoeren behoudt het bestaande beheerdersaccount en kent de rol opnieuw toe. Het vraagt wel, één keer, of het wachtwoord van dat account moet worden gereset — antwoord nee tenzij je het bent kwijtgeraakt, want een reset maakt het wachtwoord dat je nu gebruikt ongeldig. Antwoord je ja, dan verschijnt het nieuwe tijdelijke wachtwoord op dezelfde plek in de samenvatting. Een niet-interactieve herstart vraagt nooit en reset nooit.

Verander het wachtwoord meteen

Meld je aan en open dan Account onderaan de linkerzijbalk. Vul een nieuw wachtwoord van minstens 12 tekens in, bevestig het, en druk op Update password. Er is een vinkje Show passwords als je wilt lezen wat je hebt getypt.

Doe dit voordat je je afmeldt. Het tijdelijke wachtwoord is een lange willekeurige tekenreeks, bedoeld om je er één keer in te krijgen.

De aanmeldmethoden

Het aanmeldscherm herkent welke methoden je node heeft ingesteld en toont alleen die. Er zijn er drie.

Password is altijd beschikbaar. Het is je eerste aanmelding, en het werkt op een kale node zonder e-mail en zonder OAuth ingesteld, dus het is de gegarandeerde weg naar binnen.

Send magic link heeft SMTP nodig. Stel het blok smtp: in operator.yaml in en voer install opnieuw uit. Zonder dat kan de node helemaal geen e-mail versturen en blijft de optie verborgen. Zodra SMTP is ingesteld, kan elke beheerder met een account op de node om een aanmeldlink per e-mail vragen.

Continue with Google en Continue with Apple hebben providergegevens nodig in de omgeving van de authcontainer, en de eigen /auth/v1/callback van de node moet als redirect in de console van de provider zijn geregistreerd. De bijbehorende knop verschijnt dan vanzelf. De callback staat op je eigen domein, dus er is niets te registreren bij Trusted Codes.

Bestaan er wachtwoordloze methoden, dan staat daaronder een link Sign in with password die naar het wachtwoordformulier schakelt; Back to sign-in options schakelt terug. Bestaan er geen, dan is het wachtwoordformulier alles wat je krijgt.

De console biedt geen keuze van omgeving. De backend van je node ligt vast, dus er is niets om tussen te wisselen.

Voordat je node is goedgekeurd

Is je node al aangemeld maar heeft Trusted Codes haar toelating nog niet goedgekeurd, dan kun je je wel aanmelden, maar zit de console achter een scherm met de kop Awaiting trusted.codes approval. Het biedt Check again en een afmeldlink. Het ontgrendelt vanzelf zodra je server tot het federatieregister toetreedt.

Meer beheerders toevoegen

Voer dit uit op de node zelf. Het heeft geen eigen terminal nodig en is veilig om opnieuw uit te voeren.

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

Om de rol weer af te nemen:

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

Het account moet al op de node bestaan — de persoon moet zich minstens één keer hebben aangemeld. add-admin kent alleen de rol toe; het maakt het account niet aan. De weg via admin_email bij install is degene die een account voor je aanmaakt.

Het commando ligt vast op operator_admin en kan nooit de centrale rol toekennen.

Als je er niet in komt

Controleer, in deze volgorde: dat het admin-vlak is ingeschakeld en zijn host over HTTPS bereikbaar is; dat je admin_email gebruikt met het eenmalige wachtwoord uit de installatiesamenvatting, of een wachtwoord dat je sindsdien hebt ingesteld; en dat het account echt operator_admin heeft. Een aanmelding met een ander account wordt met opzet geweigerd.

De optie voor de magic link verschijnt pas zodra SMTP is ingesteld.