Log indBook en briefing

Kapitel 2.12

Første kørsel

Fra en uovertaget installation til medarbejdere i arbejde. Opret overtagelseskoden, overtag installationen i en browser, opret den første administrator med en adgangsnøgle, og tilslut derefter virksomhedslogin og inviter alle andre.

Denne side er oversat af AI fra den engelske original. Hvis noget er uklart, er den engelske side gældende. Læs denne side på engelsk

18 minutters læsetid

Når en installation er færdig, tilhører installationen ingen. Den har ingen organisation, ingen person og ingen session, og ingen kan logge ind. Den venter på, at én person i en browser beviser, at vedkommende taler med den installation, der netop er blevet oprettet. Hos Harrow Port Authority var den person Aoife Brennan, IT-chef, med Tomás Reilly ved sin side ved terminalen. Dette kapitel følger deres første tyve minutter.

Rækkefølgen ligger fast, og hvert trin lukker det foregående for bestandigt: gør krav på installationen, opret den første administrator og organisationen, opsæt en adgangsnøgle, og land på siden I dag. Derefter følger de seks ting, der skal gøres klar, virksomhedslogin og invitation af alle andre, i den rækkefølge, der passer dig.

En kæde af bokse fra venstre mod højre: "nexusctl claim-code (terminal)", "Gør krav på denne installation (browser: kode + fingeraftryk)", "Den første administrator og organisationen", "Adgangsnøgle (andet tjek)", "I dag, når alt er nyt", "Seks ting før nogen logger ind", "Inviter personer". Under kravboksen går to røde grene nedad: "kode for gammel: CLAIM_CODE_EXPIRED, opret en ny kode" og "fingeraftryk afviger: CLAIM_FINGERPRINT_MISMATCH, stop". En tynd linje under de første tre bokse har teksten "hvert trin slår det foregående fra for bestandigt".
Den første kørsel, fra terminalen til den første I dag-side, og de to steder, hvor den kan stoppe.

Opret overtagelseskoden

Kravkoden beviser, at personen foran browseren også kan se terminalen hos en person med adgang til klyngen. Kun en sådan person kan oprette en. Kør dette der, hvor din kubeconfig når klyngen:

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

nexusctl claim-code beder installationens nøgletjeneste, nexus-keys, om at oprette koden. Uden nexusctl kører den samme kommando i nøgletjenestens egen pod:

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

--source er et par ord, der fortæller, hvem der har oprettet koden. Kravsiden viser dem under "Oprettet af", så den person, der gør krav på installationen, ved, hvor koden kom fra.

 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

Tre ting ved koden er vigtige.

  • Den varer 30 minutter. En kode, der er set over skulderen på nogen, er hurtigt ubrugelig.
  • Den tillader 5 forsøg. Efter det femte forkerte forsøg er den opbrugt, uanset tiden.
  • Den er til én person. Den e-mail, du angiver, tilhører den første administrator. Den følger med kravet, og den første administrators formular viser den som låst, så den ikke skal indtastes igen.

Fingeraftrykket består af otte grupper på fire tegn, som er installationens egen identitet. Lad det blive på skærmen. Du skal sammenligne det, gruppe for gruppe, i browseren.

Overtag installationen

  1. På den computer, du vil bruge som den første administrator, skal du åbne konsollens installationsadresse, her https://console.harrow.example/install. Den sender dig til den rette side for installationens tilstand: kravsiden, mens den er åben, den første administrators side, når der er gjort krav på den, og konsollen, hvis du allerede er logget ind.
  2. På Gør krav på denne installation skal du indtaste koden i Gruppe et, Gruppe to og Gruppe tre, én gruppe på fire i hver.
  3. Sammenlign sidens Fingeraftryk for denne installation med terminalen, alle otte grupper, én ad gangen.
  4. Hvis hver gruppe stemmer overens, skal du sætte kryds i Alle otte grupper stemmer overens med det, min terminal viser.
  5. Tryk på Gør krav på denne installation, hvorefter siden bekræfter kravet og sender dig videre til den første administrator.
Overtag denne installation
Overtag denne installation
Kravsiden. Koden indtastes i tre grupper, det fulde fingeraftryk vises i otte grupper på fire til sammenligning med terminalen, og kortet til højre angiver, hvor koden kom fra, og hvor mange forsøg der er tilbage.

At gøre krav gør tre ting. Det gør denne browser til det eneste sted, hvor den første administrator kan oprettes. Det registrerer i revisionsloggen, hvem der gjorde krav på installationen, og hvornår. Og det slår kravsiden fra for bestandigt. Derefter svarer kravadressen, at der er gjort krav på installationen.

Hvis fingeraftrykket ikke stemmer overens, skal du stoppe

Et andet fingeraftryk betyder, at en anden installation svarer på denne adresse. Det kan være en forkert indtastet adresse, en forældet DNS-post (Domain Name System) eller en maskine, der er sat op til at opsnappe den første administrator. Hvis du gjorde krav på den, ville den pågældende maskine indeholde din organisation.

Gør ikke krav, og indtast ikke koden på den side. Luk siden, og kontrollér derefter to ting: at console.harrow.example peger på din ingress, og at det certifikat, browseren viser, er udstedt af den CA (certifikatmyndighed), du forventer. Din egen installation er uændret, og der er stadig ikke gjort krav på den.

Hvis der sendes et krav med et fingeraftryk, som ikke tilhører installationen, afviser nøgletjenesten det med CLAIM_FINGERPRINT_MISMATCH (403). Intet bliver gjort krav på. Siden viser derefter de to fingeraftryk side om side med de afvigende grupper markeret samt trinnene til at kontrollere adressen og certifikatet.

Fingeraftryk stemmer ikke overens
Fingeraftryk stemmer ikke overens
Den side, et uoverensstemmende fingeraftryk fører til. De afvigende grupper er markeret, og trinnene kontrollerer adressen og certifikatet, før noget andet indtastes.

Opret den første administrator og organisationen

Den efterfølgende side har overskriften "To korte formularer, så er du inde". Den første administrator kan tilføje alle andre, og næsten alt her kan ændres senere. To ting kan ikke, og siden markerer dem.

Felt Hvad der indtastes Kan det ændres senere?
Fulde navn Dit navn Ja
Arbejds-e-mail Den adresse, kravkoden blev oprettet til, vist og ikke indtastet igen Det er administratorens adresse
Rolle i Nexus Organisationsadministrator. Den første person er altid administrator. Vælges ikke her
Andet tjek Adgangsnøgle på denne bærbare computer Ja, der kan tilføjes flere
Navn (på organisationen) Harrow Port Authority Ja
Land Hvor organisationen er baseret Ja
Kort navn i adresser Dannet ud fra navnet, såsom harrow-port-authority Nej. Links og eksporter bruger det.
Hvor data opbevares Denne installation Nej. At ændre det senere kræver en ny installation.
Sprog og datoer Engelsk (UK), med dagens dato Ja
Tidszone Serverens tidszone Hver person ser klokkeslæt i sin egen

Det korte navn består af små bogstaver, cifre og bindestreger, op til 100 tegn, dannet ud fra organisationens navn med accenter fjernet. Se på det, før du trykker på noget. Det optræder i hvert link, folk deler, og hver eksport, de laver, så længe organisationen eksisterer.

Du angiver også en adgangskode på denne side. Den er aldrig nok i sig selv: En administrator logger aldrig ind med en adgangskode alene. Det andet tjek nedenfor er det, der logger dig ind.

Et nødlogin til administratorer oprettes samtidig. Det forsegles og udskrives én gang til pengeskabet. Det virker kun, når virksomhedslogin er nede, og hver brug registreres og meddeles til alle administratorer. Læg det i pengeskabet samme dag, du udskriver det.

Siden oplyser også, at Adverant ikke får at vide, hvem du er. Disse oplysninger forbliver på installationen. En licens angiver virksomhedens navn, aldrig personerne i den.

Tryk på Opret og log ind. Det tager et par sekunder at oprette administratoren og organisationen. Siden svarer "Oprettet for aoife.brennan@harrow.example. Opsæt nu din adgangsnøgle: Det er sådan, du logger ind."

Den første administrator
Den første administrator
Den første administrator og organisationen på én side. De to valg, der aldrig kan ændres – det korte navn og hvor data opbevares – angiver dette ved siden af feltet, og nødloginnet er forseglet til pengeskabet.

Adgangsnøglen: den anden kontrol

  1. Tryk på Opsæt adgangsnøglen og log ind.
  2. Din browser beder dig om at oprette en adgangsnøgle. På en bærbar computer med Touch ID eller Windows Hello skal du bekræfte med din finger, dit ansigt eller din pinkode. Hvis computeren ikke selv kan oprette en adgangsnøgle, viser browseren en QR-kode (quick response): Ret din telefons kamera mod den, og følg anvisningerne på telefonen.
  3. Siden svarer "Din adgangsnøgle er sat op, og du er logget ind som aoife.brennan@harrow.example." og åbner konsollen.

Du har ti minutter fra Opret og log ind til at oprette adgangsnøglen i den samme browser. Derefter lukkes opsætningen, og administratoren eksisterer uden en adgangsnøgle. En operatør må hjælpe, som beskrevet under nye forsøg nedenfor.

Fremover logger den første administrator ind med den pågældende adgangsnøgle. En fuldgyldig administrators adgangskode, indtastet alene, skaber aldrig en session: Logintjenesten svarer med en anmodning om det andet tjek. Det er en egenskab ved designet og årsagen til, at adgangsnøglen er vigtig. En mistet adgangsnøgle er en mistet vej ind, så tilføj en ekstra på en telefon eller en sikkerhedsnøgle allerede den første dag.

Senere logger folk ind på installationen med en adgangsnøgle, med Google, med GitHub eller med deres virksomhedslogin, alt efter hvad organisationen tillader.

Kode Hvad det betyder Hvad du skal gøre
PASSKEY_UNSUPPORTED Denne browser kan ikke oprette en adgangsnøgle. Intet blev sat op. Åbn siden i en browser, der understøtter adgangsnøgler, på den samme computer.
PASSKEY_CANCELLED Dialogboksen blev lukket, eller der blev ikke valgt noget i tide. Intet blev sendt. Tryk på knappen igen.

Den første I dag-side

Konsollen åbner på I dag, og den første dag er næsten alt på den tomt. Hvert tomt område fortæller, hvad der vil blive vist der, og giver den knap, der starter det, så "Kræver en administrator" fortæller, at anmodninger vil vente der, når folk slutter sig til, med Inviter personer ved siden af. Tjeklisten for opsætning viser, hvor mange af dens trin der er udført, i vilkårlig rækkefølge. Den eneste reelle historik, selve opsætningen, findes allerede under "Hvad er ændret": installationen er sat op, og den første administrators adgangsnøgle er oprettet.

I dag, når alt er nyt
I dag, når alt er nyt
I dag på den første dag. Hvert tomt område fortæller, hvad der vil blive vist der, og hvordan man starter det, og "Hvad er ændret" indeholder allerede selve opsætningen.

Seks ting før nogen logger ind

Siden Seks ting før nogen logger ind viser, hvad der skal være opfyldt, før folk inviteres. Det er ikke en guide. Udfør dem i vilkårlig rækkefølge, og siden tæller dem ("Tre af seks opfyldt").

Ting Hvad der gør det opfyldt
Licens En Enterprise-licens importeret. Kapitel 2.13, Licenser. Community kræver ingen licens.
Adresse og certifikat Den offentlige adresse svarer med et certifikat, hvis kæde er komplet.
Sikkerhedskopier En tidsplan for sikkerhedskopiering er indstillet, med en destination, der kan skrives til.
Virksomhedslogin Tilsluttet og testet. Indtil da bruger folk adgangsnøgler.
Mail En mailserver er indstillet. Indtil da kan invitationer ikke sendes.
AI-model En AI-model (kunstig intelligens): en modelnøgle for organisationen eller en model på jeres egen hardware. Indtil da venter assistenten. Kapitel 2.14, AI-udbydere og -modeller.

Inviter personer åbner, når alle seks er opfyldt.

Den samme side viser, hvad der bliver låst, når folk logger ind, med årsagen til hver enkelt: det korte navn i adresser, hvor data opbevares, og nøgleforvalteren (nøgler kan flyttes fra en softwareforvalter til hardware, aldrig tilbage). Organisationens navn er også anført, fordi det er værd at kontrollere, selvom det kan ændres.

Nexus besvarer ikke nogens AI-anmodning, før organisationen har en model. Der er ingen delt nøgle bag en installation og ingen reserveløsning, så en organisation uden modelnøgle får en klar afvisning, der fortæller en administrator, hvad der skal tilføjes.

Seks ting før nogen logger ind
Seks ting før nogen logger ind
Seks tjek i vilkårlig rækkefølge, talt med ord. De valg, der bliver låst, når folk logger ind, er angivet med årsagen, så ingen opdager det senere.

Virksomhedslogin

De fleste organisationer ønsker, at folk logger ind med de konti, de allerede har. Tilslut jeres identitetsudbyder på siden for virksomhedslogin: over OIDC (OpenID Connect) på Community, eller over OIDC eller SAML (Security Assertion Markup Language) på Enterprise.

  1. Vælg udbyderen og den standard, den bruger.
  2. Indtast den applikationsidentitet og den applikationshemmelighed, som jeres identitetsudbyder har givet jer. Hemmeligheden vises aldrig igen, efter at du har gemt den.
  3. Angiv, hvem der må logge ind, for eksempel alle med en @harrow.example-adresse.
  4. Tryk på Test login, og log ind som dig selv. Resultatet fortæller med ord, hvem der loggede ind, og hvad udbyderen sendte.
  5. Gem.

Community får ét virksomhedslogin for organisationen. Enterprise tilføjer håndhævelse og katalogsynkronisering. Håndhævelse slår adgangskoder fra, så alle skal bruge virksomhedslogin, og et forsøg med adgangskode afvises med SSO_REQUIRED og en knap til den rigtige vej ind. Katalogsynkronisering kopierer personer og grupper fra jeres katalog hvert 15. minut og kan gøre personer fra én navngiven gruppe til administratorer.

Når virksomhedslogin holder op med at svare, forbliver personer, der allerede er logget ind, logget ind, og et nyt login afvises med IDP_UNREACHABLE (503). En administrator kan derefter bruge nødloginnet til administratorer fra pengeskabet sammen med sin adgangsnøgle. Hver brug skrives i revisionsloggen, meddeles til hver administrator og slutter efter fire timer, eller når virksomhedslogin vender tilbage.

Tilslut jeres identitetsudbyder
Tilslut jeres identitetsudbyder
Virksomhedslogin med en test. Udbyderen, standarden med småt og et testlogin, hvis resultat er skrevet med ord, før nogen er afhængige af det.

Inviter personer

Når mail er sat op, kan du invitere personer fra siden Personer. For hver person skal du angive vedkommendes e-mail og en rolle:

  • Medlem bruger alt, hvad organisationen har, og ændrer ingen indstillinger.
  • Administrator administrerer også personer, modeller, budgetter og indstillinger.

En invitation varer 7 dage. Personen åbner den, ser hvem der inviterede vedkommende, sin rolle og hvad vedkommende vil se, og logger ind. Der bedes om et andet tjek ved det første login.

Inviterede medlemmer logger ind på konsollen og udfører deres daglige arbejde der: I dag, assistenten, teamchat, filer og søgning, notesbøger, agenter og arbejdsgange, alt efter hvad deres rolle tillader. Administratorer ser også administrationssiderne. Et medlem, der åbner en administratorside, får siden "Ikke administrator". Den viser indstillingerne som skrivebeskyttede, forklarer hvorfor og tilbyder at spørge en administrator.

Inviter en kollega
Inviter en kollega
En invitation vælger personens rolle, før vedkommende ankommer, Medlem eller Administrator, og kan indeholde en kort besked.

Tilmeldinger kræver godkendelse

Folk kan også bede om at deltage ved selv at tilmelde sig. På en installation opretter en fremmeds tilmelding ikke en fungerende konto. nexus-auth afviser den med SIGNUP_REQUIRES_APPROVAL (403) og sætter den i bero til godkendelse hos en administrator.

To andre tilmeldingskontroller findes på Adverants hostede tjeneste og er slået fra på enhver installation, uden nogen værdi til at slå dem til. Internet-CAPTCHA'en ville kræve internet ved hver tilmelding. Netværksscreeningen ved tilmelding ville kræve en licenseret geolokationsdatabase, som installationen ikke indeholder. Godkendelse er installationens port.

Genforsøg, udløbne koder og andre afvisninger

Hver afvisning under den første kørsel fortæller, hvad der skete, at intet blev ændret, hvor det er tilfældet, og hvad man skal gøre derefter.

Kode Status Hvornår Hvad du skal gøre
CLAIM_CODE_EXPIRED 410 De 30 minutter er gået. Intet blev gjort krav på, og intet blev ændret. Opret en ny kode med nexusctl claim-code --administrator <email>, og tryk derefter på Jeg har en ny kode.
CLAIM_FINGERPRINT_MISMATCH 403 Det sendte fingeraftryk tilhører ikke denne installation. Stop. Kontrollér adressen og certifikatet.
TRANSITION_NOT_PERMITTED 409 Der blev igen bedt om et trin, der allerede har fundet sted: kravet på en installation, der allerede er gjort krav på, eller den første administrator for anden gang. Log ind i konsollen; den første administrator tilføjer alle andre.
TRANSITION_NOT_PERMITTED 409 Adgangsnøgletrinnet, fra en browser uden en ventende første administrator, eller efter de ti minutter. Se nedenfor.
RATE_LIMITED 429 For mange forsøg på siderne for den første kørsel på ét minut. Intet blev sendt. Vent det antal sekunder, siden angiver, og prøv derefter igen.

En kode uden flere forsøg tilbage viser teksten "Denne kode har ikke flere forsøg tilbage". Opret en ny, på samme måde som for en udløbet kode. Kun en person med adgang til klyngen kan gøre det, hvilket er hele pointen.

Siderne for den første kørsel modtager tilsammen 20 forsøg i minuttet. Hvis du ikke selv har foretaget disse forsøg, er der en anden på dit netværk, der forsøger at tilgå siden, og det er værd at vide.

Når adgangsnøgletrinnet blev forpasset

Hvis den første administrator blev oprettet, men der ikke blev oprettet nogen adgangsnøgle inden for ti minutter, eller browseren blev lukket, eksisterer administratoren uden nogen måde at logge ind på. Adgangsnøgletrinnet svarer TRANSITION_NOT_PERMITTED med ordene "Hvis du oprettede den første administrator i denne browser for over ti minutter siden, skal du bede en operatør om hjælp: Administratoren eksisterer og har endnu ingen adgangsnøgle". Kravet er opbrugt på det tidspunkt, så en ny kravkode vil ikke hjælpe. Spørg den operatør, der kørte installationen, før noget andet forsøges.

Når browseren mistede kravet

Kravet ligger i den browser, der foretog det, i en cookie, som siden ikke kan læse. Hvis den pågældende browser mister det mellem kravet og den første administrator, for eksempel i et privat vindue, der blev lukket, accepterer den første administrators formular også kravfilen og dens opsætningshemmelighed, indsat manuelt.

Da Aoife havde fået sin adgangsnøgle, lukkede Tomás sin terminal. Kravsiden var slået fra, den første administrator eksisterede, og enhver anden vej ind gik nu gennem hende.