Versioon 1.0.0-alpha.1uusim
Peatükk 2.12
Esmakäivitus
Omastamata paigaldusest töötavate inimesteni. Looge omastamiskood, omastage paigaldus brauseris, looge pääsuvõtmega esimene administraator, seejärel ühendage ettevõtte sisselogimine ja kutsuge kõik teised.
Selle lehe tõlkis AI ingliskeelsest originaalist. Kui miski jääb ebaselgeks, võtke aluseks ingliskeelne leht. Lugege seda lehte inglise keeles

Kui paigaldamine lõpeb, ei kuulu paigaldus veel kellelegi. Sellel pole organisatsiooni, kasutajat ega seanssi ning keegi ei saa sisse logida. See ootab, et üks inimene tõendaks brauseris, et ta suhtleb äsja loodud paigaldusega. Harrow Port Authoritys oli selleks inimeseks IT-juht Aoife Brennan ja tema kõrval terminali taga Tomás Reilly. See peatükk jälgib nende esimest kahtkümmend minutit.
Järjekord on kindlaks määratud ja iga samm sulgeb eelmise lõplikult: võtke paigaldus enda nimele, looge esimene administraator ja organisatsioon, seadistage pääsuvõti ning jõudke lehele Täna. Pärast seda tulevad kuus ettevalmistavat sammu, ettevõtte sisselogimine ja kõigi teiste kutsumine – just teile sobivas järjekorras.
Looge omastamiskood
Omastamiskood tõendab, et brauseri ees istuv inimene näeb ka klastriga ühenduses oleva isiku terminali. Koodi saab luua vaid selline isik. Käivitage see seal, kus teie kubeconfig ulatub klastrini:
nexusctl claim-code --administrator aoife.brennan@harrow.examplenexusctl claim-code palub paigalduse võtmeteenusel nexus-keys koodi luua. Ilma osata nexusctl töötab sama käsk võtmeteenuse enda podis:
kubectl -n nexus exec deploy/nexus-keys -- nexus-keys claim-code \
--administrator aoife.brennan@harrow.example --source "Tomás Reilly, ops terminal"--source on mõni sõna selle kohta, kes koodi lõi. Omastamisleht näitab neid jaotises „Looja”, et paigalduse omastaja teaks, kust kood pärineb.
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
Koodi puhul on olulised kolm asja.
- See kehtib 30 minutit. Üle kellegi õla nähtud kood muutub peagi kasutuks.
- See lubab 5 katset. Pärast viiendat valet katset on kood ammendatud, sõltumata ajast.
- See on mõeldud ühele inimesele. Sisestatud e-posti aadress kuulub esimesele administraatorile. See liigub koos omastamisega kaasa ja esimese administraatori vormil kuvatakse see fikseerituna, ilma et seda peaks uuesti sisestama.
Sõrmejälg koosneb kaheksast neljamärgilisest rühmast ja on paigalduse enda identiteet. Jätke see ekraanile. Võrdlete seda brauseris rühmhaaval.
Omastage paigaldus
- Avage arvutis, mida hakkate kasutama esimese administraatorina, konsooli paigaldusaadress, siin
https://console.harrow.example/install. See suunab teid paigalduse olekule vastavale lehele: omastamislehele, kui see on avatud, esimese administraatori lehele, kui see on omastatud, ja konsooli, kui olete juba sisse logitud. - Lehel Võta see paigaldus enda nimele sisestage kood väljadele Esimene rühm, Teine rühm ja Kolmas rühm, igasse üks neljamärgiline rühm.
- Võrrelge lehel olevat välja Selle paigalduse sõrmejälg terminaliga, kõiki kaheksat rühma ükshaaval.
- Kui iga rühm klapib, märkige ruut Kõik kaheksa rühma vastavad minu terminalis kuvatule.
- Vajutage nuppu Võta see paigaldus enda nimele, misjärel leht kinnitab omastamise ja suunab teid edasi esimese administraatori juurde.
Omastamine teeb kolme asja. See muudab selle brauseri ainsaks kohaks, kus saab luua esimese administraatori. See salvestab auditilogisse, kes ja millal paigalduse omastas. Ning see lülitab omastamislehe lõplikult välja. Sellest hetkest alates vastab omastamisaadress, et paigaldus on juba omastatud.
Kui sõrmejälg ei klapi, peatuge
Erinev sõrmejälg tähendab, et sellel aadressil vastab mõni teine paigaldus. Põhjuseks võib olla valesti sisestatud aadress, aegunud DNS-i (domeeninimede süsteemi) kirje või masin, mis on üles seatud esimese administraatori püüdmiseks. Kui te selle omastaksite, jääks teie organisatsioon tolle masina kätte.
Ärge omastage paigaldust ega sisestage koodi sellel lehel. Sulgege leht ja kontrollige seejärel kahte asja: et console.harrow.example lahenduks teie sisendpunktiks (ingress) ja et brauseris näidatava sertifikaadi oleks välja andnud oodatud CA (sertifitseerimiskeskus). Teie enda paigaldus on muutmata ja endiselt omastamata.
Kui omastamistaotlus saadetakse sõrmejäljega, mis ei kuulu sellele paigaldusele, lükkab võtmeteenus selle tagasi veaga CLAIM_FINGERPRINT_MISMATCH (403). Midagi ei omastata. Leht näitab seejärel kahte sõrmejälge kõrvuti, märgistades erinevad rühmad, ning juhiseid aadressi ja sertifikaadi kontrollimiseks.
Looge esimene administraator ja organisatsioon
Järgnev leht kannab pealkirja „Kaks lühikest vormi ja oletegi sees”. Esimene administraator saab lisada kõik teised ning peaaegu kõike siin saab hiljem muuta. Kahte asja muuta ei saa ja leht märgib need ära.
| Väli | Mida sisestatakse | Kas seda saab hiljem muuta? |
|---|---|---|
| Täisnimi | Teie nimi | Jah |
| Töö e-posti aadress | Aadress, mille jaoks omastamiskood loodi; see kuvatakse ja seda ei sisestata uuesti | See on administraatori aadress |
| Roll Nexuses | Organisatsiooni administraator. Esimene kasutaja on alati administraator. | Ei valita siin |
| Teine kontroll | Pääsuvõti selles sülearvutis | Jah, neid saab juurde lisada |
| Nimi (organisatsiooni oma) | Harrow Port Authority | Jah |
| Riik | Organisatsiooni asukoht | Jah |
| Lühinimi aadressides | Loodud nimest, nt harrow-port-authority |
Ei. Seda kasutavad lingid ja ekspordid. |
| Andmete talletuskoht | See paigaldus | Ei. Selle hilisem muutmine tähendab uut paigaldust. |
| Keel ja kuupäevad | Inglise (UK), tänase kuupäevaga | Jah |
| Ajavöönd | Serveri ajavöönd | Igaüks näeb kellaaegu oma ajavööndis |
Lühinimi koosneb väiketähtedest, numbritest ja sidekriipsudest (kuni 100 tähemärki), mis on loodud organisatsiooni nimest ilma rõhumärkideta. Vaadake see üle, enne kui midagi vajutate. See esineb igas jagatavas lingis ja igas tehtavas ekspordis seni, kuni organisatsioon eksisteerib.
Sellel lehel määrate ka parooli. Sellest üksi ei piisa kunagi: administraator ei logi kunagi sisse ainult parooliga. Sisse logib teid allpool olev teine kontroll.
Samal ajal luuakse administraatori avariisisselogimine. See pitseeritakse ja prinditakse ühe korra seifi panemiseks. See töötab ainult siis, kui ettevõtte sisselogimine on maas, ning iga kasutuskord salvestatakse ja sellest teavitatakse kõiki administraatoreid. Pange see seifi samal päeval, kui selle prindite.
Lehel on ka kirjas, et Adverantile ei avaldata, kes te olete. Need andmed jäävad paigaldusse. Litsentsis on kirjas ettevõtte nimi, mitte kunagi selle töötajad.
Vajutage nuppu Loo ja logi sisse. Administraatori ja organisatsiooni loomine võtab mõne sekundi. Leht vastab: „Loodud kasutajale aoife.brennan@harrow.example. Nüüd seadistage oma pääsuvõti: selle abil logite sisse.”
Pääsuvõti: teine kontroll
- Vajutage nuppu Seadista pääsuvõti ja logi sisse.
- Teie brauser palub teil luua pääsuvõtme. Touch ID või Windows Helloga sülearvutis kinnitage see sõrmejälje, näotuvastuse või PIN-koodiga. Kui arvuti ei saa ise pääsuvõtit luua, näitab brauser QR-koodi (ruutkoodi): suunake telefoni kaamera sellele ja järgige telefoni juhiseid.
- Leht vastab: „Teie pääsuvõti on seadistatud ja olete sisse logitud kasutajana aoife.brennan@harrow.example.” ning avab konsooli.
Teil on pärast nupu Loo ja logi sisse vajutamist aega kümme minutit, et luua samas brauseris pääsuvõti. Pärast seda seadistus suletakse ja administraator jääb ilma pääsuvõtmeta. Sellisel juhul peab aitama operaator, nagu on kirjeldatud allpool korduskatsete jaotises.
Sellest hetkest alates logib esimene administraator sisse selle pääsuvõtmega. Täisõigustega administraatori parool, kui see sisestatakse üksi, ei loo kunagi seanssi: sisselogimisteenus vastab teise kontrolli nõudega. See on süsteemi ülesehituse osa ja põhjus, miks pääsuvõti on oluline. Kaotatud pääsuvõti tähendab kaotatud sissepääsu, seega lisage juba esimesel päeval teine pääsuvõti telefonis või turvavõtmel.
Hiljem logivad inimesed paigaldusse sisse pääsuvõtme, Google'i, GitHubi või ettevõtte sisselogimisega, olenevalt sellest, mida organisatsioon lubab.
| Kood | Mida see tähendab | Mida teha |
|---|---|---|
PASSKEY_UNSUPPORTED |
See brauser ei saa pääsuvõtit luua. Midagi ei seadistatud. | Avage leht samas arvutis brauseriga, mis toetab pääsuvõtmeid. |
PASSKEY_CANCELLED |
Viip suleti või midagi ei valitud õigeaegselt. Midagi ei saadetud. | Vajutage nuppu uuesti. |
Esimene Today-leht
Konsool avaneb lehel Täna ja esimesel päeval on seal peaaegu kõik tühi. Iga tühi ala ütleb, mis sinna ilmub, ja pakub nuppu selle alustamiseks – näiteks „Vajab administraatorit” ütleb, et taotlused ootavad seal, kui inimesed liituvad, ning selle kõrval on nupp Kutsu inimesi. Seadistamise kontrollnimekiri näitab, mitu sammu on tehtud, suvalises järjekorras. Ainus tegelik ajalugu, seadistamine ise, on juba jaotises „Mis muutus”: paigaldus on seadistatud ja esimese administraatori pääsuvõti loodud.
Kuus asja enne, kui keegi sisse logib
Lehel Kuus asja enne, kui keegi sisse logib on loetletud tingimused, mis peavad olema täidetud enne inimeste kutsumist. See ei ole viisard. Tehke need läbi suvalises järjekorras ja leht loendab neid („Kolm kuuest täidetud”).
| Tingimus | Mis muudab selle täidetuks |
|---|---|
| Litsents | Enterprise'i litsents on imporditud. Peatükk 2.13, Litsentsid. Community ei vaja litsentsi. |
| Aadress ja sertifikaat | Avalik aadress vastab sertifikaadiga, mille ahel on täielik. |
| Varukoopiad | Varundusgraafik on määratud ja sihtkoht on kirjutatav. |
| Ettevõtte sisselogimine | Ühendatud ja testitud. Seni kasutavad inimesed pääsuvõtmeid. |
| E-post | Meiliserver on seadistatud. Seni ei saa kutseid saata. |
| AI-mudel | AI-mudel (tehisintellekti mudel): organisatsiooni mudelivõti või mudel teie enda riistvaral. Seni assistent ootab. Peatükk 2.14, AI teenusepakkujad ja mudelid. |
Kutsu inimesi avaneb, kui kõik kuus tingimust on täidetud.
Samal lehel on loetletud valikud, mis lukustuvad pärast inimeste sisselogimist, koos igaühe põhjendusega: lühinimi aadressides, andmete talletuskoht ja võtmehoidja (võtmed saavad liikuda tarkvaraliselt hoidjalt riistvaralisele, kuid mitte kunagi tagasi). Ka organisatsiooni nimi on välja toodud, sest see tasub üle kontrollida, kuigi seda saab muuta.
Nexus ei vasta ühelegi AI-päringule enne, kui organisatsioonil on mudel. Paigalduse taga pole jagatud võtit ega varuvarianti, seega saab mudelivõtmeta organisatsioon selge keeldumise, mis ütleb administraatorile, mida tuleb lisada.
Ettevõtte sisselogimine
Enamik organisatsioone soovib, et inimesed logiksid sisse kontodega, mis neil on juba olemas. Ühendage oma identiteedipakkuja ettevõtte sisselogimise lehel: üle OIDC (OpenID Connect) Community versioonis või üle OIDC või SAML-i (Security Assertion Markup Language) Enterprise'i versioonis.
- Valige teenusepakkuja ja kasutatav standard.
- Sisestage rakenduse identiteet ja rakenduse saladus, mille saite oma identiteedipakkujalt. Pärast salvestamist saladust enam kunagi ei näidata.
- Määrake, kes võivad sisse logida, näiteks kõik, kellel on aadress kujuga
@harrow.example. - Vajutage nuppu Testi sisselogimist ja logige sisse iseendana. Tulemus ütleb sõnadega, kes sisse logis ja mida teenusepakkuja saatis.
- Salvestage.
Community saab organisatsiooni jaoks ühe ettevõtte sisselogimise. Enterprise lisab jõustamise ja kataloogi sünkroonimise. Jõustamine lülitab paroolid välja, nii et kõik peavad kasutama ettevõtte sisselogimist, ning parooliga katse lükatakse tagasi veaga SSO_REQUIRED ja nupuga, mis suunab õige sisselogimisviisi juurde. Kataloogi sünkroonimine kopeerib inimesed ja rühmad teie kataloogist iga 15 minuti järel ning saab määrata ühe kindla rühma liikmed administraatoriteks.
Kui ettevõtte sisselogimine lakkab vastamast, jäävad juba sisse logitud inimesed sisselogituks ning uus sisselogimine lükatakse tagasi veaga IDP_UNREACHABLE (503). Administraator saab seejärel kasutada seifist võetud administraatori avariisisselogimist koos oma pääsuvõtmega. Iga kasutuskord kirjutatakse auditilogisse, sellest teavitatakse kõiki administraatoreid ning see lõpeb nelja tunni pärast või siis, kui ettevõtte sisselogimine taastub.
Kutsuge inimesi
Kui e-post on seadistatud, kutsuge inimesi lehelt Inimesed. Sisestage igaühe e-posti aadress ja roll:
- Liige kasutab kõike, mis organisatsioonil on, ega muuda seadeid.
- Administraator haldab lisaks inimesi, mudeleid, eelarveid ja seadeid.
Kutse kehtib 7 päeva. Inimene avab selle, näeb kutsujat, oma rolli ja seda, mida ta nägema hakkab, ning logib sisse. Esimesel sisselogimisel küsitakse teist kontrolli.
Kutsutud liikmed logivad konsooli sisse ja teevad seal oma igapäevatööd: Täna, assistent, meeskonnavestlus, failid ja otsing, märkmikud, agendid ja töövood vastavalt sellele, mida nende roll lubab. Administraatorid näevad ka halduslehti. Liige, kes avab administraatori lehe, näeb lehte „Pole administraator”. See näitab seadeid kirjutuskaitstult, selgitab põhjust ja pakub võimalust pöörduda administraatori poole.
Registreerumised vajavad kinnitamist
Inimesed saavad liitumist taotleda ka ise registreerudes. Paigalduses ei loo võõra inimese registreerumine töötavat kontot. nexus-auth lükkab selle tagasi veaga SIGNUP_REQUIRES_APPROVAL (403) ja jätab selle ootama administraatori kinnitust.
Adveranti majutatud teenuses on veel kaks registreerumiskontrolli, mis on igas paigalduses välja lülitatud ja millel puudub väärtus nende sisselülitamiseks. Interneti CAPTCHA vajaks igal registreerumisel internetti. Registreerumise võrgufilter vajaks litsentseeritud geolokatsiooni andmebaasi, mida paigaldus ei sisalda. Paigalduse väravaks on kinnitamine.
Korduskatsed, aegunud koodid ja muud keeldumised
Iga esmase käivituse keeldumine ütleb, mis juhtus, kinnitab, et midagi ei muudetud (kui see nii on), ja juhendab, mida teha edasi.
| Kood | Olek | Millal | Mida teha |
|---|---|---|---|
CLAIM_CODE_EXPIRED |
410 | 30 minutit on möödunud. Midagi ei omastatud ja midagi ei muutunud. | Looge uus kood käsuga nexusctl claim-code --administrator <email> ja vajutage seejärel nuppu Mul on uus kood. |
CLAIM_FINGERPRINT_MISMATCH |
403 | Saadetud sõrmejälg ei kuulu sellele paigaldusele. | Peatuge. Kontrollige aadressi ja sertifikaati. |
TRANSITION_NOT_PERMITTED |
409 | Uuesti küsiti sammu, mis on juba toimunud: omastamist juba omastatud paigaldusel või esimese administraatori loomist teist korda. | Logige sisse konsoolis; esimene administraator lisab kõik teised. |
TRANSITION_NOT_PERMITTED |
409 | Pääsuvõtme samm brauserist, kus esimene administraator pole ootel, või pärast kümne minuti möödumist. | Vaadake allpool. |
RATE_LIMITED |
429 | Liiga palju katseid esmase käivituse lehtedel ühe minuti jooksul. Midagi ei saadetud. | Oodake lehel näidatud sekundid ja proovige seejärel uuesti. |
Kui koodil pole enam katseid jäänud, kuvatakse teade „Sellel koodil pole enam katseid jäänud”. Looge uus kood, täpselt nagu aegunud koodi puhul. Seda saab teha ainult keegi, kellel on juurdepääs klastrile, mis ongi asja mõte.
Esmase käivituse lehed lubavad kokku 20 katset minutis. Kui teie neid katseid ei teinud, proovib lehte keegi teine teie võrgus, ja seda on hea teada.
Kui pääsuvõtme samm jäi vahele
Kui esimene administraator loodi, kuid kümne minuti jooksul pääsuvõtit ei loodud või brauser suleti, on administraator küll olemas, kuid tal pole võimalust sisse logida. Pääsuvõtme samm vastab veaga TRANSITION_NOT_PERMITTED ja sõnadega: „Kui lõite esimese administraatori selles brauseris üle kümne minuti tagasi, pöörduge operaatori poole: administraator on olemas, kuid tal pole veel pääsuvõtit”. Omastamine on selleks hetkeks ära kasutatud, nii et uus omastamiskood ei aita. Pöörduge paigalduse käivitanud operaatori poole enne, kui proovite midagi muud.
Kui brauser kaotas omastamise
Omastamine asub selle teinud brauseris, küpsises, mida leht ise lugeda ei saa. Kui brauser kaotab selle omastamise ja esimese administraatori loomise vahel – näiteks suletud privaatse akna tõttu –, võtab esimese administraatori vorm vastu ka käsitsi kleebitud omastamisfaili ja selle seadistussaladuse.
Kui Aoife oli oma pääsuvõtme kätte saanud, sulges Tomás terminali. Omastamisleht oli välja lülitatud, esimene administraator oli olemas ja iga teine sissepääs käis nüüd tema kaudu.






