Verze 1.0.0-alpha.1nejnovější
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ě

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.
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.examplenexusctl 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
- 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. - 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ů.
- Porovnejte Otisk této instalace na stránce s terminálem, všech osm skupin, jednu po druhé.
- Pokud se každá skupina shoduje, zaškrtněte Všech osm skupin se shoduje s tím, co ukazuje můj terminál.
- 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ř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.
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.“
Přístupový klíč (passkey): druhá kontrola
- Stiskněte Nastavit přístupový klíč a přihlásit se.
- 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.
- 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.
Š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.
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.
- Vyberte poskytovatele a standard, který používá.
- 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í.
- Určete, kdo se může přihlásit, například kdokoli s adresou
@harrow.example. - 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.
- 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í.
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.
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.






