Različica 1.0.0-alpha.1najnovejša
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

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.
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.examplenexusctl 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
- 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. - 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.
- Primerjajte Prstni odtis te namestitve (Fingerprint of this installation) na strani s terminalom, vseh osem skupin, eno za drugo.
- Č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).
- Pritisnite Prevzemi to namestitev, stran pa bo potrdila prevzem in vas napotila k prvemu skrbniku.
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.
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.«
Ključ (passkey): drugo preverjanje
- Pritisnite Nastavi potrdilo in prijavi se (Set up the passkey and sign in).
- 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.
- 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.
Š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.
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.
- Izberite ponudnika in standard, ki ga uporablja.
- Vnesite identiteto aplikacije in skrivnost aplikacije, ki vam ju je dal ponudnik identitete. Ko skrivnost shranite, se nikoli več ne prikaže.
- Določite, kdo se sme prijaviti, na primer vsakdo z naslovom
@harrow.example. - 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.
- 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.
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.
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.






