PrijavaRezervirajte prezentaciju

Poglavlje 2.12

Prvo pokretanje

Od nepreuzete instalacije do ljudi koji rade. Izradite kod za preuzimanje, preuzmite instalaciju u pregledniku, izradite prvog administratora s pristupnim ključem, a zatim povežite prijavu tvrtke i pozovite sve ostale.

Ovu je stranicu s engleskog izvornika preveo AI. Ako je išta nejasno, mjerodavna je stranica na engleskom jeziku. Pročitajte ovu stranicu na engleskom jeziku

18 min čitanja

Kada instalacija završi, ona ne pripada nikome. Nema organizaciju, nema osobu ni sesiju i nitko se ne može prijaviti. Čeka da jedna osoba u pregledniku dokaže da komunicira s instalacijom koja je upravo stvorena. U organizaciji Harrow Port Authority ta je osoba bila Aoife Brennan, voditeljica IT-ja, a uz nju je za terminalom bio Tomás Reilly. Ovo poglavlje prati njihovih prvih dvadeset minuta.

Redoslijed je fiksan, a svaki korak trajno zatvara onaj prethodni: preuzmite instalaciju, izradite prvog administratora i organizaciju, postavite pristupni ključ (passkey) i otvorite stranicu Danas. Nakon toga slijedi šest stavki koje treba pripremiti, prijava tvrtke i pozivanje svih ostalih, redoslijedom koji vam odgovara.

Slijed okvira slijeva nadesno: „nexusctl claim-code (terminal)”, „Preuzmi ovu instalaciju (preglednik: kod + otisak)”, „Prvi administrator i organizacija”, „Pristupni ključ (druga provjera)”, „Danas, kada je sve novo”, „Šest stavki prije nego što se itko prijavi”, „Pozovi ljude”. Ispod okvira za preuzimanje spuštaju se dvije crvene grane: „kod je prestar: CLAIM_CODE_EXPIRED, izradite novi kod” i „otisci se razlikuju: CLAIM_FINGERPRINT_MISMATCH, stanite”. Tanka crta ispod prva tri okvira nosi oznaku „svaki korak trajno isključuje onaj prethodni”.
Prvo pokretanje, od terminala do prve stranice Danas, i dva mjesta na kojima se može zaustaviti.

Izrada koda za preuzimanje

Kod za preuzimanje dokazuje da osoba ispred preglednika istovremeno vidi terminal nekoga tko ima pristup klasteru. Samo takva osoba može izraditi kod. Pokrenite ovo na mjestu s kojeg vaš kubeconfig može pristupiti klasteru:

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

nexusctl claim-code traži od servisa za ključeve instalacije, nexus-keys, da izradi kod. Bez nexusctl, ista se naredba izvršava u vlastitom podu servisa za ključeve:

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

--source je nekoliko riječi koje govore tko je izradio kod. Stranica za preuzimanje prikazuje ih pod „Izradio”, tako da osoba koja preuzima instalaciju zna odakle je kod stigao.

 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

Tri su stvari važne u vezi s kodom.

  • Traje 30 minuta. Kod viđen preko nečijeg ramena ubrzo postaje beskoristan.
  • Dopušta 5 pokušaja. Nakon petog pogrešnog pokušaja kod je potrošen, bez obzira na preostalo vrijeme.
  • Namijenjen je jednoj osobi. Adresa e-pošte koju navedete pripada prvom administratoru. Ona putuje zajedno s preuzimanjem, a obrazac za prvog administratora prikazuje je kao fiksnu, pa se ne upisuje ponovno.

Otisak se sastoji od osam skupina po četiri znaka i predstavlja vlastiti identitet instalacije. Ostavite ga na zaslonu. Usporedit ćete ga, skupinu po skupinu, u pregledniku.

Preuzimanje instalacije

  1. Na računalu koje ćete koristiti kao prvi administrator otvorite instalacijsku adresu konzole, ovdje https://console.harrow.example/install. Ona vas šalje na odgovarajuću stranicu ovisno o stanju instalacije: na stranicu za preuzimanje dok je otvorena, na stranicu prvog administratora nakon što je preuzeta te na konzolu ako ste već prijavljeni.
  2. Na stranici Preuzmi ovu instalaciju upišite kod u polja Prva skupina, Druga skupina i Treća skupina, po jednu skupinu od četiri znaka u svako.
  3. Usporedite Otisak ove instalacije na stranici s onim u terminalu, svih osam skupina, jednu po jednu.
  4. Ako se svaka skupina podudara, označite Svih osam skupina podudara se s prikazom u mojem terminalu.
  5. Pritisnite Preuzmi ovu instalaciju, nakon čega će stranica potvrditi preuzimanje i proslijediti vas na korak za prvog administratora.
Preuzmi ovu instalaciju
Preuzmi ovu instalaciju
Stranica za preuzimanje. Kod se unosi u tri skupine, puni otisak prikazan je u osam skupina po četiri znaka radi usporedbe s terminalom, a kartica s desne strane navodi odakle je kod stigao i koliko je pokušaja preostalo.

Preuzimanje čini tri stvari. Čini ovaj preglednik jedinim mjestom na kojem se može izraditi prvi administrator. Bilježi tko je i kada preuzeo instalaciju u dnevnik revizije. I trajno isključuje stranicu za preuzimanje. Od tog trenutka nadalje, adresa za preuzimanje odgovara da je instalacija već preuzeta.

Ako se otisak ne podudara, stanite

Drugačiji otisak znači da na ovoj adresi odgovara neka druga instalacija. Uzrok može biti pogrešno upisana adresa, zastarjeli DNS (Domain Name System) zapis ili računalo postavljeno da presretne prvog administratora. Kada biste je preuzeli, to bi računalo preuzelo vašu organizaciju.

Nemojte preuzimati instalaciju i nemojte upisivati kod na toj stranici. Zatvorite stranicu pa provjerite dvije stvari: razrješava li se console.harrow.example na vaš ingress i je li certifikat koji preglednik prikazuje izdao CA (certifikacijsko tijelo) koji očekujete. Vaša vlastita instalacija ostaje nepromijenjena i još uvijek nepreuzeta.

Ako se zahtjev za preuzimanje pošalje s otiskom koji ne pripada instalaciji, servis za ključeve odbija ga uz CLAIM_FINGERPRINT_MISMATCH (403). Ništa nije preuzeto. Stranica zatim prikazuje ta dva otiska jedan uz drugoga s označenim skupinama koje se razlikuju te korake za provjeru adrese i certifikata.

Otisak se ne podudara
Otisak se ne podudara
Stranica na koju vodi nepodudaranje otisaka. Skupine koje se razlikuju su označene, a navedeni koraci provjeravaju adresu i certifikat prije nego što se išta drugo upiše.

Izrada prvog administratora i organizacije

Sljedeća stranica nosi naslov „Dva kratka obrasca, a zatim ste unutra”. Prvi administrator može dodati sve ostale, a gotovo sve ovdje navedeno može se kasnije promijeniti. Dvije se stvari ne mogu promijeniti, što je na stranici i označeno.

Polje Što se unosi Može li se kasnije promijeniti?
Puno ime Vaše ime Da
Poslovna e-pošta Adresa za koju je izrađen kod za preuzimanje; prikazana je i ne upisuje se ponovno To je adresa administratora
Uloga u sustavu Nexus Administrator organizacije. Prva osoba je uvijek administrator. Ne bira se ovdje
Druga provjera Pristupni ključ na ovom prijenosnom računalu Da, može ih se dodati još
Naziv (organizacije) Harrow Port Authority Da
Država Gdje je sjedište organizacije Da
Kratki naziv u adresama Izveden iz naziva, primjerice harrow-port-authority Ne. Koriste ga poveznice i izvozi.
Gdje se čuvaju podaci Ova instalacija Ne. Kasnija promjena znači novu instalaciju.
Jezik i datumi Engleski (UK), s današnjim datumom Da
Vremenska zona Vremenska zona poslužitelja Svaka osoba vidi vrijeme u svojoj vremenskoj zoni

Kratki naziv sastoji se od malih slova, znamenki i crtica, dužine do 100 znakova, a izvodi se iz naziva organizacije uz uklonjene dijakritičke znakove. Pregledajte ga prije nego što išta pritisnete. Pojavljuje se u svakoj poveznici koju ljudi podijele i u svakom izvozu koji naprave, sve dok organizacija postoji.

Na ovoj stranici postavljate i lozinku. Ona nikada nije dovoljna sama za sebe: administrator se nikada ne prijavljuje samo lozinkom. Druga provjera, navedena u nastavku, ono je što vas prijavljuje.

Istovremeno se izrađuje i prijava za administratora u hitnim slučajevima. Ona se pečati i ispisuje jednom, za pohranu u sef. Djeluje samo kada je prijava tvrtke nedostupna, a svaka se upotreba bilježi i objavljuje svim administratorima. Spremite je u sef istog dana kada je ispišete.

Na stranici također piše da Adverant ne dobiva podatke o tome tko ste. Ti podaci ostaju na instalaciji. Licenca glasi na tvrtku, nikada na ljude u njoj.

Pritisnite Izradi i prijavi se. Izrada administratora i organizacije traje nekoliko sekundi. Stranica odgovara: „Izrađeno za aoife.brennan@harrow.example. Sada postavite svoj pristupni ključ: pomoću njega se prijavljujete.”

Prvi administrator
Prvi administrator
Prvi administrator i organizacija na jednoj stranici. Dva odabira koja se nikada ne mogu promijeniti, kratki naziv i mjesto čuvanja podataka, imaju tu napomenu uz polje, a prijava za hitne slučajeve zapečaćena je za sef.

Pristupni ključ: druga provjera

  1. Pritisnite Postavi pristupni ključ i prijavi se.
  2. Vaš preglednik traži da izradite pristupni ključ. Na prijenosnom računalu sa značajkom Touch ID ili Windows Hello potvrdite prstom, licem ili PIN-om. Ako računalo ne može samo izraditi pristupni ključ, preglednik prikazuje QR (quick response) kod: usmjerite kameru telefona prema njemu i slijedite upute na telefonu.
  3. Stranica odgovara „Vaš pristupni ključ je postavljen i prijavljeni ste kao aoife.brennan@harrow.example.” te otvara konzolu.

Od pritiska na Izradi i prijavi se imate deset minuta da izradite pristupni ključ, u istom pregledniku. Nakon toga se postavljanje zatvara, a administrator postoji bez pristupnog ključa. Tada mora pomoći operater, kako je opisano u odjeljku o ponovnim pokušajima u nastavku.

Od sada nadalje prvi se administrator prijavljuje tim pristupnim ključem. Lozinka punopravnog administratora, upisana sama za sebe, nikada ne stvara sesiju: servis za prijavu odgovara zahtjevom za drugu provjeru. To je značajka samog dizajna i razlog zašto je pristupni ključ važan. Izgubljeni pristupni ključ znači izgubljen ulaz, stoga već prvog dana dodajte drugi, na telefonu ili sigurnosnom ključu.

Kasnije se ljudi prijavljuju u instalaciju pristupnim ključem, putem servisa Google, putem servisa GitHub ili prijavom svoje tvrtke, ovisno o tome što organizacija dopušta.

Kod Što to znači Što učiniti
PASSKEY_UNSUPPORTED Ovaj preglednik ne može izraditi pristupni ključ. Ništa nije postavljeno. Otvorite stranicu u pregledniku koji podržava pristupne ključeve, na istom računalu.
PASSKEY_CANCELLED Upit je zatvoren ili ništa nije odabrano na vrijeme. Ništa nije poslano. Ponovno pritisnite gumb.

Prva stranica Danas

Konzola se otvara na stranici Danas, a prvog je dana gotovo sve na njoj prazno. Svako prazno područje navodi što će se ondje pojaviti i nudi gumb kojim se to pokreće, pa tako „Traži administratora” navodi da će ondje čekati zahtjevi kada se ljudi pridruže, uz gumb Pozovi ljude pokraj toga. Kontrolni popis za postavljanje pokazuje koliko je koraka dovršeno, bilo kojim redoslijedom. Jedina stvarna povijest, samo postavljanje, već se nalazi pod „Što se promijenilo”: instalacija je postavljena i izrađen je pristupni ključ prvog administratora.

Danas, kada je sve novo
Danas, kada je sve novo
Stranica Danas prvog dana. Svako prazno područje navodi što će se ondje pojaviti i kako to pokrenuti, a „Što se promijenilo” već sadrži samo postavljanje.

Šest stvari prije nego što se itko prijavi

Stranica Šest stavki prije nego što se itko prijavi navodi što mora biti ispunjeno prije pozivanja ljudi. To nije čarobnjak. Obavite ih bilo kojim redoslijedom, a stranica ih broji („Tri od šest ispunjeno”).

Stavka Što je ispunjava
Licenca Uvezena Enterprise licenca. Poglavlje 2.13, Licence. Izdanje Community ne treba licencu.
Adresa i certifikat Javna adresa odgovara certifikatom čiji je lanac potpun.
Sigurnosne kopije Postavljen raspored sigurnosnog kopiranja, s odredištem na koje je moguće pisati.
Prijava tvrtke Povezana i ispitana. Do tada ljudi koriste pristupne ključeve.
Pošta Postavljen poslužitelj e-pošte. Do tada se pozivnice ne mogu slati.
AI model AI (umjetna inteligencija) model: ključ modela organizacije ili model na vašem vlastitom hardveru. Do tada asistent čeka. Poglavlje 2.14, AI pružatelji usluga i modeli.

Gumb Pozovi ljude otvara se kada je svih šest stavki ispunjeno.

Ista stranica navodi što postaje fiksno nakon što se ljudi prijave, uz razlog za svaku stavku: kratki naziv u adresama, mjesto čuvanja podataka i skrbnik ključeva (ključevi mogu prijeći sa softverskog skrbnika na hardverski, ali nikada obrnuto). Naveden je i naziv organizacije jer ga vrijedi provjeriti, iako se on može promijeniti.

Nexus neće odgovoriti ni na čiji AI zahtjev dok organizacija nema model. Iza instalacije ne postoji dijeljeni ključ niti rezervna opcija, pa organizacija bez ključa modela dobiva jasno odbijanje koje administratoru govori što treba dodati.

Šest stavki prije nego što se itko prijavi
Šest stvari prije nego što se itko prijavi
Šest provjera bilo kojim redoslijedom, brojano riječima. Odabiri koji postaju fiksni nakon što se ljudi prijave navedeni su s razlogom, kako to nitko ne bi saznao tek kasnije.

Prijava tvrtke

Većina organizacija želi da se ljudi prijavljuju računima koje već imaju. Povežite svojeg pružatelja identiteta na stranici za prijavu tvrtke: putem protokola OIDC (OpenID Connect) u izdanju Community ili putem protokola OIDC ili SAML (Security Assertion Markup Language) u izdanju Enterprise.

  1. Odaberite pružatelja usluge i standard koji koristi.
  2. Unesite identitet aplikacije i tajnu aplikacije koje vam je dao vaš pružatelj identiteta. Tajna se više nikada ne prikazuje nakon što je spremite.
  3. Navedite tko se smije prijaviti, primjerice svatko s adresom @harrow.example.
  4. Pritisnite Ispitaj prijavu i prijavite se svojim računom. Rezultat riječima navodi tko se prijavio i što je pružatelj usluge poslao.
  5. Spremite.

Izdanje Community dobiva jednu prijavu tvrtke za organizaciju. Izdanje Enterprise dodaje obveznu primjenu i sinkronizaciju imenika. Obvezna primjena isključuje lozinke, tako da svi moraju koristiti prijavu tvrtke, a pokušaj prijave lozinkom odbija se uz SSO_REQUIRED i gumb koji vodi na ispravan način prijave. Sinkronizacija imenika kopira ljude i grupe iz vašeg imenika svakih 15 minuta te može izraditi administratore iz jedne imenovane grupe.

Kada prijava tvrtke prestane odgovarati, ljudi koji su već prijavljeni ostaju prijavljeni, a nova se prijava odbija uz IDP_UNREACHABLE (503). Administrator tada može upotrijebiti prijavu za administratora u hitnim slučajevima iz sefa, zajedno sa svojim pristupnim ključem. Svaka se upotreba zapisuje u dnevnik revizije, objavljuje svakom administratoru i završava nakon četiri sata ili kada se prijava tvrtke vrati.

Povežite svojeg pružatelja identiteta
Povežite svojeg pružatelja identiteta
Prijava tvrtke s ispitivanjem. Pružatelj usluge, standard ispisan malim slovima i ispitna prijava čiji je rezultat ispisan riječima prije nego što se itko osloni na nju.

Pozivanje ljudi

Kada je pošta postavljena, pozovite ljude sa stranice Ljudi. Za svakoga navedite adresu e-pošte i ulogu:

  • Član koristi sve što organizacija ima i ne mijenja nikakve postavke.
  • Administrator također upravlja ljudima, modelima, proračunima i postavkama.

Pozivnica traje 7 dana. Osoba je otvori, vidi tko ju je pozvao, svoju ulogu i što će vidjeti te se prijavi. Pri prvoj se prijavi traži druga provjera.

Pozvani članovi prijavljuju se u konzolu i ondje obavljaju svoj svakodnevni posao: Danas, asistent, timski razgovor, datoteke i pretraživanje, bilježnice, agenti i tijekovi rada, ovisno o tome što im uloga dopušta. Administratori vide i administracijske stranice. Član koji otvori administratorsku stranicu dobiva stranicu „Niste administrator”. Ona prikazuje postavke samo za čitanje, objašnjava zašto i nudi mogućnost slanja upita administratoru.

Pozovi kolegu
Pozovi kolegu
Pozivnica određuje ulogu osobe prije njezina dolaska, Član ili Administrator, i može sadržavati kratku poruku.

Registracije zahtijevaju odobrenje

Ljudi također mogu zatražiti pridruživanje tako da se sami registriraju. Na instalaciji registracija nepoznate osobe ne stvara aktivan račun. Servis nexus-auth odbija je uz SIGNUP_REQUIRES_APPROVAL (403) i zadržava je do odobrenja administratora.

Na hostiranoj usluzi tvrtke Adverant postoje još dvije kontrole registracije koje su na svakoj instalaciji isključene i nema vrijednosti kojom bi se mogle uključiti. Internetska CAPTCHA zahtijevala bi pristup internetu pri svakoj registraciji. Provjera mreže pri registraciji zahtijevala bi licenciranu geolokacijsku bazu podataka koju instalacija ne sadržava. Odobrenje je ulazna kontrola instalacije.

Ponovni pokušaji, istekli kodovi i druga odbijanja

Svako odbijanje pri prvom pokretanju navodi što se dogodilo, da se ništa nije promijenilo (kada je to slučaj) te što učiniti dalje.

Kod Status Kada Što učiniti
CLAIM_CODE_EXPIRED 410 Prošlo je 30 minuta. Ništa nije preuzeto i ništa se nije promijenilo. Izradite novi kod pomoću nexusctl claim-code --administrator <email>, a zatim pritisnite Imam novi kod.
CLAIM_FINGERPRINT_MISMATCH 403 Poslani otisak ne pripada ovoj instalaciji. Stanite. Provjerite adresu i certifikat.
TRANSITION_NOT_PERMITTED 409 Ponovno je zatražen korak koji se već dogodio: preuzimanje na već preuzetoj instalaciji ili izrada prvog administratora po drugi put. Prijavite se u konzolu; prvi administrator dodaje sve ostale.
TRANSITION_NOT_PERMITTED 409 Korak s pristupnim ključem, iz preglednika u kojem ne čeka prvi administrator ili nakon isteka njegovih deset minuta. Pogledajte u nastavku.
RATE_LIMITED 429 Previše pokušaja na stranicama prvog pokretanja u jednoj minuti. Ništa nije poslano. Pričekajte onoliko sekundi koliko stranica navodi, a zatim pokušajte ponovno.

Kod bez preostalih pokušaja ispisuje „Ovaj kod nema preostalih pokušaja”. Izradite novi, jednako kao i za istekli kod. To može učiniti samo netko s pristupom klasteru, što i jest svrha.

Stranice prvog pokretanja zajedno dopuštaju 20 pokušaja u minuti. Ako te pokušaje niste napravili vi, netko drugi na vašoj mreži pokušava pristupiti stranici, a to je korisna informacija.

Kada je propušten korak s pristupnim ključem

Ako je prvi administrator izrađen, ali u roku od deset minuta nije izrađen pristupni ključ ili je preglednik zatvoren, administrator postoji bez mogućnosti prijave. Korak za pristupni ključ odgovara uz TRANSITION_NOT_PERMITTED i riječi: „Ako ste u ovom pregledniku izradili prvog administratora prije više od deset minuta, obratite se operateru: administrator postoji i još nema pristupni ključ”. Preuzimanje je u tom trenutku potrošeno, pa novi kod za preuzimanje neće pomoći. Obratite se operateru koji je pokrenuo instalaciju prije nego što pokušate bilo što drugo.

Kada je preglednik izgubio preuzimanje

Preuzimanje se nalazi u pregledniku koji ga je izvršio, u kolačiću koji stranica ne može pročitati. Ako ga taj preglednik izgubi između preuzimanja i izrade prvog administratora, primjerice u privatnom prozoru koji je zatvoren, obrazac za prvog administratora također prihvaća datoteku preuzimanja i njezinu tajnu za postavljanje, ručno zalijepljene.

Nakon što je Aoife dobila svoj pristupni ključ, Tomás je zatvorio svoj terminal. Stranica za preuzimanje bila je isključena, prvi je administrator postojao, a svaki je drugi ulaz sada išao preko nje.