Verzija 1.0.0-alpha.1najnovije
Poglavlje 2.12
Prvo pokretanje
Od nepreuzete instalacije do ljudi na poslu. Napravite kod za preuzimanje, preuzmite instalaciju u pregledaču, napravite prvog administratora sa passkey ključem, a zatim povežite prijavu preko kompanije i pozovite sve ostale.
Ovu stranicu je sa engleskog originala prevela AI tehnologija. Ako nešto nije jasno, merodavna je stranica na engleskom. Pročitajte ovu stranicu na engleskom

Kada se instalacija završi, instalacija ne pripada nikome. Nema organizaciju, osobu ni sesiju, i niko ne može da se prijavi. Ona čeka da jedna osoba u pregledaču dokaže da komunicira sa instalacijom koja je upravo napravljena. U organizaciji Harrow Port Authority ta osoba je bila Aoife Brennan, rukovodilac IT-a, a pored nje za terminalom bio je Tomás Reilly. Ovo poglavlje prati njihovih prvih dvadeset minuta.
Redosled je utvrđen i svaki korak trajno zatvara prethodni: preuzmite instalaciju, napravite prvog administratora i organizaciju, podesite pristupni ključ i stignite na stranicu Today. Posle toga slede šest stvari koje treba pripremiti, prijava preko kompanije i pozivanje svih ostalih, redosledom koji vama odgovara.
Napravite kod za preuzimanje
Kod za preuzimanje dokazuje da osoba ispred pregledača može da vidi i terminal nekoga ko ima pristup klasteru. Samo takva osoba može da ga napravi. Pokrenite ovo tamo gde vaš kubeconfig dopire do klastera:
nexusctl claim-code --administrator aoife.brennan@harrow.examplenexusctl claim-code traži od servisa za ključeve instalacije, nexus-keys, da napravi kod. Bez nexusctl, ista komanda se izvršava u sopstvenom 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 su nekoliko reči koje govore ko je napravio kod. Stranica za preuzimanje ih prikazuje pod „Napravio“, tako da osoba koja preuzima zna odakle kod potiče.
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 stvari u vezi sa kodom su važne.
- Važi 30 minuta. Kod viđen preko nečijeg ramena brzo postaje beskoristan.
- Dozvoljava 5 pokušaja. Posle petog pogrešnog pokušaja je iskorišćen, bez obzira na vreme.
- Namenjen je jednoj osobi. Adresa e-pošte koju unesete pripada prvom administratoru. Ona putuje uz preuzimanje, a obrazac prvog administratora je prikazuje kao fiksnu, ne unosi se ponovo.
Otisak se sastoji od osam grupa od po četiri znaka i predstavlja sopstveni identitet instalacije. Ostavite ga na ekranu. Uporedićete ga, grupu po grupu, u pregledaču.
Preuzmite instalaciju
- Na računaru koji ćete koristiti kao prvi administrator otvorite instalacionu adresu konzole, ovde
https://console.harrow.example/install. Ona vas upućuje na odgovarajuću stranicu prema stanju instalacije: na stranicu za preuzimanje dok je otvorena, na stranicu prvog administratora kada je preuzeta i na konzolu ako ste već prijavljeni. - Na stranici Preuzmite ovu instalaciju unesite kod u polja Prva grupa, Druga grupa i Treća grupa, po jednu grupu od četiri znaka u svako.
- Uporedite Otisak ove instalacije na stranici sa terminalom, svih osam grupa, jednu po jednu.
- Ako se svaka grupa poklapa, označite Svih osam grupa se poklapa sa onim što prikazuje moj terminal.
- Pritisnite Preuzmite ovu instalaciju, a stranica potvrđuje preuzimanje i vodi vas dalje na prvog administratora.
Preuzimanje čini tri stvari. Ovaj pregledač postaje jedino mesto na kome se može napraviti prvi administrator. U evidenciji revizije beleži ko je preuzeo instalaciju i kada. I trajno isključuje stranicu za preuzimanje. Od tada adresa za preuzimanje odgovara da je instalacija preuzeta.
Ako se otisak ne poklapa, zaustavite se
Drugačiji otisak znači da na ovoj adresi odgovara druga instalacija. To može biti pogrešno uneta adresa, zastareli DNS (Domain Name System) zapis ili mašina podešena da uhvati prvog administratora. Kada biste je preuzeli, ta mašina bi držala vašu organizaciju.
Nemojte preuzimati i nemojte unositi kod na toj stranici. Zatvorite stranicu, a zatim proverite dve stvari: da se console.harrow.example razrešava na vaš ingress i da je sertifikat koji pregledač prikazuje izdao CA (sertifikaciono telo) koji očekujete. Vaša sopstvena instalacija je nepromenjena i i dalje nepreuzeta.
Ako se preuzimanje pošalje sa otiskom koji nije otisak instalacije, servis za ključeve ga odbija sa CLAIM_FINGERPRINT_MISMATCH (403). Ništa nije preuzeto. Stranica tada prikazuje dva otiska jedan pored drugog, sa označenim grupama koje se razlikuju, i korake za proveru adrese i sertifikata.
Kreirajte prvog administratora i organizaciju
Stranica koja sledi nosi naslov „Dva kratka obrasca, a zatim ste unutra“. Prvi administrator može da doda sve ostale, a gotovo sve ovde može kasnije da se promeni. Dve stvari ne mogu, i stranica ih označava.
| Polje | Šta se unosi | Može li se kasnije promeniti? |
|---|---|---|
| Puno ime | Vaše ime | Da |
| Poslovna e-pošta | Adresa za koju je kod za preuzimanje napravljen, prikazana i ne unosi se ponovo | To je adresa administratora |
| Uloga u Nexus-u | Administrator organizacije. Prva osoba je uvek administrator. | Ne bira se ovde |
| Druga provera | Pristupni ključ na ovom laptopu | Da, mogu se dodati još |
| Naziv (organizacije) | Harrow Port Authority | Da |
| Država | Gde se organizacija nalazi | Da |
| Kratak naziv u adresama | Napravljen od naziva, na primer harrow-port-authority |
Ne. Koriste ga linkovi i izvozi. |
| Gde se podaci čuvaju | Ova instalacija | Ne. Kasnija promena znači novu instalaciju. |
| Jezik i datumi | English (UK), sa današnjim datumom | Da |
| Vremenska zona | Vremenska zona servera | Svaka osoba vidi vreme u svojoj |
Kratak naziv se sastoji od malih slova, cifara i crtica, do 100 znakova, i pravi se od naziva organizacije bez dijakritičkih znakova. Pogledajte ga pre nego što bilo šta pritisnete. Pojavljuje se u svakom linku koji ljudi dele i u svakom izvozu koji naprave, sve dok organizacija postoji.
Na ovoj stranici postavljate i lozinku. Ona nikada nije dovoljna sama: administrator se nikada ne prijavljuje samo lozinkom. Druga provera, u nastavku, je ono što vas prijavljuje.
Istovremeno se pravi i hitna administratorska prijava. Ona je zapečaćena i štampa se jednom, za sef. Radi samo kada prijava preko kompanije ne radi, a svaka upotreba se beleži i najavljuje svim administratorima. Stavite je u sef istog dana kada je odštampate.
Stranica takođe navodi da Adverant ne dobija informaciju o tome ko ste. Ovi podaci ostaju na instalaciji. Licenca navodi kompaniju, nikada ljude u njoj.
Pritisnite Napravite i prijavite se. Pravljenje administratora i organizacije traje nekoliko sekundi. Stranica odgovara „Napravljeno za aoife.brennan@harrow.example. Sada podesite pristupni ključ: njime se prijavljujete.“
Pristupni ključ (passkey): dodatna provera
- Pritisnite Podesite pristupni ključ i prijavite se.
- Pregledač traži da napravite pristupni ključ. Na laptopu sa Touch ID ili Windows Hello potvrdite prstom, licem ili PIN-om. Ako računar sam ne može da napravi pristupni ključ, pregledač prikazuje QR (quick response) kod: usmerite kameru telefona na njega i pratite uputstva na telefonu.
- Stranica odgovara „Vaš pristupni ključ je podešen i prijavljeni ste kao aoife.brennan@harrow.example.“ i otvara konzolu.
Imate deset minuta od pritiska na Napravite i prijavite se da napravite pristupni ključ, u istom pregledaču. Posle toga podešavanje je zatvoreno, a administrator postoji bez pristupnog ključa. Mora da pomogne operater, kako je opisano u delu o ponovnim pokušajima u nastavku.
Od sada se prvi administrator prijavljuje tim pristupnim ključem. Lozinka punopravnog administratora, uneta sama, nikada ne otvara sesiju: servis za prijavu odgovara zahtevom za drugu proveru. To je svojstvo dizajna i razlog zašto je pristupni ključ važan. Izgubljen pristupni ključ znači izgubljen pristup, zato prvog dana dodajte drugi, na telefonu ili sigurnosnom ključu.
Kasnije se ljudi prijavljuju na instalaciju pristupnim ključem, preko Google-a, preko GitHub-a ili preko prijave svoje kompanije, šta god organizacija dozvoljava.
| Kod | Šta znači | Šta učiniti |
|---|---|---|
PASSKEY_UNSUPPORTED |
Ovaj pregledač ne može da napravi pristupni ključ. Ništa nije podešeno. | Otvorite stranicu u pregledaču koji podržava pristupne ključeve, na istom računaru. |
PASSKEY_CANCELLED |
Upit je zatvoren ili ništa nije izabrano na vreme. Ništa nije poslato. | Ponovo pritisnite dugme. |
Prva stranica Danas
Konzola se otvara na stranici Today, a prvog dana je gotovo sve na njoj prazno. Svaka prazna oblast navodi šta će se tu pojaviti i nudi dugme koje to pokreće, pa „Potreban je administrator“ navodi da će zahtevi tu čekati kada se ljudi pridruže, sa dugmetom Pozovite ljude pored. Kontrolna lista za podešavanje pokazuje koliko je njenih koraka završeno, bilo kojim redosledom. Jedina prava istorija, samo podešavanje, već se nalazi pod „Šta se promenilo“: instalacija je podešena i pristupni ključ prvog administratora je napravljen.
Šest stvari pre nego što se bilo ko prijavi
Stranica Šest stvari pre nego što se iko prijavi navodi šta mora biti ispunjeno pre nego što se ljudi pozovu. To nije čarobnjak. Uradite ih bilo kojim redosledom, a stranica ih broji („Ispunjeno tri od šest“).
| Stavka | Šta je čini ispunjenom |
|---|---|
| Licenca | Uvezena Enterprise licenca. Poglavlje 2.13, Licence. Za Community nije potrebna licenca. |
| Adresa i sertifikat | Javna adresa odgovara sertifikatom čiji je lanac potpun. |
| Rezervne kopije | Postavljen raspored pravljenja rezervnih kopija, sa odredištem u koje se može upisivati. |
| Prijava preko kompanije | Povezana i testirana. Do tada ljudi koriste pristupne ključeve. |
| Pošta | Postavljen server za poštu. Do tada pozivnice ne mogu da se šalju. |
| AI model | AI (veštačka inteligencija) model: ključ modela organizacije ili model na vašem sopstvenom hardveru. Do tada asistent čeka. Poglavlje 2.14, AI dobavljači i modeli. |
Pozovite ljude se otvara kada je svih šest ispunjeno.
Ista stranica navodi šta postaje fiksno kada se ljudi prijave, uz razlog za svaku stavku: kratak naziv u adresama, mesto čuvanja podataka i čuvar ključeva (ključevi mogu da pređu sa softverskog čuvara na hardverski, nikada nazad). Naveden je i naziv organizacije, jer ga vredi proveriti, iako može da se promeni.
Nexus neće odgovoriti ni na čiji AI zahtev dok organizacija nema model. Iza instalacije ne postoji zajednički ključ niti rezervna opcija, pa organizacija bez ključa modela dobija jasno odbijanje koje administratoru govori šta treba da doda.
Kompanijsko prijavljivanje
Većina organizacija želi da se ljudi prijavljuju nalozima koje već imaju. Povežite svog dobavljača identiteta na stranici za prijavu preko kompanije: preko OIDC (OpenID Connect) na Community izdanju, ili preko OIDC ili SAML (Security Assertion Markup Language) na Enterprise izdanju.
- Izaberite dobavljača i standard koji koristi.
- Unesite identitet aplikacije i tajnu aplikacije koje vam je dao dobavljač identiteta. Tajna se nikada više ne prikazuje nakon što je sačuvate.
- Navedite ko sme da se prijavi, na primer svako sa adresom
@harrow.example. - Pritisnite Testirajte prijavu i prijavite se kao vi. Rezultat rečima navodi ko se prijavio i šta je dobavljač poslao.
- Sačuvajte.
Community dobija jednu prijavu preko kompanije za organizaciju. Enterprise dodaje obavezno sprovođenje i sinhronizaciju direktorijuma. Obavezno sprovođenje isključuje lozinke, tako da svi moraju da koriste prijavu preko kompanije, a pokušaj prijave lozinkom se odbija sa SSO_REQUIRED i dugmetom koje vodi na pravi način prijave. Sinhronizacija direktorijuma kopira ljude i grupe iz vašeg direktorijuma svakih 15 minuta i može da napravi administratore iz jedne imenovane grupe.
Kada prijava preko kompanijskog naloga prestane da odgovara, osobe koje su već prijavljene ostaju prijavljene, a nova prijava se odbija uz IDP_UNREACHABLE (503). Administrator tada može da koristi hitnu administratorsku prijavu iz sefa, zajedno sa svojim passkey ključem. Svaka upotreba se upisuje u dnevnik revizije, o njoj se obaveštavaju svi administratori i završava se nakon četiri sata ili kada se prijava preko kompanijskog naloga vrati.
Pozovite ljude
Kada je pošta podešena, pozovite osobe sa stranice Osobe. Za svaku navedite e-adresu i ulogu:
- Član koristi sve što organizacija ima i ne menja nijedno podešavanje.
- Administrator takođe upravlja osobama, modelima, budžetima i podešavanjima.
Pozivnica važi 7 dana. Osoba je otvara, vidi ko ju je pozvao, svoju ulogu i šta će videti, i prijavljuje se. Pri prvoj prijavi traži se druga provera.
Pozvani članovi se prijavljuju u konzolu i tamo obavljaju svakodnevni rad: Danas, asistent, timsko ćaskanje, datoteke i pretraga, beležnice, agenti i tokovi rada, u meri u kojoj im uloga dozvoljava. Administratori vide i administrativne stranice. Član koji otvori administratorsku stranicu dobija stranicu „Niste administrator“. Ona prikazuje podešavanja samo za čitanje, objašnjava razlog i nudi mogućnost da se zatraži pomoć administratora.
Registracije zahtevaju odobrenje
Osobe mogu i same da zatraže pridruživanje tako što se registruju. Na instalaciji, registracija nepoznate osobe ne stvara funkcionalan nalog. nexus-auth je odbija uz SIGNUP_REQUIRES_APPROVAL (403) i zadržava je do odobrenja administratora.
Na Adverant hostovanoj usluzi postoje još dve kontrole registracije, koje su isključene na svakoj instalaciji i ne postoji vrednost kojom bi se uključile. Internet CAPTCHA bi zahtevala pristup internetu pri svakoj registraciji. Mrežna provera pri registraciji bi zahtevala licenciranu bazu podataka za geolokaciju koju instalacija ne sadrži. Odobrenje je kapija instalacije.
Ponovni pokušaji, istekli kodovi i druga odbijanja
Svako odbijanje tokom prvog pokretanja navodi šta se dogodilo, da se ništa nije promenilo kada je to tačno, i šta treba uraditi sledeće.
| Kod | Status | Kada | Šta učiniti |
|---|---|---|---|
CLAIM_CODE_EXPIRED |
410 | Prošlo je 30 minuta. Ništa nije preuzeto i ništa se nije promenilo. | Napravite novi kod pomoću nexusctl claim-code --administrator <email>, zatim pritisnite Imam novi kod. |
CLAIM_FINGERPRINT_MISMATCH |
403 | Poslati otisak ne pripada ovoj instalaciji. | Stanite. Proverite adresu i sertifikat. |
TRANSITION_NOT_PERMITTED |
409 | Ponovo je zatražen korak koji je već obavljen: preuzimanje već preuzete instalacije ili prvi administrator po drugi put. | Prijavite se u konzolu; prvi administrator dodaje sve ostale. |
TRANSITION_NOT_PERMITTED |
409 | Korak za passkey ključ, iz pregledača u kojem ne čeka nijedan prvi administrator, ili nakon isteka njegovih deset minuta. | Pogledajte u nastavku. |
RATE_LIMITED |
429 | Previše pokušaja na stranicama prvog pokretanja u jednom minutu. Ništa nije poslato. | Sačekajte onoliko sekundi koliko stranica navodi, a zatim pokušajte ponovo. |
Za kod bez preostalih pokušaja prikazuje se „Ovaj kod nema preostalih pokušaja“. Napravite novi, isto kao za istekli kod. To može samo neko ko ima pristup klasteru, i upravo je to svrha.
Stranice prvog pokretanja ukupno prihvataju 20 pokušaja u minutu. Ako Vi niste napravili te pokušaje, neko drugi na Vašoj mreži pokušava da pristupi stranici, i to je vredno znati.
Kada je korak za passkey ključ propušten
Ako je prvi administrator kreiran, ali passkey ključ nije napravljen u roku od deset minuta, ili je pregledač zatvoren, administrator postoji bez ikakvog načina da se prijavi. Korak za passkey ključ odgovara sa TRANSITION_NOT_PERMITTED i rečima „Ako ste prvog administratora napravili u ovom pregledaču pre više od deset minuta, obratite se operateru: administrator postoji i još nema passkey ključ“. Preuzimanje je u tom trenutku iskorišćeno, pa novi kod za preuzimanje neće pomoći. Obratite se operateru koji je izvršio instalaciju pre nego što se bilo šta drugo pokuša.
Kada je pregledač izgubio preuzimanje
Preuzimanje se čuva u pregledaču koji ga je izvršio, u kolačiću koji stranica ne može da pročita. Ako ga taj pregledač izgubi između preuzimanja i kreiranja prvog administratora, na primer u privatnom prozoru koji je zatvoren, obrazac za prvog administratora prihvata i datoteku preuzimanja i njenu tajnu za podešavanje, ručno nalepljene.
Kada je Aoife dobila svoj passkey ključ, Tomás je zatvorio svoj terminal. Stranica za preuzimanje je bila isključena, prvi administrator je postojao, a svaki drugi način pristupa sada je vodio preko nje.






