Verżjoni 1.0.0-alpha.1l-aħħar
Kapitlu 2.12
L-ewwel tħaddim
Minn installazzjoni mhux ikklejmjata għal nies fuq ix-xogħol. Oħloq il-kodiċi tat-talba, ikklejmja l-installazzjoni fi brawżer, oħloq l-ewwel amministratur b'passkey, imbagħad qabbad id-dħul tal-kumpanija u stieden lil kulħadd.
Din il-paġna ġiet tradotta bl-IA mill-oriġinal bl-Ingliż. Jekk xi ħaġa mhijiex ċara, il-paġna bl-Ingliż hija r-referenza. Aqra din il-paġna bl-Ingliż

Meta installazzjoni tintemm, l-installazzjoni ma tkun ta' ħadd. M'għandha l-ebda organizzazzjoni, l-ebda persuna u l-ebda sessjoni, u ħadd ma jista' jidħol. Tistenna persuna waħda biex tipprova, f'browser, li qed tkellem lill-installazzjoni li għadha kemm saret. F'Harrow Port Authority dik il-persuna kienet Aoife Brennan, kap tal-IT, b'Tomás Reilly maġenbha fit-terminal. Dan il-kapitlu jsegwi l-ewwel għoxrin minuta tagħhom.
L-ordni hija fissa, u kull pass jagħlaq dak ta' qablu għal dejjem: ħu l-installazzjoni f'idejk, oħloq l-ewwel amministratur u l-organizzazzjoni, waqqaf passkey u wasal fuq il-paġna Today. Wara dan jiġu s-sitt affarijiet li jridu jitlestew, id-dħul tal-kumpanija, u l-istedina ta' kulħadd, fi kwalunkwe ordni li jgħodd għalik.
Oħloq il-kodiċi tat-talba
Il-kodiċi tat-talba jipprova li l-persuna ta' quddiem il-browser tista' tara wkoll it-terminal ta' xi ħadd b'aċċess għall-cluster. Persuna bħal din biss tista' toħloq wieħed. Ħaddem dan fejn il-kubeconfig tiegħek jilħaq il-cluster:
nexusctl claim-code --administrator aoife.brennan@harrow.examplenexusctl claim-code jitlob lis-servizz taċ-ċwievet tal-installazzjoni, nexus-keys, biex joħloq il-kodiċi. Mingħajr nexusctl, l-istess kmand jaħdem fil-pod tas-servizz taċ-ċwievet stess:
kubectl -n nexus exec deploy/nexus-keys -- nexus-keys claim-code \
--administrator aoife.brennan@harrow.example --source "Tomás Reilly, ops terminal"--source huwa ftit kliem li jgħid min ħoloq il-kodiċi. Il-paġna tat-talba turihom taħt "Made by", sabiex il-persuna li qed tieħu l-installazzjoni f'idejha tkun taf minn fejn ġie l-kodiċi.
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
Tliet affarijiet dwar il-kodiċi huma importanti.
- Idum 30 minuta. Kodiċi li jidher minn wara dahar xi ħadd malajr isir inutli.
- Jippermetti 5 tentattivi. Wara l-ħames tentattiv ħażin ikun spiċċa, ikun x'ikun il-ħin.
- Huwa għal persuna waħda. L-email li tagħti huwa tal-ewwel amministratur. Jivvjaġġa mat-talba, u l-formola tal-ewwel amministratur turih bħala fiss, mhux ittajpjat mill-ġdid.
Il-marka tas-swaba' diġitali (fingerprint) hija tmien gruppi ta' erba' karattri, l-identità proprja tal-installazzjoni. Ħalliha fuq l-iskrin. Se tqabbilha, grupp b'grupp, fil-browser.
Ikklejmja l-installazzjoni
- Fuq il-kompjuter li se tuża bħala l-ewwel amministratur, iftaħ l-indirizz tal-installazzjoni tal-console, hawnhekk
https://console.harrow.example/install. Dan jibgħatek fil-paġna t-tajba għall-istat tal-installazzjoni: il-paġna tat-talba waqt li tkun miftuħa, il-paġna tal-ewwel amministratur ladarba tittieħed f'idejk, u l-console jekk tkun diġà dħalt. - Fuq Claim this installation, ittajpja l-kodiċi fi Group one, Group two u Group three, grupp wieħed ta' erbgħa f'kull wieħed.
- Qabbel Fingerprint of this installation tal-paġna mat-terminal, it-tmien gruppi kollha, wieħed wieħed.
- Jekk kull grupp jaqbel, immarka All eight groups match what my terminal shows.
- Agħfas Claim this installation, u l-paġna tikkonferma t-talba u tibgħatek għand l-ewwel amministratur.
It-teħid tal-installazzjoni f'idejk jagħmel tliet affarijiet. Jagħmel dan il-browser l-uniku post fejn jista' jinħoloq l-ewwel amministratur. Jirreġistra min ħa l-installazzjoni f'idejh, u meta, fir-reġistru tal-awditjar (audit log). U jitfi l-paġna tat-talba għal dejjem. Minn dakinhar 'il quddiem, l-indirizz tat-talba jwieġeb li l-installazzjoni ttieħdet.
Jekk il-marka tas-swaba' diġitali ma taqbilx, ieqaf
Marka tas-swaba' diġitali differenti tfisser li installazzjoni differenti qed twieġeb f'dan l-indirizz. Jista' jkun indirizz ittajpjat ħażin, rekord antik tad-DNS (Domain Name System), jew magna mwaqqfa biex taqbad l-ewwel amministratur. Kieku ħadtha f'idejk, dik il-magna kien ikollha l-organizzazzjoni tiegħek.
Tiħux l-installazzjoni f'idejk, u tittajpjax il-kodiċi fuq dik il-paġna. Agħlaq il-paġna, imbagħad iċċekkja żewġ affarijiet: li console.harrow.example jirriżolvi għall-ingress tiegħek, u li ċ-ċertifikat li juri l-browser huwa maħruġ mis-CA (awtorità taċ-ċertifikazzjoni) li tistenna. L-installazzjoni tiegħek stess tibqa' mhux mibdula u għadha ma ttiħditx.
Jekk tintbagħat talba b'marka tas-swaba' diġitali li mhijiex tal-installazzjoni, is-servizz taċ-ċwievet jirrifjutaha b'CLAIM_FINGERPRINT_MISMATCH (403). Xejn ma jittieħed. Il-paġna mbagħad turi ż-żewġ marki tas-swaba' diġitali maġenb xulxin bil-gruppi li ma jaqblux immarkati, u l-passi biex tiċċekkja l-indirizz u ċ-ċertifikat.
Oħloq l-ewwel amministratur u l-organizzazzjoni
Il-paġna li jmiss għandha t-titlu "Two short forms, then you are in". L-ewwel amministratur jista' jżid lil kulħadd, u kważi kollox hawnhekk jista' jinbidel aktar tard. Żewġ affarijiet ma jistgħux, u l-paġna timmarkahom.
| Qasam | X'jidħol | Jista' jinbidel aktar tard? |
|---|---|---|
| Isem sħiħ | Ismek | Iva |
| Email tax-xogħol | L-indirizz li għalih inħoloq il-kodiċi tat-talba, muri u mhux ittajpjat mill-ġdid | Huwa l-indirizz tal-amministratur |
| Rwol f'Nexus | Amministratur tal-organizzazzjoni. L-ewwel persuna dejjem tkun amministratur. | Mhux magħżul hawn |
| It-tieni kontroll | Passkey fuq dan il-laptop | Iva, jistgħu jiżdiedu aktar |
| Isem (tal-organizzazzjoni) | Harrow Port Authority | Iva |
| Pajjiż | Fejn hija bbażata l-organizzazzjoni | Iva |
| Isem qasir fl-indirizzi | Magħmul mill-isem, bħal harrow-port-authority |
Le. Il-links u l-esportazzjonijiet jużawh. |
| Fejn tinżamm id-data | Din l-installazzjoni | Le. Jekk tibdlu aktar tard ikun ifisser installazzjoni ġdida. |
| Lingwa u dati | Ingliż (ir-Renju Unit), bid-data tal-lum | Iva |
| Żona tal-ħin | Iż-żona tal-ħin tas-server | Kull persuna tara l-ħinijiet f'tagħha stess |
L-isem qasir huwa ittri żgħar, ċifri u singijiet, sa 100 karattru, magħmul mill-isem tal-organizzazzjoni bl-aċċenti mneħħija. Ħares lejh qabel ma tagħfas xi ħaġa. Jidher f'kull link li n-nies jaqsmu u f'kull esportazzjoni li jagħmlu, sakemm tibqa' teżisti l-organizzazzjoni.
Issettja wkoll password fuq din il-paġna. Qatt ma hija biżżejjed waħedha: amministratur qatt ma jidħol b'password biss. It-tieni kontroll, hawn taħt, huwa dak li jdaħħlek.
Dħul ta' emerġenza għall-amministratur jinħoloq fl-istess ħin. Huwa ssiġillat u stampat darba, għas-safe. Jaħdem biss meta d-dħul tal-kumpanija jkun wieqaf, u kull użu jiġi rreġistrat u mħabbar lill-amministraturi kollha. Poġġih fis-safe dakinhar stess li tipprintjah.
Il-paġna tgħid ukoll li Adverant ma jingħadlux min int. Dawn id-dettalji jibqgħu fuq l-installazzjoni. Liċenzjassemmi l-kumpanija, qatt in-nies fiha.
Agħfas Create and sign in. Il-ħolqien tal-amministratur u l-organizzazzjoni jieħu ftit sekondi. Il-paġna twieġeb "Made for aoife.brennan@harrow.example. Now set up your passkey: it is how you sign in."
Il-passkey: it-tieni kontroll
- Agħfas Set up the passkey and sign in.
- Il-browser tiegħek jitolbok toħloq passkey. Fuq laptop b'Touch ID jew Windows Hello, ikkonferma b'sebgħek, b'wiċċek jew bil-PIN. Jekk il-kompjuter ma jistax joħloq passkey waħdu, il-browser juri kodiċi QR (quick response): ipponta l-kamera tal-mowbajl tiegħek lejh u segwi l-mowbajl.
- Il-paġna twieġeb "Your passkey is set up and you are signed in as aoife.brennan@harrow.example." u tiftaħ il-console.
Għandek għaxar minuti minn Create and sign in biex toħloq il-passkey, fl-istess browser. Wara dan it-twaqqif jingħalaq, u l-amministratur jeżisti mingħajr passkey. Operatur irid jgħin, kif deskritt taħt it-tentattivi mill-ġdid hawn taħt.
Minn issa 'l quddiem l-ewwel amministratur jidħol b'dik il-passkey. Password ta' amministratur sħiħ, ittajpjata waħedha, qatt ma toħloq sessjoni: is-servizz tad-dħul iwieġeb b'talba għat-tieni kontroll. Dik hija karatteristika tad-disinn, u r-raġuni għaliex il-passkey hija importanti. Passkey mitlufa hija mod ta' dħul mitluf, għalhekk żid it-tieni waħda, fuq mowbajl jew security key, fl-ewwel jum.
Aktar tard, in-nies jidħlu fl-installazzjoni b'passkey, b'Google, b'GitHub, jew bid-dħul tal-kumpanija tagħhom, skont liema tippermetti l-organizzazzjoni.
| Kodiċi | Xi tfisser | X'għandek tagħmel |
|---|---|---|
PASSKEY_UNSUPPORTED |
Dan il-browser ma jistax joħloq passkey. Xejn ma twaqqaf. | Iftaħ il-paġna f'browser li jappoġġja l-passkeys, fuq l-istess kompjuter. |
PASSKEY_CANCELLED |
Il-messaġġ ingħalaq, jew ma ntgħażel xejn fil-ħin. Xejn ma ntbagħat. | Erġa' agħfas il-buttuna. |
L-ewwel paġna Today
Il-console jiftaħ fuq Today, u fl-ewwel jum kważi kollox fuqu jkun vojt. Kull żona vojta tgħid x'se jidher hemm u tagħti l-buttuna li tibdieh, għalhekk "Needs an administrator" tgħid li t-talbiet se jistennewhom hemm ladarba n-nies jingħaqdu, b'Invite people maġenbha. Il-lista ta' kontroll tat-twaqqif tgħid kemm mill-passi tagħha saru, fi kwalunkwe ordni. L-unika storja reali, it-twaqqif innifsu, hija diġà taħt "What changed": l-installazzjoni mwaqqfa, u l-passkey tal-ewwel amministratur maħluqa.
Sitt affarijiet qabel ma xi ħadd jidħol
Il-paġna Six things before anyone signs in telenka x'inhu dak li jrid ikun veru qabel ma n-nies jiġu mistiedna. Mhijiex wizard. Agħmilhom fi kwalunkwe ordni, u l-paġna tgħoddhom ("Three of six true").
| Ħaġa | X'jagħmilha vera |
|---|---|
| Liċenzja | Liċenzja Enterprise importata. Kapitlu 2.13, Liċenzji. Community m'għandha bżonn l-ebda liċenzja. |
| Indirizz u ċertifikat | L-indirizz pubbliku jwieġeb b'ċertifikat li l-katina tiegħu hija kompluta. |
| Backups | Skeda ta' backup issettjata, b'destinazzjoni li tista' tinkiteb fuqha. |
| Dħul tal-kumpanija | Konness u ttestjat. Sadakittant, in-nies jużaw passkeys. |
| Posta | Server tal-posta ssettjat. Sadakittant, l-istediniet ma jistgħux jintbagħtu. |
| Mudell tal-IA | Mudell tal-IA (intelliġenza artifiċjali): ċavetta tal-mudell tal-organizzazzjoni, jew mudell fuq il-ħardwer tiegħek stess. Sadakittant, l-assistent jistenna. Kapitlu 2.14, Fornituri u mudelli tal-IA. |
Invite people tiftaħ meta s-sitta kollha jkunu veri.
L-istess paġna telenka x'isir fiss ladarba n-nies jidħlu, bir-raġuni għal kull wieħed: l-isem qasir fl-indirizzi, fejn tinżamm id-data, u l-kustodju taċ-ċwievet (iċ-ċwievet jistgħu jimxu minn kustodju tas-softwer għal ħardwer, qatt lura). L-isem tal-organizzazzjoni huwa elenkat ukoll, għax ta' min jiċċekkjah, għalkemm jista' jinbidel.
Nexus mhux se jwieġeb it-talba tal-IA ta' ħadd sakemm l-organizzazzjoni jkollha mudell. M'hemm l-ebda ċavetta kondiviża wara installazzjoni u l-ebda riżerva (fallback), għalhekk organizzazzjoni mingħajr ċavetta tal-mudell tirċievi rifjut ċar li jgħid lil amministratur x'għandu jżid.
Dħul tal-kumpanija
Ħafna organizzazzjonijiet iridu li n-nies jidħlu bil-kontijiet li diġà għandhom. Qabbad il-fornitur tal-identità tiegħek fuq il-paġna tad-dħul tal-kumpanija: permezz ta' OIDC (OpenID Connect) fuq Community, jew permezz ta' OIDC jew SAML (Security Assertion Markup Language) fuq Enterprise.
- Agħżel il-fornitur u l-istandard li juża.
- Daħħal l-identità tal-applikazzjoni u s-sigriet tal-applikazzjoni li tak il-fornitur tal-identità tiegħek. Is-sigriet qatt ma jerġa' jintwera wara li tissejvjah.
- Għid min jista' jidħol, pereżempju kull min għandu indirizz
@harrow.example. - Agħfas Test sign-in u idħol bħalek innifsek. Ir-riżultat jgħid, bil-kliem, min daħal u x'bagħat il-fornitur.
- Issejvja.
Community tikseb dħul tal-kumpanija wieħed għall-organizzazzjoni. Enterprise iżżid l-infurzar u s-sinkronizzazzjoni tad-direttorju. L-infurzar jitfi l-passwords, sabiex kulħadd irid juża d-dħul tal-kumpanija, u tentattiv bil-password jiġi rrifjutat b'SSO_REQUIRED u buttuna għall-mod it-tajjeb ta' dħul. Is-sinkronizzazzjoni tad-direttorju tikkopja n-nies u l-gruppi mid-direttorju tiegħek kull 15-il minuta, u tista' tagħmel amministraturi minn grupp wieħed imsemmi.
Meta d-dħul tal-kumpanija jieqaf iwieġeb, in-nies li diġà daħlu jibqgħu ġewwa, u dħul ġdid jiġi rrifjutat b'IDP_UNREACHABLE (503). Amministratur jista' mbagħad juża d-dħul ta' emerġenza għall-amministratur mis-safe, flimkien mal-passkey tiegħu. Kull użu jinkiteb fir-reġistru tal-awditjar, jiġi mħabbar lil kull amministratur, u jintemm wara erba' sigħat jew meta d-dħul tal-kumpanija jirritorna.
Stieden lin-nies
Bil-posta mwaqqfa, stieden lin-nies mill-paġna People. Għal kull wieħed, agħti l-email tiegħu u rwol:
- Membru juża dak kollu li għandha l-organizzazzjoni u ma jibdel l-ebda setting.
- Amministratur jimmaniġġja wkoll in-nies, il-mudelli, il-baġits u s-settings.
Stedina ddum 7 ijiem. Il-persuna tiftaħha, tara min stidinha, ir-rwol tagħha u x'se tara, u tidħol. It-tieni kontroll jintalab fl-ewwel dħul tagħha.
Il-membri mistiedna jidħlu fil-console u jagħmlu x-xogħol tagħhom ta' kuljum hemmhekk: Today, l-assistent, iċ-chat tat-tim, il-fajls u t-tfittxija, in-notebooks, l-aġenti u l-workflows, kif jippermetti r-rwol tagħhom. L-amministraturi jaraw il-paġni tal-amministrazzjoni wkoll. Membru li jiftaħ paġna ta' amministratur jikseb il-paġna "Not an administrator". Din turi s-settings għall-qari biss, tgħid għaliex, u toffri li tistaqsi lil amministratur.
Ir-reġistrazzjonijiet jeħtieġu approvazzjoni
In-nies jistgħu wkoll jitolbu li jingħaqdu billi jirreġistraw huma stess. Fuq installazzjoni, ir-reġistrazzjoni ta' barrani ma toħloqx kont li jaħdem. nexus-auth jirrifjutaha b'SIGNUP_REQUIRES_APPROVAL (403) u jżommha għall-approvazzjoni ta' amministratur.
Żewġ kontrolli oħra tar-reġistrazzjoni jeżistu fuq is-servizz ospitat ta' Adverant u huma mitfija fuq kull installazzjoni, mingħajr l-ebda valur biex jinxtegħlu. Is-CAPTCHA tal-internet ikollha bżonn l-internet f'kull reġistrazzjoni. L-iskrin tan-netwerk tar-reġistrazzjoni jkollu bżonn database tal-ġeolokalizzazzjoni liċenzjata li l-installazzjoni ma ġġorrx. L-approvazzjoni hija l-bieb tal-installazzjoni.
Tentattivi mill-ġdid, kodiċijiet skaduti u rifjuti oħra
Kull rifjut fl-ewwel darba li titħaddem jgħid x'ġara, li xejn ma nbidel fejn dak huwa minnu, u x'għandek tagħmel wara.
| Kodiċi | Stat | Meta | X'għandek tagħmel |
|---|---|---|---|
CLAIM_CODE_EXPIRED |
410 | Għaddew it-30 minuta. Xejn ma ttieħed u xejn ma nbidel. | Oħloq kodiċi ġdid b'nexusctl claim-code --administrator <email>, imbagħad agħfas I have a new code. |
CLAIM_FINGERPRINT_MISMATCH |
403 | Il-marka tas-swaba' diġitali mibgħuta mhijiex ta' din l-installazzjoni. | Ieqaf. Iċċekkja l-indirizz u ċ-ċertifikat. |
TRANSITION_NOT_PERMITTED |
409 | Pass li diġà seħħ intalab mill-ġdid: it-talba fuq installazzjoni li diġà ttieħdet, jew l-ewwel amministratur għat-tieni darba. | Idħol fil-console; l-ewwel amministratur iżid lil kulħadd. |
TRANSITION_NOT_PERMITTED |
409 | Il-pass tal-passkey, minn browser mingħajr l-ebda l-ewwel amministratur jistenna, jew wara l-għaxar minuti tiegħu. | Ara hawn taħt. |
RATE_LIMITED |
429 | Wisq tentattivi fuq il-paġni tal-ewwel darba f'minuta. Xejn ma ntbagħat. | Stenna s-sekondi li tagħti l-paġna, imbagħad erġa' pprova. |
Kodiċi li m'għandux aktar tentattivi juri "This code has no tries left". Oħloq wieħed ġdid, l-istess bħal għal kodiċi skadut. Xi ħadd b'aċċess għall-cluster biss jista' jagħmel dan, li huwa l-punt.
Il-paġni tal-ewwel darba jieħdu 20 tentattiv fil-minuta bejniethom. Jekk ma għamiltx dawk it-tentattivi int, xi ħadd ieħor fuq in-netwerk tiegħek qed jipprova l-paġna, u dan ta' min ikun jafu.
Meta l-pass tal-passkey inqabeż
Jekk l-ewwel amministratur inħoloq iżda ma saret l-ebda passkey fi żmien għaxar minuti, jew il-browser ingħalaq, l-amministratur jeżisti mingħajr l-ebda mod kif jidħol. Il-pass tal-passkey iwieġeb TRANSITION_NOT_PERMITTED bil-kliem "If you made the first administrator in this browser over ten minutes ago, ask an operator: the administrator exists and has no passkey yet". It-talba tkun intużat f'dak il-punt, għalhekk kodiċi tat-talba ġdid mhux se jgħin. Staqsi lill-operatur li ħaddem l-installazzjoni qabel ma tiġi ppruvata xi ħaġa oħra.
Meta l-browser tilef it-talba
It-talba tgħix fil-browser li għamilha, f'cookie li l-paġna ma tistax taqra. Jekk dak il-browser jitlifha bejn it-talba u l-ewwel amministratur, pereżempju f'tieqa privata li ngħalqet, il-formola tal-ewwel amministratur taċċetta wkoll il-fajl tat-talba u s-sigriet tat-twaqqif tagħha, iddaħħla bl-idejn.
Ladarba Aoife kellha l-passkey tagħha, Tomás għalaq it-terminal tiegħu. Il-paġna tat-talba kienet mitfija, l-ewwel amministratur kien jeżisti, u kull mod ieħor ta' dħul issa kien jgħaddi minnha.






