AutentificareProgramați o prezentare

Capitolul 2.12

Prima rulare

De la o instalare nerevendicată la oameni care lucrează. Generați codul de revendicare, revendicați instalarea într-un browser, creați primul administrator cu o cheie de acces (passkey), apoi conectați autentificarea companiei și invitați restul persoanelor.

Această pagină a fost tradusă cu ajutorul IA din originalul în limba engleză. Dacă există neclarități, pagina în limba engleză rămâne cea de referință. Citiți această pagină în limba engleză

18 minute de lectură

Când o instalare se termină, instanța instalată nu aparține nimănui. Nu are nicio organizație, nicio persoană și nicio sesiune, iar nimeni nu se poate conecta. Așteaptă ca o persoană să dovedească, într-un browser, că comunică cu instalarea care tocmai a fost creată. La Harrow Port Authority, acea persoană a fost Aoife Brennan, șefa departamentului IT, avându-l alături, la terminal, pe Tomás Reilly. Acest capitol urmărește primele lor douăzeci de minute.

Ordinea este fixă, iar fiecare pas îl închide definitiv pe cel dinaintea lui: revendicați instalarea, creați primul administrator și organizația, configurați o cheie de acces (passkey) și ajungeți pe pagina Astăzi. După aceea urmează cele șase aspecte de pregătit, conectarea la nivelul companiei și invitarea tuturor celorlalți, în orice ordine vă convine.

Un lanț de casete de la stânga la dreapta: „nexusctl claim-code (terminal)”, „Revendicați această instalare (browser: cod + amprentă)”, „Primul administrator și organizația”, „Cheie de acces (a doua verificare)”, „Astăzi, când totul este nou”, „Șase lucruri înainte ca cineva să se conecteze”, „Invitați persoane”. Sub caseta de revendicare, coboară două ramificații roșii: „cod prea vechi: CLAIM_CODE_EXPIRED, generați un cod nou” și „amprentele diferă: CLAIM_FINGERPRINT_MISMATCH, opriți-vă”. O linie subțire sub primele trei casete are eticheta „fiecare pas îl dezactivează definitiv pe cel dinaintea lui”.
Prima rulare, de la terminal la prima pagină Astăzi, și cele două locuri în care se poate opri.

Generați codul de revendicare

Codul de revendicare dovedește că persoana din fața browserului poate vedea și terminalul cuiva care are acces la cluster. Doar o astfel de persoană poate genera unul. Rulați această comandă acolo unde fișierul dvs. kubeconfig are acces la cluster:

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

nexusctl claim-code îi cere serviciului de chei al instalării, nexus-keys, să genereze codul. Fără nexusctl, aceeași comandă rulează în propriul pod al serviciului de chei:

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

--source reprezintă câteva cuvinte care indică cine a generat codul. Pagina de revendicare le afișează sub „Creat de”, astfel încât persoana care face revendicarea să știe de unde provine codul.

 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

Trei aspecte legate de cod sunt importante.

  • Este valabil 30 de minute. Un cod văzut peste umărul cuiva devine în scurt timp inutil.
  • Permite 5 încercări. După a cincea încercare greșită, este epuizat, indiferent de timpul rămas.
  • Este pentru o singură persoană. Adresa de e-mail pe care o furnizați este cea a primului administrator. Aceasta însoțește revendicarea, iar formularul primului administrator o afișează ca fiind fixă, fără a mai fi introdusă din nou.

Amprenta este formată din opt grupuri de câte patru caractere, reprezentând identitatea proprie a instalării. Lăsați-o pe ecran. O veți compara, grup cu grup, în browser.

Revendicați instalarea

  1. Pe computerul pe care îl veți folosi ca prim administrator, deschideți adresa de instalare a consolei, aici https://console.harrow.example/install. Aceasta vă trimite la pagina potrivită pentru starea instalării: pagina de revendicare cât timp este deschisă, pagina primului administrator odată ce a fost revendicată și consola dacă sunteți deja conectat.
  2. În Revendicați această instalare, introduceți codul în Grupul unu, Grupul doi și Grupul trei, câte un grup de patru în fiecare.
  3. Comparați Amprenta acestei instalări de pe pagină cu cea din terminal, toate cele opt grupuri, pe rând.
  4. Dacă fiecare grup corespunde, bifați Toate cele opt grupuri corespund cu ceea ce afișează terminalul meu.
  5. Apăsați Revendicați această instalare, iar pagina confirmă revendicarea și vă trimite mai departe la configurarea primului administrator.
Revendică această instalare
Revendică această instalare
Pagina de revendicare. Codul se introduce în trei grupuri, amprenta completă este afișată în opt grupuri de câte patru pentru a fi comparată cu terminalul, iar caseta din dreapta indică de unde provine codul și câte încercări au mai rămas.

Revendicarea face trei lucruri. Face din acest browser singurul loc în care poate fi creat primul administrator. Înregistrează cine a revendicat instalarea și când, în jurnalul de audit. Și dezactivează definitiv pagina de revendicare. Din acel moment, adresa de revendicare răspunde că instalarea a fost revendicată.

Dacă amprenta nu corespunde, opriți-vă

O amprentă diferită înseamnă că o altă instalare răspunde la această adresă. Poate fi o adresă scrisă greșit, o înregistrare DNS (Domain Name System) învechită sau o mașină configurată pentru a intercepta primul administrator. Dacă ați revendica-o, acea mașină ar deține organizația dvs.

Nu revendicați și nu introduceți codul pe acea pagină. Închideți pagina, apoi verificați două lucruri: că console.harrow.example se rezolvă către ingress-ul dvs. și că certificatul afișat de browser este emis de CA (autoritatea de certificare) la care vă așteptați. Propria dvs. instalare este neschimbată și încă nerevendicată.

Dacă o revendicare este trimisă cu o amprentă care nu aparține instalării, serviciul de chei o refuză cu CLAIM_FINGERPRINT_MISMATCH (403). Nimic nu este revendicat. Pagina afișează apoi cele două amprente una lângă alta, având marcate grupurile care diferă, precum și pașii pentru verificarea adresei și a certificatului.

Amprenta nu corespunde
Amprenta nu corespunde
Pagina la care duce o amprentă care nu corespunde. Grupurile diferite sunt marcate, iar pașii verifică adresa și certificatul înainte ca orice altceva să fie introdus.

Creați primul administrator și organizația

Pagina care urmează are titlul „Două formulare scurte, apoi ați intrat”. Primul administrator îi poate adăuga pe toți ceilalți, și aproape tot ce este aici poate fi modificat ulterior. Două lucruri nu pot fi modificate, iar pagina le marchează.

Câmp Ce se introduce Se poate modifica ulterior?
Nume complet Numele dvs. Da
E-mail de serviciu Adresa pentru care a fost generat codul de revendicare, afișată și fără a mai fi introdusă din nou Este adresa administratorului
Rol în Nexus Administrator al organizației. Prima persoană este întotdeauna administrator. Nu se alege aici
A doua verificare Cheie de acces (passkey) pe acest laptop Da, pot fi adăugate mai multe
Nume (al organizației) Harrow Port Authority Da
Țară Unde își are sediul organizația Da
Nume scurt în adrese Format din nume, cum ar fi harrow-port-authority Nu. Linkurile și exporturile îl folosesc.
Unde sunt păstrate datele Această instalare Nu. Modificarea ulterioară înseamnă o nouă instalare.
Limbă și date calendaristice Engleză (Regatul Unit), cu data de astăzi Da
Fus orar Fusul orar al serverului Fiecare persoană vede orele în propriul său fus orar

Numele scurt este format din litere mici, cifre și cratime, având până la 100 de caractere, generat din numele organizației fără diacritice. Verificați-l înainte de a apăsa pe orice. Acesta apare în fiecare link pe care utilizatorii îl distribuie și în fiecare export pe care îl fac, atât timp cât organizația există.

De asemenea, setați o parolă pe această pagină. Aceasta nu este niciodată suficientă singură: un administrator nu se conectează niciodată doar cu o parolă. A doua verificare, de mai jos, este cea care vă conectează.

În același timp, este creată o metodă de conectare de urgență pentru administrator. Este sigilată și tipărită o singură dată, pentru a fi pusă în seif. Funcționează doar atunci când conectarea la nivelul companiei este nefuncțională, iar fiecare utilizare este înregistrată și anunțată tuturor administratorilor. Puneți-o în seif în ziua în care o tipăriți.

Pagina menționează, de asemenea, că Adverant nu este informat cine sunteți. Aceste detalii rămân pe instalare. O licență indică numele companiei, niciodată persoanele din cadrul acesteia.

Apăsați Creați și conectați-vă. Crearea administratorului și a organizației durează câteva secunde. Pagina răspunde „Creat pentru aoife.brennan@harrow.example. Acum configurați cheia de acces: este modul în care vă conectați.”

Primul administrator
Primul administrator
Primul administrator și organizația pe o singură pagină. Cele două opțiuni care nu pot fi modificate niciodată, numele scurt și locul unde sunt păstrate datele, menționează acest lucru lângă câmp, iar conectarea de urgență este sigilată pentru seif.

Cheia de acces (passkey): a doua verificare

  1. Apăsați Configurați cheia de acces și conectați-vă.
  2. Browserul vă solicită să creați o cheie de acces. Pe un laptop cu Touch ID sau Windows Hello, confirmați cu amprenta, fața sau codul PIN. Dacă computerul nu poate crea singur o cheie de acces, browserul afișează un cod QR (quick response): îndreptați camera telefonului spre acesta și urmați instrucțiunile de pe telefon.
  3. Pagina răspunde „Cheia dvs. de acces este configurată și sunteți conectat ca aoife.brennan@harrow.example.” și deschide consola.

Aveți la dispoziție zece minute de la apăsarea Creați și conectați-vă pentru a crea cheia de acces, în același browser. După aceea, configurarea se închide, iar administratorul există fără cheie de acces. Un operator trebuie să intervină, așa cum este descris mai jos la secțiunea despre reîncercări.

Din acest moment, primul administrator se conectează cu acea cheie de acces. Parola unui administrator cu drepturi depline, introdusă singură, nu creează niciodată o sesiune: serviciul de conectare răspunde cu o solicitare pentru a doua verificare. Aceasta este o caracteristică de proiectare și motivul pentru care cheia de acces este importantă. O cheie de acces pierdută înseamnă o cale de acces pierdută, așa că adăugați o a doua cheie, pe un telefon sau pe o cheie de securitate fizică, încă din prima zi.

Ulterior, persoanele se conectează la instalare cu o cheie de acces, cu Google, cu GitHub sau cu sistemul de conectare al companiei lor, în funcție de ceea ce permite organizația.

Cod Ce înseamnă Ce trebuie să faceți
PASSKEY_UNSUPPORTED Acest browser nu poate crea o cheie de acces. Nimic nu a fost configurat. Deschideți pagina într-un browser care acceptă chei de acces, pe același computer.
PASSKEY_CANCELLED Fereastra de solicitare a fost închisă sau nu s-a făcut nicio alegere în timp util. Nimic nu a fost trimis. Apăsați din nou butonul.

Prima pagină Astăzi

Consola se deschide pe pagina Astăzi, iar în prima zi aproape totul pe ea este gol. Fiecare zonă goală indică ce va apărea acolo și oferă butonul care o inițiază; astfel, „Necesită un administrator” indică faptul că solicitările vor aștepta acolo odată ce persoanele se alătură, având alături butonul Invitați persoane. Lista de verificare pentru configurare arată câți dintre pașii săi sunt finalizați, în orice ordine. Singurul istoric real, configurarea în sine, se află deja sub „Ce s-a schimbat”: instalarea configurată și cheia de acces a primului administrator creată.

Astăzi, când totul este nou
Astăzi, când totul este nou
Pagina Astăzi în prima zi. Fiecare zonă goală indică ce va apărea acolo și cum să o inițiați, iar „Ce s-a schimbat” conține deja configurarea în sine.

Șase lucruri înainte ca cineva să se autentifice

Pagina Șase lucruri înainte ca cineva să se conecteze enumeră condițiile care trebuie îndeplinite înainte ca persoanele să fie invitate. Nu este un asistent pas-cu-pas (wizard). Parcurgeți-le în orice ordine, iar pagina le numără („Trei din șase îndeplinite”).

Element Ce îl face îndeplinit
Licență O licență Enterprise importată. Capitolul 2.13, Licențe. Ediția Community nu necesită licență.
Adresă și certificat Adresa publică răspunde cu un certificat al cărui lanț este complet.
Copii de rezervă Un program de copii de rezervă setat, cu o destinație pe care se poate scrie.
Conectare la nivelul companiei Conectată și testată. Până atunci, persoanele folosesc chei de acces.
E-mail Un server de e-mail setat. Până atunci, invitațiile nu pot fi trimise.
Model de IA Un model de IA (inteligență artificială): o cheie de model a organizației sau un model pe propriul dvs. hardware. Până atunci, asistentul așteaptă. Capitolul 2.14, Furnizori și modele de IA.

Invitați persoane devine disponibil când toate cele șase condiții sunt îndeplinite.

Aceeași pagină enumeră ceea ce devine fix odată ce persoanele se conectează, împreună cu motivul pentru fiecare: numele scurt în adrese, locul unde sunt păstrate datele și custodele cheilor (cheile pot fi mutate de la un custode software la unul hardware, dar niciodată invers). Numele organizației este de asemenea enumerat, deoarece merită verificat, deși poate fi modificat.

Nexus nu va răspunde la nicio solicitare de IA până când organizația nu are un model. Nu există nicio cheie partajată în spatele unei instalări și nicio variantă de rezervă, astfel încât o organizație fără o cheie de model primește un refuz explicit care îi indică administratorului ce trebuie să adauge.

Șase lucruri înainte ca cineva să se conecteze
Șase lucruri înainte ca cineva să se autentifice
Șase verificări în orice ordine, numărate în cuvinte. Opțiunile care devin fixe odată ce persoanele se conectează sunt enumerate împreună cu motivul, astfel încât nimeni să nu afle abia mai târziu.

Autentificarea companiei

Majoritatea organizațiilor doresc ca persoanele să se conecteze cu conturile pe care le au deja. Conectați furnizorul dvs. de identitate pe pagina de conectare la nivelul companiei: prin OIDC (OpenID Connect) în ediția Community, sau prin OIDC sau SAML (Security Assertion Markup Language) în ediția Enterprise.

  1. Alegeți furnizorul și standardul pe care îl utilizează.
  2. Introduceți identitatea aplicației și secretul aplicației pe care vi le-a oferit furnizorul de identitate. Secretul nu mai este afișat niciodată după ce îl salvați.
  3. Specificați cine se poate conecta, de exemplu oricine are o adresă @harrow.example.
  4. Apăsați Testați conectarea și conectați-vă cu propriul cont. Rezultatul indică, în cuvinte, cine s-a conectat și ce a trimis furnizorul.
  5. Salvați.

Ediția Community primește o singură metodă de conectare la nivelul companiei pentru organizație. Ediția Enterprise adaugă impunerea (enforcement) și sincronizarea directorului. Impunerea dezactivează parolele, astfel încât toată lumea trebuie să utilizeze conectarea la nivelul companiei, iar o încercare cu parolă este refuzată cu SSO_REQUIRED și un buton către calea corectă de acces. Sincronizarea directorului copiază persoanele și grupurile din directorul dvs. la fiecare 15 minute și poate desemna administratori dintr-un grup specificat.

Când conectarea la nivelul companiei nu mai răspunde, persoanele deja conectate rămân conectate, iar o nouă conectare este refuzată cu IDP_UNREACHABLE (503). Un administrator poate utiliza atunci conectarea de urgență pentru administrator din seif, împreună cu cheia sa de acces. Fiecare utilizare este scrisă în jurnalul de audit, anunțată fiecărui administrator și se încheie după patru ore sau când conectarea la nivelul companiei își revine.

Conectați furnizorul dvs. de identitate
Conectați furnizorul dvs. de identitate
Conectarea la nivelul companiei cu un test. Furnizorul, standardul scris cu caractere mici și o conectare de test al cărei rezultat este scris în cuvinte înainte ca cineva să se bazeze pe ea.

Invitați persoane

Cu serviciul de e-mail configurat, invitați persoane din pagina Persoane. Pentru fiecare, furnizați adresa de e-mail și un rol:

  • Membrul utilizează tot ce are organizația și nu modifică nicio setare.
  • Administratorul gestionează, de asemenea, persoanele, modelele, bugetele și setările.

O invitație este valabilă 7 zile. Persoana o deschide, vede cine a invitat-o, rolul său și ce va vedea, și se conectează. O a doua verificare este solicitată la prima sa conectare.

Membrii invitați se conectează la consolă și își desfășoară activitatea zilnică acolo: Astăzi, asistentul, chatul de echipă, fișierele și căutarea, caietele (notebooks), agenții și fluxurile de lucru, în funcție de ceea ce le permite rolul. Administratorii văd și paginile de administrare. Un membru care deschide o pagină de administrator primește pagina „Nu sunteți administrator”. Aceasta afișează setările doar în citire, explică motivul și oferă opțiunea de a solicita ajutorul unui administrator.

Invită un coleg
Invită un coleg
O invitație stabilește rolul persoanei înainte ca aceasta să sosească, Membru sau Administrator, și poate conține o scurtă notă.

Înregistrările necesită aprobare

Persoanele pot solicita să se alăture și înregistrându-se singure. Pe o instalare, înregistrarea unui străin nu creează un cont funcțional. Serviciul nexus-auth o refuză cu SIGNUP_REQUIRES_APPROVAL (403) și o reține pentru aprobarea unui administrator.

Alte două controale de înregistrare există pe serviciul găzduit al Adverant și sunt dezactivate pe fiecare instalare, fără nicio valoare pentru a le activa. Sistemul CAPTCHA prin internet ar necesita acces la internet la fiecare înregistrare. Filtrul de rețea la înregistrare ar necesita o bază de date de geolocalizare licențiată, pe care instalarea nu o include. Aprobarea este poarta de acces a instalării.

Reîncercări, coduri expirate și alte refuzuri

Fiecare refuz din timpul primei rulări indică ce s-a întâmplat, faptul că nimic nu s-a modificat acolo unde acest lucru este valabil, și ce trebuie făcut în continuare.

Cod Stare Când Ce trebuie să faceți
CLAIM_CODE_EXPIRED 410 Cele 30 de minute au trecut. Nimic nu a fost revendicat și nimic nu s-a modificat. Generați un cod nou cu nexusctl claim-code --administrator <email>, apoi apăsați Am un cod nou.
CLAIM_FINGERPRINT_MISMATCH 403 Amprenta trimisă nu aparține acestei instalări. Opriți-vă. Verificați adresa și certificatul.
TRANSITION_NOT_PERMITTED 409 Un pas care a avut deja loc a fost solicitat din nou: revendicarea pe o instalare deja revendicată sau crearea primului administrator pentru a doua oară. Conectați-vă la consolă; primul administrator îi adaugă pe toți ceilalți.
TRANSITION_NOT_PERMITTED 409 Pasul pentru cheia de acces, dintr-un browser în care nu așteaptă niciun prim administrator, sau după expirarea celor zece minute. Consultați mai jos.
RATE_LIMITED 429 Prea multe încercări pe paginile primei rulări într-un minut. Nimic nu a fost trimis. Așteptați numărul de secunde indicat de pagină, apoi încercați din nou.

Un cod fără încercări rămase afișează „Acest cod nu mai are încercări rămase”. Generați unul nou, la fel ca pentru un cod expirat. Doar cineva cu acces la cluster poate face acest lucru, ceea ce este și scopul.

Paginile primei rulări acceptă împreună 20 de încercări pe minut. Dacă nu dvs. ați făcut acele încercări, altcineva din rețeaua dvs. încearcă să acceseze pagina, iar acest lucru merită știut.

Când pasul pentru cheia de acces a fost ratat

Dacă primul administrator a fost creat, dar nu a fost configurată nicio cheie de acces în decurs de zece minute, sau dacă browserul a fost închis, administratorul există fără nicio modalitate de a se conecta. Pasul pentru cheia de acces răspunde TRANSITION_NOT_PERMITTED cu mesajul „Dacă ați creat primul administrator în acest browser acum mai bine de zece minute, apelați la un operator: administratorul există și nu are încă o cheie de acces”. Revendicarea este consumată în acel moment, astfel încât un nou cod de revendicare nu va ajuta. Apelați la operatorul care a rulat instalarea înainte de a încerca orice altceva.

Când browserul a pierdut revendicarea

Revendicarea este păstrată în browserul care a efectuat-o, într-un cookie pe care pagina nu îl poate citi. Dacă acel browser îl pierde între momentul revendicării și cel al creării primului administrator, de exemplu într-o fereastră privată care a fost închisă, formularul primului administrator acceptă, de asemenea, fișierul de revendicare și secretul său de configurare, lipite manual.

Odată ce Aoife a avut cheia sa de acces, Tomás a închis terminalul. Pagina de revendicare era dezactivată, primul administrator exista, iar orice altă cale de acces trecea acum prin ea.