PrijavaRezervirajte predstavitev

Poglavje 2.12

Prvi zagon

Od neprevzete namestitve do zaposlenih pri delu. Ustvarite kodo za prevzem, prevzemite namestitev v brskalniku, ustvarite prvega skrbnika s ključem (passkey), nato povežite podjetniško prijavo in povabite vse ostale.

To stran je iz angleškega izvirnika prevedla UI. Če je karkoli nejasno, je referenca angleška stran. Preberite to stran v angleščini

18 min branja

Ko se namestitev zaključi, ne pripada nikomur. Nima organizacije, osebe in seje, zato se nihče ne more prijaviti. Čaka na eno osebo, ki v brskalniku dokaže, da komunicira s pravkar ustvarjeno namestitvijo. Pri Harrow Port Authority je bila ta oseba Aoife Brennan, vodja IT, ob njej pa je bil za terminalom Tomás Reilly. To poglavje spremlja njunih prvih dvajset minut.

Vrstni red je določen in vsak korak dokončno zapre prejšnjega: prevzemite namestitev, ustvarite prvega skrbnika in organizacijo, nastavite potrdilo (passkey) in pristanite na strani Danes (Today). Nato sledi šest stvari, ki jih je treba pripraviti, prijava podjetja in vabljenje vseh ostalih, v vrstnem redu, ki vam ustreza.

Veriga polj od leve proti desni: »nexusctl claim-code (terminal)«, »Prevzemi to namestitev (brskalnik: koda + prstni odtis)«, »Prvi skrbnik in organizacija«, »Potrdilo (drugo preverjanje)«, »Danes, ko je vse novo«, »Šest stvari, preden se kdorkoli prijavi«, »Povabi ljudi«. Pod poljem za prevzem se spustita dve rdeči veji: »koda je prestara: CLAIM_CODE_EXPIRED, ustvarite novo kodo« in »prstna odtisa se razlikujeta: CLAIM_FINGERPRINT_MISMATCH, prenehajte«. Tanka črta pod prvimi tremi polji ima oznako »vsak korak dokončno izklopi prejšnjega«.
Prvi zagon, od terminala do prve strani Danes, in dve mesti, kjer se lahko ustavi.

Ustvarjanje kode za prevzem

Prevzemna koda dokazuje, da oseba pred brskalnikom vidi tudi terminal nekoga z dostopom do gruče (cluster). Samo takšna oseba jo lahko ustvari. Zaženite to tam, kjer vaš kubeconfig doseže gručo:

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

nexusctl claim-code zahteva od storitve ključev namestitve, nexus-keys, da ustvari kodo. Brez nexusctl se isti ukaz zažene v lastnem podu storitve ključev:

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

--source je nekaj besed, ki povedo, kdo je ustvaril kodo. Stran za prevzem jih prikaže pod »Ustvaril« (Made by), tako da oseba, ki prevzema, ve, od kod koda izvira.

 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

Pri kodi so pomembne tri stvari.

  • Velja 30 minut. Koda, ki jo nekdo vidi čez ramo, je kmalu neuporabna.
  • Omogoča 5 poskusov. Po petem napačnem poskusu je porabljena, ne glede na čas.
  • Namenjena je eni osebi. E-poštni naslov, ki ga navedete, pripada prvemu skrbniku. Potuje skupaj s prevzemom, obrazec prvega skrbnika pa ga prikaže kot nespremenljivega, zato ga ni treba znova vpisovati.

Prstni odtis je osem skupin po štiri znake, lastna identiteta namestitve. Pustite ga na zaslonu. V brskalniku ga boste primerjali skupino za skupino.

Prevzem namestitve

  1. V računalniku, ki ga boste uporabljali kot prvi skrbnik, odprite namestitveni naslov konzole, tukaj https://console.harrow.example/install. Preusmeril vas bo na pravo stran glede na stanje namestitve: na stran za prevzem, dokler je odprta, na stran prvega skrbnika, ko je prevzeta, in v konzolo, če ste že prijavljeni.
  2. V razdelku Prevzemi to namestitev (Claim this installation) vpišite kodo v polja Prva skupina (Group one), Druga skupina (Group two) in Tretja skupina (Group three), po eno skupino štirih znakov v vsako.
  3. Primerjajte Prstni odtis te namestitve (Fingerprint of this installation) na strani s terminalom, vseh osem skupin, eno za drugo.
  4. Če se vsaka skupina ujema, označite Vseh osem skupin se ujema s prikazom v mojem terminalu (All eight groups match what my terminal shows).
  5. Pritisnite Prevzemi to namestitev, stran pa bo potrdila prevzem in vas napotila k prvemu skrbniku.
Prevzemi to namestitev
Prevzemi to namestitev
Stran za prevzem. Koda se vnese v treh skupinah, celoten prstni odtis je prikazan v osmih skupinah po štiri znake za primerjavo s terminalom, kartica na desni pa pove, od kod koda izvira in koliko poskusov je še na voljo.

Prevzem naredi tri stvari. Ta brskalnik postane edino mesto, kjer je mogoče ustvariti prvega skrbnika. V revizijski dnevnik zabeleži, kdo in kdaj je prevzel namestitev. In dokončno izklopi stran za prevzem. Od takrat naprej naslov za prevzem odgovarja, da je bila namestitev že prevzeta.

Če se prstni odtis ne ujema, prenehajte

Drugačen prstni odtis pomeni, da na tem naslovu odgovarja druga namestitev. Lahko gre za napačno vtipkan naslov, zastarel zapis DNS (Domain Name System) ali napravo, nastavljeno za prestrezanje prvega skrbnika. Če bi jo prevzeli, bi ta naprava imela vašo organizacijo.

Ne prevzemite je in na tej strani ne vpisujte kode. Zaprite stran in nato preverite dve stvari: da se console.harrow.example razreši na vaš ingress in da je digitalno potrdilo, ki ga prikazuje brskalnik, izdal overitelj (CA – certificate authority), ki ga pričakujete. Vaša lastna namestitev je nespremenjena in še vedno neprevzeta.

Če je zahteva za prevzem poslana s prstnim odtisom, ki ne pripada namestitvi, jo storitev ključev zavrne s kodo CLAIM_FINGERPRINT_MISMATCH (403). Nič se ne prevzame. Stran nato prikaže oba prstna odtisa drugega ob drugem z označenimi skupinami, ki se razlikujejo, ter korake za preverjanje naslova in digitalnega potrdila.

Prstni odtis se ne ujema
Prstni odtis se ne ujema
Stran, na katero vodi neujemajoč se prstni odtis. Različne skupine so označene, koraki pa preverijo naslov in digitalno potrdilo, preden se vpiše karkoli drugega.

Ustvarjanje prvega skrbnika in organizacije

Stran, ki sledi, ima naslov »Dva kratka obrazca, nato ste vstopili« (Two short forms, then you are in). Prvi skrbnik lahko doda vse ostale in skoraj vse tukaj je mogoče pozneje spremeniti. Dveh stvari ni mogoče spremeniti in stran ju označi.

Polje Kaj se vnese Ali se lahko pozneje spremeni?
Polno ime Vaše ime Da
Službeni e-poštni naslov Naslov, za katerega je bila ustvarjena prevzemna koda; je prikazan in se ne vpisuje znova To je naslov skrbnika
Vloga v sistemu Nexus Skrbnik organizacije. Prva oseba je vedno skrbnik. Tukaj ni mogoče izbrati
Drugo preverjanje Potrdilo (passkey) na tem prenosniku Da, dodati jih je mogoče več
Ime (organizacije) Harrow Port Authority Da
Država Kjer ima organizacija sedež Da
Kratko ime v naslovih Ustvarjeno iz imena, na primer harrow-port-authority Ne. Uporabljajo ga povezave in izvozi.
Kje se hranijo podatki Ta namestitev Ne. Poznejša sprememba pomeni novo namestitev.
Jezik in datumi Angleščina (VB), z današnjim datumom Da
Časovni pas Časovni pas strežnika Vsaka oseba vidi čas v svojem pasu

Kratko ime je sestavljeno iz malih črk, števk in vezajev, dolgo do 100 znakov, ustvarjeno iz imena organizacije z odstranjenimi naglasnimi znamenji. Preglejte ga, preden karkoli pritisnete. Pojavlja se v vsaki povezavi, ki jo ljudje delijo, in v vsakem izvozu, ki ga naredijo, vse dokler organizacija obstaja.

Na tej strani nastavite tudi geslo. Samo po sebi nikoli ni dovolj: skrbnik se nikoli ne prijavi zgolj z geslom. Drugo preverjanje, opisano spodaj, je tisto, kar vas prijavi.

Hkrati se ustvari zasilna prijava skrbnika. Zapečati in natisne se enkrat, za v sef. Deluje le, ko prijava podjetja ne deluje, vsaka uporaba pa se zabeleži in sporoči vsem skrbnikom. Spravite jo v sef na dan, ko jo natisnete.

Na strani je navedeno tudi, da Adverant ni obveščen o tem, kdo ste. Ti podatki ostanejo na namestitvi. Licenca navaja ime podjetja, nikoli ljudi v njem.

Pritisnite Ustvari in prijavi se (Create and sign in). Ustvarjanje skrbnika in organizacije traja nekaj sekund. Stran odgovori »Ustvarjeno za aoife.brennan@harrow.example. Zdaj nastavite svoje potrdilo (passkey): z njim se prijavite.«

Prvi skrbnik
Prvi skrbnik
Prvi skrbnik in organizacija na eni strani. Dve izbiri, ki se nikoli ne moreta spremeniti – kratko ime in kje se hranijo podatki – imata to navedeno ob polju, zasilna prijava pa je zapečatena za v sef.

Ključ (passkey): drugo preverjanje

  1. Pritisnite Nastavi potrdilo in prijavi se (Set up the passkey and sign in).
  2. Brskalnik vas pozove, da ustvarite potrdilo (passkey). Na prenosniku s funkcijo Touch ID ali Windows Hello potrdite s prstnim odtisom, obrazom ali kodo PIN. Če računalnik sam ne more ustvariti potrdila, brskalnik prikaže kodo QR (quick response): vanjo usmerite kamero telefona in sledite navodilom na telefonu.
  3. Stran odgovori »Vaše potrdilo je nastavljeno in prijavljeni ste kot aoife.brennan@harrow.example.« ter odpre konzolo.

Od pritiska na Ustvari in prijavi se imate na voljo deset minut, da v istem brskalniku ustvarite potrdilo. Po tem se nastavitev zapre in skrbnik obstaja brez potrdila. Pomagati mora upravljavec, kot je opisano spodaj pod ponovnimi poskusi.

Od zdaj naprej se prvi skrbnik prijavlja s tem potrdilom. Geslo polnega skrbnika, vpisano samo po sebi, nikoli ne ustvari seje: prijavna storitev odgovori z zahtevo za drugo preverjanje. To je lastnost zasnove in razlog, zakaj je potrdilo pomembno. Izgubljeno potrdilo pomeni izgubljen vstop, zato že prvi dan dodajte drugega, na telefonu ali varnostnem ključu.

Pozneje se ljudje v namestitev prijavljajo s potrdilom, z računom Google, GitHub ali s prijavo svojega podjetja, odvisno od tega, kaj organizacija dovoljuje.

Koda Kaj pomeni Kaj storiti
PASSKEY_UNSUPPORTED Ta brskalnik ne more ustvariti potrdila. Nič ni bilo nastavljeno. Odprite stran v brskalniku, ki podpira ključe za dostop, v istem računalniku.
PASSKEY_CANCELLED Poziv je bil zaprt ali pa ni bilo nič izbrano pravočasno. Nič ni bilo poslano. Znova pritisnite gumb.

Prva stran Danes (Today)

Konzola se odpre na strani Danes (Today) in prvi dan je skoraj vse na njej prazno. Vsako prazno območje pove, kaj se bo tam pojavilo, in ponudi gumb za začetek, tako da razdelek »Potrebuje skrbnika« (Needs an administrator) pove, da bodo tam čakale zahteve, ko se ljudje pridružijo, poleg njega pa je gumb Povabi ljudi (Invite people). Kontrolni seznam nastavitve pove, koliko korakov je opravljenih, v poljubnem vrstnem redu. Edina prava zgodovina, sama nastavitev, je že pod »Kaj se je spremenilo« (What changed): namestitev je nastavljena in potrdilo prvega skrbnika je ustvarjeno.

Danes, ko je vse novo
Danes, ko je vse novo
Stran Danes na prvi dan. Vsako prazno območje pove, kaj se bo tam pojavilo in kako začeti, razdelek »Kaj se je spremenilo« pa že vsebuje samo nastavitev.

Šest korakov, preden se kdor koli prijavi

Stran Šest stvari, preden se kdorkoli prijavi (Six things before anyone signs in) navaja, kaj mora držati, preden povabite ljudi. To ni čarovnik. Opravite jih v poljubnem vrstnem redu, stran pa jih šteje (»Tri od šestih držijo«).

Stvar Kaj je potrebno, da drži
Licenca Uvožena licenca Enterprise. Poglavje 2.13, Licence. Izdaja Community ne potrebuje licence.
Naslov in digitalno potrdilo Javni naslov odgovarja z digitalnim potrdilom, katerega veriga je popolna.
Varnostne kopije Nastavljen urnik varnostnega kopiranja s ciljem, na katerega je mogoče pisati.
Prijava podjetja Povezana in preizkušena. Do takrat ljudje uporabljajo potrdila (passkeys).
Pošta Nastavljen poštni strežnik. Do takrat vabil ni mogoče pošiljati.
Model UI Model UI (umetna inteligenca): ključ modela organizacije ali model na vaši lastni strojni opremi. Do takrat pomočnik čaka. Poglavje 2.14, Ponudniki in modeli UI.

Možnost Povabi ljudi se odpre, ko drži vseh šest stvari.

Ista stran navaja, kaj postane nespremenljivo, ko se ljudje prijavijo, skupaj z razlogom za vsako postavko: kratko ime v naslovih, kje se hranijo podatki, in skrbnik ključev (ključi se lahko premaknejo iz programskega skrbnika na strojno opremo, nikoli pa nazaj). Navedeno je tudi ime organizacije, saj ga je vredno preveriti, čeprav se lahko spremeni.

Nexus ne bo odgovoril na nobeno zahtevo UI, dokler organizacija nima modela. V ozadju namestitve ni deljenega ključa in ni rezervne možnosti, zato organizacija brez ključa modela dobi preprosto zavrnitev, ki skrbniku pove, kaj mora dodati.

Šest stvari, preden se kdorkoli prijavi
Šest korakov, preden se kdor koli prijavi
Šest preverjanj v poljubnem vrstnem redu, preštetih z besedami. Izbire, ki postanejo nespremenljive, ko se ljudje prijavijo, so navedene skupaj z razlogom, da tega nihče ne ugotovi šele pozneje.

Podjetniška prijava

Večina organizacij želi, da se ljudje prijavijo z računi, ki jih že imajo. Povežite svojega ponudnika identitete na strani za prijavo podjetja: prek OIDC (OpenID Connect) v izdaji Community ali prek OIDC ali SAML (Security Assertion Markup Language) v izdaji Enterprise.

  1. Izberite ponudnika in standard, ki ga uporablja.
  2. Vnesite identiteto aplikacije in skrivnost aplikacije, ki vam ju je dal ponudnik identitete. Ko skrivnost shranite, se nikoli več ne prikaže.
  3. Določite, kdo se sme prijaviti, na primer vsakdo z naslovom @harrow.example.
  4. Pritisnite Preizkusi prijavo (Test sign-in) in se prijavite kot vi sami. Rezultat z besedami pove, kdo se je prijavil in kaj je poslal ponudnik.
  5. Shranite.

Izdaja Community dobi eno prijavo podjetja za organizacijo. Enterprise doda uveljavljanje in sinhronizacijo imenika. Uveljavljanje izklopi gesla, tako da morajo vsi uporabljati prijavo podjetja, poskus prijave z geslom pa se zavrne s kodo SSO_REQUIRED in gumbom za pravi način vstopa. Sinhronizacija imenika vsakih 15 minut kopira ljudi in skupine iz vašega imenika ter lahko ustvari skrbnike iz ene imenovane skupine.

Ko prijava podjetja preneha odgovarjati, že prijavljeni ljudje ostanejo prijavljeni, nova prijava pa se zavrne s kodo IDP_UNREACHABLE (503). Skrbnik lahko takrat uporabi zasilno prijavo skrbnika iz sefa, skupaj s svojim potrdilom (passkey). Vsaka uporaba se zapiše v revizijski dnevnik, sporoči vsakemu skrbniku in se konča po štirih urah ali ko se prijava podjetja vrne.

Povežite svojega ponudnika identitete
Povežite svojega ponudnika identitete
Prijava podjetja s preizkusom. Ponudnik, standard v drobnem tisku in preizkusna prijava, katere rezultat je zapisan z besedami, preden se kdorkoli zanese nanjo.

Povabilo uporabnikov

Ko je pošta nastavljena, povabite ljudi s strani Ljudje (People). Za vsakega navedite e-poštni naslov in vlogo:

  • Član (Member) uporablja vse, kar ima organizacija, in ne spreminja nobenih nastavitev.
  • Skrbnik (Administrator) upravlja tudi ljudi, modele, proračune in nastavitve.

Vabilo velja 7 dni. Oseba ga odpre, vidi, kdo jo je povabil, svojo vlogo in kaj bo videla, ter se prijavi. Ob prvi prijavi se zahteva drugo preverjanje.

Povabljeni člani se prijavijo v konzolo in tam opravljajo svoje vsakodnevno delo: Danes (Today), pomočnik, skupinski klepet, datoteke in iskanje, zvezki, agenti in delovni tokovi, kot jim dovoljuje njihova vloga. Skrbniki vidijo tudi skrbniške strani. Član, ki odpre skrbniško stran, dobi stran »Niste skrbnik« (Not an administrator). Ta prikazuje nastavitve samo za branje, pojasni zakaj in ponudi možnost, da vprašate skrbnika.

Povabi sodelavca
Povabi sodelavca
Vabilo določi vlogo osebe, preden ta prispe – Član ali Skrbnik – in lahko vsebuje kratko sporočilo.

Registracije potrebujejo odobritev

Ljudje lahko zaprosijo za pridružitev tudi tako, da se sami registrirajo. Na namestitvi registracija tujca ne ustvari delujočega računa. Storitev nexus-auth jo zavrne s kodo SIGNUP_REQUIRES_APPROVAL (403) in jo zadrži v čakanju na odobritev skrbnika.

V gostovani storitvi Adverant obstajata še dve drugi kontroli registracije, ki sta na vsaki namestitvi izklopljeni, pri čemer ni nobene vrednosti, s katero bi ju bilo mogoče vklopiti. Internetni CAPTCHA bi pri vsaki registraciji potreboval internet. Omrežno preverjanje registracije bi potrebovalo licencirano geolokacijsko podatkovno zbirko, ki je namestitev nima. Odobritev je vratar namestitve.

Ponovni poskusi, potekle kode in druge zavrnitve

Vsaka zavrnitev v prvem zagonu pove, kaj se je zgodilo, da se ni nič spremenilo (kjer to drži), in kaj storiti naprej.

Koda Stanje Kdaj Kaj storiti
CLAIM_CODE_EXPIRED 410 30 minut je minilo. Nič ni bilo prevzeto in nič se ni spremenilo. Ustvarite novo kodo z ukazom nexusctl claim-code --administrator <email>, nato pritisnite Imam novo kodo (I have a new code).
CLAIM_FINGERPRINT_MISMATCH 403 Poslani prstni odtis ne pripada tej namestitvi. Prenehajte. Preverite naslov in digitalno potrdilo.
TRANSITION_NOT_PERMITTED 409 Znova je bil zahtevan korak, ki se je že zgodil: prevzem že prevzete namestitve ali ustvarjanje prvega skrbnika drugič. Prijavite se v konzoli; prvi skrbnik doda vse ostale.
TRANSITION_NOT_PERMITTED 409 Korak s potrdilom (passkey) iz brskalnika, kjer ne čaka noben prvi skrbnik, ali po preteku njegovih desetih minut. Glejte spodaj.
RATE_LIMITED 429 Preveč poskusov na straneh prvega zagona v eni minuti. Nič ni bilo poslano. Počakajte toliko sekund, kolikor jih navaja stran, nato poskusite znova.

Pri kodi brez preostalih poskusov se izpiše »Ta koda nima več poskusov« (This code has no tries left). Ustvarite novo, enako kot pri potekli kodi. To lahko stori samo nekdo z dostopom do gruče, kar je tudi namen.

Strani prvega zagona skupaj sprejmejo 20 poskusov na minuto. Če teh poskusov niste naredili vi, stran preizkuša nekdo drug v vašem omrežju, kar je dobro vedeti.

Ko je bil korak s potrdilom zamujen

Če je bil prvi skrbnik ustvarjen, vendar v desetih minutah ni bilo ustvarjeno nobeno potrdilo (passkey), ali pa je bil brskalnik zaprt, skrbnik obstaja brez možnosti prijave. Korak s potrdilom odgovori s kodo TRANSITION_NOT_PERMITTED in besedami »Če ste v tem brskalniku ustvarili prvega skrbnika pred več kot desetimi minutami, prosite upravljavca: skrbnik obstaja in še nima potrdila«. Prevzem je na tej točki porabljen, zato nova prevzemna koda ne bo pomagala. Preden poskusite karkoli drugega, se obrnite na upravljavca, ki je zagnal namestitev.

Ko je brskalnik izgubil prevzem

Prevzem živi v brskalniku, ki ga je opravil, v piškotku, ki ga stran ne more prebrati. Če ga ta brskalnik izgubi med prevzemom in ustvarjanjem prvega skrbnika, na primer v zasebnem oknu, ki je bilo zaprto, obrazec prvega skrbnika sprejme tudi datoteko prevzema in njeno namestitveno skrivnost, prilepljeno ročno.

Ko je Aoife imela svoje potrdilo, je Tomás zaprl svoj terminal. Stran za prevzem je bila izklopljena, prvi skrbnik je obstajal in vsaka druga pot vstopa je zdaj potekala prek nje.