Přihlásit seDomluvit prezentaci

Kapitola 2.12

První spuštění

Od nepřevzaté instalace k pracujícím lidem. Vytvořte kód pro převzetí, převezměte instalaci v prohlížeči, vytvořte prvního administrátora s přístupovým klíčem (passkey), poté připojte firemní přihlašování a pozvěte všechny ostatní.

Tato stránka byla přeložena pomocí AI z anglického originálu. Pokud je cokoliv nejasné, směrodatná je anglická stránka. Přečíst tuto stránku v angličtině

18 min čtení

Když instalace skončí, nepatří nikomu. Nemá žádnou organizaci, žádnou osobu a žádnou relaci a nikdo se nemůže přihlásit. Čeká na jednu osobu, která v prohlížeči prokáže, že komunikuje s instalací, která byla právě vytvořena. V Harrow Port Authority tou osobou byla Aoife Brennan, vedoucí IT, a vedle ní u terminálu seděl Tomás Reilly. Tato kapitola sleduje jejich prvních dvacet minut.

Pořadí je pevně dané a každý krok natrvalo uzavře ten předchozí: převzít instalaci, vytvořit prvního správce a organizaci, nastavit přístupový klíč (passkey) a přejít na stránku Dnes. Poté následuje šest věcí, které je třeba připravit, firemní přihlašování a pozvání všech ostatních, v jakémkoli pořadí, které vám vyhovuje.

Řetězec políček zleva doprava: „nexusctl claim-code (terminál)“, „Převzít tuto instalaci (prohlížeč: kód + otisk)“, „První správce a organizace“, „Přístupový klíč (druhé ověření)“, „Dnes, když je vše nové“, „Šest věcí, než se kdokoli přihlásí“, „Pozvat lidi“. Pod políčkem převzetí vedou dolů dvě červené větve: „kód je příliš starý: CLAIM_CODE_EXPIRED, vytvořte nový kód“ a „otisky se liší: CLAIM_FINGERPRINT_MISMATCH, zastavte“. Tenká čára pod prvními třemi políčky nese popisek „každý krok natrvalo vypne ten předchozí“.
První spuštění, od terminálu po první stránku Dnes, a dvě místa, kde se může zastavit.

Vytvoření kódu pro převzetí

Kód pro převzetí prokazuje, že osoba před prohlížečem zároveň vidí terminál někoho, kdo má přístup ke clusteru. Takový kód může vytvořit pouze tato osoba. Spusťte tento příkaz tam, odkud váš kubeconfig dosáhne na cluster:

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

nexusctl claim-code požádá klíčovou službu instalace, nexus-keys, aby vytvořila kód. Bez nexusctl se stejný příkaz spustí ve vlastním podu klíčové 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 několik slov uvádějících, kdo kód vytvořil. Stránka pro převzetí je zobrazuje pod položkou „Vytvořil(a)“, takže osoba přebírající instalaci ví, odkud kód pochází.

 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

U kódu jsou důležité tři věci.

  • Platí 30 minut. Kód zahlédnutý přes rameno je brzy k ničemu.
  • Umožňuje 5 pokusů. Po pátém chybném pokusu je vyčerpán, bez ohledu na čas.
  • Je určen pro jednu osobu. E-mail, který zadáte, patří prvnímu správci. Putuje společně s převzetím a formulář prvního správce jej zobrazí jako pevně daný, aniž by se znovu vypisoval.

Otisk (fingerprint) tvoří osm skupin po čtyřech znacích a představuje vlastní identitu instalace. Nechte jej na obrazovce. V prohlížeči jej pak porovnáte, skupinu po skupině.

Převzetí instalace

  1. Na počítači, který budete používat jako první správce, otevřete instalační adresu konzole, zde https://console.harrow.example/install. Ta vás přesměruje na správnou stránku podle stavu instalace: na stránku pro převzetí, dokud je otevřená, na stránku prvního správce po převzetí instalace a do konzole, pokud již jste přihlášeni.
  2. Na stránce Převzít tuto instalaci zadejte kód do polí Skupina jedna, Skupina dvě a Skupina tři, do každého jednu skupinu čtyř znaků.
  3. Porovnejte Otisk této instalace na stránce s terminálem, všech osm skupin, jednu po druhé.
  4. Pokud se každá skupina shoduje, zaškrtněte Všech osm skupin se shoduje s tím, co ukazuje můj terminál.
  5. Stiskněte Převzít tuto instalaci a stránka potvrdí převzetí a přesměruje vás k nastavení prvního správce.
Převzít tuto instalaci
Převzít tuto instalaci
Stránka pro převzetí. Kód se zadává ve třech skupinách, celý otisk je zobrazen v osmi skupinách po čtyřech znacích pro porovnání s terminálem a karta vpravo uvádí, odkud kód pochází a kolik pokusů zbývá.

Převzetí udělá tři věci. Učiní z tohoto prohlížeče jediné místo, kde lze vytvořit prvního správce. Zaznamená do auditního protokolu, kdo a kdy instalaci převzal. A natrvalo vypne stránku pro převzetí. Od té chvíle adresa pro převzetí odpovídá, že instalace již byla převzata.

Pokud se otisk neshoduje, zastavte

Odlišný otisk znamená, že na této adrese odpovídá jiná instalace. Může jít o překlep v adrese, zastaralý záznam DNS (Domain Name System) nebo o stroj nastražený k zachycení prvního správce. Pokud byste ji převzali, držel by vaši organizaci tento stroj.

Instalaci nepřebírejte a na této stránce kód nezadávejte. Zavřete stránku a poté zkontrolujte dvě věci: zda console.harrow.example směřuje na váš ingress a zda certifikát, který prohlížeč ukazuje, vydala CA (certifikační autorita), kterou očekáváte. Vaše vlastní instalace je nezměněná a stále nepřevzatá.

Pokud je odeslán požadavek na převzetí s otiskem, který nepatří dané instalaci, klíčová služba jej odmítne s chybou CLAIM_FINGERPRINT_MISMATCH (403). Nic není převzato. Stránka poté zobrazí oba otisky vedle sebe s vyznačenými skupinami, které se liší, a kroky pro kontrolu adresy a certifikátu.

Otisk se neshoduje
Otisk se neshoduje
Stránka, na kterou vede neshodující se otisk. Odlišné skupiny jsou vyznačeny a uvedené kroky provedou kontrolu adresy a certifikátu dříve, než se zadá cokoli dalšího.

Vytvoření prvního administrátora a organizace

Následující stránka nese nadpis „Dva krátké formuláře a jste uvnitř“. První správce může přidat všechny ostatní a téměř vše, co je zde uvedeno, lze později změnit. Dvě věci změnit nelze a stránka je označuje.

Pole Co se zadává Lze to později změnit?
Celé jméno Vaše jméno Ano
Pracovní e-mail Adresa, pro kterou byl vytvořen kód pro převzetí; pouze se zobrazí a znovu se nezadává Je to adresa správce
Role v systému Nexus Správce organizace. První osoba je vždy správce. Zde se nevolí
Druhé ověření Přístupový klíč na tomto notebooku Ano, lze přidat další
Název (organizace) Harrow Port Authority Ano
Země Kde organizace sídlí Ano
Krátký název v adresách Vytvořeno z názvu, například harrow-port-authority Ne. Používají jej odkazy a exporty.
Kde jsou uložena data Tato instalace Ne. Pozdější změna znamená novou instalaci.
Jazyk a data Angličtina (UK), s dnešním datem Ano
Časové pásmo Časové pásmo serveru Každá osoba vidí časy ve svém vlastním pásmu

Krátký název se skládá z malých písmen, číslic a pomlček, má délku až 100 znaků a je vytvořen z názvu organizace s odstraněnou diakritikou. Než cokoli stisknete, prohlédněte si jej. Objevuje se v každém odkazu, který lidé sdílejí, a v každém exportu, který vytvoří, po celou dobu existence organizace.

Na této stránce si také nastavíte heslo. Samo o sobě nikdy nestačí: správce se nikdy nepřihlašuje pouze heslem. Přihlásí vás až druhé ověření uvedené níže.

Současně se vytvoří nouzové přihlášení správce. Je zapečetěno a vytištěno pouze jednou, pro uložení do trezoru. Funguje pouze tehdy, když je firemní přihlašování nedostupné, a každé použití je zaznamenáno a oznámeno všem správcům. Uložte jej do trezoru v den, kdy jej vytisknete.

Stránka také uvádí, že společnosti Adverant se nesděluje, kdo jste. Tyto údaje zůstávají v instalaci. Licence uvádí název společnosti, nikdy ne lidi v ní.

Stiskněte Vytvořit a přihlásit se. Vytvoření správce a organizace trvá několik sekund. Stránka odpoví „Vytvořeno pro aoife.brennan@harrow.example. Nyní si nastavte přístupový klíč: pomocí něj se budete přihlašovat.“

První administrátor
První správce
První správce a organizace na jedné stránce. Dvě volby, které nelze nikdy změnit – krátký název a místo uložení dat – to mají uvedeno vedle pole a nouzové přihlášení je zapečetěno pro uložení do trezoru.

Přístupový klíč (passkey): druhá kontrola

  1. Stiskněte Nastavit přístupový klíč a přihlásit se.
  2. Váš prohlížeč vás vyzve k vytvoření přístupového klíče. Na notebooku s Touch ID nebo Windows Hello potvrďte otiskem prstu, obličejem nebo kódem PIN. Pokud počítač nedokáže vytvořit přístupový klíč sám, prohlížeč zobrazí QR (quick response) kód: namiřte na něj fotoaparát telefonu a postupujte podle pokynů na telefonu.
  3. Stránka odpoví „Váš přístupový klíč je nastaven a jste přihlášeni jako aoife.brennan@harrow.example.“ a otevře konzoli.

Od stisknutí Vytvořit a přihlásit se máte deset minut na to, abyste ve stejném prohlížeči vytvořili přístupový klíč. Poté se nastavení uzavře a správce existuje bez přístupového klíče. Pak musí pomoci operátor, jak je popsáno níže v části věnované opakovaným pokusům.

Od této chvíle se první správce přihlašuje pomocí tohoto přístupového klíče. Heslo plného správce, zadané samostatně, nikdy nevytvoří relaci: přihlašovací služba odpoví požadavkem na druhé ověření. To je vlastnost návrhu a důvod, proč na přístupovém klíči záleží. Ztracený přístupový klíč znamená ztracenou cestu dovnitř, proto si hned první den přidejte druhý, na telefonu nebo na bezpečnostním klíči.

Později se lidé do instalace přihlašují pomocí přístupového klíče, účtu Google, účtu GitHub nebo pomocí svého firemního přihlašování, podle toho, co organizace povolí.

Kód Co to znamená Co dělat
PASSKEY_UNSUPPORTED Tento prohlížeč neumí vytvořit přístupový klíč. Nic nebylo nastaveno. Otevřete stránku v prohlížeči, který podporuje přístupové klíče, na stejném počítači.
PASSKEY_CANCELLED Výzva byla zavřena nebo nebylo včas nic vybráno. Nic nebylo odesláno. Stiskněte tlačítko znovu.

První stránka Dnes

Konzole se otevře na stránce Dnes a první den je na ní téměř vše prázdné. Každá prázdná oblast uvádí, co se v ní objeví, a nabízí tlačítko, kterým to spustíte; například „Vyžaduje správce“ uvádí, že zde budou čekat požadavky, jakmile se připojí lidé, a vedle je tlačítko Pozvat lidi. Kontrolní seznam nastavení ukazuje, kolik kroků je hotovo, v libovolném pořadí. Jediná skutečná historie, samotné nastavení, je již v části „Co se změnilo“: instalace byla nastavena a byl vytvořen přístupový klíč prvního správce.

Dnes, když je vše nové
Dnes, když je vše nové
Stránka Dnes první den. Každá prázdná oblast uvádí, co se v ní objeví a jak to spustit, a část „Co se změnilo“ již obsahuje samotné nastavení.

Šest kroků před prvním přihlášením uživatelů

Stránka Šest věcí, než se kdokoli přihlásí vypisuje, co musí platit, než budou pozváni lidé. Není to průvodce. Splňte je v libovolném pořadí a stránka je počítá („Tři ze šesti splněny“).

Položka Co ji splňuje
Licence Naimportovaná licence Enterprise. Kapitola 2.13, Licence. Edice Community žádnou licenci nepotřebuje.
Adresa a certifikát Veřejná adresa odpovídá certifikátem, jehož řetězec je úplný.
Zálohy Nastavený plán zálohování s cílem, do kterého lze zapisovat.
Firemní přihlašování Připojeno a otestováno. Do té doby lidé používají přístupové klíče.
Pošta Nastavený poštovní server. Do té doby nelze odesílat pozvánky.
AI model AI (umělá inteligence) model: klíč modelu organizace nebo model na vašem vlastním hardwaru. Do té doby asistent čeká. Kapitola 2.14, Poskytovatelé a modely AI.

Možnost Pozvat lidi se zpřístupní, jakmile je splněno všech šest bodů.

Tatáž stránka vypisuje, co se stane neměnným, jakmile se lidé přihlásí, a u každé položky uvádí důvod: krátký název v adresách, kde jsou uložena data a správce klíčů (klíče se mohou přesunout ze softwarového správce do hardwarového, nikdy ne zpět). Název organizace je zde uveden také, protože stojí za kontrolu, i když jej změnit lze.

Nexus neodpoví na žádný požadavek na AI, dokud organizace nemá model. Za instalací není žádný sdílený klíč ani žádné záložní řešení, takže organizace bez klíče modelu dostane prosté odmítnutí, které správci sdělí, co má přidat.

Šest věcí, než se kdokoli přihlásí
Šest kroků před prvním přihlášením uživatelů
Šest kontrol v libovolném pořadí, počítaných slovy. Volby, které se stanou neměnnými po přihlášení lidí, jsou vypsány i s důvodem, aby to nikdo nezjišťoval až dodatečně.

Firemní přihlašování

Většina organizací chce, aby se lidé přihlašovali pomocí účtů, které již mají. Připojte svého poskytovatele identity na stránce firemního přihlašování: přes OIDC (OpenID Connect) v edici Community, nebo přes OIDC či SAML (Security Assertion Markup Language) v edici Enterprise.

  1. Vyberte poskytovatele a standard, který používá.
  2. Zadejte identitu aplikace a tajný klíč aplikace (secret), které vám poskytl váš poskytovatel identity. Tajný klíč se po uložení již nikdy znovu nezobrazí.
  3. Určete, kdo se může přihlásit, například kdokoli s adresou @harrow.example.
  4. Stiskněte Otestovat přihlášení a přihlaste se sami za sebe. Výsledek slovy uvádí, kdo se přihlásil a co poskytovatel odeslal.
  5. Uložte.

Edice Community získá jedno firemní přihlašování pro organizaci. Edice Enterprise přidává vynucení a synchronizaci adresáře. Vynucení vypne hesla, takže všichni musí používat firemní přihlašování, a pokus o zadání hesla je odmítnut s chybou SSO_REQUIRED a tlačítkem vedoucím ke správnému způsobu přihlášení. Synchronizace adresáře kopíruje lidi a skupiny z vašeho adresáře každých 15 minut a může vytvořit správce z jedné pojmenované skupiny.

Když firemní přihlašování přestane odpovídat, již přihlášení lidé zůstanou přihlášeni a nové přihlášení je odmítnuto s chybou IDP_UNREACHABLE (503). Správce pak může použít nouzové přihlášení správce z trezoru společně se svým přístupovým klíčem. Každé použití je zapsáno do auditního protokolu, oznámeno každému správci a skončí po čtyřech hodinách nebo ve chvíli, kdy se firemní přihlašování obnoví.

Připojte svého poskytovatele identity
Připojte svého poskytovatele identity
Firemní přihlašování s testem. Poskytovatel, standard drobným písmem a testovací přihlášení, jehož výsledek je vypsán slovy dříve, než se na něj kdokoli spolehne.

Pozvání uživatelů

Jakmile je nastavena pošta, pozvěte lidi ze stránky Lidé. U každého zadejte e-mail a roli:

  • Člen využívá vše, co organizace má, a nemění žádná nastavení.
  • Správce navíc spravuje lidi, modely, rozpočty a nastavení.

Pozvánka platí 7 dní. Osoba ji otevře, uvidí, kdo ji pozval, svou roli a co uvidí, a přihlásí se. Při prvním přihlášení je vyžádáno druhé ověření.

Pozvaní členové se přihlásí do konzole a vykonávají tam svou každodenní práci: Dnes, asistent, týmový chat, soubory a vyhledávání, zápisníky, agenty a pracovní postupy, podle toho, co jim jejich role dovoluje. Správci vidí také stránky správy. Členovi, který otevře stránku správce, se zobrazí stránka „Nejste správce“. Ta ukazuje nastavení pouze pro čtení, uvádí proč a nabízí možnost požádat správce.

Pozvat kolegu
Pozvat kolegu
Pozvánka určuje roli osoby před jejím příchodem, Člen nebo Správce, a může obsahovat krátkou poznámku.

Registrace vyžadují schválení

Lidé mohou o připojení požádat také tím, že se sami zaregistrují. V instalaci registrace cizí osoby nevytvoří funkční účet. Služba nexus-auth ji odmítne s chybou SIGNUP_REQUIRES_APPROVAL (403) a podrží ji ke schválení správcem.

V hostované službě společnosti Adverant existují ještě dva další ovládací prvky registrace, které jsou v každé instalaci vypnuté a neexistuje hodnota, kterou by šlo je zapnout. Internetová CAPTCHA by vyžadovala připojení k internetu při každé registraci. Síťový filtr registrací by vyžadoval licencovanou geolokační databázi, kterou instalace neobsahuje. Branou instalace je schválení.

Opakované pokusy, expirované kódy a další zamítnutí

Každé odmítnutí při prvním spuštění uvádí, co se stalo, že se nic nezměnilo (pokud to platí), a co udělat dál.

Kód Stav Kdy Co dělat
CLAIM_CODE_EXPIRED 410 Uplynulo 30 minut. Nic nebylo převzato a nic se nezměnilo. Vytvořte nový kód pomocí nexusctl claim-code --administrator <email> a poté stiskněte Mám nový kód.
CLAIM_FINGERPRINT_MISMATCH 403 Odeslaný otisk nepatří této instalaci. Zastavte. Zkontrolujte adresu a certifikát.
TRANSITION_NOT_PERMITTED 409 Byl znovu vyžádán krok, který již proběhl: převzetí již převzaté instalace nebo druhé vytvoření prvního správce. Přihlaste se v konzoli; první správce přidá všechny ostatní.
TRANSITION_NOT_PERMITTED 409 Krok nastavení přístupového klíče z prohlížeče, ve kterém nečeká žádný první správce, nebo po uplynutí jeho deseti minut. Viz níže.
RATE_LIMITED 429 Příliš mnoho pokusů na stránkách prvního spuštění za minutu. Nic nebylo odesláno. Počkejte počet sekund uvedený na stránce a poté to zkuste znovu.

Kód, kterému nezbývají žádné pokusy, hlásí „Tomuto kódu nezbývají žádné pokusy“. Vytvořte nový, stejně jako v případě kódu s vypršenou platností. Může to udělat pouze někdo s přístupem ke clusteru, což je smyslem věci.

Stránky prvního spuštění přijmou dohromady 20 pokusů za minutu. Pokud jste tyto pokusy neprovedli vy, zkouší stránku někdo jiný ve vaší síti, a to stojí za to vědět.

Když byl zmeškán krok nastavení přístupového klíče

Pokud byl první správce vytvořen, ale do deseti minut nebyl vytvořen žádný přístupový klíč, nebo byl prohlížeč zavřen, správce existuje bez možnosti se přihlásit. Krok nastavení přístupového klíče odpoví TRANSITION_NOT_PERMITTED se slovy „Pokud jste v tomto prohlížeči vytvořili prvního správce před více než deseti minutami, požádejte operátora: správce existuje a zatím nemá přístupový klíč“. Převzetí je v té chvíli již vyčerpáno, takže nový kód pro převzetí nepomůže. Než zkusíte cokoli jiného, požádejte operátora, který instalaci spustil.

Když prohlížeč ztratil převzetí

Převzetí je uloženo v prohlížeči, který jej provedl, v souboru cookie, který stránka nemůže přečíst. Pokud jej tento prohlížeč mezi převzetím a vytvořením prvního správce ztratí, například v anonymním okně, které bylo zavřeno, formulář prvního správce přijme také soubor převzetí a jeho tajný klíč nastavení, vložené ručně.

Jakmile měla Aoife svůj přístupový klíč, Tomás zavřel svůj terminál. Stránka pro převzetí byla vypnutá, první správce existoval a každá další cesta dovnitř nyní vedla přes ni.