Versione 1.0.0-alpha.1ultima
Capitolo 2.12
Il primo avvio
Da un'installazione non rivendicata alle persone al lavoro. Generate il codice di rivendicazione, rivendicate l'installazione in un browser, create il primo amministratore con una passkey, quindi collegate il sistema di accesso aziendale e invitate tutti gli altri.
Questa pagina è stata tradotta dall'IA a partire dall'originale in inglese. In caso di dubbi, fa fede la pagina in inglese. Legga questa pagina in inglese

Al termine di un'installazione, questa non appartiene a nessuno. Non ha organizzazione, né persone, né sessioni, e nessuno può accedere. Attende che una persona dimostri, in un browser, di stare comunicando con l'installazione appena creata. Presso la Harrow Port Authority quella persona era Aoife Brennan, responsabile IT, con Tomás Reilly al suo fianco al terminale. Questo capitolo ripercorre i loro primi venti minuti.
L'ordine è fisso e ogni passaggio chiude definitivamente quello precedente: rivendicare l'installazione, creare il primo amministratore e l'organizzazione, configurare una passkey e arrivare alla pagina Oggi. Dopodiché seguono i sei elementi da preparare, l'accesso aziendale e l'invito di tutti gli altri, nell'ordine che preferite.
Generare il codice di rivendicazione
Il codice di rivendicazione dimostra che la persona davanti al browser può anche vedere il terminale di qualcuno con accesso al cluster. Solo una persona in queste condizioni può generarne uno. Eseguite questo comando da una posizione in cui il vostro kubeconfig raggiunge il cluster:
nexusctl claim-code --administrator aoife.brennan@harrow.examplenexusctl claim-code chiede al servizio chiavi dell'installazione, nexus-keys, di generare il codice. Senza nexusctl, lo stesso comando viene eseguito direttamente nel pod del servizio chiavi:
kubectl -n nexus exec deploy/nexus-keys -- nexus-keys claim-code \
--administrator aoife.brennan@harrow.example --source "Tomás Reilly, ops terminal"--source consiste in poche parole che indicano chi ha generato il codice. La pagina di rivendicazione le mostra sotto "Creato da", in modo che la persona che effettua la rivendicazione sappia da dove proviene il codice.
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
Tre aspetti del codice sono importanti.
- Dura 30 minuti. Un codice sbirciato alle spalle di qualcuno diventa presto inutile.
- Consente 5 tentativi. Dopo il quinto tentativo errato si esaurisce, indipendentemente dal tempo trascorso.
- È per una sola persona. L'email che indicate è quella del primo amministratore. Viaggia insieme alla rivendicazione e il modulo del primo amministratore la mostra come fissa, senza doverla digitare di nuovo.
L'impronta digitale è composta da otto gruppi di quattro caratteri e rappresenta l'identità stessa dell'installazione. Lasciatela sullo schermo. La confronterete, gruppo per gruppo, nel browser.
Rivendicare l'installazione
- Sul computer che userete come primo amministratore, aprite l'indirizzo di installazione della console, qui
https://console.harrow.example/install. Vi indirizzerà alla pagina corretta per lo stato dell'installazione: la pagina di rivendicazione mentre è aperta, la pagina del primo amministratore una volta rivendicata e la console se avete già effettuato l'accesso. - In Rivendica questa installazione, digitate il codice in Gruppo uno, Gruppo due e Gruppo tre, un gruppo di quattro caratteri in ciascuno.
- Confrontate l'Impronta digitale di questa installazione sulla pagina con il terminale, tutti gli otto gruppi, uno alla volta.
- Se ogni gruppo corrisponde, spuntate Tutti gli otto gruppi corrispondono a quanto mostrato dal mio terminale.
- Premete Rivendica questa installazione; la pagina confermerà la rivendicazione e vi reindirizzerà al primo amministratore.
La rivendicazione compie tre azioni. Rende questo browser l'unico posto in cui è possibile creare il primo amministratore. Registra chi ha rivendicato l'installazione, e quando, nel log di audit. E disattiva definitivamente la pagina di rivendicazione. Da quel momento in poi, l'indirizzo di rivendicazione risponde che l'installazione è stata rivendicata.
Se l'impronta digitale non corrisponde, fermatevi
Un'impronta digitale diversa significa che a questo indirizzo sta rispondendo un'installazione diversa. Potrebbe trattarsi di un indirizzo digitato male, di un record DNS (Domain Name System) obsoleto o di una macchina configurata per intercettare il primo amministratore. Se la rivendicaste, quella macchina conterrebbe la vostra organizzazione.
Non effettuate la rivendicazione e non digitate il codice su quella pagina. Chiudete la pagina, quindi verificate due cose: che console.harrow.example risolva verso il vostro ingress e che il certificato mostrato dal browser sia emesso dalla CA (autorità di certificazione) prevista. La vostra installazione è intatta e ancora non rivendicata.
Se viene inviata una rivendicazione con un'impronta digitale che non è quella dell'installazione, il servizio chiavi la rifiuta con CLAIM_FINGERPRINT_MISMATCH (403). Non viene rivendicato nulla. La pagina mostra quindi le due impronte digitali affiancate, evidenziando i gruppi che differiscono, e i passaggi per verificare l'indirizzo e il certificato.
Creare il primo amministratore e l'organizzazione
La pagina successiva è intitolata "Due brevi moduli, poi siete dentro". Il primo amministratore può aggiungere tutti gli altri e quasi tutto ciò che si trova qui può essere modificato in seguito. Due cose non possono essere modificate, e la pagina le segnala.
| Campo | Cosa inserire | Può cambiare in seguito? |
|---|---|---|
| Nome completo | Il vostro nome | Sì |
| Email di lavoro | L'indirizzo per cui è stato generato il codice di rivendicazione, mostrato senza doverlo digitare di nuovo | È l'indirizzo dell'amministratore |
| Ruolo in Nexus | Amministratore dell'organizzazione. La prima persona è sempre un amministratore. | Non selezionabile qui |
| Secondo controllo | Passkey su questo portatile | Sì, se ne possono aggiungere altre |
| Nome (dell'organizzazione) | Harrow Port Authority | Sì |
| Paese | Dove ha sede l'organizzazione | Sì |
| Nome breve negli indirizzi | Ricavato dal nome, ad esempio harrow-port-authority |
No. I link e le esportazioni lo utilizzano. |
| Dove sono conservati i dati | Questa installazione | No. Cambiarlo in seguito comporta una nuova installazione. |
| Lingua e date | Inglese (Regno Unito), con la data di oggi | Sì |
| Fuso orario | Il fuso orario del server | Ogni persona vede gli orari nel proprio |
Il nome breve è composto da lettere minuscole, cifre e trattini, fino a 100 caratteri, ricavato dal nome dell'organizzazione rimuovendo gli accenti. Controllatelo prima di premere qualsiasi pulsante. Apparirà in ogni link condiviso dalle persone e in ogni esportazione effettuata, per tutta la durata dell'organizzazione.
Su questa pagina impostate anche una password. Non è mai sufficiente da sola: un amministratore non accede mai solo con una password. Il secondo controllo, qui sotto, è ciò che vi consente di accedere.
Allo stesso tempo viene generato un accesso di emergenza per l'amministratore. Viene sigillato e stampato una sola volta, per essere riposto in cassaforte. Funziona solo quando l'accesso aziendale è fuori servizio e ogni utilizzo viene registrato e notificato a tutti gli amministratori. Mettetelo in cassaforte il giorno stesso in cui lo stampate.
La pagina indica inoltre che ad Adverant non viene comunicato chi siete. Questi dettagli rimangono sull'installazione. Una licenza riporta il nome dell'azienda, mai quello delle persone che ne fanno parte.
Premete Crea e accedi. La creazione dell'amministratore e dell'organizzazione richiede pochi secondi. La pagina risponde "Creato per aoife.brennan@harrow.example. Ora configura la tua passkey: è il modo in cui accedi."
La passkey: la seconda verifica
- Premete Configura la passkey e accedi.
- Il vostro browser vi chiede di creare una passkey. Su un portatile con Touch ID o Windows Hello, confermate con l'impronta digitale, il volto o il PIN. Se il computer non può creare autonomamente una passkey, il browser mostra un codice QR (quick response): inquadratelo con la fotocamera del telefono e seguite le istruzioni sul telefono.
- La pagina risponde "La tua passkey è configurata e hai effettuato l'accesso come aoife.brennan@harrow.example." e apre la console.
Avete dieci minuti di tempo da quando premete Crea e accedi per creare la passkey, nello stesso browser. Dopodiché la configurazione si chiude e l'amministratore esiste ma senza passkey. Dovrà intervenire un operatore, come descritto più avanti nella sezione sui nuovi tentativi.
Da questo momento in poi il primo amministratore accede con quella passkey. La password di un amministratore con pieni poteri, digitata da sola, non avvia mai una sessione: il servizio di accesso risponde richiedendo il secondo controllo. Questa è una caratteristica progettuale ed è il motivo per cui la passkey è importante. Una passkey persa significa perdere la possibilità di entrare, quindi aggiungetene una seconda, su un telefono o su una chiave di sicurezza, già il primo giorno.
In seguito, le persone accedono all'installazione con una passkey, con Google, con GitHub o con il proprio accesso aziendale, a seconda di ciò che l'organizzazione consente.
| Codice | Cosa significa | Cosa fare |
|---|---|---|
PASSKEY_UNSUPPORTED |
Questo browser non può creare una passkey. Non è stato configurato nulla. | Aprite la pagina in un browser che supporta le passkey, sullo stesso computer. |
PASSKEY_CANCELLED |
La richiesta è stata chiusa o non è stata effettuata alcuna scelta in tempo. Non è stato inviato nulla. | Premete di nuovo il pulsante. |
La prima pagina Today
La console si apre su Oggi e, il primo giorno, quasi tutto al suo interno è vuoto. Ogni area vuota spiega cosa apparirà lì e fornisce il pulsante per iniziare; ad esempio, "Richiede un amministratore" indica che le richieste rimarranno in attesa lì una volta che le persone si uniranno, con Invita persone accanto. La lista di controllo della configurazione indica quanti passaggi sono stati completati, in qualsiasi ordine. L'unica cronologia reale, ovvero la configurazione stessa, si trova già sotto "Cosa è cambiato": l'installazione configurata e la passkey del primo amministratore creata.
Sei operazioni prima che chiunque effettui l'accesso
La pagina Sei cose prima che qualcuno acceda elenca ciò che deve essere verificato prima che le persone vengano invitate. Non è una procedura guidata. Completatele in qualsiasi ordine e la pagina le conterà ("Tre su sei verificate").
| Elemento | Cosa lo rende verificato |
|---|---|
| Licenza | Una licenza Enterprise importata. Capitolo 2.13, Licenze. La versione Community non richiede alcuna licenza. |
| Indirizzo e certificato | L'indirizzo pubblico risponde con un certificato la cui catena è completa. |
| Backup | Una pianificazione di backup impostata, con una destinazione su cui è possibile scrivere. |
| Accesso aziendale | Connesso e testato. Fino ad allora, le persone utilizzano le passkey. |
| Posta | Un server di posta impostato. Fino ad allora, gli inviti non possono essere inviati. |
| Modello di IA | Un modello di IA (intelligenza artificiale): una chiave di modello dell'organizzazione o un modello sul proprio hardware. Fino ad allora, l'assistente rimane in attesa. Capitolo 2.14, Fornitori e modelli di IA. |
Invita persone si sblocca quando tutti e sei gli elementi sono verificati.
La stessa pagina elenca ciò che diventa fisso una volta che le persone effettuano l'accesso, indicandone il motivo per ciascuno: il nome breve negli indirizzi, dove sono conservati i dati e il custode delle chiavi (le chiavi possono passare da un custode software a uno hardware, ma mai viceversa). Anche il nome dell'organizzazione è elencato, poiché vale la pena controllarlo, sebbene possa cambiare.
Nexus non risponderà alla richiesta di IA di nessuno finché l'organizzazione non disporrà di un modello. Non c'è alcuna chiave condivisa dietro un'installazione e nessun fallback, quindi un'organizzazione senza chiave di modello riceve un semplice rifiuto che indica a un amministratore cosa aggiungere.
Accesso aziendale
La maggior parte delle organizzazioni desidera che le persone accedano con gli account che già possiedono. Collegate il vostro identity provider nella pagina di accesso aziendale: tramite OIDC (OpenID Connect) su Community, oppure tramite OIDC o SAML (Security Assertion Markup Language) su Enterprise.
- Scegliete il fornitore e lo standard che utilizza.
- Inserite l'identità dell'applicazione e il segreto dell'applicazione forniti dal vostro identity provider. Il segreto non verrà mai più mostrato dopo il salvataggio.
- Indicate chi può accedere, ad esempio chiunque abbia un indirizzo
@harrow.example. - Premete Testa l'accesso e accedete con il vostro account. Il risultato indica, a parole, chi ha effettuato l'accesso e cosa ha inviato il fornitore.
- Salvate.
Community dispone di un unico accesso aziendale per l'organizzazione. Enterprise aggiunge l'obbligatorietà e la sincronizzazione della directory. L'obbligatorietà disattiva le password, per cui tutti devono usare l'accesso aziendale, e un tentativo con password viene rifiutato con SSO_REQUIRED e un pulsante che rimanda alla modalità d'ingresso corretta. La sincronizzazione della directory copia persone e gruppi dalla vostra directory ogni 15 minuti e può assegnare il ruolo di amministratore a partire da un gruppo specifico.
Quando l'accesso aziendale smette di rispondere, le persone già collegate rimangono collegate, mentre un nuovo accesso viene rifiutato con IDP_UNREACHABLE (503). Un amministratore può quindi utilizzare l'accesso di emergenza per amministratori custodito in cassaforte, insieme alla propria passkey. Ogni utilizzo viene scritto nel log di audit, notificato a ogni amministratore e termina dopo quattro ore o quando l'accesso aziendale torna disponibile.
Invitare le persone
Una volta configurata la posta, invitate le persone dalla pagina Persone. Per ciascuna, indicate l'email e un ruolo:
- Il Membro utilizza tutto ciò di cui dispone l'organizzazione e non modifica alcuna impostazione.
- L'Amministratore gestisce anche persone, modelli, budget e impostazioni.
Un invito dura 7 giorni. La persona lo apre, vede chi l'ha invitata, il proprio ruolo e cosa vedrà, quindi effettua l'accesso. Al primo accesso viene richiesto un secondo controllo.
I membri invitati accedono alla console e vi svolgono il proprio lavoro quotidiano: Oggi, l'assistente, la chat del team, i file e la ricerca, i blocchi note, gli agenti e i flussi di lavoro, secondo quanto consentito dal proprio ruolo. Gli amministratori vedono anche le pagine di amministrazione. Un membro che apre una pagina di amministrazione visualizza la pagina "Non sei un amministratore". Questa mostra le impostazioni in sola lettura, ne spiega il motivo e offre la possibilità di chiedere a un amministratore.
Le registrazioni richiedono approvazione
Le persone possono anche chiedere di unirsi registrandosi autonomamente. Su un'installazione, la registrazione di uno sconosciuto non crea un account funzionante. nexus-auth la rifiuta con SIGNUP_REQUIRES_APPROVAL (403) e la trattiene in attesa dell'approvazione di un amministratore.
Esistono altri due controlli di registrazione sul servizio ospitato di Adverant, ma sono disattivati su ogni installazione e non esiste alcun valore per attivarli. Il CAPTCHA internet richiederebbe la connessione a internet a ogni registrazione. Il filtro di rete per le registrazioni richiederebbe un database di geolocalizzazione con licenza che l'installazione non include. L'approvazione costituisce il filtro d'ingresso dell'installazione.
Nuovi tentativi, codici scaduti e altri rifiuti
Ogni rifiuto durante il primo avvio spiega cosa è successo, conferma che nulla è cambiato laddove ciò sia vero e indica cosa fare dopo.
| Codice | Stato | Quando | Cosa fare |
|---|---|---|---|
CLAIM_CODE_EXPIRED |
410 | I 30 minuti sono trascorsi. Non è stato rivendicato nulla e non è cambiato nulla. | Generate un nuovo codice con nexusctl claim-code --administrator <email>, quindi premete Ho un nuovo codice. |
CLAIM_FINGERPRINT_MISMATCH |
403 | L'impronta digitale inviata non appartiene a questa installazione. | Fermatevi. Verificate l'indirizzo e il certificato. |
TRANSITION_NOT_PERMITTED |
409 | È stato richiesto nuovamente un passaggio già avvenuto: la rivendicazione su un'installazione già rivendicata o la creazione del primo amministratore per una seconda volta. | Accedete alla console; il primo amministratore aggiunge tutti gli altri. |
TRANSITION_NOT_PERMITTED |
409 | Il passaggio della passkey, da un browser senza alcun primo amministratore in attesa o dopo lo scadere dei dieci minuti. | Vedete più avanti. |
RATE_LIMITED |
429 | Troppi tentativi sulle pagine di primo avvio in un minuto. Non è stato inviato nulla. | Attendete i secondi indicati dalla pagina, quindi riprovate. |
Un codice con tentativi esauriti riporta il messaggio "Questo codice ha esaurito i tentativi". Generatene uno nuovo, proprio come per un codice scaduto. Può farlo solo chi ha accesso al cluster, che è esattamente lo scopo.
Le pagine di primo avvio accettano complessivamente 20 tentativi al minuto. Se non siete stati voi a fare quei tentativi, qualcun altro sulla vostra rete sta provando ad accedere alla pagina, ed è un'informazione utile da sapere.
Quando il passaggio della passkey è stato mancato
Se il primo amministratore è stato creato ma non è stata generata alcuna passkey entro dieci minuti, oppure il browser è stato chiuso, l'amministratore esiste ma non ha modo di accedere. Il passaggio della passkey risponde TRANSITION_NOT_PERMITTED con le parole "Se hai creato il primo amministratore in questo browser più di dieci minuti fa, chiedi a un operatore: l'amministratore esiste e non ha ancora una passkey". A quel punto la rivendicazione è esaurita, quindi un nuovo codice di rivendicazione non servirà. Rivolgetevi all'operatore che ha eseguito l'installazione prima di tentare qualsiasi altra cosa.
Quando il browser ha perso la rivendicazione
La rivendicazione risiede nel browser che l'ha effettuata, in un cookie che la pagina non può leggere. Se quel browser lo perde tra la rivendicazione e la creazione del primo amministratore, ad esempio in una finestra di navigazione privata che è stata chiusa, il modulo del primo amministratore accetta anche il file di rivendicazione e il relativo segreto di configurazione, incollati manualmente.
Una volta che Aoife ebbe la sua passkey, Tomás chiuse il terminale. La pagina di rivendicazione era disattivata, il primo amministratore esisteva e ogni altra via d'accesso passava ormai attraverso di lei.






