Versio 1.0.0-alpha.1uusin
Luku 2.12
Ensimmäinen käyttökerta
Lunastamattomasta asennuksesta työn ääreen. Luo lunastuskoodi, lunasta asennus selaimessa, luo ensimmäinen pääkäyttäjä avainkoodilla, yhdistä sitten yrityksen kirjautuminen ja kutsu kaikki muut.
Tämä sivu on käännetty tekoälyllä englanninkielisestä alkuperäistekstistä. Jos jokin kohta on epäselvä, englanninkielinen sivu on ensisijainen lähde. Lue tämä sivu englanniksi

Kun asennus valmistuu, se ei kuulu kenellekään. Sillä ei ole organisaatiota, käyttäjää eikä istuntoa, eikä kukaan voi kirjautua sisään. Se odottaa yhtä henkilöä todistamaan selaimessa, että hän on yhteydessä juuri luotuun asennukseen. Harrow Port Authorityssa tämä henkilö oli tietohallintojohtaja Aoife Brennan, ja hänen vieressään päätteen ääressä oli Tomás Reilly. Tämä luku seuraa heidän ensimmäisiä kahtakymmentä minuuttiaan.
Järjestys on kiinteä, ja jokainen vaihe sulkee edellisen pysyvästi: ota asennus haltuun, luo ensimmäinen pääkäyttäjä ja organisaatio, määritä avainkoodi ja siirry Tänään-sivulle. Tämän jälkeen ovat vuorossa kuusi valmisteltavaa asiaa, yrityskirjautuminen ja muiden kutsuminen haluamassasi järjestyksessä.
Luo lunastuskoodi
Haltuunottokoodi todistaa, että selaimen äärellä oleva henkilö näkee myös klusteriin pääsevän henkilön päätteen. Vain tällainen henkilö voi luoda koodin. Suorita tämä siellä, missä kubeconfig-määritykselläsi on yhteys klusteriin:
nexusctl claim-code --administrator aoife.brennan@harrow.examplenexusctl claim-code pyytää asennuksen avainpalvelua, nexus-keys, luomaan koodin. Ilman komentoa nexusctl sama komento suoritetaan avainpalvelun omassa podissa:
kubectl -n nexus exec deploy/nexus-keys -- nexus-keys claim-code \
--administrator aoife.brennan@harrow.example --source "Tomás Reilly, ops terminal"--source on muutama sana, jotka kertovat, kuka koodin loi. Haltuunottosivu näyttää ne kohdassa "Tekijä", jotta haltuunottaja tietää, mistä koodi on peräisin.
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
Koodissa on kolme tärkeää seikkaa.
- Se on voimassa 30 minuuttia. Olkapään yli nähty koodi on pian hyödytön.
- Se sallii 5 yritystä. Viidennen väärän yrityksen jälkeen se on käytetty loppuun ajasta riippumatta.
- Se on tarkoitettu yhdelle henkilölle. Antamasi sähköpostiosoite kuuluu ensimmäiselle pääkäyttäjälle. Se kulkee haltuunoton mukana, ja ensimmäisen pääkäyttäjän lomake näyttää sen kiinteänä, eikä sitä kirjoiteta uudelleen.
Sormenjälki koostuu kahdeksasta neljän merkin ryhmästä, ja se on asennuksen oma tunniste. Jätä se näkyviin näytölle. Vertaat sitä selaimessa ryhmä kerrallaan.
Lunasta asennus
- Avaa sillä tietokoneella, jota käytät ensimmäisenä pääkäyttäjänä, konsolin asennusosoite, tässä
https://console.harrow.example/install. Se ohjaa sinut asennuksen tilaa vastaavalle sivulle: haltuunottosivulle sen ollessa avoinna, ensimmäisen pääkäyttäjän sivulle, kun asennus on otettu haltuun, ja konsoliin, jos olet jo kirjautunut sisään. - Kirjoita Ota tämä asennus haltuun -sivulla koodi kenttiin Ryhmä yksi, Ryhmä kaksi ja Ryhmä kolme, yksi neljän merkin ryhmä kuhunkin.
- Vertaa sivun kohtaa Tämän asennuksen sormenjälki päätteeseen, kaikki kahdeksan ryhmää yksi kerrallaan.
- Jos jokainen ryhmä täsmää, valitse Kaikki kahdeksan ryhmää vastaavat päätteeni näyttämää.
- Paina Ota tämä asennus haltuun, jolloin sivu vahvistaa haltuunoton ja ohjaa sinut eteenpäin ensimmäisen pääkäyttäjän luontiin.
Haltuunotto tekee kolme asiaa. Se tekee tästä selaimesta ainoan paikan, jossa ensimmäinen pääkäyttäjä voidaan luoda. Se kirjaa tarkastuslokiin, kuka otti asennuksen haltuun ja milloin. Lisäksi se poistaa haltuunottosivun käytöstä pysyvästi. Siitä lähtien haltuunotto-osoite vastaa, että asennus on jo otettu haltuun.
Jos sormenjälki ei täsmää, lopeta
Eri sormenjälki tarkoittaa, että tässä osoitteessa vastaa eri asennus. Kyseessä voi olla väärin kirjoitettu osoite, vanhentunut DNS (Domain Name System) -tietue tai kone, joka on pystytetty sieppaamaan ensimmäinen pääkäyttäjä. Jos ottaisit sen haltuun, organisaatiosi päätyisi kyseisen koneen haltuun.
Älä ota asennusta haltuun äläkä kirjoita koodia kyseiselle sivulle. Sulje sivu ja tarkista sitten kaksi asiaa: että console.harrow.example osoittaa omaan ingressiisi ja että selaimen näyttämä varmenne on odottamasi varmentajan (CA, certificate authority) myöntämä. Oma asennuksesi on muuttumaton ja edelleen vailla haltijaa.
Jos haltuunottopyyntö lähetetään sormenjäljellä, joka ei kuulu asennukselle, avainpalvelu hylkää sen virheellä CLAIM_FINGERPRINT_MISMATCH (403). Mitään ei oteta haltuun. Sivu näyttää tällöin kaksi sormenjälkeä rinnakkain, merkitsee poikkeavat ryhmät ja antaa ohjeet osoitteen ja varmenteen tarkistamiseen.
Luo ensimmäinen pääkäyttäjä ja organisaatio
Seuraavan sivun otsikko on "Kaksi lyhyttä lomaketta, ja olet sisällä". Ensimmäinen pääkäyttäjä voi lisätä kaikki muut, ja lähes kaikkea täällä olevaa voi muuttaa myöhemmin. Kahta asiaa ei voi muuttaa, ja sivu merkitsee ne.
| Kenttä | Mitä syötetään | Voiko sitä muuttaa myöhemmin? |
|---|---|---|
| Koko nimi | Nimesi | Kyllä |
| Työsähköposti | Osoite, jolle haltuunottokoodi luotiin; näytetään valmiina eikä kirjoiteta uudelleen | Se on pääkäyttäjän osoite |
| Rooli Nexusissa | Organisaation pääkäyttäjä. Ensimmäinen henkilö on aina pääkäyttäjä. | Ei valita tässä |
| Toinen vahvistus | Avainkoodi tällä kannettavalla tietokoneella | Kyllä, uusia voi lisätä |
| Nimi (organisaation) | Harrow Port Authority | Kyllä |
| Maa | Missä organisaatio sijaitsee | Kyllä |
| Lyhyt nimi osoitteissa | Muodostetaan nimestä, esimerkiksi harrow-port-authority |
Ei. Linkit ja viennit käyttävät sitä. |
| Missä tietoja säilytetään | Tämä asennus | Ei. Sen muuttaminen myöhemmin tarkoittaa uutta asennusta. |
| Kieli ja päivämäärät | Englanti (UK) ja tämä päivämäärä | Kyllä |
| Aikavyöhyke | Palvelimen aikavyöhyke | Jokainen näkee ajat omalla aikavyöhykkeellään |
Lyhyt nimi koostuu pienistä kirjaimista, numeroista ja yhdysmerkeistä. Se on enintään 100 merkkiä pitkä, ja se muodostetaan organisaation nimestä poistamalla tarkkeet. Tarkista se ennen kuin painat mitään. Se näkyy jokaisessa linkissä, jonka käyttäjät jakavat, ja jokaisessa viennissä, jonka he tekevät, niin kauan kuin organisaatio on olemassa.
Asetat tällä sivulla myös salasanan. Se ei koskaan riitä yksinään: pääkäyttäjä ei koskaan kirjaudu sisään pelkällä salasanalla. Alla oleva toinen vahvistus on se, joka kirjaa sinut sisään.
Samalla luodaan pääkäyttäjän hätäkirjautuminen. Se sinetöidään ja tulostetaan kerran kassakaappia varten. Se toimii vain silloin, kun yrityskirjautuminen on poissa käytöstä, ja jokainen käyttökerta kirjataan ja ilmoitetaan kaikille pääkäyttäjille. Laita se kassakaappiin samana päivänä, kun tulostat sen.
Sivulla kerrotaan myös, ettei Adverantille ilmoiteta, kuka olet. Nämä tiedot pysyvät asennuksessa. Lisenssi nimeää yrityksen, ei koskaan sen henkilöitä.
Paina Luo ja kirjaudu sisään. Pääkäyttäjän ja organisaation luominen kestää muutaman sekunnin. Sivu vastaa: "Luotu käyttäjälle aoife.brennan@harrow.example. Määritä nyt avainkoodisi: sen avulla kirjaudut sisään."
Avainkoodi: toinen tarkistus
- Paina Määritä avainkoodi ja kirjaudu sisään.
- Selaimesi pyytää sinua luomaan avainkoodin. Jos kannettavassa tietokoneessa on Touch ID tai Windows Hello, vahvista sormenjäljellä, kasvoilla tai PIN-koodilla. Jos tietokone ei pysty itse luomaan avainkoodia, selain näyttää QR (quick response) -koodin: osoita sitä puhelimesi kameralla ja seuraa puhelimen ohjeita.
- Sivu vastaa "Avainkoodisi on määritetty ja olet kirjautunut sisään käyttäjänä aoife.brennan@harrow.example." ja avaa konsolin.
Sinulla on Luo ja kirjaudu sisään -painikkeen painamisesta kymmenen minuuttia aikaa luoda avainkoodi samassa selaimessa. Sen jälkeen käyttöönotto suljetaan, ja pääkäyttäjä on olemassa ilman avainkoodia. Tällöin ylläpitäjän on autettava, kuten alla olevassa uudelleenyrityksiä käsittelevässä kohdassa kuvataan.
Tästä lähtien ensimmäinen pääkäyttäjä kirjautuu sisään kyseisellä avainkoodilla. Täysivaltaisen pääkäyttäjän salasana yksinään kirjoitettuna ei koskaan avaa istuntoa: kirjautumispalvelu vastaa pyytämällä toista vahvistusta. Tämä on suunnitteluominaisuus ja syy siihen, miksi avainkoodi on tärkeä. Kadonnut avainkoodi tarkoittaa menetettyä pääsyä, joten lisää toinen avainkoodi puhelimeen tai turva-avaimeen jo ensimmäisenä päivänä.
Myöhemmin käyttäjät kirjautuvat asennukseen avainkoodilla, Googlella, GitHubilla tai yrityksensä kirjautumisella sen mukaan, minkä organisaatio sallii.
| Koodi | Mitä se tarkoittaa | Mitä tehdä |
|---|---|---|
PASSKEY_UNSUPPORTED |
Tämä selain ei pysty luomaan avainkoodia. Mitään ei määritetty. | Avaa sivu samalla tietokoneella selaimessa, joka tukee avainkoodeja. |
PASSKEY_CANCELLED |
Kehote suljettiin tai mitään ei valittu ajoissa. Mitään ei lähetetty. | Paina painiketta uudelleen. |
Ensimmäinen Today-sivu
Konsoli avautuu Tänään-näkymään, ja ensimmäisenä päivänä lähes kaikki siinä on tyhjää. Jokainen tyhjä alue kertoo, mitä sinne tulee näkyviin, ja tarjoaa painikkeen toiminnon aloittamiseen: esimerkiksi "Vaatii pääkäyttäjää" kertoo, että pyynnöt odottavat siellä, kunhan ihmisiä liittyy mukaan, ja sen vieressä on Kutsu ihmisiä -painike. Käyttöönoton tarkistuslista kertoo, kuinka monta sen vaiheista on tehty, missä tahansa järjestyksessä. Ainoa todellinen tapahtumahistoria, itse käyttöönotto, on jo kohdassa "Mikä muuttui": asennus on otettu käyttöön ja ensimmäisen pääkäyttäjän avainkoodi on luotu.
Kuusi asiaa ennen kuin kukaan kirjautuu sisään
Sivu Kuusi asiaa ennen kuin kukaan kirjautuu sisään luettelee, minkä ehtojen on täytyttävä ennen kuin ihmisiä kutsutaan. Se ei ole ohjattu toiminto. Tee ne missä tahansa järjestyksessä, ja sivu laskee ne ("Kolme kuudesta valmiina").
| Asia | Mikä tekee siitä valmiin |
|---|---|
| Lisenssi | Enterprise-lisenssi on tuotu. Luku 2.13, Lisenssit. Community ei tarvitse lisenssiä. |
| Osoite ja varmenne | Julkinen osoite vastaa varmenteella, jonka ketju on täydellinen. |
| Varmuuskopiot | Varmuuskopiointiaikataulu on asetettu ja kohteeseen voidaan kirjoittaa. |
| Yrityskirjautuminen | Yhdistetty ja testattu. Siihen asti käyttäjät käyttävät avainkoodeja. |
| Sähköposti | Sähköpostipalvelin on asetettu. Siihen asti kutsuja ei voida lähettää. |
| Tekoälymalli | Tekoälymalli (AI, artificial intelligence): organisaation malliavain tai malli omalla laitteistollasi. Siihen asti avustaja odottaa. Luku 2.14, Tekoälypalveluntarjoajat ja -mallit. |
Kutsu ihmisiä avautuu, kun kaikki kuusi kohtaa ovat valmiina.
Samalla sivulla luetellaan syineen, mitkä asiat muuttuvat kiinteiksi, kun käyttäjät kirjautuvat sisään: lyhyt nimi osoitteissa, tietojen säilytyspaikka ja avainten säilyttäjä (avaimet voidaan siirtää ohjelmistopohjaiselta säilyttäjältä laitteistolle, mutta ei koskaan takaisin). Myös organisaation nimi on luettelossa, koska se kannattaa tarkistaa, vaikka sitä voikin muuttaa.
Nexus ei vastaa kenenkään tekoälypyyntöön ennen kuin organisaatiolla on malli. Asennuksen taustalla ei ole jaettua avainta eikä varajärjestelmää, joten ilman malliavainta oleva organisaatio saa selkeän hylkäyksen, joka kertoo pääkäyttäjälle, mitä pitää lisätä.
Yrityksen kirjautuminen
Useimmat organisaatiot haluavat ihmisten kirjautuvan sisään tileillä, jotka heillä jo on. Yhdistä identiteetinhallintapalvelusi yrityskirjautumissivulla: OIDC:n (OpenID Connect) kautta Community-versiossa tai OIDC:n tai SAML:n (Security Assertion Markup Language) kautta Enterprise-versiossa.
- Valitse palveluntarjoaja ja sen käyttämä standardi.
- Syötä identiteetinhallintapalvelusi antama sovellustunnus ja sovellussalaisuus. Salaisuutta ei koskaan näytetä uudelleen tallentamisen jälkeen.
- Määritä, ketkä saavat kirjautua sisään, esimerkiksi kuka tahansa, jolla on
@harrow.example-osoite. - Paina Testaa kirjautumista ja kirjaudu sisään omana itsenäsi. Tulos kertoo sanallisesti, kuka kirjautui sisään ja mitä palveluntarjoaja lähetti.
- Tallenna.
Community-versio sisältää yhden yrityskirjautumisen organisaatiolle. Enterprise lisää pakotuksen ja hakemistosynkronoinnin. Pakotus poistaa salasanat käytöstä, jolloin kaikkien on käytettävä yrityskirjautumista, ja salasanayritys hylätään koodilla SSO_REQUIRED sekä painikkeella, joka ohjaa oikeaan kirjautumistapaan. Hakemistosynkronointi kopioi henkilöt ja ryhmät hakemistostasi 15 minuutin välein ja voi tehdä pääkäyttäjiä yhdestä nimetystä ryhmästä.
Kun yrityskirjautuminen lakkaa vastaamasta, jo sisäänkirjautuneet henkilöt pysyvät kirjautuneina, ja uudet kirjautumiset hylätään koodilla IDP_UNREACHABLE (503). Tällöin pääkäyttäjä voi käyttää kassakaapissa olevaa pääkäyttäjän hätäkirjautumista yhdessä avainkoodinsa kanssa. Jokainen käyttökerta kirjataan tarkastuslokiin, ilmoitetaan jokaiselle pääkäyttäjälle ja päättyy neljän tunnin kuluttua tai kun yrityskirjautuminen palaa käyttöön.
Kutsu ihmisiä
Kun sähköposti on määritetty, kutsu ihmisiä Ihmiset-sivulta. Anna jokaiselle sähköpostiosoite ja rooli:
- Jäsen käyttää kaikkea, mitä organisaatiolla on, eikä muuta mitään asetuksia.
- Pääkäyttäjä hallinnoi lisäksi ihmisiä, malleja, budjetteja ja asetuksia.
Kutsu on voimassa 7 päivää. Henkilö avaa sen, näkee kuka hänet kutsui, roolinsa ja mitä hän tulee näkemään, ja kirjautuu sisään. Ensimmäisellä kirjautumiskerralla pyydetään toista vahvistusta.
Kutsutut jäsenet kirjautuvat konsoliin ja tekevät siellä päivittäiset työnsä: Tänään-näkymä, avustaja, tiimikeskustelu, tiedostot ja haku, muistikirjat, agentit ja työnkulut oman roolinsa sallimissa rajoissa. Pääkäyttäjät näkevät myös hallintasivut. Jäsen, joka avaa pääkäyttäjän sivun, saa eteensä "Ei pääkäyttäjä" -sivun. Se näyttää asetukset vain luku -tilassa, kertoo syyn ja tarjoaa mahdollisuutta pyytää oikeuksia pääkäyttäjältä.
Rekisteröitymiset vaativat hyväksynnän
Ihmiset voivat myös pyytää liittymistä rekisteröitymällä itse. Asennuksessa tuntemattoman henkilön rekisteröityminen ei luo toimivaa tiliä. nexus-auth hylkää sen koodilla SIGNUP_REQUIRES_APPROVAL (403) ja jättää sen odottamaan pääkäyttäjän hyväksyntää.
Adverantin ylläpitämässä palvelussa on kaksi muutakin rekisteröitymisen hallintakeinoa, mutta ne ovat poissa käytöstä jokaisessa asennuksessa, eikä niille ole asetusta, jolla ne voisi kytkeä päälle. Internet-CAPTCHA vaatisi internetyhteyden jokaisella rekisteröitymiskerralla. Rekisteröitymisen verkkoseulonta puolestaan vaatisi lisensoidun paikannustietokannan, jota asennuksessa ei ole. Hyväksyntä toimii asennuksen porttina.
Uudelleenyritykset, vanhentuneet koodit ja muut hylkäykset
Jokainen hylkäys ensimmäisen käyttökerran aikana kertoo, mitä tapahtui, ettei mikään muuttunut (kun se pitää paikkansa) ja mitä tehdä seuraavaksi.
| Koodi | Tila | Tilanne | Mitä tehdä |
|---|---|---|---|
CLAIM_CODE_EXPIRED |
410 | 30 minuuttia on kulunut. Mitään ei otettu haltuun eikä mikään muuttunut. | Luo uusi koodi komennolla nexusctl claim-code --administrator <email> ja paina sitten Minulla on uusi koodi. |
CLAIM_FINGERPRINT_MISMATCH |
403 | Lähetetty sormenjälki ei kuulu tälle asennukselle. | Lopeta. Tarkista osoite ja varmenne. |
TRANSITION_NOT_PERMITTED |
409 | Vaihetta, joka on jo suoritettu, pyydettiin uudelleen: haltuunottoa jo haltuunotetulle asennukselle tai ensimmäisen pääkäyttäjän luontia toisen kerran. | Kirjaudu sisään konsolissa; ensimmäinen pääkäyttäjä lisää kaikki muut. |
TRANSITION_NOT_PERMITTED |
409 | Avainkoodivaihe selaimesta, jossa ensimmäinen pääkäyttäjä ei ole odottamassa, tai kymmenen minuutin aikarajan jälkeen. | Katso alta. |
RATE_LIMITED |
429 | Liian monta yritystä ensimmäisen käyttökerran sivuilla yhden minuutin aikana. Mitään ei lähetetty. | Odota sivun ilmoittamat sekunnit ja yritä sitten uudelleen. |
Koodi, jolla ei ole yrityksiä jäljellä, näyttää ilmoituksen "Tällä koodilla ei ole yrityksiä jäljellä". Luo uusi koodi samalla tavalla kuin vanhentuneelle koodille. Vain henkilö, jolla on pääsy klusteriin, voi tehdä sen, mikä onkin koko asian tarkoitus.
Ensimmäisen käyttökerran sivut sallivat yhteensä 20 yritystä minuutissa. Jos et tehnyt näitä yrityksiä itse, joku muu verkossasi yrittää käyttää sivua, ja se on hyvä tietää.
Kun avainkoodivaihe jäi väliin
Jos ensimmäinen pääkäyttäjä luotiin, mutta avainkoodia ei luotu kymmenen minuutin kuluessa tai selain suljettiin, pääkäyttäjä on olemassa ilman tapaa kirjautua sisään. Avainkoodivaihe vastaa koodilla TRANSITION_NOT_PERMITTED ja sanoilla "Jos loit ensimmäisen pääkäyttäjän tässä selaimessa yli kymmenen minuuttia sitten, pyydä apua ylläpitäjältä: pääkäyttäjä on olemassa, mutta sillä ei ole vielä avainkoodia". Haltuunotto on tässä vaiheessa käytetty, joten uusi haltuunottokoodi ei auta. Pyydä apua asennuksen suorittaneelta ylläpitäjältä ennen kuin mitään muuta yritetään.
Kun selain kadotti haltuunoton
Haltuunotto säilyy sen tehneessä selaimessa evästeessä, jota sivu ei voi lukea. Jos kyseinen selain kadottaa sen haltuunoton ja ensimmäisen pääkäyttäjän luonnin välillä – esimerkiksi suljetussa yksityisessä ikkunassa – ensimmäisen pääkäyttäjän lomake hyväksyy myös haltuunottotiedoston ja sen käyttöönottosalaisuuden käsin liitettynä.
Kun Aoife oli saanut avainkoodinsa, Tomás sulki päätteensä. Haltuunottosivu oli poissa käytöstä, ensimmäinen pääkäyttäjä oli olemassa, ja jokainen muu reitti sisään kulki nyt hänen kauttaan.






