Verzija 1.0.0-alpha.1najnovije
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

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.
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.examplenexusctl 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
- 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. - 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.
- Usporedite Otisak ove instalacije na stranici s onim u terminalu, svih osam skupina, jednu po jednu.
- Ako se svaka skupina podudara, označite Svih osam skupina podudara se s prikazom u mojem terminalu.
- Pritisnite Preuzmi ovu instalaciju, nakon čega će stranica potvrditi preuzimanje i proslijediti vas na korak za prvog administratora.
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.
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.”
Pristupni ključ: druga provjera
- Pritisnite Postavi pristupni ključ i prijavi se.
- 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.
- 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.
Š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.
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.
- Odaberite pružatelja usluge i standard koji koristi.
- 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.
- Navedite tko se smije prijaviti, primjerice svatko s adresom
@harrow.example. - Pritisnite Ispitaj prijavu i prijavite se svojim računom. Rezultat riječima navodi tko se prijavio i što je pružatelj usluge poslao.
- 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.
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.
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.






