Versioni 1.0.0-alpha.1më i fundit
Kapitulli 2.12
Nisja e parë
Nga një instalim i pamarrë në pronësi deri te njerëzit në punë. Krijoni kodin e marrjes në pronësi, merrni instalimin në pronësi në një shfletues, krijoni administratorin e parë me një çelës kalimi, pastaj lidhni identifikimin e kompanisë dhe ftoni të gjithë të tjerët.
Kjo faqe u përkthye nga AI prej origjinalit në anglisht. Nëse diçka është e paqartë, faqja në anglisht shërben si referencë. Lexoni këtë faqe në anglisht

Kur përfundon një instalim, instalimi nuk i përket askujt. Nuk ka organizatë, as person dhe as sesion, dhe askush nuk mund të identifikohet. Pret që një person të vërtetojë, në një shfletues, se po komunikon me instalimin që sapo u krye. Në Harrow Port Authority, ky person ishte Aoife Brennan, drejtuese e IT-së, me Tomás Reilly pranë saj në terminal. Ky kapitull ndjek njëzet minutat e tyre të para.
Radha është e pandryshueshme dhe çdo hap mbyll përgjithmonë atë para tij: merrni në pronësi instalimin, krijoni administratorin e parë dhe organizatën, konfiguroni një çelës kalimi (passkey) dhe mbërrini në faqen Sot (Today). Pas kësaj vijnë gjashtë gjërat që duhen bërë gati, identifikimi i kompanisë dhe ftesa për të gjithë të tjerët, në çfarëdo radhe që ju përshtatet.
Krijoni kodin e marrjes në pronësi
Kodi i marrjes në pronësi vërteton që personi përballë shfletuesit mund të shohë gjithashtu terminalin e dikujt me qasje në klaster. Vetëm një person i tillë mund ta krijojë një të tillë. Ekzekutojeni këtë aty ku kubeconfig juaj arrin klasterin:
nexusctl claim-code --administrator aoife.brennan@harrow.examplenexusctl claim-code i kërkon shërbimit të çelësave të instalimit, nexus-keys, të krijojë kodin. Pa nexusctl, e njëjta komandë ekzekutohet në pod-in e vetë shërbimit të çelësave:
kubectl -n nexus exec deploy/nexus-keys -- nexus-keys claim-code \
--administrator aoife.brennan@harrow.example --source "Tomás Reilly, ops terminal"--source përbëhet nga disa fjalë që tregojnë se kush e krijoi kodin. Faqja e marrjes në pronësi i shfaq ato nën "Krijuar nga", në mënyrë që personi që kryen marrjen në pronësi të dijë se nga erdhi kodi.
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 gjëra rreth kodit kanë rëndësi.
- Zgjat 30 minuta. Një kod i parë mbi supe të dikujt bëhet shpejt i padobishëm.
- Lejon 5 prova. Pas tentativës së pestë të gabuar ai konsumohet, pavarësisht kohës.
- Është për një person të vetëm. Email-i që jepni është i administratorit të parë. Ai shoqëron marrjen në pronësi dhe formulari i administratorit të parë e shfaq atë si të pandryshueshëm, pa u shkruar sërish.
Gjurma dixhitale përbëhet nga tetë grupe me nga katër karaktere, vetë identiteti i instalimit. Lëreni në ekran. Do ta krahasoni atë, grup pas grupi, në shfletues.
Merrni instalimin në pronësi
- Në kompjuterin që do të përdorni si administratori i parë, hapni adresën e instalimit të konsolës, këtu
https://console.harrow.example/install. Ajo ju dërgon në faqen e duhur për gjendjen e instalimit: faqja e marrjes në pronësi ndërsa është e hapur, faqja e administratorit të parë sapo të jetë marrë në pronësi, dhe konsola nëse jeni identifikuar tashmë. - Në Merrni në pronësi këtë instalim, shkruani kodin te Grupi një, Grupi dy dhe Grupi tre, nga një grup me katër në secilin.
- Krahasoni Gjurma dixhitale e këtij instalimi të faqes me terminalin, të tetë grupet, një nga një.
- Nëse çdo grup përputhet, shënoni Të tetë grupet përputhen me atë që tregon terminali im.
- Shtypni Merrni në pronësi këtë instalim, dhe faqja konfirmon marrjen në pronësi dhe ju dërgon më tej te administratori i parë.
Marrja në pronësi kryen tri gjëra. E bën këtë shfletues vendin e vetëm ku mund të krijohet administratori i parë. Regjistron në regjistrin e auditimit se kush e mori në pronësi instalimin dhe kur. Dhe e çaktivizon përgjithmonë faqen e marrjes në pronësi. Që nga ai moment, adresa e marrjes në pronësi përgjigjet se instalimi është marrë në pronësi.
Nëse gjurma dixhitale nuk përputhet, ndaloni
Një gjurmë tjetër dixhitale do të thotë se një instalim tjetër po përgjigjet në këtë adresë. Mund të jetë një adresë e shkruar gabim, një regjistrim i vjetruar DNS (Domain Name System), ose një makinë e konfiguruar për të kapur administratorin e parë. Nëse do ta merrnit në pronësi, ajo makinë do të mbante organizatën tuaj.
Mos e merrni në pronësi dhe mos e shkruani kodin në atë faqe. Mbylleni faqen, më pas kontrolloni dy gjëra: që console.harrow.example zgjidhet në ingress-in tuaj dhe që certifikata që shfaq shfletuesi është lëshuar nga CA (autoriteti certifikues) që prisni. Instalimi juaj është i pandryshuar dhe ende i pamarrë në pronësi.
Nëse dërgohet një kërkesë marrjeje në pronësi me një gjurmë dixhitale që nuk është e instalimit, shërbimi i çelësave e refuzon atë me CLAIM_FINGERPRINT_MISMATCH (403). Asgjë nuk merret në pronësi. Faqja më pas shfaq dy gjurmët dixhitale krah për krah me grupet që ndryshojnë të shënuara, si dhe hapat për të kontrolluar adresën dhe certifikatën.
Krijoni administratorin e parë dhe organizatën
Faqja që vijon titullohet "Dy formularë të shkurtër, pastaj jeni brenda". Administratori i parë mund të shtojë të gjithë të tjerët, dhe pothuajse gjithçka këtu mund të ndryshojë më vonë. Dy gjëra nuk mund të ndryshojnë, dhe faqja i shënon ato.
| Fusha | Çfarë vendoset | A mund të ndryshojë më vonë? |
|---|---|---|
| Emri i plotë | Emri juaj | Po |
| Email-i i punës | Adresa për të cilën u krijua kodi i marrjes në pronësi, e shfaqur dhe që nuk shkruhet sërish | Është adresa e administratorit |
| Roli në Nexus | Administrator i organizatës. Personi i parë është gjithmonë administrator. | Nuk zgjidhet këtu |
| Kontrolli i dytë | Çelës kalimi në këtë laptop | Po, mund të shtohen të tjerë |
| Emri (i organizatës) | Harrow Port Authority | Po |
| Shteti | Ku e ka selinë organizata | Po |
| Emri i shkurtër në adresa | I krijuar nga emri, si për shembull harrow-port-authority |
Jo. Lidhjet dhe eksportimet e përdorin atë. |
| Ku mbahen të dhënat | Ky instalim | Jo. Ndryshimi i tij më vonë nënkupton një instalim të ri. |
| Gjuha dhe datat | Anglisht (MB), me datën e sotme | Po |
| Zona kohore | Zona kohore e serverit | Çdo person i sheh oraret në zonën e vet |
Emri i shkurtër përbëhet nga shkronja të vogla, shifra dhe viza ndarëse, deri në 100 karaktere, i krijuar nga emri i organizatës duke hequr thekset. Shikojeni përpara se të shtypni ndonjë gjë. Ai shfaqet në çdo lidhje që njerëzit ndajnë dhe në çdo eksportim që ata bëjnë, për aq kohë sa organizata ekziston.
Ju gjithashtu caktoni një fjalëkalim në këtë faqe. Ai nuk është kurrë i mjaftueshëm i vetëm: një administrator nuk identifikohet kurrë vetëm me një fjalëkalim. Kontrolli i dytë, më poshtë, është ai që ju identifikon.
Në të njëjtën kohë krijohet një identifikim emergjence për administratorin. Ai vuloset dhe printohet një herë, për t'u mbajtur në kasafortë. Funksionon vetëm kur identifikimi i kompanisë nuk punon, dhe çdo përdorim regjistrohet dhe u njoftohet të gjithë administratorëve. Vendoseni në kasafortë ditën që e printoni.
Faqja thotë gjithashtu se Adverant nuk informohet se kush jeni ju. Këto detaje qëndrojnë në instalim. Një licencë mban emrin e kompanisë, kurrë të njerëzve në të.
Shtypni Krijo dhe identifikohu. Krijimi i administratorit dhe i organizatës zgjat disa sekonda. Faqja përgjigjet "Krijuar për aoife.brennan@harrow.example. Tani konfiguroni çelësin tuaj të kalimit: kjo është mënyra se si identifikoheni."
Çelësi i kalimit: kontrolli i dytë
- Shtypni Konfiguro çelësin e kalimit dhe identifikohu.
- Shfletuesi juaj ju kërkon të krijoni një çelës kalimi. Në një laptop me Touch ID ose Windows Hello, konfirmoni me gishtin, fytyrën ose PIN-in tuaj. Nëse kompjuteri nuk mund të krijojë vetë një çelës kalimi, shfletuesi shfaq një kod QR (quick response): drejtojeni kamerën e telefonit tuaj drejt tij dhe ndiqni udhëzimet në telefon.
- Faqja përgjigjet "Çelësi juaj i kalimit është konfiguruar dhe jeni identifikuar si aoife.brennan@harrow.example." dhe hap konsolën.
Keni dhjetë minuta nga Krijo dhe identifikohu për të krijuar çelësin e kalimit, në të njëjtin shfletues. Pas kësaj, konfigurimi mbyllet dhe administratori ekziston pa çelës kalimi. Një operator duhet të ndihmojë, siç përshkruhet nën riprovat më poshtë.
Që tani e tutje, administratori i parë identifikohet me atë çelës kalimi. Fjalëkalimi i një administratori të plotë, i shkruar i vetëm, nuk krijon kurrë një sesion: shërbimi i identifikimit përgjigjet me një kërkesë për kontrollin e dytë. Kjo është një veti e dizajnit dhe arsyeja pse çelësi i kalimit ka rëndësi. Një çelës kalimi i humbur është një mënyrë hyrjeje e humbur, ndaj shtoni një të dytë, në një telefon ose një çelës sigurie, që ditën e parë.
Më vonë, njerëzit identifikohen në instalim me një çelës kalimi, me Google, me GitHub ose me identifikimin e kompanisë së tyre, cilindo që lejon organizata.
| Kodi | Çfarë do të thotë | Çfarë duhet të bëni |
|---|---|---|
PASSKEY_UNSUPPORTED |
Ky shfletues nuk mund të krijojë një çelës kalimi. Asgjë nuk u konfigurua. | Hapni faqen në një shfletues që mbështet çelësat e kalimit, në të njëjtin kompjuter. |
PASSKEY_CANCELLED |
Kërkesa u mbyll ose asgjë nuk u zgjodh në kohë. Asgjë nuk u dërgua. | Shtypni butonin përsëri. |
Faqja e parë Today
Konsola hapet te Sot (Today), dhe në ditën e parë pothuajse gjithçka në të është bosh. Çdo hapësirë bosh tregon se çfarë do të shfaqet atje dhe jep butonin që e nis atë, kështu që "Kërkon një administrator" thotë se kërkesat do të presin atje sapo njerëzit të bashkohen, me Fto njerëz pranë tij. Lista e kontrollit të konfigurimit tregon se sa nga hapat e saj janë kryer, në çfarëdo radhe. I vetmi historik real, vetë konfigurimi, ndodhet tashmë nën "Çfarë ndryshoi": instalimi u konfigurua dhe çelësi i kalimit i administratorit të parë u krijua.
Gjashtë gjëra përpara se dikush të identifikohet
Faqja Gjashtë gjëra përpara se dikush të identifikohet rendit çfarë duhet të jetë e vërtetë përpara se të ftohen njerëzit. Nuk është një magjistar (wizard). Kryejini ato në çfarëdo radhe, dhe faqja i numëron ato ("Tri nga gjashtë të vërteta").
| Elementi | Çfarë e bën të vërtetë |
|---|---|
| Licenca | Një licencë Enterprise e importuar. Kapitulli 2.13, Licencat. Community nuk ka nevojë për licencë. |
| Adresa dhe certifikata | Adresa publike përgjigjet me një certifikatë zinxhiri i së cilës është i plotë. |
| Kopjet rezervë | Një orar kopjimi rezervë i caktuar, me një objektiv ku mund të shkruhet. |
| Identifikimi i kompanisë | I lidhur dhe i testuar. Deri atëherë, njerëzit përdorin çelësa kalimi. |
| Posta elektronike | Një server poste i caktuar. Deri atëherë, ftesat nuk mund të dërgohen. |
| Modeli AI | Një model AI (inteligjencë artificiale): një çelës modeli i organizatës, ose një model në harduerin tuaj. Deri atëherë, asistenti pret. Kapitulli 2.14, Ofruesit dhe modelet e AI. |
Fto njerëz hapet kur të gjashta janë të vërteta.
E njëjta faqe rendit çfarë bëhet e pandryshueshme sapo njerëzit identifikohen, me arsyen për secilën: emri i shkurtër në adresa, vendi ku mbahen të dhënat dhe kujdestari i çelësave (çelësat mund të kalojnë nga një kujdestar softuerik në harduer, kurrë anasjelltas). Emri i organizatës renditet gjithashtu, sepse ia vlen të kontrollohet, megjithëse mund të ndryshojë.
Nexus nuk do t'i përgjigjet kërkesës për AI të askujt derisa organizata të ketë një model. Nuk ka asnjë çelës të përbashkët pas një instalimi dhe asnjë zgjidhje rezervë, kështu që një organizatë pa çelës modeli merr një refuzim të thjeshtë që i tregon një administratori se çfarë të shtojë.
Identifikimi i kompanisë
Shumica e organizatave duan që njerëzit të identifikohen me llogaritë që kanë tashmë. Lidhni ofruesin tuaj të identitetit në faqen e identifikimit të kompanisë: përmes OIDC (OpenID Connect) në Community, ose përmes OIDC ose SAML (Security Assertion Markup Language) në Enterprise.
- Zgjidhni ofruesin dhe standardin që ai përdor.
- Vendosni identitetin e aplikacionit dhe sekretin e aplikacionit që ju dha ofruesi juaj i identitetit. Sekreti nuk shfaqet më kurrë pasi ta ruani.
- Tregoni se kush mund të identifikohet, për shembull kushdo me një adresë
@harrow.example. - Shtypni Testo identifikimin dhe identifikohuni si vetja juaj. Rezultati tregon, me fjalë, se kush u identifikua dhe çfarë dërgoi ofruesi.
- Ruaj.
Community merr një identifikim kompanie për organizatën. Enterprise shton detyrimin e zbatimit dhe sinkronizimin e direktorisë. Detyrimi i zbatimit çaktivizon fjalëkalimet, kështu që të gjithë duhet të përdorin identifikimin e kompanisë, dhe një përpjekje me fjalëkalim refuzohet me SSO_REQUIRED dhe një buton drejt mënyrës së duhur të hyrjes. Sinkronizimi i direktorisë kopjon njerëzit dhe grupet nga direktoria juaj çdo 15 minuta dhe mund të krijojë administratorë nga një grup i emërtuar.
Kur identifikimi i kompanisë ndalon së përgjigjuri, njerëzit e identifikuar tashmë qëndrojnë të identifikuar, dhe një identifikim i ri refuzohet me IDP_UNREACHABLE (503). Një administrator mund të përdorë atëherë identifikimin e emergjencës për administratorin nga kasaforta, së bashku me çelësin e tij të kalimit. Çdo përdorim shkruhet në regjistrin e auditimit, i njoftohet çdo administratori dhe përfundon pas katër orësh ose kur rikthehet identifikimi i kompanisë.
Ftoni njerëz
Me postën elektronike të konfiguruar, ftoni njerëz nga faqja Njerëzit (People). Për secilin, jepni email-in e tyre dhe një rol:
- Anëtari (Member) përdor gjithçka që ka organizata dhe nuk ndryshon asnjë cilësim.
- Administratori (Administrator) menaxhon gjithashtu njerëzit, modelet, buxhetet dhe cilësimet.
Një ftesë zgjat 7 ditë. Personi e hap atë, sheh se kush e ftoi, rolin e tij dhe çfarë do të shohë, dhe identifikohet. Një kontroll i dytë kërkohet në identifikimin e tyre të parë.
Anëtarët e ftuar identifikohen në konsolë dhe bëjnë punën e tyre të përditshme atje: Sot (Today), asistenti, biseda në ekip, skedarët dhe kërkimi, blloqet e shënimeve, agjentët dhe rrjedhat e punës, sipas asaj që u lejon roli i tyre. Administratorët shohin gjithashtu faqet e administrimit. Një anëtar që hap faqen e një administratori merr faqen "Nuk jeni administrator". Ajo shfaq cilësimet vetëm për lexim, tregon pse dhe ofron mundësinë për të pyetur një administrator.
Regjistrimet kanë nevojë për miratim
Njerëzit mund të kërkojnë gjithashtu të bashkohen duke u regjistruar vetë. Në një instalim, regjistrimi i një të panjohuri nuk krijon një llogari funksionale. nexus-auth e refuzon atë me SIGNUP_REQUIRES_APPROVAL (403) dhe e mban në pritje për miratimin e një administratori.
Dy kontrolle të tjera regjistrimi ekzistojnë në shërbimin e hostuar të Adverant dhe janë të çaktivizuara në çdo instalim, pa asnjë vlerë për t'i aktivizuar. CAPTCHA i internetit do të kërkonte internet në çdo regjistrim. Filtri i rrjetit të regjistrimit do të kërkonte një bazë të dhënash gjeolokacioni të licencuar që instalimi nuk e mbart. Miratimi është porta e instalimit.
Riprovat, kodet e skaduara dhe refuzimet e tjera
Çdo refuzim në ekzekutimin e parë tregon se çfarë ndodhi, që asgjë nuk ndryshoi aty ku kjo është e vërtetë, dhe çfarë duhet bërë më tej.
| Kodi | Statusi | Kur | Çfarë duhet të bëni |
|---|---|---|---|
CLAIM_CODE_EXPIRED |
410 | Kanë kaluar 30 minutat. Asgjë nuk u mor në pronësi dhe asgjë nuk ndryshoi. | Krijoni një kod të ri me nexusctl claim-code --administrator <email>, pastaj shtypni Kam një kod të ri. |
CLAIM_FINGERPRINT_MISMATCH |
403 | Gjurma dixhitale e dërguar nuk është e këtij instalimi. | Ndaloni. Kontrolloni adresën dhe certifikatën. |
TRANSITION_NOT_PERMITTED |
409 | Një hap që ka ndodhur tashmë u kërkua përsëri: marrja në pronësi në një instalim të marrë në pronësi, ose administratori i parë për herë të dytë. | Identifikohuni në konsolë; administratori i parë shton të gjithë të tjerët. |
TRANSITION_NOT_PERMITTED |
409 | Hapi i çelësit të kalimit, nga një shfletues pa asnjë administrator të parë në pritje, ose pas dhjetë minutave të tij. | Shihni më poshtë. |
RATE_LIMITED |
429 | Shumë tentativa në faqet e ekzekutimit të parë brenda një minute. Asgjë nuk u dërgua. | Prisni sekondat që jep faqja, pastaj provoni përsëri. |
Një kod pa prova të mbetura thotë "Ky kod nuk ka më prova të mbetura". Krijoni një të ri, njësoj si për një kod të skaduar. Vetëm dikush me qasje në klaster mund ta bëjë këtë, që është edhe qëllimi.
Faqet e ekzekutimit të parë pranojnë së bashku 20 tentativa në minutë. Nëse nuk i keni bërë ju ato tentativa, dikush tjetër në rrjetin tuaj po provon faqen, dhe kjo ia vlen të dihet.
Kur hapi i çelësit të kalimit u humb
Nëse administratori i parë u krijua por nuk u bë asnjë çelës kalimi brenda dhjetë minutave, ose shfletuesi u mbyll, administratori ekziston pa asnjë mënyrë për t'u identifikuar. Hapi i çelësit të kalimit përgjigjet TRANSITION_NOT_PERMITTED me fjalët "Nëse e krijuat administratorin e parë në këtë shfletues mbi dhjetë minuta më parë, pyesni një operator: administratori ekziston dhe nuk ka ende një çelës kalimi". Marrja në pronësi është ezauruar në atë pikë, kështu që një kod i ri marrjeje në pronësi nuk do të ndihmojë. Pyesni operatorin që ekzekutoi instalimin përpara se të provohet ndonjë gjë tjetër.
Kur shfletuesi humbi marrjen në pronësi
Marrja në pronësi jeton në shfletuesin që e bëri atë, në një cookie që faqja nuk mund ta lexojë. Nëse ai shfletues e humb atë midis marrjes në pronësi dhe administratorit të parë, për shembull në një dritare private që u mbyll, formulari i administratorit të parë pranon gjithashtu skedarin e marrjes në pronësi dhe sekretin e tij të konfigurimit, të ngjitura me dorë.
Sapo Aoife pati çelësin e saj të kalimit, Tomás mbylli terminalin e tij. Faqja e marrjes në pronësi ishte çaktivizuar, administratori i parë ekzistonte dhe çdo mënyrë tjetër hyrjeje tani kalonte përmes saj.






