Versija 1.0.0-alpha.1naujausia
2.12 skyrius
Pirmasis paleidimas
Nuo neperimto diegimo iki dirbančių žmonių. Sukurkite perėmimo kodą, perimkite diegimą naršyklėje, sukurkite pirmąjį administratorių su prieigos raktu, tada prijunkite įmonės prisijungimo sistemą ir pakvieskite visus kitus.
Šį puslapį iš originalo anglų kalba išvertė DI. Jei kas nors neaišku, remkitės puslapiu anglų kalba. Skaityti šį puslapį anglų kalba

Pasibaigus diegimui, diegimas nepriklauso niekam. Jame nėra nei organizacijos, nei asmens, nei seanso, ir niekas negali prisijungti. Jis laukia, kol vienas asmuo naršyklėje įrodys, kad kreipiasi į ką tik atliktą diegimą. „Harrow Port Authority“ toks asmuo buvo IT vadovė Aoife Brennan, o šalia jos prie terminalo sėdėjo Tomás Reilly. Šiame skyriuje aprašomos pirmosios dvidešimt jų darbo minučių.
Tvarka yra griežtai nustatyta, ir kiekvienas žingsnis visam laikui uždaro ankstesnįjį: priskirkite diegimą sau, sukurkite pirmąjį administratorių ir organizaciją, nustatykite prieigos raktą ir pateksite į puslapį „Šiandien“. Po to seka šeši dalykai, kuriuos reikia paruošti, įmonės prisijungimas ir visų kitų pakvietimas jums patogia tvarka.
Sukurkite perėmimo kodą
Priskyrimo kodas įrodo, kad priešais naršyklę esantis asmuo taip pat mato terminalą asmens, turinčio prieigą prie klasterio. Tik toks asmuo gali jį sugeneruoti. Paleiskite tai ten, kur jūsų „kubeconfig“ pasiekia klasterį:
nexusctl claim-code --administrator aoife.brennan@harrow.examplenexusctl claim-code paprašo diegimo raktų tarnybos, nexus-keys, sugeneruoti kodą. Be nexusctl ta pati komanda vykdoma pačiame raktų tarnybos pode:
kubectl -n nexus exec deploy/nexus-keys -- nexus-keys claim-code \
--administrator aoife.brennan@harrow.example --source "Tomás Reilly, ops terminal"--source yra keli žodžiai, nurodantys, kas sukūrė kodą. Priskyrimo puslapyje jie rodomi po „Sukūrė“, todėl priskyrimą atliekantis asmuo žino, iš kur gautas kodas.
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
Svarbūs trys su kodu susiję dalykai.
- Jis galioja 30 minučių. Per petį pamatytas kodas greitai tampa bevertis.
- Jis leidžia 5 bandymus. Po penkto neteisingo bandymo jis tampa nebegaliojančiu, nepriklausomai nuo laiko.
- Jis skirtas vienam asmeniui. Jūsų nurodytas el. pašto adresas yra pirmojo administratoriaus. Jis perduodamas kartu su priskyrimu, o pirmojo administratoriaus formoje rodomas kaip fiksuotas – jo nereikia įvesti iš naujo.
Kontrolinis kodas – tai aštuonios keturių simbolių grupės, paties diegimo tapatybė. Palikite jį ekrane. Naršyklėje jį palyginsite grupę po grupės.
Perimkite diegimą
- Kompiuteryje, kurį naudosite kaip pirmasis administratorius, atidarykite pulto diegimo adresą, čia
https://console.harrow.example/install. Jis nukreips jus į puslapį, atitinkantį diegimo būseną: priskyrimo puslapį, kol jis atviras, pirmojo administratoriaus puslapį, kai diegimas priskirtas, ir pultą, jei jau esate prisijungę. - Puslapyje Priskirti šį diegimą įveskite kodą į laukus Pirma grupė, Antra grupė ir Trečia grupė, po vieną keturių simbolių grupę kiekviename.
- Palyginkite puslapyje rodomą Šio diegimo kontrolinį kodą su terminalu – visas aštuonias grupes, vieną po kitos.
- Jei visos grupės sutampa, pažymėkite Visos aštuonios grupės sutampa su tuo, ką rodo mano terminalas.
- Paspauskite Priskirti šį diegimą – puslapis patvirtins priskyrimą ir nukreips jus į pirmojo administratoriaus kūrimo žingsnį.
Priskyrimas atlieka tris dalykus. Jis padaro šią naršyklę vienintele vieta, kurioje gali būti sukurtas pirmasis administratorius. Audito žurnale įrašoma, kas ir kada priskyrė diegimą. Be to, priskyrimo puslapis visam laikui išjungiamas. Nuo tada priskyrimo adresas atsako, kad diegimas jau priskirtas.
Jei kontrolinis kodas nesutampa, sustokite
Kitoks kontrolinis kodas reiškia, kad šiuo adresu atsako kitas diegimas. Tai gali būti klaidingai įvestas adresas, pasenęs DNS (domenų vardų sistemos) įrašas arba mašina, paruošta perimti pirmojo administratoriaus duomenis. Jei jį priskirtumėte, jūsų organizacija atsidurtų toje mašinoje.
Nepriskirkite ir neveskite kodo tame puslapyje. Uždarykite puslapį ir patikrinkite du dalykus: ar console.harrow.example nukreipia į jūsų įeigą (ingress) ir ar naršyklės rodomas sertifikatas yra išduotas tos CA (sertifikatų įstaigos), kurios tikitės. Jūsų paties diegimas lieka nepakitęs ir vis dar nepriskirtas.
Jei priskyrimo užklausa išsiunčiama su kontroliniu kodu, kuris nepriklauso šiam diegimui, raktų tarnyba ją atmeta su klaida CLAIM_FINGERPRINT_MISMATCH (403). Niekas nepriskiriama. Tada puslapyje vienas šalia kito parodomi abu kontroliniai kodai, pažymimos besiskiriančios grupės ir pateikiami žingsniai, kaip patikrinti adresą ir sertifikatą.
Sukurkite pirmąjį administratorių ir organizaciją
Toliau atsidarančio puslapio antraštė yra „Dvi trumpos formos, ir jūs jau viduje“. Pirmasis administratorius gali pridėti visus kitus, ir beveik viską čia vėliau bus galima pakeisti. Dviejų dalykų pakeisti negalima, ir puslapis juos pažymi.
| Laukas | Kas įvedama | Ar galima pakeisti vėliau? |
|---|---|---|
| Vardas ir pavardė | Jūsų vardas ir pavardė | Taip |
| Darbo el. paštas | Adresas, kuriam buvo sukurtas priskyrimo kodas; jis rodomas ir jo nereikia įvesti iš naujo | Tai administratoriaus adresas |
| Vaidmuo „Nexus“ sistemoje | Organizacijos administratorius. Pirmasis asmuo visada yra administratorius. | Čia nepasirenkama |
| Antrasis patikrinimas | Prieigos raktas šiame nešiojamajame kompiuteryje | Taip, galima pridėti daugiau |
| Pavadinimas (organizacijos) | Harrow Port Authority | Taip |
| Šalis | Kur įsikūrusi organizacija | Taip |
| Trumpasis pavadinimas adresuose | Sudaromas iš pavadinimo, pavyzdžiui, harrow-port-authority |
Ne. Jį naudoja nuorodos ir eksportuojami duomenys. |
| Kur laikomi duomenys | Šiame diegime | Ne. Norint tai pakeisti vėliau, reikės naujo diegimo. |
| Kalba ir datos | Anglų (JK), su šiandienos data | Taip |
| Laiko juosta | Serverio laiko juosta | Kiekvienas asmuo mato laiką pagal savo laiko juostą |
Trumpasis pavadinimas sudaromas iš mažųjų raidžių, skaitmenų ir brūkšnelių (iki 100 simbolių) pagal organizacijos pavadinimą, pašalinus diakritinius ženklus. Peržiūrėkite jį prieš ką nors spausdami. Jis bus matomas kiekvienoje nuorodoje, kuria dalijasi žmonės, ir kiekviename jų atliekamame eksporte tol, kol gyvuos organizacija.
Šiame puslapyje taip pat nustatote slaptažodį. Vieno jo niekada nepakanka: administratorius niekada neprisijungia vien tik slaptažodžiu. Jus prijungia žemiau esantis antrasis patikrinimas.
Tuo pačiu metu sukuriamas avarinis administratoriaus prisijungimas. Jis užantspauduojamas ir išspausdinamas vieną kartą, kad būtų padėtas į seifą. Jis veikia tik tada, kai neveikia įmonės prisijungimas, o kiekvienas panaudojimas yra registruojamas ir apie jį pranešama visiems administratoriams. Padėkite jį į seifą tą pačią dieną, kai išspausdinsite.
Puslapyje taip pat nurodoma, kad „Adverant“ nėra pranešama, kas jūs esate. Šie duomenys lieka diegime. Licencijoje nurodoma įmonė, bet niekada – joje dirbantys žmonės.
Paspauskite Sukurti ir prisijungti. Administratoriaus ir organizacijos sukūrimas trunka kelias sekundes. Puslapis atsako: „Sukurta aoife.brennan@harrow.example. Dabar nustatykite savo prieigos raktą: juo prisijungsite.“
Prieigos raktas: antrasis patikrinimas
- Paspauskite Nustatyti prieigos raktą ir prisijungti.
- Naršyklė paprašys sukurti prieigos raktą. Nešiojamajame kompiuteryje su „Touch ID“ arba „Windows Hello“ patvirtinkite piršto atspaudu, veidu arba PIN kodu. Jei kompiuteris pats negali sukurti prieigos rakto, naršyklė parodys QR (greitojo atsakymo) kodą: nukreipkite į jį telefono kamerą ir vykdykite telefone pateikiamus nurodymus.
- Puslapis atsako „Jūsų prieigos raktas nustatytas ir esate prisijungę kaip aoife.brennan@harrow.example.“ ir atidaro pultą.
Nuo Sukurti ir prisijungti paspaudimo turite dešimt minučių prieigos raktui sukurti toje pačioje naršyklėje. Po to sąranka uždaroma, ir administratorius lieka sukurtas be prieigos rakto. Tokiu atveju turi padėti operatorius, kaip aprašyta žemiau esančiame skyriuje apie pakartotinius bandymus.
Nuo šiol pirmasis administratorius prisijungia naudodamas tą prieigos raktą. Vien tik įvestas pilnateisio administratoriaus slaptažodis niekada nesukuria seanso: prisijungimo tarnyba atsako prašymu atlikti antrąjį patikrinimą. Tai yra architektūros savybė ir priežastis, kodėl prieigos raktas toks svarbus. Prarastas prieigos raktas reiškia prarastą galimybę prisijungti, todėl jau pirmąją dieną pridėkite antrąjį – telefone arba saugos rakte.
Vėliau žmonės prie diegimo jungiasi naudodami prieigos raktą, „Google“, „GitHub“ arba savo įmonės prisijungimą – priklausomai nuo to, ką leidžia organizacija.
| Kodas | Ką tai reiškia | Ką daryti |
|---|---|---|
PASSKEY_UNSUPPORTED |
Ši naršyklė negali sukurti prieigos rakto. Niekas nebuvo nustatyta. | Atidarykite puslapį naršyklėje, kuri palaiko prieigos raktus, tame pačiame kompiuteryje. |
PASSKEY_CANCELLED |
Užklausa buvo uždaryta arba laiku nieko nepasirinkta. Niekas nebuvo išsiųsta. | Paspauskite mygtuką dar kartą. |
Pirmasis puslapis „Šiandien“
Pultas atsidaro puslapyje „Šiandien“, ir pirmąją dieną beveik viskas jame yra tuščia. Kiekvienoje tuščioje srityje parašyta, kas ten atsiras, ir pateiktas mygtukas, kuris tai paleidžia; pavyzdžiui, skiltyje „Reikalingas administratorius“ nurodoma, kad čia lauks užklausos, kai prisijungs žmonės, o šalia yra mygtukas Pakviesti žmonių. Sąrankos kontroliniame sąraše rodoma, kiek žingsnių jau atlikta (bet kokia tvarka). Vienintelė tikra istorija – pati sąranka – jau yra skiltyje „Kas pasikeitė“: diegimas nustatytas ir pirmojo administratoriaus prieigos raktas sukurtas.
Šeši dalykai prieš kam nors prisijungiant
Puslapyje Šeši dalykai prieš kam nors prisijungiant išvardyta, kokios sąlygos turi būti išpildytos prieš kviečiant žmones. Tai nėra vedlys. Atlikite juos bet kokia tvarka, o puslapis juos skaičiuos („Išpildyta trys iš šešių“).
| Dalykas | Kas išpildo šią sąlygą |
|---|---|
| Licencija | Importuota „Enterprise“ licencija. 2.13 skyrius, Licencijos. „Community“ laidai licencijos nereikia. |
| Adresas ir sertifikatas | Viešasis adresas atsako sertifikatu, kurio grandinė yra pilna. |
| Atsarginės kopijos | Nustatytas atsarginių kopijų kūrimo tvarkaraštis ir paskirties vieta, į kurią galima įrašyti. |
| Įmonės prisijungimas | Prijungtas ir išbandytas. Iki tol žmonės naudoja prieigos raktus. |
| Paštas | Nustatytas pašto serveris. Iki tol kvietimų išsiųsti negalima. |
| DI modelis | DI (dirbtinio intelekto) modelis: organizacijos modelio raktas arba modelis jūsų pačių aparatinėje įrangoje. Iki tol asistentas laukia. 2.14 skyrius, DI teikėjai ir modeliai. |
Pakviesti žmonių atsidaro, kai išpildomos visos šešios sąlygos.
Tame pačiame puslapyje išvardyta, kas tampa nebekeičiama žmonėms prisijungus, ir nurodoma kiekvieno punkto priežastis: trumpasis pavadinimas adresuose, duomenų saugojimo vieta ir raktų saugotojas (raktus galima perkelti iš programinio saugotojo į aparatinę įrangą, bet niekada atgal). Organizacijos pavadinimas taip pat įtrauktas į sąrašą, nes jį verta patikrinti, nors vėliau jį ir galima pakeisti.
„Nexus“ neatsakys į jokią DI užklausą, kol organizacija neturės modelio. Diegime nėra jokio bendro vidinio rakto ir jokio atsarginio varianto, todėl organizacija, neturinti modelio rakto, gauna aiškų atmetimą, kuriame administratoriui nurodoma, ką reikia pridėti.
Įmonės prisijungimas
Dauguma organizacijų nori, kad žmonės prisijungtų naudodami jau turimas paskyras. Prijunkite savo tapatybės teikėją įmonės prisijungimo puslapyje: per OIDC (OpenID Connect) naudojant „Community“ laidą arba per OIDC ar SAML (Security Assertion Markup Language) naudojant „Enterprise“ laidą.
- Pasirinkite teikėją ir jo naudojamą standartą.
- Įveskite programos identifikatorių ir programos paslaptį, kuriuos jums suteikė tapatybės teikėjas. Išsaugojus paslaptį, ji daugiau niekada neberodoma.
- Nurodykite, kas gali prisijungti, pavyzdžiui, visi, turintys
@harrow.exampleadresą. - Paspauskite Išbandyti prisijungimą ir prisijunkite patys. Rezultate žodžiais nurodoma, kas prisijungė ir kokius duomenis atsiuntė teikėjas.
- Išsaugokite.
„Community“ laida suteikia vieną įmonės prisijungimą visai organizacijai. „Enterprise“ prideda priverstinį taikymą ir katalogo sinchronizavimą. Priverstinis taikymas išjungia slaptažodžius, todėl visi privalo naudoti įmonės prisijungimą, o bandymas prisijungti slaptažodžiu atmetamas su klaida SSO_REQUIRED ir mygtuku, nukreipiančiu į tinkamą prisijungimo būdą. Katalogo sinchronizavimas kas 15 minučių kopijuoja žmones ir grupes iš jūsų katalogo ir gali paskirti administratorius iš vienos nurodytos grupės.
Kai įmonės prisijungimas nustoja atsakyti, jau prisijungę žmonės lieka prisijungę, o naujas prisijungimas atmetamas su klaida IDP_UNREACHABLE (503). Tokiu atveju administratorius gali panaudoti avarinį administratoriaus prisijungimą iš seifo kartu su savo prieigos raktu. Kiekvienas panaudojimas įrašomas į audito žurnalą, apie jį pranešama kiekvienam administratoriui, o jo galiojimas baigiasi po keturių valandų arba kai vėl pradeda veikti įmonės prisijungimas.
Pakvieskite žmones
Nustatę paštą, kvieskite žmones puslapyje „Žmonės“. Kiekvienam nurodykite el. pašto adresą ir vaidmenį:
- Narys naudojasi viskuo, ką turi organizacija, ir nekeičia jokių nustatymų.
- Administratorius taip pat valdo žmones, modelius, biudžetus ir nustatymus.
Kvietimas galioja 7 dienas. Asmuo jį atidaro, mato, kas jį pakvietė, savo vaidmenį bei tai, ką matys prisijungęs, ir prisijungia.Pirmojo prisijungimo metu paprašoma atlikti antrąjį patikrinimą.
Pakviesti nariai prisijungia prie pulto ir ten atlieka savo kasdienį darbą: naudoja „Šiandien“, asistentą, komandos pokalbius, failus ir paiešką, užrašines, agentus ir darbo eigas, kiek tai leidžia jų vaidmuo. Administratoriai taip pat mato administravimo puslapius. Narys, atidaręs administratoriaus puslapį, pamato puslapį „Ne administratorius“. Jame nustatymai rodomi tik skaitymo režimu, paaiškinama kodėl, ir pasiūloma kreiptis į administratorių.
Registracijoms reikalingas patvirtinimas
Žmonės taip pat gali paprašyti prisijungti užsiregistruodami patys. Diegime pašalinio asmens registracija nesukuria veikiančios paskyros. „nexus-auth“ ją atmeta su klaida SIGNUP_REQUIRES_APPROVAL (403) ir sulaiko, kol patvirtins administratorius.
„Adverant“ talpinamoje paslaugoje yra dar dvi registracijos kontrolės priemonės, kurios kiekviename diegime yra išjungtos ir neturi nustatymo joms įjungti. Internetinei CAPTCHA patikrai kiekvienos registracijos metu reikėtų interneto ryšio. Registracijos tinklo patikrai reikėtų licencijuotos geografinės vietos duomenų bazės, kurios diegime nėra. Diegimo apsauga yra patvirtinimas.
Pakartotiniai bandymai, nebegaliojantys kodai ir kiti atmetimai
Kiekviename pirmojo paleidimo atmetimo pranešime nurodoma, kas nutiko, patvirtinama, kad niekas nepasikeitė (jei tai tiesa), ir pasakoma, ką daryti toliau.
| Kodas | Būsena | Kada | Ką daryti |
|---|---|---|---|
CLAIM_CODE_EXPIRED |
410 | Praėjo 30 minučių. Niekas nebuvo priskirta ir niekas nepasikeitė. | Sugeneruokite naują kodą naudodami nexusctl claim-code --administrator <email>, tada paspauskite Turiu naują kodą. |
CLAIM_FINGERPRINT_MISMATCH |
403 | Išsiųstas kontrolinis kodas nepriklauso šiam diegimui. | Sustokite. Patikrinkite adresą ir sertifikatą. |
TRANSITION_NOT_PERMITTED |
409 | Dar kartą paprašyta atlikti žingsnį, kuris jau buvo įvykdytas: priskirti jau priskirtą diegimą arba antrą kartą sukurti pirmąjį administratorių. | Prisijunkite pulte; pirmasis administratorius prideda visus kitus. |
TRANSITION_NOT_PERMITTED |
409 | Prieigos rakto žingsnis atidarytas naršyklėje, kurioje nelaukia joks pirmasis administratorius, arba praėjus jam skirtoms dešimčiai minučių. | Žr. žemiau. |
RATE_LIMITED |
429 | Per daug bandymų pirmojo paleidimo puslapiuose per vieną minutę. Niekas nebuvo išsiųsta. | Palaukite puslapyje nurodytą sekundžių skaičių ir bandykite dar kartą. |
Išnaudojus visus kodo bandymus, rodomas pranešimas „Šis kodas nebeturi bandymų“. Sugeneruokite naują kodą taip pat, kaip ir pasibaigus jo galiojimo laikui. Tai padaryti gali tik asmuo, turintis prieigą prie klasterio – tokia ir yra šio mechanizmo esmė.
Pirmojo paleidimo puslapiuose iš viso leidžiama atlikti 20 bandymų per minutę. Jei šiuos bandymus atlikote ne jūs, vadinasi, puslapį bando pasiekti kažkas kitas jūsų tinkle, ir tai verta žinoti.
Kai buvo praleistas prieigos rakto žingsnis
Jei pirmasis administratorius buvo sukurtas, bet per dešimt minučių nebuvo sukurtas prieigos raktas arba buvo uždaryta naršyklė, administratorius egzistuoja, tačiau neturi jokio būdo prisijungti. Prieigos rakto žingsnis atsako klaida TRANSITION_NOT_PERMITTED ir žodžiais: „Jei šioje naršyklėje sukūrėte pirmąjį administratorių prieš daugiau nei dešimt minučių, kreipkitės į operatorių: administratorius egzistuoja, bet dar neturi prieigos rakto“. Šiuo momentu priskyrimas jau yra išnaudotas, todėl naujas priskyrimo kodas nepadės. Prieš bandydami ką nors kita, kreipkitės į diegimą vykdžiusį operatorių.
Kai naršyklė prarado priskyrimą
Priskyrimas saugomas jį atlikusioje naršyklėje, slapuke, kurio pats puslapis negali perskaityti. Jei ta naršyklė jį praranda tarp priskyrimo ir pirmojo administratoriaus sukūrimo (pavyzdžiui, uždarius privatų langą), pirmojo administratoriaus forma taip pat priima rankiniu būdu įklijuotą priskyrimo failą ir jo sąrankos paslaptį.
Kai Aoife susikūrė savo prieigos raktą, Tomás uždarė savo terminalą. Priskyrimo puslapis buvo išjungtas, pirmasis administratorius sukurtas, ir visi kiti keliai į sistemą dabar ėjo per ją.






