Logg innBestill en gjennomgang

Kapittel 2.12

Første oppstart

Fra en uregistrert installasjon til ansatte i arbeid. Lag kravkoden, gjør krav på installasjonen i en nettleser, opprett den første administratoren med en passnøkkel, koble deretter til bedriftspålogging og inviter alle andre.

Denne siden er oversatt med KI fra den engelske originalen. Hvis noe er uklart, er den engelske siden referansen. Les denne siden på engelsk

18 minutter å lese

Når en installasjon er fullført, tilhører installasjonen ingen. Den har ingen organisasjon, ingen person og ingen økt, og ingen kan logge inn. Den venter på at én person skal bevise, i en nettleser, at vedkommende snakker med den installasjonen som nettopp ble opprettet. Hos Harrow Port Authority var denne personen Aoife Brennan, IT-sjef, med Tomás Reilly ved siden av seg ved terminalen. Dette kapittelet følger deres første tjue minutter.

Rekkefølgen er fast, og hvert trinn lukker det foregående for godt: gjør krav på installasjonen, opprett den første administratoren og organisasjonen, konfigurer en passnøkkel og land på I dag-siden. Etter det følger de seks tingene som må gjøres klare, bedriftsinnlogging og å invitere alle andre, i den rekkefølgen som passer deg.

En kjede av bokser fra venstre mot høyre: «nexusctl claim-code (terminal)», «Gjør krav på denne installasjonen (nettleser: kode + fingeravtrykk)», «Den første administratoren og organisasjonen», «Passnøkkel (andre kontroll)», «I dag, når alt er nytt», «Seks ting før noen logger inn», «Inviter folk». Under kravboksen går to røde grener nedover: «kode for gammel: CLAIM_CODE_EXPIRED, lag en ny kode» og «fingeravtrykk avviker: CLAIM_FINGERPRINT_MISMATCH, stopp». En tynn linje under de tre første boksene har påskriften «hvert trinn slår det foregående av for godt».
Den første kjøringen, fra terminalen til den første I dag-siden, og de to stedene den kan stoppe.

Lag kravkoden

Kravkoden beviser at personen foran nettleseren også kan se terminalen til noen med tilgang til klyngen. Bare en slik person kan opprette en. Kjør dette der din kubeconfig når klyngen:

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

nexusctl claim-code ber installasjonens nøkkeltjeneste, nexus-keys, om å opprette koden. Uten nexusctl kjører den samme kommandoen i nøkkeltjenestens 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 noen få ord som sier hvem som opprettet koden. Kravsiden viser dem under «Opprettet av», slik at personen som gjør krav på installasjonen, vet 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 viktige.

  • Den varer i 30 minutter. En kode som blir sett over skulderen til noen, er snart ubrukelig.
  • Den tillater 5 forsøk. Etter det femte feilaktige forsøket er den brukt opp, uansett tid.
  • Den gjelder for én person. E-postadressen du oppgir, tilhører den første administratoren. Den følger med kravet, og skjemaet for den første administratoren viser den som fastsatt, slik at den ikke skrives inn på nytt.

Fingeravtrykket består av åtte grupper på fire tegn, installasjonens egen identitet. La det stå på skjermen. Du skal sammenligne det, gruppe for gruppe, i nettleseren.

Gjør krav på installasjonen

  1. På datamaskinen du skal bruke som den første administratoren, åpner du konsollens installasjonsadresse, her https://console.harrow.example/install. Den sender deg til riktig side for installasjonens tilstand: kravsiden mens den er åpen, siden for den første administratoren når det er gjort krav på den, og konsollen hvis du allerede er logget inn.
  2. På Gjør krav på denne installasjonen skriver du inn koden i Gruppe én, Gruppe to og Gruppe tre, én gruppe på fire i hver.
  3. Sammenlign sidens Fingeravtrykk for denne installasjonen med terminalen, alle åtte gruppene, én om gangen.
  4. Hvis hver gruppe stemmer overens, krysser du av for Alle åtte grupper stemmer med det terminalen min viser.
  5. Trykk på Gjør krav på denne installasjonen, så bekrefter siden kravet og sender deg videre til den første administratoren.
Gjør krav på denne installasjonen
Gjør krav på denne installasjonen
Kravsiden. Koden fylles inn i tre grupper, hele fingeravtrykket vises i åtte grupper på fire for å sammenlignes med terminalen, og kortet til høyre sier hvor koden kom fra og hvor mange forsøk som gjenstår.

Å gjøre krav på installasjonen gjør tre ting. Det gjør denne nettleseren til det eneste stedet den første administratoren kan opprettes. Det registrerer hvem som gjorde krav på installasjonen, og når, i revisjonsloggen. Og det slår av kravsiden for godt. Fra da av svarer kravadressen at det er gjort krav på installasjonen.

Hvis fingeravtrykket ikke stemmer, stopp

Et annet fingeravtrykk betyr at en annen installasjon svarer på denne adressen. Det kan være en feilskrevet adresse, en utdatert DNS-oppføring (Domain Name System), eller en maskin som er satt opp for å fange opp den første administratoren. Hvis du gjorde krav på den, ville den maskinen hatt organisasjonen din.

Ikke gjør krav på den, og ikke skriv inn koden på den siden. Lukk siden, og sjekk deretter to ting: at console.harrow.example slår opp til din ingress, og at sertifikatet nettleseren viser, er utstedt av den CA-en (sertifikatautoriteten) du forventer. Din egen installasjon er uendret og fortsatt uten eier.

Hvis et krav sendes med et fingeravtrykk som ikke tilhører installasjonen, avviser nøkkeltjenesten det med CLAIM_FINGERPRINT_MISMATCH (403). Ingenting blir gjort krav på. Siden viser deretter de to fingeravtrykkene side om side der gruppene som avviker er markert, samt trinnene for å sjekke adressen og sertifikatet.

Fingeravtrykket stemmer ikke
Fingeravtrykket stemmer ikke
Siden et avvikende fingeravtrykk fører til. De avvikende gruppene er markert, og trinnene sjekker adressen og sertifikatet før noe annet skrives inn.

Opprett den første administratoren og organisasjonen

Siden som følger har overskriften «To korte skjemaer, så er du inne». Den første administratoren kan legge til alle andre, og nesten alt her kan endres senere. To ting kan ikke endres, og siden markerer dem.

Felt Hva som fylles inn Kan det endres senere?
Fullt navn Ditt navn Ja
Jobb-e-post Adressen kravkoden ble laget for, vises og skrives ikke inn på nytt Det er administratorens adresse
Rolle i Nexus Organisasjonsadministrator. Den første personen er alltid en administrator. Velges ikke her
Andre kontroll Passnøkkel på denne bærbare datamaskinen Ja, flere kan legges til
Navn (på organisasjonen) Harrow Port Authority Ja
Land Hvor organisasjonen hører hjemme Ja
Kortnavn i adresser Laget ut fra navnet, for eksempel harrow-port-authority Nei. Lenker og eksporter bruker det.
Hvor data lagres Denne installasjonen Nei. Å endre det senere innebærer en ny installasjon.
Språk og datoer Engelsk (Storbritannia), med dagens dato Ja
Tidssone Serverens tidssone Hver person ser klokkeslett i sin egen

Kortnavnet består av små bokstaver, sifre og bindestreker, opptil 100 tegn, laget ut fra organisasjonens navn uten aksenter. Se nøye på det før du trykker på noe. Det vises i hver lenke folk deler og hver eksport de lager, så lenge organisasjonen eksisterer.

Du angir også et passord på denne siden. Det er aldri nok alene: en administrator logger aldri inn med bare et passord. Den andre kontrollen, nedenfor, er det som logger deg inn.

En nødinnlogging for administrator opprettes samtidig. Den forsegles og skrives ut én gang, for å legges i safen. Den fungerer bare når bedriftsinnloggingen er nede, og hver bruk registreres og varsles til alle administratorer. Legg den i safen samme dag som du skriver den ut.

Siden opplyser også om at Adverant ikke får vite hvem du er. Disse opplysningene blir værende på installasjonen. En lisens navngir selskapet, aldri personene i det.

Trykk på Opprett og logg inn. Det tar noen sekunder å opprette administratoren og organisasjonen. Siden svarer «Opprettet for aoife.brennan@harrow.example. Konfigurer nå passnøkkelen din: det er slik du logger inn.»

Den første administratoren
Den første administratoren
Den første administratoren og organisasjonen på én side. De to valgene som aldri kan endres, kortnavnet og hvor data lagres, opplyser om dette ved siden av feltet, og nødinnloggingen er forseglet for safen.

Passnøkkelen: den andre kontrollen

  1. Trykk på Konfigurer passnøkkelen og logg inn.
  2. Nettleseren ber deg om å opprette en passnøkkel. På en bærbar datamaskin med Touch ID eller Windows Hello bekrefter du med fingeren, ansiktet eller PIN-koden. Hvis datamaskinen ikke kan opprette en passnøkkel selv, viser nettleseren en QR-kode (quick response): rett telefonens kamera mot den og følg instruksjonene på telefonen.
  3. Siden svarer «Passnøkkelen din er konfigurert, og du er logget inn som aoife.brennan@harrow.example.» og åpner konsollen.

Du har ti minutter fra Opprett og logg inn til å opprette passnøkkelen, i samme nettleser. Etter det lukkes oppsettet, og administratoren eksisterer uten passnøkkel. En operatør må da hjelpe til, som beskrevet under nye forsøk nedenfor.

Fra nå av logger den første administratoren inn med denne passnøkkelen. Passordet til en fullverdig administrator, skrevet inn alene, oppretter aldri en økt: innloggingstjenesten svarer med en forespørsel om den andre kontrollen. Dette er en egenskap ved designet, og grunnen til at passnøkkelen er viktig. En tapt passnøkkel er en tapt vei inn, så legg til en ekstra, på en telefon eller en sikkerhetsnøkkel, allerede første dag.

Senere logger folk inn på installasjonen med en passnøkkel, med Google, med GitHub eller med bedriftens innlogging, avhengig av hva organisasjonen tillater.

Kode Hva det betyr Hva du skal gjøre
PASSKEY_UNSUPPORTED Denne nettleseren kan ikke opprette en passnøkkel. Ingenting ble konfigurert. Åpne siden i en nettleser som støtter passnøkler, på samme datamaskin.
PASSKEY_CANCELLED Dialogboksen ble lukket, eller ingenting ble valgt i tide. Ingenting ble sendt. Trykk på knappen igjen.

Den første I dag-siden

Konsollen åpnes på I dag, og den første dagen er nesten alt der tomt. Hvert tomt område forteller hva som vil dukke opp der, og gir knappen som starter det, så «Trenger en administrator» sier at forespørsler vil vente der når folk blir med, med Inviter folk ved siden av. Sjekklisten for oppsett sier hvor mange av trinnene som er fullført, i vilkårlig rekkefølge. Den eneste faktiske historikken, selve oppsettet, ligger allerede under «Hva som er endret»: installasjonen er satt opp, og den første administratorens passnøkkel er opprettet.

I dag, når alt er nytt
I dag, når alt er nytt
I dag på den første dagen. Hvert tomt område sier hva som vil dukke opp der og hvordan du starter det, og «Hva som er endret» inneholder allerede selve oppsettet.

Seks ting før noen logger inn

Siden Seks ting før noen logger inn lister opp hva som må være på plass før folk inviteres. Det er ikke en veiviser. Gjør dem i hvilken som helst rekkefølge, så teller siden dem («Tre av seks oppfylt»).

Punkt Hva som gjør det oppfylt
Lisens En Enterprise-lisens er importert. Kapittel 2.13, Lisenser. Community trenger ingen lisens.
Adresse og sertifikat Den offentlige adressen svarer med et sertifikat som har en komplett kjede.
Sikkerhetskopier En tidsplan for sikkerhetskopiering er satt, med et mål det kan skrives til.
Bedriftsinnlogging Tilkoblet og testet. Inntil da bruker folk passnøkler.
E-post En e-postserver er satt opp. Inntil da kan ikke invitasjoner sendes.
KI-modell En KI-modell (kunstig intelligens): en modellnøkkel for organisasjonen, eller en modell på egen maskinvare. Inntil da venter assistenten. Kapittel 2.14, KI-leverandører og -modeller.

Inviter folk åpnes når alle seks er oppfylt.

Den samme siden lister opp hva som blir låst når folk logger inn, med begrunnelsen for hvert punkt: kortnavnet i adresser, hvor data lagres, og nøkkelforvalteren (nøkler kan flyttes fra en programvareforvalter til maskinvare, aldri tilbake). Organisasjonens navn er også oppført, fordi det er verdt å sjekke, selv om det kan endres.

Nexus vil ikke svare på noens KI-forespørsel før organisasjonen har en modell. Det finnes ingen delt nøkkel bak en installasjon og ingen reserveløsning, så en organisasjon uten modellnøkkel får en ren avvisning som forteller en administrator hva som må legges til.

Seks ting før noen logger inn
Seks ting før noen logger inn
Seks kontroller i vilkårlig rekkefølge, telt med ord. Valgene som blir låst når folk logger inn, er oppført med begrunnelse, slik at ingen oppdager det i etterkant.

Bedriftspålogging

De fleste organisasjoner ønsker at folk skal logge inn med kontoene de allerede har. Koble til identitetsleverandøren din på siden for bedriftsinnlogging: over OIDC (OpenID Connect) på Community, eller over OIDC eller SAML (Security Assertion Markup Language) på Enterprise.

  1. Velg leverandøren og standarden den bruker.
  2. Skriv inn applikasjonsidentiteten og applikasjonshemmeligheten du fikk fra identitetsleverandøren din. Hemmeligheten vises aldri igjen etter at du har lagret den.
  3. Angi hvem som kan logge inn, for eksempel alle med en @harrow.example-adresse.
  4. Trykk på Test innlogging og logg inn som deg selv. Resultatet forteller, med ord, hvem som logget inn og hva leverandøren sendte.
  5. Lagre.

Community får én bedriftsinnlogging for organisasjonen. Enterprise legger til håndheving og katalogsynkronisering. Håndheving slår av passord, slik at alle må bruke bedriftsinnlogging, og et passordforsøk avvises med SSO_REQUIRED og en knapp til riktig innloggingsmåte. Katalogsynkronisering kopierer personer og grupper fra katalogen din hvert 15. minutt, og kan gjøre medlemmer av én navngitt gruppe til administratorer.

Når bedriftsinnloggingen slutter å svare, forblir personer som allerede er logget inn, innlogget, og en ny innlogging avvises med IDP_UNREACHABLE (503). En administrator kan da bruke nødinnloggingen for administrator fra safen, sammen med passnøkkelen sin. Hver bruk skrives til revisjonsloggen, varsles til alle administratorer, og avsluttes etter fire timer eller når bedriftsinnloggingen er tilbake.

Koble til identitetsleverandøren din
Koble til identitetsleverandøren din
Bedriftsinnlogging med en test. Leverandøren, standarden med liten skrift, og en testinnlogging der resultatet skrives med ord før noen er avhengige av den.

Inviter personer

Når e-post er satt opp, kan du invitere folk fra Personer-siden. Oppgi e-postadresse og en rolle for hver enkelt:

  • Medlem bruker alt organisasjonen har og endrer ingen innstillinger.
  • Administrator administrerer også personer, modeller, budsjetter og innstillinger.

En invitasjon varer i 7 dager. Personen åpner den, ser hvem som inviterte vedkommende, rollen sin og hva de vil se, og logger inn. Det bes om en andre kontroll ved første innlogging.

Inviterte medlemmer logger inn i konsollen og gjør sitt daglige arbeid der: I dag, assistenten, gruppechat, filer og søk, notatbøker, agenter og arbeidsflyter, etter hva rollen deres tillater. Administratorer ser også administrasjonssidene. Et medlem som åpner en administratorside, får opp siden «Ikke en administrator». Den viser innstillingene som skrivebeskyttet, forklarer hvorfor, og tilbyr å spørre en administrator.

Inviter en kollega
Inviter en kollega
En invitasjon velger personens rolle før vedkommende kommer inn, Medlem eller Administrator, og kan inneholde en kort melding.

Registreringer krever godkjenning

Folk kan også be om å bli med ved å registrere seg selv. På en installasjon oppretter ikke en fremmed persons registrering en fungerende konto. nexus-auth avviser den med SIGNUP_REQUIRES_APPROVAL (403) og setter den på vent for godkjenning fra en administrator.

To andre registreringskontroller finnes på Adverants vertsbaserte tjeneste og er slått av på hver installasjon, uten noen verdi for å slå dem på. Internett-CAPTCHA-en ville kreve internettilgang ved hver registrering. Nettverkssjekken for registrering ville kreve en lisensiert geolokaliseringsdatabase som installasjonen ikke har med seg. Godkjenning er installasjonens portvakt.

Nye forsøk, utløpte koder og andre avvisninger

Hver avvisning under den første kjøringen forteller hva som skjedde, at ingenting ble endret der det stemmer, og hva du skal gjøre videre.

Kode Status Når Hva du skal gjøre
CLAIM_CODE_EXPIRED 410 De 30 minuttene har gått. Ingenting ble gjort krav på, og ingenting ble endret. Lag en ny kode med nexusctl claim-code --administrator <email>, og trykk deretter på Jeg har en ny kode.
CLAIM_FINGERPRINT_MISMATCH 403 Fingeravtrykket som ble sendt, tilhører ikke denne installasjonen. Stopp. Sjekk adressen og sertifikatet.
TRANSITION_NOT_PERMITTED 409 Et trinn som allerede er utført, ble forespurt på nytt: kravet på en installasjon det allerede er gjort krav på, eller den første administratoren for andre gang. Logg inn i konsollen; den første administratoren legger til alle andre.
TRANSITION_NOT_PERMITTED 409 Passnøkkeltrinnet, fra en nettleser uten en ventende første administrator, eller etter at de ti minuttene har gått. Se nedenfor.
RATE_LIMITED 429 For mange forsøk på sidene for første kjøring i løpet av ett minutt. Ingenting ble sendt. Vent det antallet sekunder siden oppgir, og prøv deretter på nytt.

En kode uten flere forsøk igjen viser meldingen «Denne koden har ingen forsøk igjen». Lag en ny, på samme måte som for en utløpt kode. Bare noen med tilgang til klyngen kan gjøre det, noe som er hele poenget.

Sidene for første kjøring tillater til sammen 20 forsøk i minuttet. Hvis det ikke var du som gjorde disse forsøkene, er det noen andre på nettverket ditt som prøver seg på siden, og det er verdt å vite.

Når passnøkkeltrinnet ble forbigått

Hvis den første administratoren ble opprettet, men ingen passnøkkel ble laget innen ti minutter, eller nettleseren ble lukket, eksisterer administratoren uten noen måte å logge inn på. Passnøkkeltrinnet svarer TRANSITION_NOT_PERMITTED med ordene «Hvis du opprettet den første administratoren i denne nettleseren for over ti minutter siden, kontakt en operatør: administratoren eksisterer og har ingen passnøkkel ennå». Kravet er brukt opp på dette tidspunktet, så en ny kravkode vil ikke hjelpe. Kontakt operatøren som kjørte installasjonen, før noe annet forsøkes.

Når nettleseren mistet kravet

Kravet lever i nettleseren som utførte det, i en informasjonskapsel siden ikke kan lese. Hvis den nettleseren mister det mellom kravet og opprettelsen av den første administratoren, for eksempel i et privat vindu som ble lukket, godtar skjemaet for den første administratoren også kravfilen og dens oppsettshemmelighet, limt inn manuelt.

Så snart Aoife hadde passnøkkelen sin, lukket Tomás terminalen sin. Kravsiden var slått av, den første administratoren eksisterte, og enhver annen vei inn gikk nå gjennom henne.