Prihlásiť saRezervovať brífing

Kapitola 2.12

Prvé spustenie

Od neprevzatej inštalácie k pracujúcim ľuďom. Vytvorte kód na prevzatie, prevezmite inštaláciu v prehliadači, vytvorte prvého správcu s prístupovým kľúčom (passkey), potom pripojte firemné prihlasovanie a pozvite všetkých ostatných.

Táto stránka bola preložená pomocou AI z anglického originálu. V prípade akýchkoľvek nejasností je rozhodujúca anglická verzia stránky. Prečítať túto stránku v angličtine

18 min čítania

Po dokončení inštalácie nepatrí inštalácia nikomu. Nemá žiadnu organizáciu, žiadnu osobu a žiadnu reláciu a nikto sa nemôže prihlásiť. Čaká na jednu osobu, ktorá v prehliadači dokáže, že komunikuje s inštaláciou, ktorá bola práve vytvorená. V Harrow Port Authority tou osobou bola Aoife Brennan, vedúca IT, pričom vedľa nej pri termináli bol Tomás Reilly. Táto kapitola sleduje ich prvých dvadsať minút.

Poradie je pevne dané a každý krok natrvalo uzatvára ten predchádzajúci: prevziať inštaláciu, vytvoriť prvého správcu a organizáciu, nastaviť prístupový kľúč (passkey) a dostať sa na stránku Dnes. Potom nasleduje šesť vecí, ktoré treba pripraviť, firemné prihlasovanie a pozvanie všetkých ostatných, v akomkoľvek poradí, ktoré vám vyhovuje.

Reťazec polí zľava doprava: „nexusctl claim-code (terminál)“, „Prevziať túto inštaláciu (prehliadač: kód + odtlačok)“, „Prvý správca a organizácia“, „Prístupový kľúč (druhé overenie)“, „Dnes, keď je všetko nové“, „Šesť vecí predtým, než sa niekto prihlási“, „Pozvať ľudí“. Pod poľom prevzatia smerujú nadol dve červené vetvy: „príliš starý kód: CLAIM_CODE_EXPIRED, vytvorte nový kód“ a „odtlačky sa líšia: CLAIM_FINGERPRINT_MISMATCH, zastavte sa“. Tenká čiara pod prvými tromi poľami má popis „každý krok natrvalo vypne ten predchádzajúci“.
Prvé spustenie, od terminálu po prvú stránku Dnes, a dve miesta, kde sa môže zastaviť.

Vytvorenie kódu na prevzatie

Kód na prevzatie dokazuje, že osoba pred prehliadačom vidí aj terminál niekoho s prístupom ku klastru. Vytvoriť ho môže len takáto osoba. Spustite toto tam, kde váš kubeconfig dosiahne na klaster:

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

nexusctl claim-code požiada kľúčovú službu inštalácie, nexus-keys, o vytvorenie kódu. Bez nexusctl beží ten istý príkaz vo vlastnom pode kľúčovej služby:

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

--source je niekoľko slov, ktoré hovoria, kto kód vytvoril. Stránka na prevzatie ich zobrazuje v časti „Vytvoril“, takže osoba, ktorá inštaláciu preberá, vie, odkiaľ kód pochádza.

 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 kóde sú dôležité tri veci.

  • Platí 30 minút. Kód zahliadnutý ponad niečie plece je čoskoro nepoužiteľný.
  • Umožňuje 5 pokusov. Po piatom nesprávnom pokuse je vyčerpaný, bez ohľadu na čas.
  • Je určený pre jednu osobu. E-mail, ktorý zadáte, patrí prvému správcovi. Putuje spolu s prevzatím a formulár prvého správcu ho zobrazí ako pevne daný, nezadáva sa znova.

Odtlačok pozostáva z ôsmich skupín po štyroch znakoch a predstavuje vlastnú identitu inštalácie. Nechajte ho na obrazovke. V prehliadači ho budete porovnávať skupinu po skupine.

Prevzatie inštalácie

  1. Na počítači, ktorý budete používať ako prvý správca, otvorte inštalačnú adresu konzoly, tu https://console.harrow.example/install. Presmeruje vás na správnu stránku podľa stavu inštalácie: na stránku prevzatia, kým je otvorená, na stránku prvého správcu po jej prevzatí a do konzoly, ak už ste prihlásení.
  2. Na stránke Prevziať túto inštaláciu zadajte kód do polí Skupina jedna, Skupina dva a Skupina tri, do každého jednu štvorznakovú skupinu.
  3. Porovnajte Odtlačok tejto inštalácie na stránke s terminálom, všetkých osem skupín, jednu po druhej.
  4. Ak sa každá skupina zhoduje, zaškrtnite Všetkých osem skupín sa zhoduje s tým, čo zobrazuje môj terminál.
  5. Stlačte Prevziať túto inštaláciu a stránka potvrdí prevzatie a presmeruje vás na prvého správcu.
Prevziať túto inštaláciu
Prevziať túto inštaláciu
Stránka prevzatia. Kód sa zadáva v troch skupinách, celý odtlačok sa zobrazuje v ôsmich skupinách po štyroch na porovnanie s terminálom a karta vpravo uvádza, odkiaľ kód pochádza a koľko pokusov zostáva.

Prevzatie vykoná tri veci. Urobí z tohto prehliadača jediné miesto, kde možno vytvoriť prvého správcu. Zaznamená do audítorského záznamu, kto a kedy inštaláciu prevzal. A natrvalo vypne stránku prevzatia. Od tej chvíle adresa prevzatia odpovedá, že inštalácia už bola prevzatá.

Ak sa odtlačok nezhoduje, zastavte sa

Odlišný odtlačok znamená, že na tejto adrese odpovedá iná inštalácia. Môže ísť o preklep v adrese, zastaraný záznam DNS (Domain Name System) alebo o stroj nastražený na zachytenie prvého správcu. Ak by ste ju prevzali, tento stroj by mal v rukách vašu organizáciu.

Nepreberajte inštaláciu a na tejto stránke kód nezadávajte. Zatvorte stránku a potom skontrolujte dve veci: či console.harrow.example smeruje na váš ingress a či certifikát, ktorý prehliadač zobrazuje, vydala CA (certifikačná autorita), ktorú očakávate. Vaša vlastná inštalácia je nezmenená a stále neprevzatá.

Ak sa odošle žiadosť o prevzatie s odtlačkom, ktorý nepatrí danej inštalácii, kľúčová služba ju odmietne s chybou CLAIM_FINGERPRINT_MISMATCH (403). Nič sa neprevezme. Stránka následne zobrazí oba odtlačky vedľa seba s vyznačenými odlišnými skupinami a kroky na kontrolu adresy a certifikátu.

Odtlačok sa nezhoduje
Odtlačok sa nezhoduje
Stránka, na ktorú vedie nezhodný odtlačok. Odlišné skupiny sú vyznačené a kroky preveria adresu a certifikát predtým, než sa zadá čokoľvek ďalšie.

Vytvorenie prvého správcu a organizácie

Nasledujúca stránka má nadpis „Dva krátke formuláre a ste dnu“. Prvý správca môže pridať všetkých ostatných a takmer všetko tu uvedené sa dá neskôr zmeniť. Dve veci sa zmeniť nedajú a stránka ich označuje.

Pole Čo sa zadáva Dá sa to neskôr zmeniť?
Celé meno Vaše meno Áno
Pracovný e-mail Adresa, pre ktorú bol vytvorený kód na prevzatie, zobrazená a nezadáva sa znova Je to adresa správcu
Rola v systéme Nexus Správca organizácie. Prvá osoba je vždy správcom. Tu sa nevyberá
Druhé overenie Prístupový kľúč (passkey) na tomto notebooku Áno, je možné pridať ďalšie
Názov (organizácie) Harrow Port Authority Áno
Krajina Kde organizácia sídli Áno
Krátky názov v adresách Vytvorený z názvu, napríklad harrow-port-authority Nie. Používajú ho odkazy a exporty.
Kde sú uložené údaje Táto inštalácia Nie. Zmeniť to neskôr znamená novú inštaláciu.
Jazyk a dátumy Angličtina (UK), s dnešným dátumom Áno
Časové pásmo Časové pásmo servera Každá osoba vidí časy vo svojom vlastnom

Krátky názov tvoria malé písmená, číslice a spojovníky, má najviac 100 znakov a vytvára sa z názvu organizácie po odstránení diakritiky. Pozrite sa naň predtým, než čokoľvek stlačíte. Objavuje sa v každom odkaze, ktorý ľudia zdieľajú, a v každom exporte, ktorý vytvoria, počas celej existencie organizácie.

Na tejto stránke si nastavíte aj heslo. Samo osebe nikdy nestačí: správca sa nikdy neprihlasuje iba heslom. To, čo vás prihlási, je druhé overenie uvedené nižšie.

Zároveň sa vytvorí núdzové prihlásenie správcu. Je zapečatené a vytlačí sa raz, do trezora. Funguje len vtedy, keď je firemné prihlasovanie nedostupné, a každé použitie sa zaznamená a oznámi všetkým správcom. Uložte ho do trezora v deň, keď ho vytlačíte.

Stránka tiež uvádza, že spoločnosti Adverant sa neoznamuje, kto ste. Tieto údaje zostávajú v inštalácii. Licencia uvádza názov spoločnosti, nikdy nie ľudí v nej.

Stlačte Vytvoriť a prihlásiť sa. Vytvorenie správcu a organizácie trvá niekoľko sekúnd. Stránka odpovie „Vytvorené pre aoife.brennan@harrow.example. Teraz si nastavte prístupový kľúč (passkey): pomocou neho sa prihlasujete.“

Prvý správca
Prvý správca
Prvý správca a organizácia na jednej stránke. Dve voľby, ktoré sa nikdy nedajú zmeniť – krátky názov a miesto uloženia údajov – to uvádzajú vedľa príslušného poľa a núdzové prihlásenie je zapečatené pre uloženie do trezora.

Prístupový kľúč (passkey): druhá kontrola

  1. Stlačte Nastaviť prístupový kľúč a prihlásiť sa.
  2. Váš prehliadač vás požiada o vytvorenie prístupového kľúča (passkey). Na notebooku s Touch ID alebo Windows Hello to potvrďte prstom, tvárou alebo kódom PIN. Ak počítač nedokáže vytvoriť prístupový kľúč sám, prehliadač zobrazí QR (quick response) kód: namierte naň fotoaparát telefónu a postupujte podľa pokynov v telefóne.
  3. Stránka odpovie „Váš prístupový kľúč je nastavený a ste prihlásení ako aoife.brennan@harrow.example.“ a otvorí konzolu.

Od stlačenia Vytvoriť a prihlásiť sa máte desať minút na vytvorenie prístupového kľúča v tom istom prehliadači. Potom sa nastavenie uzavrie a správca existuje bez prístupového kľúča. Pomôcť musí operátor, ako je opísané v časti o opakovaných pokusoch nižšie.

Od tejto chvíle sa prvý správca prihlasuje týmto prístupovým kľúčom. Heslo plnohodnotného správcu, zadané samostatne, nikdy nevytvorí reláciu: prihlasovacia služba odpovie žiadosťou o druhé overenie. Je to vlastnosť návrhu a dôvod, prečo na prístupovom kľúči záleží. Stratený prístupový kľúč znamená stratený prístup, preto si hneď v prvý deň pridajte druhý, v telefóne alebo na bezpečnostnom kľúči.

Neskôr sa ľudia do inštalácie prihlasujú pomocou prístupového kľúča, účtu Google, účtu GitHub alebo firemného prihlasovania, podľa toho, čo organizácia povoľuje.

Kód Čo to znamená Čo robiť
PASSKEY_UNSUPPORTED Tento prehliadač nedokáže vytvoriť prístupový kľúč. Nič nebolo nastavené. Otvorte stránku v prehliadači, ktorý podporuje prístupové kľúče, na tom istom počítači.
PASSKEY_CANCELLED Výzva bola zatvorená alebo sa nič nevybralo včas. Nič nebolo odoslané. Stlačte tlačidlo znova.

Prvá stránka Dnes (Today)

Konzola sa otvorí na stránke Dnes a v prvý deň je na nej takmer všetko prázdne. Každá prázdna oblasť uvádza, čo sa v nej zobrazí, a ponúka tlačidlo, ktorým to spustíte; takže „Vyžaduje správcu“ hovorí, že tam budú čakať žiadosti, keď sa pridajú ľudia, a vedľa je tlačidlo Pozvať ľudí. Kontrolný zoznam nastavenia uvádza, koľko krokov je hotových, v ľubovoľnom poradí. Jediná skutočná história, samotné nastavenie, sa už nachádza v časti „Čo sa zmenilo“: inštalácia bola nastavená a prístupový kľúč prvého správcu vytvorený.

Dnes, keď je všetko nové
Dnes, keď je všetko nové
Stránka Dnes v prvý deň. Každá prázdna oblasť hovorí, čo sa v nej zobrazí a ako to spustiť, a časť „Čo sa zmenilo“ už obsahuje samotné nastavenie.

Šesť krokov predtým, než sa ktokoľvek prihlási

Stránka Šesť vecí predtým, než sa niekto prihlási uvádza zoznam toho, čo musí platiť pred pozvaním ľudí. Nie je to sprievodca. Urobte ich v ľubovoľnom poradí a stránka ich spočíta („Splnené tri zo šiestich“).

Položka Čo zabezpečí jej splnenie
Licencia Naimportovaná licencia Enterprise. Kapitola 2.13, Licencie. Edícia Community nepotrebuje žiadnu licenciu.
Adresa a certifikát Verejná adresa odpovedá certifikátom, ktorého reťazec je úplný.
Zálohy Nastavený plán zálohovania s cieľovým umiestnením, do ktorého je možné zapisovať.
Firemné prihlasovanie Pripojené a otestované. Dovtedy ľudia používajú prístupové kľúče.
Pošta Nastavený poštový server. Dovtedy nie je možné odosielať pozvánky.
Model AI Model AI (umelej inteligencie): kľúč modelu organizácie alebo model na vašom vlastnom hardvéri. Dovtedy asistent čaká. Kapitola 2.14, Poskytovatelia a modely AI.

Možnosť Pozvať ľudí sa sprístupní, keď sú splnené všetky šesť.

Tá istá stránka uvádza, čo sa stane nemenným, keď sa ľudia prihlásia, spolu s dôvodom pre každú položku: krátky názov v adresách, miesto uloženia údajov a správca kľúčov (kľúče sa môžu presunúť zo softvérového správcu na hardvérový, nikdy nie späť). Uvedený je aj názov organizácie, pretože sa oplatí ho skontrolovať, hoci sa dá zmeniť.

Nexus neodpovie na žiadnu požiadavku týkajúcu sa AI, kým organizácia nemá model. Za inštaláciou nie je žiadny zdieľaný kľúč ani záložné riešenie, takže organizácia bez kľúča modelu dostane jasné odmietnutie, ktoré správcovi povie, čo treba pridať.

Šesť vecí predtým, než sa niekto prihlási
Šesť krokov predtým, než sa ktokoľvek prihlási
Šesť kontrol v ľubovoľnom poradí, vyjadrených slovami. Voľby, ktoré sa po prihlásení ľudí stanú nemennými, sú uvedené spolu s dôvodom, aby to nikto nezistil až neskôr.

Firemné prihlasovanie

Väčšina organizácií chce, aby sa ľudia prihlasovali účtami, ktoré už majú. Pripojte svojho poskytovateľa identity na stránke firemného prihlasovania: cez OIDC (OpenID Connect) v edícii Community, alebo cez OIDC či SAML (Security Assertion Markup Language) v edícii Enterprise.

  1. Vyberte poskytovateľa a štandard, ktorý používa.
  2. Zadajte identitu aplikácie a tajný kľúč aplikácie, ktoré vám dal váš poskytovateľ identity. Tajný kľúč sa po uložení už nikdy nezobrazí.
  3. Určite, kto sa môže prihlásiť, napríklad ktokoľvek s adresou @harrow.example.
  4. Stlačte Otestovať prihlásenie a prihláste sa pod svojím účtom. Výsledok slovne uvedie, kto sa prihlásil a čo poskytovateľ odoslal.
  5. Uložte.

Edícia Community poskytuje jedno firemné prihlasovanie pre organizáciu. Edícia Enterprise pridáva vynútenie a synchronizáciu adresára. Vynútenie vypne heslá, takže každý musí používať firemné prihlasovanie, a pokus o prihlásenie heslom je odmietnutý s chybou SSO_REQUIRED a tlačidlom na správny spôsob prihlásenia. Synchronizácia adresára kopíruje ľudí a skupiny z vášho adresára každých 15 minút a môže vytvoriť správcov z jednej určenej skupiny.

Keď firemné prihlasovanie prestane odpovedať, už prihlásení ľudia zostanú prihlásení a nové prihlásenie je odmietnuté s chybou IDP_UNREACHABLE (503). Správca potom môže použiť núdzové prihlásenie správcu z trezora spolu so svojím prístupovým kľúčom. Každé použitie sa zapíše do audítorského záznamu, oznámi sa každému správcovi a skončí sa po štyroch hodinách alebo po obnovení firemného prihlasovania.

Pripojte svojho poskytovateľa identity
Pripojte svojho poskytovateľa identity
Firemné prihlasovanie s testom. Poskytovateľ, štandard malým písmom a testovacie prihlásenie, ktorého výsledok je vypísaný slovami predtým, než sa naň ktokoľvek spoľahne.

Pozvanie používateľov

Keď je nastavená pošta, pozvite ľudí zo stránky Ľudia. Pri každom zadajte jeho e-mail a rolu:

  • Člen používa všetko, čo organizácia má, a nemení žiadne nastavenia.
  • Správca okrem toho spravuje ľudí, modely, rozpočty a nastavenia.

Pozvánka platí 7 dní. Osoba ju otvorí, uvidí, kto ju pozval, svoju rolu a čo uvidí, a prihlási sa. Pri prvom prihlásení sa vyžiada druhé overenie.

Pozvaní členovia sa prihlásia do konzoly a vykonávajú tam svoju každodennú prácu: Dnes, asistent, tímový čet, súbory a vyhľadávanie, zápisníky, agenti a pracovné postupy, podľa toho, čo im dovoľuje ich rola. Správcovia vidia aj stránky správy. Členovi, ktorý otvorí stránku správcu, sa zobrazí stránka „Nie ste správca“. Zobrazuje nastavenia len na čítanie, vysvetľuje prečo a ponúka možnosť požiadať správcu.

Pozvať kolegu
Pozvať kolegu
Pozvánka určuje rolu osoby ešte pred jej príchodom, Člen alebo Správca, a môže obsahovať krátku poznámku.

Registrácie vyžadujú schválenie

Ľudia môžu o pridanie požiadať aj tak, že sa sami zaregistrujú. V inštalácii registrácia cudzej osoby nevytvorí funkčný účet. Služba nexus-auth ju odmietne s chybou SIGNUP_REQUIRES_APPROVAL (403) a podrží ju na schválenie správcom.

V hostovanej službe spoločnosti Adverant existujú ešte dve ďalšie kontroly registrácie, ktoré sú v každej inštalácii vypnuté a neexistuje hodnota, ktorou by sa dali zapnúť. Internetová CAPTCHA by pri každej registrácii vyžadovala internet. Sieťová kontrola pri registrácii by vyžadovala licencovanú geolokačnú databázu, ktorú inštalácia neobsahuje. Vstupnou bránou inštalácie je schválenie.

Opakované pokusy, exspirované kódy a iné odmietnutia

Každé odmietnutie pri prvom spustení hovorí, čo sa stalo, že sa nič nezmenilo (ak je to pravda), a čo robiť ďalej.

Kód Stav Kedy Čo robiť
CLAIM_CODE_EXPIRED 410 Uplynulo 30 minút. Nič nebolo prevzaté a nič sa nezmenilo. Vytvorte nový kód pomocou nexusctl claim-code --administrator <email> a potom stlačte Mám nový kód.
CLAIM_FINGERPRINT_MISMATCH 403 Odoslaný odtlačok nepatrí tejto inštalácii. Zastavte sa. Skontrolujte adresu a certifikát.
TRANSITION_NOT_PERMITTED 409 Krok, ktorý už prebehol, bol vyžiadaný znova: prevzatie na už prevzatej inštalácii alebo vytvorenie prvého správcu po druhýkrát. Prihláste sa v konzole; prvý správca pridá všetkých ostatných.
TRANSITION_NOT_PERMITTED 409 Krok s prístupovým kľúčom z prehliadača, v ktorom nečaká žiadny prvý správca, alebo po uplynutí jeho desiatich minút. Pozrite nižšie.
RATE_LIMITED 429 Príliš veľa pokusov na stránkach prvého spustenia za minútu. Nič nebolo odoslané. Počkajte toľko sekúnd, koľko uvádza stránka, a potom to skúste znova.

Kód bez zostávajúcich pokusov zobrazí hlásenie „Pre tento kód nezostávajú žiadne pokusy“. Vytvorte nový, rovnako ako pri kóde s vypršanou platnosťou. Urobiť to môže len niekto s prístupom ku klastru, čo je aj zmyslom tohto opatrenia.

Stránky prvého spustenia spolu povolia 20 pokusov za minútu. Ak ste tieto pokusy nevykonali vy, stránku skúša niekto iný vo vašej sieti, a o tom sa oplatí vedieť.

Keď sa zmeškal krok s prístupovým kľúčom

Ak bol prvý správca vytvorený, ale do desiatich minút nebol vytvorený žiadny prístupový kľúč, alebo bol prehliadač zatvorený, správca existuje bez možnosti prihlásiť sa. Krok s prístupovým kľúčom odpovie chybou TRANSITION_NOT_PERMITTED so slovami „Ak ste v tomto prehliadači vytvorili prvého správcu pred viac ako desiatimi minútami, požiadajte operátora: správca existuje a zatiaľ nemá prístupový kľúč“. Prevzatie je v tom momente už vyčerpané, takže nový kód na prevzatie nepomôže. Predtým, než vyskúšate čokoľvek iné, požiadajte operátora, ktorý inštaláciu spustil.

Keď prehliadač stratil prevzatie

Prevzatie je uložené v prehliadači, ktorý ho vykonal, v súbore cookie, ktorý stránka nedokáže prečítať. Ak ho tento prehliadač medzi prevzatím a vytvorením prvého správcu stratí, napríklad v súkromnom okne, ktoré bolo zatvorené, formulár prvého správcu prijme aj súbor prevzatia a jeho tajný kľúč nastavenia, vložené ručne.

Keď mala Aoife svoj prístupový kľúč, Tomás zatvoril svoj terminál. Stránka prevzatia bola vypnutá, prvý správca existoval a každá ďalšia cesta dnu teraz viedla cez ňu.