InloggenBriefing plannen

Hoofdstuk 2.12

De eerste ingebruikname

Van een niet-geclaimde installatie naar mensen aan het werk. Maak de claimcode aan, claim de installatie in een browser, maak de eerste beheerder aan met een passkey, koppel vervolgens de bedrijfsaanmelding en nodig alle anderen uit.

Deze pagina is door AI vertaald vanuit het Engelse origineel. Als er iets onduidelijk is, geldt de Engelse pagina als referentie. Lees deze pagina in het Engels

18 minuten leestijd

Wanneer een installatie is voltooid, is de installatie van niemand. Er is geen organisatie, geen persoon en geen sessie, en niemand kan inloggen. De installatie wacht tot één persoon in een browser bewijst dat diegene communiceert met de installatie die zojuist is aangemaakt. Bij Harrow Port Authority was die persoon Aoife Brennan, hoofd IT, met Tomás Reilly naast haar achter de terminal. Dit hoofdstuk volgt hun eerste twintig minuten.

De volgorde ligt vast, en elke stap sluit de voorgaande definitief af: de installatie claimen, de eerste beheerder en de organisatie aanmaken, een passkey instellen en op de pagina Vandaag uitkomen. Daarna volgen de zes zaken die u moet voorbereiden, het zakelijk inloggen en het uitnodigen van alle anderen, in de volgorde die u uitkomt.

Een reeks vakken van links naar rechts: "nexusctl claim-code (terminal)", "Deze installatie claimen (browser: code + vingerafdruk)", "De eerste beheerder en de organisatie", "Passkey (tweede controle)", "Vandaag, wanneer alles nieuw is", "Zes dingen voordat iemand inlogt", "Mensen uitnodigen". Onder het claimvak lopen twee rode vertakkingen naar beneden: "code te oud: CLAIM_CODE_EXPIRED, maak een nieuwe code aan" en "vingerafdrukken wijken af: CLAIM_FINGERPRINT_MISMATCH, stop". Een dunne lijn onder de eerste drie vakken heeft het bijschrift "elke stap schakelt de voorgaande definitief uit".
De eerste doorloop, van de terminal tot de eerste pagina Vandaag, en de twee plekken waar deze kan stoppen.

De claimcode aanmaken

De claimcode bewijst dat de persoon achter de browser ook de terminal kan zien van iemand met toegang tot het cluster. Alleen zo'n persoon kan er een aanmaken. Voer dit uit waar uw kubeconfig verbinding maakt met het cluster:

nexusctl claim-code --administrator aoife.brennan@harrow.example

nexusctl claim-code vraagt de sleutelservice van de installatie, nexus-keys, om de code aan te maken. Zonder nexusctl wordt dezelfde opdracht uitgevoerd in de eigen pod van de sleutelservice:

kubectl -n nexus exec deploy/nexus-keys -- nexus-keys claim-code \
  --administrator aoife.brennan@harrow.example --source "Tomás Reilly, ops terminal"

--source bestaat uit een paar woorden die aangeven wie de code heeft aangemaakt. De claimpagina toont deze onder "Aangemaakt door", zodat de persoon die claimt weet waar de code vandaan komt.

 Code  7KQM-4TXD-PL9R  works once, for 30 minutes, until 09:55 · 5 tries
 Fingerprint of this installation, to compare in the browser:
 3F9A C21B 77E0 5D4C 9B12 A6F3 0E88 41D7

Drie dingen over de code zijn van belang.

  • De code is 30 minuten geldig. Een code die over iemands schouder is meegekeken, is snel onbruikbaar.
  • De code staat 5 pogingen toe. Na de vijfde foute poging is de code verbruikt, ongeacht de resterende tijd.
  • De code is voor één persoon. Het e-mailadres dat u opgeeft, is dat van de eerste beheerder. Het reist mee met de claim, en het formulier voor de eerste beheerder toont het als vaststaand gegeven dat niet opnieuw hoeft te worden ingetypt.

De vingerafdruk bestaat uit acht groepen van vier tekens: de eigen identiteit van de installatie. Laat deze op het scherm staan. U gaat deze straks groep voor groep vergelijken in de browser.

De installatie claimen

  1. Open op de computer die u als eerste beheerder gaat gebruiken het installatieadres van de console, in dit geval https://console.harrow.example/install. Dit stuurt u door naar de juiste pagina voor de status van de installatie: de claimpagina zolang deze openstaat, de pagina voor de eerste beheerder zodra deze is geclaimd, en de console als u al bent ingelogd.
  2. Typ op Deze installatie claimen de code in bij Groep één, Groep twee en Groep drie, één groep van vier tekens in elk veld.
  3. Vergelijk de Vingerafdruk van deze installatie op de pagina met de terminal, alle acht groepen, één voor één.
  4. Als elke groep overeenkomt, vinkt u Alle acht groepen komen overeen met wat mijn terminal toont aan.
  5. Druk op Deze installatie claimen; de pagina bevestigt de claim en stuurt u door naar de pagina voor de eerste beheerder.
Deze installatie claimen
Deze installatie claimen
De claimpagina. De code wordt in drie groepen ingevoerd, de volledige vingerafdruk wordt in acht groepen van vier getoond ter vergelijking met de terminal, en de kaart rechts vermeldt waar de code vandaan komt en hoeveel pogingen er nog over zijn.

Claimen doet drie dingen. Het maakt van deze browser de enige plek waar de eerste beheerder kan worden aangemaakt. Het legt in het auditlogboek vast wie de installatie heeft geclaimd, en wanneer. En het schakelt de claimpagina definitief uit. Vanaf dat moment antwoordt het claimadres dat de installatie al is geclaimd.

Als de vingerafdruk niet overeenkomt, stop dan

Een afwijkende vingerafdruk betekent dat een andere installatie op dit adres antwoordt. Het kan gaan om een verkeerd getypt adres, een verouderd DNS-record (Domain Name System), of een machine die is opgezet om de eerste beheerder te onderscheppen. Als u deze zou claimen, zou die machine uw organisatie in handen hebben.

Claim niet en typ de code niet in op die pagina. Sluit de pagina en controleer vervolgens twee dingen: dat console.harrow.example verwijst naar uw ingress, en dat het certificaat dat de browser toont, is uitgegeven door de CA (certificaatautoriteit) die u verwacht. Uw eigen installatie is ongewijzigd en nog steeds niet geclaimd.

Als een claim wordt verzonden met een vingerafdruk die niet van de installatie is, weigert de sleutelservice deze met CLAIM_FINGERPRINT_MISMATCH (403). Er wordt niets geclaimd. De pagina toont vervolgens de twee vingerafdrukken naast elkaar waarbij de afwijkende groepen zijn gemarkeerd, plus de stappen om het adres en het certificaat te controleren.

Vingerafdruk komt niet overeen
Vingerafdruk komt niet overeen
De pagina waar een niet-overeenkomende vingerafdruk naartoe leidt. De afwijkende groepen zijn gemarkeerd en de stappen controleren het adres en het certificaat voordat er iets anders wordt ingetypt.

De eerste beheerder en de organisatie aanmaken

De pagina die volgt, heeft als kop "Twee korte formulieren, daarna bent u binnen". De eerste beheerder kan alle anderen toevoegen en bijna alles hier kan later worden gewijzigd. Twee dingen kunnen niet worden gewijzigd, en de pagina geeft deze aan.

Veld Wat wordt ingevuld Kan dit later worden gewijzigd?
Volledige naam Uw naam Ja
Zakelijk e-mailadres Het adres waarvoor de claimcode is aangemaakt; wordt getoond en niet opnieuw ingetypt Het is het adres van de beheerder
Rol in Nexus Organisatiebeheerder. De eerste persoon is altijd een beheerder. Wordt hier niet gekozen
Tweede controle Passkey op deze laptop Ja, er kunnen er meer worden toegevoegd
Naam (van de organisatie) Harrow Port Authority Ja
Land Waar de organisatie is gevestigd Ja
Korte naam in adressen Gemaakt op basis van de naam, zoals harrow-port-authority Nee. Links en exports gebruiken deze.
Waar gegevens worden bewaard Deze installatie Nee. Dit later wijzigen betekent een nieuwe installatie.
Taal en datums Engels (VK), met de datum van vandaag Ja
Tijdzone De tijdzone van de server Elke persoon ziet tijden in de eigen tijdzone

De korte naam bestaat uit kleine letters, cijfers en koppeltekens, tot 100 tekens, gemaakt op basis van de naam van de organisatie zonder accenten. Bekijk deze goed voordat u ergens op drukt. Deze verschijnt in elke link die mensen delen en elke export die ze maken, zolang de organisatie bestaat.

U stelt op deze pagina ook een wachtwoord in. Dat is op zichzelf nooit genoeg: een beheerder logt nooit in met alleen een wachtwoord. De tweede controle, hieronder, is waarmee u inlogt.

Tegelijkertijd wordt een nood-inlogcode voor beheerders aangemaakt. Deze wordt verzegeld en één keer afgedrukt, voor in de kluis. Deze werkt alleen wanneer het zakelijk inloggen niet beschikbaar is, en elk gebruik wordt vastgelegd en gemeld aan alle beheerders. Leg deze in de kluis op de dag dat u hem afdrukt.

De pagina vermeldt ook dat aan Adverant niet wordt doorgegeven wie u bent. Deze gegevens blijven op de installatie. Een licentie vermeldt de naam van het bedrijf, nooit de mensen die er werken.

Druk op Aanmaken en inloggen. Het aanmaken van de beheerder en de organisatie duurt een paar seconden. De pagina antwoordt "Aangemaakt voor aoife.brennan@harrow.example. Stel nu uw passkey in: hiermee logt u in."

De eerste beheerder
De eerste beheerder
De eerste beheerder en de organisatie op één pagina. Bij de twee keuzes die nooit kunnen worden gewijzigd, de korte naam en waar gegevens worden bewaard, staat dit naast het veld vermeld, en de nood-inlogcode wordt verzegeld voor in de kluis.

De passkey: de tweede controle

  1. Druk op Passkey instellen en inloggen.
  2. Uw browser vraagt u om een passkey aan te maken. Op een laptop met Touch ID of Windows Hello bevestigt u met uw vinger, gezicht of pincode. Als de computer zelf geen passkey kan aanmaken, toont de browser een QR-code (quick response): richt de camera van uw telefoon erop en volg de instructies op de telefoon.
  3. De pagina antwoordt "Uw passkey is ingesteld en u bent ingelogd als aoife.brennan@harrow.example." en opent de console.

U hebt vanaf het drukken op Aanmaken en inloggen tien minuten de tijd om de passkey aan te maken, in dezelfde browser. Daarna wordt de installatiestap gesloten en bestaat de beheerder zonder passkey. Een operator moet dan helpen, zoals hieronder beschreven bij nieuwe pogingen.

Vanaf nu logt de eerste beheerder in met die passkey. Het wachtwoord van een volledige beheerder, op zichzelf ingetypt, brengt nooit een sessie tot stand: de inlogservice antwoordt met een verzoek om de tweede controle. Dat is een eigenschap van het ontwerp, en de reden waarom de passkey belangrijk is. Een verloren passkey betekent dat u niet meer naar binnen kunt, dus voeg op de eerste dag een tweede toe, op een telefoon of een beveiligingssleutel.

Later loggen mensen in op de installatie met een passkey, met Google, met GitHub of met het zakelijk inloggen van hun bedrijf, afhankelijk van wat de organisatie toestaat.

Code Wat het betekent Wat te doen
PASSKEY_UNSUPPORTED Deze browser kan geen passkey aanmaken. Er is niets ingesteld. Open de pagina in een browser die passkeys ondersteunt, op dezelfde computer.
PASSKEY_CANCELLED Het venster is gesloten of er is niet op tijd een keuze gemaakt. Er is niets verzonden. Druk opnieuw op de knop.

De eerste Vandaag-pagina

De console opent op Vandaag, en op de eerste dag is bijna alles daarop leeg. Elk leeg gedeelte vermeldt wat daar zal verschijnen en bevat de knop om ermee te beginnen; zo vermeldt "Vereist een beheerder" dat verzoeken daar zullen wachten zodra mensen deelnemen, met Mensen uitnodigen ernaast. De installatiechecklist geeft aan hoeveel stappen ervan zijn voltooid, in willekeurige volgorde. De enige echte geschiedenis, de installatie zelf, staat al onder "Wat is er gewijzigd": de installatie is ingesteld en de passkey van de eerste beheerder is aangemaakt.

Vandaag, wanneer alles nieuw is
Vandaag, wanneer alles nieuw is
Vandaag op de eerste dag. Elk leeg gedeelte vermeldt wat daar zal verschijnen en hoe u ermee begint, en "Wat is er gewijzigd" bevat al de installatie zelf.

Zes dingen voordat iemand zich aanmeldt

De pagina Zes dingen voordat iemand inlogt somt op waaraan moet zijn voldaan voordat mensen worden uitgenodigd. Het is geen wizard. Voer ze in willekeurige volgorde uit, en de pagina telt ze ("Drie van de zes voltooid").

Onderdeel Wanneer is hieraan voldaan
Licentie Een Enterprise-licentie geïmporteerd. Hoofdstuk 2.13, Licenties. Community heeft geen licentie nodig.
Adres en certificaat Het openbare adres antwoordt met een certificaat waarvan de keten volledig is.
Back-ups Een back-upschema ingesteld, met een doel waarnaar kan worden geschreven.
Zakelijk inloggen verbonden en getest. Tot die tijd gebruiken mensen passkeys.
E-mail Een mailserver ingesteld. Tot die tijd kunnen er geen uitnodigingen worden verzonden.
AI-model Een AI-model (kunstmatige intelligentie): een modelsleutel van de organisatie, of een model op uw eigen hardware. Tot die tijd wacht de assistent. Hoofdstuk 2.14, AI-providers en -modellen.

Mensen uitnodigen wordt geopend wanneer aan alle zes is voldaan.

Dezelfde pagina somt op wat vast komt te liggen zodra mensen inloggen, met voor elk de reden: de korte naam in adressen, waar gegevens worden bewaard, en de sleutelbeheerder (sleutels kunnen van een softwarematige beheerder naar hardware worden verplaatst, maar nooit terug). De naam van de organisatie wordt ook vermeld, omdat het de moeite waard is deze te controleren, al kan deze nog worden gewijzigd.

Nexus beantwoordt geen enkel AI-verzoek voordat de organisatie een model heeft. Er zit geen gedeelde sleutel achter een installatie en er is geen terugvaloptie, dus een organisatie zonder modelsleutel krijgt een duidelijke weigering die een beheerder vertelt wat er moet worden toegevoegd.

Zes dingen voordat iemand inlogt
Zes dingen voordat iemand zich aanmeldt
Zes controles in willekeurige volgorde, uitgeschreven geteld. De keuzes die vast komen te liggen zodra mensen inloggen, worden vermeld met de reden, zodat niemand er pas later achter komt.

Bedrijfsaanmelding

De meeste organisaties willen dat mensen inloggen met de accounts die ze al hebben. Verbind uw identityprovider op de pagina voor zakelijk inloggen: via OIDC (OpenID Connect) bij Community, of via OIDC of SAML (Security Assertion Markup Language) bij Enterprise.

  1. Kies de provider en de standaard die deze gebruikt.
  2. Voer de applicatie-identiteit en het applicatiegeheim in die u van uw identityprovider hebt gekregen. Het geheim wordt nooit meer getoond nadat u het hebt opgeslagen.
  3. Geef aan wie mag inloggen, bijvoorbeeld iedereen met een @harrow.example-adres.
  4. Druk op Inloggen testen en log in als uzelf. Het resultaat vermeldt in woorden wie er heeft ingelogd en wat de provider heeft meegestuurd.
  5. Sla op.

Community krijgt één zakelijke inlogmethode voor de organisatie. Enterprise voegt afdwingen en directorysynchronisatie toe. Afdwingen schakelt wachtwoorden uit, zodat iedereen zakelijk inloggen moet gebruiken, en een wachtwoordpoging wordt geweigerd met SSO_REQUIRED en een knop naar de juiste inlogmethode. Directorysynchronisatie kopieert elke 15 minuten mensen en groepen uit uw directory, en kan beheerders maken van één opgegeven groep.

Wanneer zakelijk inloggen niet meer antwoordt, blijven mensen die al zijn ingelogd gewoon ingelogd, en wordt een nieuwe inlogpoging geweigerd met IDP_UNREACHABLE (503). Een beheerder kan dan de nood-inlogcode voor beheerders uit de kluis gebruiken, samen met de eigen passkey. Elk gebruik wordt weggeschreven naar het auditlogboek, gemeld aan elke beheerder, en eindigt na vier uur of wanneer zakelijk inloggen weer werkt.

Verbind uw identityprovider
Verbind uw identityprovider
Zakelijk inloggen met een test. De provider, de standaard in kleine letters, en een test-inlogpoging waarvan het resultaat in woorden wordt uitgeschreven voordat iemand ervan afhankelijk is.

Mensen uitnodigen

Zodra e-mail is ingesteld, nodigt u mensen uit vanaf de pagina Mensen. Geef voor elke persoon het e-mailadres en een rol op:

  • Lid gebruikt alles wat de organisatie heeft en wijzigt geen instellingen.
  • Beheerder beheert daarnaast mensen, modellen, budgetten en instellingen.

Een uitnodiging is 7 dagen geldig. De persoon opent deze, ziet wie de uitnodiging heeft verstuurd, wat de rol is en wat er zichtbaar zal zijn, en logt in. Bij de eerste keer inloggen wordt om een tweede controle gevraagd.

Uitgenodigde leden loggen in op de console en doen daar hun dagelijkse werk: Vandaag, de assistent, teamchat, bestanden en zoeken, notitieblokken, agents en workflows, voor zover hun rol dat toestaat. Beheerders zien ook de beheerpagina's. Een lid dat een beheerpagina opent, krijgt de pagina "Geen beheerder" te zien. Deze toont de instellingen als alleen-lezen, legt uit waarom, en biedt de mogelijkheid om het aan een beheerder te vragen.

Een collega uitnodigen
Een collega uitnodigen
Een uitnodiging bepaalt de rol van de persoon vóór binnenkomst, Lid of Beheerder, en kan een kort bericht bevatten.

Aanmeldingen vereisen goedkeuring

Mensen kunnen ook vragen om deel te nemen door zichzelf aan te melden. Op een installatie levert de aanmelding van een onbekende geen werkend account op. nexus-auth weigert deze met SIGNUP_REQUIRES_APPROVAL (403) en houdt deze vast voor goedkeuring door een beheerder.

Op de gehoste service van Adverant bestaan nog twee andere aanmeldingscontroles; deze staan op elke installatie uit en er is geen instelling om ze in te schakelen. De internet-CAPTCHA zou bij elke aanmelding internet vereisen. De netwerkcontrole bij aanmelding zou een gelicentieerde geolocatiedatabase vereisen die niet bij de installatie is inbegrepen. Goedkeuring vormt de poort van de installatie.

Nieuwe pogingen, verlopen codes en andere weigeringen

Elke weigering tijdens de eerste doorloop vermeldt wat er is gebeurd, dat er niets is gewijzigd wanneer dat het geval is, en wat u vervolgens moet doen.

Code Status Wanneer Wat te doen
CLAIM_CODE_EXPIRED 410 De 30 minuten zijn verstreken. Er is niets geclaimd en er is niets gewijzigd. Maak een nieuwe code aan met nexusctl claim-code --administrator <email> en druk vervolgens op Ik heb een nieuwe code.
CLAIM_FINGERPRINT_MISMATCH 403 De verzonden vingerafdruk is niet van deze installatie. Stop. Controleer het adres en het certificaat.
TRANSITION_NOT_PERMITTED 409 Een stap die al heeft plaatsgevonden, is opnieuw aangevraagd: de claim op een al geclaimde installatie, of een tweede keer de eerste beheerder. Log in bij de console; de eerste beheerder voegt alle anderen toe.
TRANSITION_NOT_PERMITTED 409 De passkey-stap, vanuit een browser waarin geen eerste beheerder klaarstaat, of nadat de tien minuten zijn verstreken. Zie hieronder.
RATE_LIMITED 429 Te veel pogingen binnen één minuut op de pagina's van de eerste doorloop. Er is niets verzonden. Wacht het aantal seconden dat de pagina aangeeft en probeer het daarna opnieuw.

Bij een code zonder resterende pogingen staat "Er zijn geen pogingen meer over voor deze code". Maak een nieuwe aan, net als bij een verlopen code. Alleen iemand met toegang tot het cluster kan dat doen, en dat is precies de bedoeling.

De pagina's van de eerste doorloop staan samen 20 pogingen per minuut toe. Als u die pogingen niet zelf hebt gedaan, probeert iemand anders op uw netwerk de pagina te gebruiken, en dat is goed om te weten.

Wanneer de passkey-stap is gemist

Als de eerste beheerder is aangemaakt maar er niet binnen tien minuten een passkey is aangemaakt, of als de browser is gesloten, bestaat de beheerder zonder een manier om in te loggen. De passkey-stap antwoordt dan TRANSITION_NOT_PERMITTED met de tekst "Als u de eerste beheerder meer dan tien minuten geleden in deze browser hebt aangemaakt, vraag dan een operator om hulp: de beheerder bestaat al en heeft nog geen passkey". De claim is op dat moment verbruikt, dus een nieuwe claimcode helpt niet. Vraag de operator die de installatie heeft uitgevoerd om hulp voordat u iets anders probeert.

Wanneer de browser de claim is kwijtgeraakt

De claim bevindt zich in de browser waarin deze is gedaan, in een cookie die de pagina niet kan lezen. Als die browser de claim kwijtraakt tussen het claimen en het aanmaken van de eerste beheerder, bijvoorbeeld in een privévenster dat is gesloten, accepteert het formulier voor de eerste beheerder ook het claimbestand en het bijbehorende installatiegeheim, handmatig geplakt.

Zodra Aoife haar passkey had, sloot Tomás zijn terminal. De claimpagina was uitgeschakeld, de eerste beheerder bestond, en elke andere weg naar binnen liep nu via haar.