Verzió 1.0.0-alpha.1legújabb
2.12. fejezet
Az első indítás
A még birtokba nem vett telepítéstől a munkába állásig. Hozza létre az igénylőkódot, vegye birtokba a telepítést egy böngészőben, hozza létre az első adminisztrátort egy hozzáférési kulccsal (passkey), majd kapcsolja össze a vállalati bejelentkezést, és hívjon meg mindenki mást.
Ezt az oldalt AI fordította az eredeti angol szövegből. Ha bármi nem egyértelmű, az angol nyelvű oldal az irányadó. Oldal olvasása angolul

Amikor egy telepítés befejeződik, a telepített rendszer még senkihez sem tartozik. Nincs szervezete, nincs felhasználója és nincs munkamenete, és senki sem tud bejelentkezni. Arra vár, hogy egyetlen személy egy böngészőben igazolja, hogy a most létrehozott telepített rendszerrel kommunikál. A Harrow Port Authority-nél ez a személy Aoife Brennan, az IT vezetője volt, mellette a terminálnál Tomás Reilly állt. Ez a fejezet az első húsz percüket követi nyomon.
A sorrend kötött, és minden lépés végérvényesen lezárja az előtte lévőt: igényelje a telepített rendszert, hozza létre az első adminisztrátort és a szervezetet, állítson be egy hozzáférési kulcsot (passkey), és érkezzen meg a Ma (Today) oldalra. Ezután következik a hat előkészítendő dolog, a vállalati bejelentkezés, valamint a többiek meghívása, az Önnek megfelelő sorrendben.
Az igénylőkód létrehozása
Az igénylőkód igazolja, hogy a böngésző előtt ülő személy egy olyan felhasználó terminálját is látja, aki hozzáfér a fürthöz. Csak egy ilyen személy készíthet kódot. Futtassa ezt ott, ahol a kubeconfig eléri a fürtöt:
nexusctl claim-code --administrator aoife.brennan@harrow.exampleA(z) nexusctl claim-code megkéri a telepített rendszer kulcsszolgáltatását, a(z) nexus-keys-t, hogy készítse el a kódot. A(z) nexusctl nélkül ugyanez a parancs a kulcsszolgáltatás saját podjában fut:
kubectl -n nexus exec deploy/nexus-keys -- nexus-keys claim-code \
--administrator aoife.brennan@harrow.example --source "Tomás Reilly, ops terminal"A(z) --source néhány szó arról, hogy ki készítette a kódot. Az igénylőoldal ezeket a „Készítette” (Made by) alatt jeleníti meg, így az igénylő személy tudja, honnan származik a kód.
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
A kóddal kapcsolatban három dolog számít.
- 30 percig érvényes. Egy valaki válla fölött ellesett kód hamar használhatatlanná válik.
- 5 próbálkozást engedélyez. Az ötödik hibás kísérlet után elhasználódik, az időtől függetlenül.
- Egyetlen személynek szól. Az Ön által megadott e-mail-cím az első adminisztrátoré. Az igényléssel együtt továbbítódik, és az első adminisztrátor űrlapja rögzítettként jeleníti meg, nem kell újra begépelni.
Az ujjlenyomat nyolc, négy karakterből álló csoport, a telepített rendszer saját személyazonossága. Hagyja a képernyőn. Csoportról csoportra fogja összehasonlítani a böngészőben.
A telepítés birtokbavétele
- Azon a számítógépen, amelyet első adminisztrátorként fog használni, nyissa meg a konzol telepítési címét, itt:
https://console.harrow.example/install. Ez a telepített rendszer állapotának megfelelő oldalra irányítja: az igénylőoldalra, amíg az nyitva van, az első adminisztrátor oldalára, miután igényelték, és a konzolra, ha már be van jelentkezve. - A Telepített rendszer igénylése (Claim this installation) oldalon írja be a kódot az Első csoport (Group one), Második csoport (Group two) és Harmadik csoport (Group three) mezőkbe, mindegyikbe egy-egy négykarakteres csoportot.
- Hasonlítsa össze az oldalon található A telepített rendszer ujjlenyomata (Fingerprint of this installation) értéket a terminállal, mind a nyolc csoportot, egyesével.
- Ha minden csoport egyezik, jelölje be a Mind a nyolc csoport megegyezik azzal, amit a terminálom mutat (All eight groups match what my terminal shows) lehetőséget.
- Nyomja meg a Telepített rendszer igénylése (Claim this installation) gombot, mire az oldal megerősíti az igénylést, és továbbküldi Önt az első adminisztrátorhoz.
Az igénylés három dolgot tesz. Ezt a böngészőt teszi az egyetlen hellyé, ahol az első adminisztrátor létrehozható. Rögzíti az auditnaplóban, hogy ki és mikor igényelte a telepített rendszert. És végérvényesen kikapcsolja az igénylőoldalt. Attól kezdve az igénylési cím azt válaszolja, hogy a telepített rendszert már igényelték.
Ha az ujjlenyomat nem egyezik, álljon meg
Az eltérő ujjlenyomat azt jelenti, hogy egy másik telepített rendszer válaszol ezen a címen. Ez lehet elgépelt cím, elavult DNS-rekord (Domain Name System), vagy egy olyan gép, amelyet az első adminisztrátor csapdába ejtésére állítottak fel. Ha igényelné, az a gép birtokolná az Ön szervezetét.
Ne igényelje, és ne írja be a kódot azon az oldalon. Zárja be az oldalt, majd ellenőrizzen két dolgot: hogy a(z) console.harrow.example az Ön ingressére oldódik-e fel, és hogy a böngésző által mutatott tanúsítványt az Ön által várt CA (tanúsítványkibocsátó) állította-e ki. A saját telepített rendszere változatlan és továbbra is igénylésre vár.
Ha egy igénylést olyan ujjlenyomattal küldenek el, amely nem a telepített rendszeré, a kulcsszolgáltatás CLAIM_FINGERPRINT_MISMATCH (403) hibával elutasítja azt. Semmi sem kerül igénylésre. Az oldal ezután egymás mellett mutatja a két ujjlenyomatot, megjelölve az eltérő csoportokat, valamint a cím és a tanúsítvány ellenőrzésének lépéseit.
Az első adminisztrátor és a szervezet létrehozása
A következő oldal fejléce: „Két rövid űrlap, és bent van” (Two short forms, then you are in). Az első adminisztrátor hozzáadhat mindenki mást, és az itt szereplő adatok szinte mindegyike módosítható később. Két dolog nem, és ezeket az oldal megjelöli.
| Mező | Mi kerül ide | Módosítható később? |
|---|---|---|
| Teljes név | Az Ön neve | Igen |
| Munkahelyi e-mail-cím | Az a cím, amelyhez az igénylőkód készült; megjelenik, és nem kell újra begépelni | Ez az adminisztrátor címe |
| Szerepkör a Nexusban | Szervezeti adminisztrátor. Az első személy mindig adminisztrátor. | Nem itt választandó |
| Másodlagos ellenőrzés | Hozzáférési kulcs (passkey) ezen a laptopon | Igen, további is hozzáadható |
| Név (a szervezeté) | Harrow Port Authority | Igen |
| Ország | Ahol a szervezet székhelye van | Igen |
| Rövid név a címekben | A névből készül, például harrow-port-authority |
Nem. A hivatkozások és az exportálások használják. |
| Hol tárolják az adatokat | Ez a telepített rendszer | Nem. A későbbi módosítása új telepített rendszert jelent. |
| Nyelv és dátumok | Angol (Egyesült Királyság), a mai dátummal | Igen |
| Időzóna | A szerver időzónája | Mindenki a sajátjában látja az időpontokat |
A rövid név kisbetűkből, számjegyekből és kötőjelekből áll, legfeljebb 100 karakter hosszú, és a szervezet nevéből készül az ékezetek eltávolításával. Nézze meg, mielőtt bármit megnyomna. Minden hivatkozásban, amelyet a felhasználók megosztanak, és minden általuk készített exportálásban megjelenik, amíg a szervezet létezik.
Ezen az oldalon egy jelszót is beállít. Ez önmagában soha nem elég: egy adminisztrátor soha nem jelentkezik be pusztán jelszóval. A másodlagos ellenőrzés – alább – az, ami bejelentkezteti Önt.
Ezzel egy időben egy vészhelyzeti adminisztrátori bejelentkezés is készül. Ezt lezárják és egyszer kinyomtatják, a széf számára. Csak akkor működik, ha a vállalati bejelentkezés nem elérhető, és minden használatát rögzítik és bejelentik az összes adminisztrátornak. Tegye a széfbe még a kinyomtatás napján.
Az oldal azt is közli, hogy az Adverant nem kap értesítést arról, hogy Ön kicsoda. Ezek az adatok a telepített rendszeren maradnak. A licenc a vállalatot nevezi meg, soha nem a benne dolgozó személyeket.
Nyomja meg a Létrehozás és bejelentkezés (Create and sign in) gombot. Az adminisztrátor és a szervezet létrehozása néhány másodpercet vesz igénybe. Az oldal válasza: „Létrehozva aoife.brennan@harrow.example számára. Most állítsa be a hozzáférési kulcsát (passkey): ezzel tud bejelentkezni.”
A hozzáférési kulcs (passkey): a második ellenőrzés
- Nyomja meg a Hozzáférési kulcs beállítása és bejelentkezés (Set up the passkey and sign in) gombot.
- A böngészője megkéri egy hozzáférési kulcs (passkey) létrehozására. Touch ID-val vagy Windows Hello-val rendelkező laptopon erősítse meg ujjlenyomatával, arcával vagy PIN-kódjával. Ha a számítógép maga nem tud hozzáférési kulcsot létrehozni, a böngésző egy QR-kódot (quick response) jelenít meg: irányítsa rá telefonja kameráját, és kövesse a telefon utasításait.
- Az oldal válasza: „A hozzáférési kulcsa be van állítva, és bejelentkezett mint aoife.brennan@harrow.example.”, majd megnyitja a konzolt.
A Létrehozás és bejelentkezés (Create and sign in) megnyomásától számítva tíz perce van a hozzáférési kulcs létrehozására, ugyanabban a böngészőben. Ezután a beállítás lezárul, és az adminisztrátor hozzáférési kulcs nélkül létezik. Egy üzemeltetőnek kell segítenie, az alábbi újrapróbálkozásokról szóló részben leírtak szerint.
Mostantól az első adminisztrátor ezzel a hozzáférési kulccsal jelentkezik be. Egy teljes jogú adminisztrátor önmagában begépelt jelszava soha nem hoz létre munkamenetet: a bejelentkezési szolgáltatás a másodlagos ellenőrzés kérésével válaszol. Ez a tervezés alapvető tulajdonsága, és az oka annak, amiért a hozzáférési kulcs számít. Az elveszett hozzáférési kulcs elveszett bejutási lehetőséget jelent, ezért még az első napon adjon hozzá egy másodikat egy telefonon vagy biztonsági kulcson.
Később a felhasználók hozzáférési kulccsal, Google-lal, GitHubbal vagy a vállalati bejelentkezésükkel jelentkeznek be a telepített rendszerbe, attól függően, hogy a szervezet melyiket engedélyezi.
| Kód | Mit jelent | Teendők |
|---|---|---|
PASSKEY_UNSUPPORTED |
Ez a böngésző nem tud hozzáférési kulcsot létrehozni. Semmi sem lett beállítva. | Nyissa meg az oldalt egy olyan böngészőben, amely támogatja a hozzáférési kulcsokat, ugyanazon a számítógépen. |
PASSKEY_CANCELLED |
A felugró ablakot bezárták, vagy nem választottak semmit időben. Semmi sem lett elküldve. | Nyomja meg újra a gombot. |
Az első Today oldal
A konzol a Ma (Today) oldalon nyílik meg, és az első napon szinte minden üres rajta. Minden üres terület leírja, mi fog ott megjelenni, és megadja az azt elindító gombot, így az „Adminisztrátort igényel” (Needs an administrator) rész jelzi, hogy a kérések ott fognak várakozni, amint a felhasználók csatlakoznak, mellette az Emberek meghívása (Invite people) gombbal. A beállítási ellenőrzőlista mutatja, hogy a lépései közül hány készült el, tetszőleges sorrendben. Az egyetlen valódi előzmény, maga a beállítás, már szerepel a „Mi változott” (What changed) alatt: a telepített rendszer beállítva, és az első adminisztrátor hozzáférési kulcsa elkészült.
Hat teendő, mielőtt bárki bejelentkezne
A Hat dolog, mielőtt bárki bejelentkezik (Six things before anyone signs in) oldal felsorolja, minek kell teljesülnie, mielőtt meghívná a felhasználókat. Ez nem egy varázsló. Végezze el őket tetszőleges sorrendben, az oldal pedig számolja őket („Hatból három teljesült”).
| Elem | Mitől teljesül |
|---|---|
| Licenc | Importált Enterprise licenc. 2.13. fejezet, Licencek. A Community kiadáshoz nincs szükség licencre. |
| Cím és tanúsítvány | A nyilvános cím olyan tanúsítvánnyal válaszol, amelynek a lánca teljes. |
| Biztonsági mentések | Beállított biztonságimentés-ütemezés, írható célhellyel. |
| Vállalati bejelentkezés | Csatlakoztatva és tesztelve. Addig a felhasználók hozzáférési kulcsokat használnak. |
| Levelezés | Beállított levelezőszerver. Addig nem küldhetők meghívók. |
| AI-modell | Egy AI-modell (mesterséges intelligencia): egy szervezeti modellkulcs vagy egy modell a saját hardverén. Addig az asszisztens várakozik. 2.14. fejezet, AI-szolgáltatók és -modellek. |
Az Emberek meghívása (Invite people) akkor nyílik meg, ha mind a hat teljesült.
Ugyanez az oldal felsorolja, mi válik rögzítetté, amint a felhasználók bejelentkeznek, mindegyiknél megadva az okot: a rövid név a címekben, az adatok tárolási helye és a kulcsőrző (a kulcsok átkerülhetnek szoftveres kulcsőrzőből hardveresbe, de vissza soha). A szervezet neve is szerepel a listán, mert érdemes ellenőrizni, bár az változhat.
A Nexus senki AI-kérésére nem válaszol, amíg a szervezet nem rendelkezik modellel. A telepített rendszer mögött nincs megosztott kulcs és nincs tartalék megoldás, így a modellkulcs nélküli szervezet egyértelmű elutasítást kap, amely megmondja az adminisztrátornak, mit kell hozzáadnia.
Vállalati bejelentkezés
A legtöbb szervezet azt szeretné, ha a felhasználók a már meglévő fiókjukkal jelentkeznének be. Csatlakoztassa személyazonosság-szolgáltatóját a vállalati bejelentkezés oldalon: OIDC-n (OpenID Connect) keresztül Community kiadásban, vagy OIDC-n, illetve SAML-en (Security Assertion Markup Language) keresztül Enterprise kiadásban.
- Válassza ki a szolgáltatót és az általa használt szabványt.
- Adja meg a személyazonosság-szolgáltatótól kapott alkalmazásazonosítót és titkos alkalmazáskulcsot. A titkos kulcs a mentés után soha többé nem jelenik meg.
- Adja meg, ki jelentkezhet be, például bárki, aki
@harrow.examplecímmel rendelkezik. - Nyomja meg a Bejelentkezés tesztelése (Test sign-in) gombot, és jelentkezzen be saját magaként. Az eredmény szövegesen közli, hogy ki jelentkezett be, és mit küldött a szolgáltató.
- Mentse el.
A Community kiadás egy vállalati bejelentkezést biztosít a szervezet számára. Az Enterprise kiadás kikényszerítést és címtár-szinkronizálást is kínál. A kikényszerítés kikapcsolja a jelszavakat, így mindenkinek a vállalati bejelentkezést kell használnia, a jelszavas próbálkozást pedig a rendszer SSO_REQUIRED hibával és a megfelelő belépési módra mutató gombbal utasítja el. A címtár-szinkronizálás 15 percenként átmásolja a személyeket és csoportokat az Ön címtárából, és egy megnevezett csoportból adminisztrátorokat hozhat létre.
Amikor a vállalati bejelentkezés nem válaszol, a már bejelentkezett felhasználók bejelentkezve maradnak, az új bejelentkezéseket pedig a rendszer IDP_UNREACHABLE (503) hibával elutasítja. Egy adminisztrátor ekkor használhatja a széfből kivett vészhelyzeti adminisztrátori bejelentkezést, a hozzáférési kulcsával együtt. Minden használat bekerül az auditnaplóba, bejelentésre kerül minden adminisztrátornak, és négy óra elteltével vagy a vállalati bejelentkezés visszatérésekor véget ér.
Munkatársak meghívása
A levelezés beállítása után hívjon meg felhasználókat az Emberek (People) oldalról. Mindegyikükhöz adja meg az e-mail-címet és egy szerepkört:
- A Tag (Member) használ mindent, amivel a szervezet rendelkezik, és nem módosít semmilyen beállítást.
- Az Adminisztrátor (Administrator) emellett kezeli a felhasználókat, a modelleket, a költségvetéseket és a beállításokat.
Egy meghívó 7 napig érvényes. A személy megnyitja, látja, ki hívta meg, mi a szerepköre és mit fog látni, majd bejelentkezik. Az első bejelentkezéskor a rendszer másodlagos ellenőrzést kér.
A meghívott tagok bejelentkeznek a konzolra, és ott végzik napi munkájukat: Ma (Today), az asszisztens, csapatcsevegés, fájlok és keresés, jegyzetfüzetek, ügynökök és munkafolyamatok, ahogy azt a szerepkörük engedi. Az adminisztrátorok az adminisztrációs oldalakat is látják. Az a tag, aki megnyit egy adminisztrátori oldalt, a „Nem adminisztrátor” (Not an administrator) oldalt kapja. Ez írásvédetten mutatja a beállításokat, megmondja az okot, és felajánlja, hogy kérjen meg egy adminisztrátort.
A regisztrációkhoz jóváhagyás szükséges
A felhasználók úgy is kérhetik a csatlakozást, hogy maguk regisztrálnak. Egy telepített rendszeren egy idegen regisztrációja nem hoz létre működő fiókot. A nexus-auth SIGNUP_REQUIRES_APPROVAL (403) hibával elutasítja, és visszatartja egy adminisztrátor jóváhagyására várva.
Két másik regisztrációs vezérlő is létezik az Adverant által üzemeltetett szolgáltatásban, amelyek minden telepített rendszeren ki vannak kapcsolva, és nincs olyan érték, amellyel be lehetne kapcsolni őket. Az internetes CAPTCHA-hoz minden regisztrációnál internetkapcsolatra lenne szükség. A regisztrációs hálózati szűréshez olyan licencelt geolokációs adatbázisra lenne szükség, amelyet a telepített rendszer nem tartalmaz. A jóváhagyás a telepített rendszer kapuja.
Újrapróbálkozások, lejárt kódok és egyéb elutasítások
Az első indítás során minden elutasítás közli, hogy mi történt, hogy semmi sem változott (ahol ez igaz), és hogy mi a következő teendő.
| Kód | Állapot | Mikor | Teendők |
|---|---|---|---|
CLAIM_CODE_EXPIRED |
410 | A 30 perc letelt. Semmi sem került igénylésre, és semmi sem változott. | Készítsen új kódot a(z) nexusctl claim-code --administrator <email> paranccsal, majd nyomja meg a Van új kódom (I have a new code) gombot. |
CLAIM_FINGERPRINT_MISMATCH |
403 | Az elküldött ujjlenyomat nem ennek a telepített rendszernek az ujjlenyomata. | Álljon meg. Ellenőrizze a címet és a tanúsítványt. |
TRANSITION_NOT_PERMITTED |
409 | Egy már megtörtént lépést kértek újra: az igénylést egy már igényelt telepített rendszeren, vagy az első adminisztrátor létrehozását másodszor. | Jelentkezzen be a konzolon; az első adminisztrátor ad hozzá mindenki mást. |
TRANSITION_NOT_PERMITTED |
409 | A hozzáférési kulcs lépése egy olyan böngészőből, ahol nem várakozik első adminisztrátor, vagy a tíz perc letelte után. | Lásd alább. |
RATE_LIMITED |
429 | Túl sok próbálkozás az első indítás oldalain egy percen belül. Semmi sem lett elküldve. | Várja meg az oldal által megadott másodperceket, majd próbálja újra. |
Egy olyan kód, amelynél nem maradt több próbálkozás, a „Ehhez a kódhoz nem maradt több próbálkozás” (This code has no tries left) üzenetet mutatja. Készítsen újat, ugyanúgy, mint a lejárt kód esetében. Csak olyan valaki teheti ezt meg, aki hozzáfér a fürthöz, ami éppen a lényeg.
Az első indítás oldalai együttesen percenként 20 próbálkozást fogadnak el. Ha nem Ön tette ezeket a kísérleteket, akkor valaki más a hálózatán próbálkozik az oldallal, és erről érdemes tudni.
Amikor a hozzáférési kulcs lépése kimaradt
Ha az első adminisztrátort létrehozták, de tíz percen belül nem készült hozzáférési kulcs, vagy a böngészőt bezárták, az adminisztrátor létezik, de nincs módja bejelentkezni. A hozzáférési kulcs lépése TRANSITION_NOT_PERMITTED hibával és a következő szavakkal válaszol: „Ha több mint tíz perce hozta létre az első adminisztrátort ebben a böngészőben, kérjen meg egy üzemeltetőt: az adminisztrátor létezik, és még nincs hozzáférési kulcsa”. Az igénylés ezen a ponton már elhasználódott, így egy új igénylőkód nem segít. Kérje meg a telepítést futtató üzemeltetőt, mielőtt bármi mással próbálkozna.
Amikor a böngésző elvesztette az igénylést
Az igénylés abban a böngészőben él, amelyik létrehozta, egy olyan sütiben, amelyet az oldal nem tud olvasni. Ha az a böngésző elveszíti azt az igénylés és az első adminisztrátor létrehozása között – például egy bezárt privát ablakban –, az első adminisztrátor űrlapja elfogadja az igénylőfájlt és annak beállítási titkos kulcsát is, kézzel beillesztve.
Miután Aoife megkapta a hozzáférési kulcsát, Tomás bezárta a terminálját. Az igénylőoldal ki volt kapcsolva, az első adminisztrátor létezett, és minden további bejutási út mostantól rajta keresztül vezetett.






