Logga inBoka en genomgång

Kapitel 2.12

Den första körningen

Från en oanspråkad installation till människor i arbete. Skapa anspråkskoden, gör anspråk på installationen i en webbläsare, skapa den första administratören med en nyckel (passkey), anslut sedan företagsinloggning och bjud in alla andra.

Denna sida har översatts av AI från det engelska originalet. Om något är oklart är den engelska sidan referensen. Läs denna sida på engelska

18 minuters läsning

När en installation är klar tillhör den ingen. Den har ingen organisation, ingen person och ingen session, och ingen kan logga in. Den väntar på att en person i en webbläsare ska bevisa att de talar med den installation som precis skapades. På Harrow Port Authority var den personen Aoife Brennan, IT-chef, med Tomás Reilly bredvid sig vid terminalen. Det här kapitlet följer deras första tjugo minuter.

Ordningen är fast, och varje steg stänger det föregående för gott: gör anspråk på installationen, skapa den första administratören och organisationen, konfigurera en passnyckel och landa på sidan Idag. Därefter följer de sex sakerna som ska förberedas, företagsinloggning och att bjuda in alla andra, i vilken ordning som än passar er.

En kedja av rutor från vänster till höger: ”nexusctl claim-code (terminal)”, ”Gör anspråk på denna installation (webbläsare: kod + fingeravtryck)”, ”Den första administratören och organisationen”, ”Passnyckel (andra kontroll)”, ”Idag, när allt är nytt”, ”Sex saker innan någon loggar in”, ”Bjud in personer”. Under anspråksrutan går två röda grenar nedåt: ”koden är för gammal: CLAIM_CODE_EXPIRED, skapa en ny kod” och ”fingeravtrycken skiljer sig åt: CLAIM_FINGERPRINT_MISMATCH, avbryt”. En tunn linje under de första tre rutorna är märkt ”varje steg stänger av det föregående för gott”.
Den första körningen, från terminalen till den första Idag-sidan, och de två ställen där den kan stanna.

Skapa anspråkskoden

Anspråkskoden bevisar att personen framför webbläsaren också kan se terminalen hos någon med åtkomst till klustret. Endast en sådan person kan skapa en kod. Kör detta där er kubeconfig når klustret:

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

nexusctl claim-code ber installationens nyckeltjänst, nexus-keys, att skapa koden. Utan nexusctl körs samma kommando i nyckeltjänstens egen podd:

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

--source är några ord som anger vem som skapade koden. Anspråkssidan visar dem under ”Skapad av”, så att personen som gör anspråk vet var koden kom ifrån.

 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 saker gällande koden är viktiga.

  • Den är giltig i 30 minuter. En kod som någon sett över axeln blir snart oanvändbar.
  • Den tillåter 5 försök. Efter det femte felaktiga försöket är den förbrukad, oavsett tid.
  • Den gäller för en person. E-postadressen ni anger tillhör den första administratören. Den följer med anspråket, och formuläret för den första administratören visar den som låst, så den behöver inte skrivas in igen.

Fingeravtrycket består av åtta grupper om fyra tecken och är installationens egen identitet. Lämna det på skärmen. Ni kommer att jämföra det, grupp för grupp, i webbläsaren.

Gör anspråk på installationen

  1. På den dator ni kommer att använda som första administratör öppnar ni konsolens installationsadress, här https://console.harrow.example/install. Den skickar er till rätt sida utifrån installationens tillstånd: anspråkssidan medan den är öppen, sidan för den första administratören när anspråk har gjorts, och konsolen om ni redan är inloggade.
  2. På Gör anspråk på denna installation skriver ni in koden i Grupp ett, Grupp två och Grupp tre, en grupp om fyra i varje.
  3. Jämför sidans Fingeravtryck för denna installation med terminalen, alla åtta grupperna, en i taget.
  4. Om varje grupp stämmer överens kryssar ni i Alla åtta grupper stämmer överens med vad min terminal visar.
  5. Tryck på Gör anspråk på denna installation, så bekräftar sidan anspråket och skickar er vidare till den första administratören.
Ta över denna installation
Ta över denna installation
Anspråkssidan. Koden matas in i tre grupper, hela fingeravtrycket visas i åtta grupper om fyra för att jämföras med terminalen, och kortet till höger anger var koden kom ifrån och hur många försök som återstår.

Att göra anspråk gör tre saker. Det gör denna webbläsare till den enda plats där den första administratören kan skapas. Det registrerar vem som gjorde anspråk på installationen, och när, i granskningsloggen. Och det stänger av anspråkssidan för gott. Från och med då svarar anspråksadressen att anspråk har gjorts på installationen.

Om fingeravtrycket inte stämmer överens, avbryt

Ett annat fingeravtryck betyder att en annan installation svarar på den här adressen. Det kan vara en felstavad adress, en inaktuell DNS-post (Domain Name System) eller en maskin som satts upp för att fånga upp den första administratören. Om ni gjorde anspråk på den skulle den maskinen inneha er organisation.

Gör inte anspråk och skriv inte in koden på den sidan. Stäng sidan och kontrollera sedan två saker: att console.harrow.example slår upp till er ingress, och att certifikatet som webbläsaren visar är utfärdat av den CA (certifikatutfärdare) ni förväntar er. Er egen installation är oförändrad och fortfarande utan anspråk.

Om ett anspråk skickas med ett fingeravtryck som inte tillhör installationen nekar nyckeltjänsten det med CLAIM_FINGERPRINT_MISMATCH (403). Inget anspråk görs. Sidan visar då de två fingeravtrycken sida vid sida med de avvikande grupperna markerade, samt stegen för att kontrollera adressen och certifikatet.

Fingeravtrycket stämmer inte överens
Fingeravtrycket stämmer inte överens
Sidan som ett felaktigt fingeravtryck leder till. De avvikande grupperna är markerade, och stegen kontrollerar adressen och certifikatet innan något annat skrivs in.

Skapa den första administratören och organisationen

Sidan som följer har rubriken ”Två korta formulär, sedan är du inne”. Den första administratören kan lägga till alla andra, och nästan allt här kan ändras senare. Två saker kan inte ändras, och sidan markerar dem.

Fält Vad som fylls i Kan det ändras senare?
Fullständigt namn Ert namn Ja
Arbets-e-post Adressen som anspråkskoden skapades för, visas och skrivs inte in igen Det är administratörens adress
Roll i Nexus Organisationsadministratör. Den första personen är alltid en administratör. Väljs inte här
Andra kontroll Passnyckel på den här bärbara datorn Ja, fler kan läggas till
Namn (på organisationen) Harrow Port Authority Ja
Land Där organisationen är baserad Ja
Kortnamn i adresser Skapas från namnet, såsom harrow-port-authority Nej. Länkar och exporter använder det.
Var data lagras Denna installation Nej. Att ändra det senare innebär en ny installation.
Språk och datum Engelska (Storbritannien), med dagens datum Ja
Tidszon Serverns tidszon Varje person ser tider i sin egen

Kortnamnet består av gemener, siffror och bindestreck, upp till 100 tecken, och skapas från organisationens namn utan accenter. Titta på det innan ni trycker på något. Det visas i varje länk som personer delar och i varje export de gör, så länge organisationen existerar.

Ni anger också ett lösenord på den här sidan. Det räcker aldrig på egen hand: en administratör loggar aldrig in med enbart ett lösenord. Den andra kontrollen, nedan, är det som loggar in er.

En nödinloggning för administratörer skapas samtidigt. Den förseglas och skrivs ut en gång, för kassaskåpet. Den fungerar endast när företagsinloggningen ligger nere, och varje användning registreras och meddelas alla administratörer. Lägg den i kassaskåpet samma dag som ni skriver ut den.

Sidan anger också att Adverant inte får veta vem ni är. Dessa uppgifter stannar på installationen. En licens namnger företaget, aldrig personerna i det.

Tryck på Skapa och logga in. Att skapa administratören och organisationen tar några sekunder. Sidan svarar ”Skapad för aoife.brennan@harrow.example. Konfigurera nu din passnyckel: det är så du loggar in.”

Den första administratören
Den första administratören
Den första administratören och organisationen på en sida. De två val som aldrig kan ändras, kortnamnet och var data lagras, anger detta bredvid fältet, och nödinloggningen är förseglad för kassaskåpet.

Nyckeln (passkey): den andra kontrollen

  1. Tryck på Konfigurera passnyckeln och logga in.
  2. Er webbläsare ber er att skapa en passnyckel. På en bärbar dator med Touch ID eller Windows Hello bekräftar ni med ert finger, ansikte eller PIN-kod. Om datorn inte kan skapa en passnyckel själv visar webbläsaren en QR-kod (quick response): rikta telefonens kamera mot den och följ instruktionerna på telefonen.
  3. Sidan svarar ”Din passnyckel är konfigurerad och du är inloggad som aoife.brennan@harrow.example.” och öppnar konsolen.

Ni har tio minuter på er från Skapa och logga in att skapa passnyckeln, i samma webbläsare. Därefter stängs konfigurationen, och administratören existerar utan passnyckel. En operatör måste då hjälpa till, enligt beskrivningen under nya försök nedan.

Från och med nu loggar den första administratören in med den passnyckeln. En fullständig administratörs lösenord, inskrivet på egen hand, skapar aldrig en session: inloggningstjänsten svarar med en begäran om den andra kontrollen. Det är en egenskap i designen och anledningen till att passnyckeln är viktig. En förlorad passnyckel är en förlorad väg in, så lägg till en andra, på en telefon eller en säkerhetsnyckel, redan första dagen.

Senare loggar personer in på installationen med en passnyckel, med Google, med GitHub eller med sin företagsinloggning, beroende på vad organisationen tillåter.

Kod Vad det innebär Vad du ska göra
PASSKEY_UNSUPPORTED Den här webbläsaren kan inte skapa en passnyckel. Ingenting konfigurerades. Öppna sidan i en webbläsare som stöder passnycklar, på samma dator.
PASSKEY_CANCELLED Dialogrutan stängdes, eller så valdes ingenting i tid. Ingenting skickades. Tryck på knappen igen.

Den första Idag-sidan

Konsolen öppnas på Idag, och den första dagen är nästan allt på den tomt. Varje tomt område anger vad som kommer att visas där och tillhandahåller knappen som startar det, så ”Behöver en administratör” anger att förfrågningar kommer att vänta där när personer ansluter sig, med Bjud in personer bredvid. Konfigurationschecklistan anger hur många av dess steg som är klara, i valfri ordning. Den enda faktiska historiken, själva konfigurationen, finns redan under ”Vad har ändrats”: installationen har konfigurerats och den första administratörens passnyckel har skapats.

Idag, när allt är nytt
Idag, när allt är nytt
Idag under den första dagen. Varje tomt område anger vad som kommer att visas där och hur man startar det, och ”Vad har ändrats” innehåller redan själva konfigurationen.

Sex saker innan någon loggar in

Sidan Sex saker innan någon loggar in listar vad som måste vara uppfyllt innan personer bjuds in. Det är ingen guide. Gör dem i valfri ordning, så räknar sidan dem (”Tre av sex uppfyllda”).

Sak Vad som gör det uppfyllt
Licens En Enterprise-licens har importerats. Kapitel 2.13, Licenser. Community behöver ingen licens.
Adress och certifikat Den publika adressen svarar med ett certifikat vars kedja är komplett.
Säkerhetskopior Ett schema för säkerhetskopiering har ställts in, med ett mål som det går att skriva till.
Företagsinloggning Ansluten och testad. Tills dess använder personer passnycklar.
E-post En e-postserver har ställts in. Tills dess kan inbjudningar inte skickas.
AI-modell En AI-modell (artificiell intelligens): en modellnyckel för organisationen, eller en modell på er egen hårdvara. Tills dess väntar assistenten. Kapitel 2.14, AI-leverantörer och modeller.

Bjud in personer öppnas när alla sex är uppfyllda.

Samma sida listar vad som blir låst när personer loggar in, med anledningen för var och en: kortnamnet i adresser, var data lagras och nyckelförvaltaren (nycklar kan flyttas från en mjukvaruförvaltare till hårdvara, aldrig tillbaka). Organisationens namn listas också eftersom det är värt att kontrollera, även om det kan ändras.

Nexus kommer inte att svara på någons AI-förfrågan förrän organisationen har en modell. Det finns ingen delad nyckel bakom en installation och ingen reservlösning, så en organisation utan modellnyckel får ett tydligt avslag som talar om för en administratör vad som behöver läggas till.

Sex saker innan någon loggar in
Sex saker innan någon loggar in
Sex kontroller i valfri ordning, räknade i ord. De val som blir låsta när personer loggar in listas med anledningen, så att ingen upptäcker det senare.

Företagsinloggning

De flesta organisationer vill att personer ska logga in med de konton de redan har. Anslut er identitetsleverantör på sidan för företagsinloggning: över OIDC (OpenID Connect) i Community, eller över OIDC eller SAML (Security Assertion Markup Language) i Enterprise.

  1. Välj leverantören och den standard som den använder.
  2. Ange applikationsidentiteten och applikationshemligheten som ni fått av er identitetsleverantör. Hemligheten visas aldrig igen efter att ni har sparat den.
  3. Ange vem som får logga in, till exempel alla med en @harrow.example-adress.
  4. Tryck på Testa inloggning och logga in som er själva. Resultatet anger, i ord, vem som loggade in och vad leverantören skickade.
  5. Spara.

Community får en företagsinloggning för organisationen. Enterprise lägger till tvingande krav och katalogsynkronisering. Tvingande krav stänger av lösenord så att alla måste använda företagsinloggning, och ett lösenordsförsök nekas med SSO_REQUIRED och en knapp till rätt inloggningsväg. Katalogsynkronisering kopierar personer och grupper från er katalog var 15:e minut och kan skapa administratörer från en namngiven grupp.

När företagsinloggningen slutar svara förblir personer som redan är inloggade inloggade, och en ny inloggning nekas med IDP_UNREACHABLE (503). En administratör kan då använda nödinloggningen för administratörer från kassaskåpet, tillsammans med sin passnyckel. Varje användning skrivs till granskningsloggen, meddelas varje administratör och avslutas efter fyra timmar eller när företagsinloggningen kommer tillbaka.

Anslut din identitetsleverantör
Anslut din identitetsleverantör
Företagsinloggning med ett test. Leverantören, standarden i liten stil och en testinloggning vars resultat skrivs ut i ord innan någon förlitar sig på den.

Bjud in personer

När e-posten är konfigurerad kan ni bjuda in personer från sidan Personer. Ange e-postadress och en roll för var och en:

  • Medlem använder allt som organisationen har och ändrar inga inställningar.
  • Administratör hanterar även personer, modeller, budgetar och inställningar.

En inbjudan är giltig i 7 dagar. Personen öppnar den, ser vem som bjöd in dem, sin roll och vad de kommer att se, och loggar in. En andra kontroll efterfrågas vid deras första inloggning.

Inbjudna medlemmar loggar in i konsolen och utför sitt dagliga arbete där: Idag, assistenten, teamchatt, filer och sökning, anteckningsböcker, agenter och arbetsflöden, i den mån deras roll tillåter det. Administratörer ser även administrationssidorna. En medlem som öppnar en administratörssida får sidan ”Inte en administratör”. Den visar inställningarna som skrivskyddade, anger varför och erbjuder möjligheten att fråga en administratör.

Bjud in en kollega
Bjud in en kollega
En inbjudan väljer personens roll innan de anländer, Medlem eller Administratör, och kan innehålla ett kort meddelande.

Registreringar kräver godkännande

Personer kan också be om att få gå med genom att registrera sig själva. På en installation skapar en främlings registrering inte ett fungerande konto. nexus-auth nekar den med SIGNUP_REQUIRES_APPROVAL (403) och håller den i väntan på en administratörs godkännande.

Två andra registreringskontroller finns på Adverants värdtjänst och är avstängda på varje installation, utan något värde för att slå på dem. Internet-CAPTCHA skulle kräva internet vid varje registrering. Nätverkskontrollen vid registrering skulle kräva en licensierad geolokaliseringsdatabas som installationen inte innehåller. Godkännande är installationens spärr.

Omförsök, utgångna koder och andra avvisningar

Varje avslag under den första körningen anger vad som hände, att ingenting ändrades när så är fallet, och vad man ska göra härnäst.

Kod Status När Vad du ska göra
CLAIM_CODE_EXPIRED 410 De 30 minuterna har passerat. Inget anspråk gjordes och ingenting ändrades. Skapa en ny kod med nexusctl claim-code --administrator <email> och tryck sedan på Jag har en ny kod.
CLAIM_FINGERPRINT_MISMATCH 403 Det skickade fingeravtrycket tillhör inte denna installation. Avbryt. Kontrollera adressen och certifikatet.
TRANSITION_NOT_PERMITTED 409 Ett steg som redan har inträffat efterfrågades igen: anspråket på en installation som redan har ett anspråk, eller den första administratören en andra gång. Logga in i konsolen; den första administratören lägger till alla andra.
TRANSITION_NOT_PERMITTED 409 Passnyckelsteget, från en webbläsare utan någon väntande första administratör, eller efter dess tio minuter. Se nedan.
RATE_LIMITED 429 För många försök på sidorna för den första körningen under en minut. Ingenting skickades. Vänta det antal sekunder som sidan anger och försök sedan igen.

En kod utan kvarvarande försök visar ”Denna kod har inga försök kvar”. Skapa en ny, precis som för en utgången kod. Endast någon med åtkomst till klustret kan göra det, vilket är själva poängen.

Sidorna för den första körningen tillåter tillsammans 20 försök per minut. Om ni inte gjorde dessa försök är det någon annan på ert nätverk som provar sidan, och det är värt att veta.

När passnyckelsteget missades

Om den första administratören skapades men ingen passnyckel skapades inom tio minuter, eller om webbläsaren stängdes, existerar administratören utan något sätt att logga in. Passnyckelsteget svarar TRANSITION_NOT_PERMITTED med orden ”Om du skapade den första administratören i den här webbläsaren för över tio minuter sedan, be en operatör om hjälp: administratören existerar och har ingen passnyckel ännu”. Anspråket är vid det laget förbrukat, så en ny anspråkskod hjälper inte. Fråga operatören som körde installationen innan något annat provas.

När webbläsaren förlorade anspråket

Anspråket lever i den webbläsare som gjorde det, i en cookie som sidan inte kan läsa. Om den webbläsaren förlorar det mellan anspråket och den första administratören, till exempel i ett privat fönster som stängdes, accepterar formuläret för den första administratören även anspråksfilen och dess konfigurationshemlighet, inklistrade för hand.

När Aoife hade sin passnyckel stängde Tomás sin terminal. Anspråkssidan var avstängd, den första administratören existerade och varje annan väg in gick nu genom henne.