Logi sisseBroneerige tutvustus

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

18 minutit lugemist

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.

Vasakult paremale kulgev kastide ahel: „nexusctl claim-code (terminal)”, „Võta see paigaldus enda nimele (brauser: kood + sõrmejälg)”, „Esimene administraator ja organisatsioon”, „Pääsuvõti (teine kontroll)”, „Täna, kui kõik on uus”, „Kuus asja enne, kui keegi sisse logib”, „Kutsu inimesi”. Omastamiskasti alt hargneb allapoole kaks punast haru: „kood on liiga vana: CLAIM_CODE_EXPIRED, looge uus kood” ja „sõrmejäljed erinevad: CLAIM_FINGERPRINT_MISMATCH, peatuge”. Esimese kolme kasti all on peenike joon sildiga „iga samm lülitab eelmise lõplikult välja”.
Esmane käivitus terminalist kuni esimese Täna-leheni ja kaks kohta, kus see võib peatuda.

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.example

nexusctl 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

  1. 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.
  2. 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.
  3. Võrrelge lehel olevat välja Selle paigalduse sõrmejälg terminaliga, kõiki kaheksat rühma ükshaaval.
  4. Kui iga rühm klapib, märkige ruut Kõik kaheksa rühma vastavad minu terminalis kuvatule.
  5. Vajutage nuppu Võta see paigaldus enda nimele, misjärel leht kinnitab omastamise ja suunab teid edasi esimese administraatori juurde.
Omista see paigaldus
Omista see paigaldus
Omastamisleht. Kood sisestatakse kolmes rühmas, täielik sõrmejälg kuvatakse terminaliga võrdlemiseks kaheksas neljamärgilises rühmas ning parempoolsel kaardil on kirjas, kust kood pärineb ja mitu katset on jäänud.

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.

Sõrmejälg ei klapi
Sõrmejälg ei klapi
Leht, kuhu viib mitteklappiv sõrmejälg. Erinevad rühmad on märgistatud ning sammud kontrollivad aadressi ja sertifikaati enne, kui midagi muud sisestatakse.

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.”

Esimene administraator
Esimene administraator
Esimene administraator ja organisatsioon ühel lehel. Kaks valikut, mida ei saa kunagi muuta – lühinimi ja andmete talletuskoht –, on välja kõrval ära märgitud ning avariisisselogimine on seifi jaoks pitseeritud.

Pääsuvõti: teine kontroll

  1. Vajutage nuppu Seadista pääsuvõti ja logi sisse.
  2. 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.
  3. 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.

„Täna“, kui kõik on uus
„Täna“, kui kõik on uus
Leht Täna esimesel päeval. Iga tühi ala ütleb, mis sinna ilmub ja kuidas seda alustada, ning jaotises „Mis muutus” on juba kirjas seadistamine ise.

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.

Kuus asja enne, kui keegi sisse logib
Kuus asja enne, kui keegi sisse logib
Kuus kontrolli suvalises järjekorras, sõnadega loendatud. Valikud, mis lukustuvad pärast inimeste sisselogimist, on loetletud koos põhjendusega, et keegi ei avastaks seda hiljem.

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.

  1. Valige teenusepakkuja ja kasutatav standard.
  2. Sisestage rakenduse identiteet ja rakenduse saladus, mille saite oma identiteedipakkujalt. Pärast salvestamist saladust enam kunagi ei näidata.
  3. Määrake, kes võivad sisse logida, näiteks kõik, kellel on aadress kujuga @harrow.example.
  4. Vajutage nuppu Testi sisselogimist ja logige sisse iseendana. Tulemus ütleb sõnadega, kes sisse logis ja mida teenusepakkuja saatis.
  5. 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.

Ühendage oma identiteedipakkuja
Ühendage oma identiteedipakkuja
Ettevõtte sisselogimine koos testiga. Teenusepakkuja, väikeses kirjas standard ja testsisselogimine, mille tulemus kuvatakse sõnadega enne, kui keegi sellele lootma jääb.

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.

Kutsu kolleeg
Kutsu kolleeg
Kutse määrab inimese rolli – Liige või Administraator – enne tema saabumist ja võib sisaldada lühikest märkust.

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.