AccediPrenota un briefing

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

18 minuti di lettura

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.

Una catena di riquadri da sinistra a destra: "nexusctl claim-code (terminale)", "Rivendica questa installazione (browser: codice + impronta digitale)", "Il primo amministratore e l'organizzazione", "Passkey (secondo controllo)", "Oggi, quando tutto è nuovo", "Sei cose prima che qualcuno acceda", "Invita persone". Sotto il riquadro di rivendicazione scendono due diramazioni rosse: "codice troppo vecchio: CLAIM_CODE_EXPIRED, genera un nuovo codice" e "le impronte digitali differiscono: CLAIM_FINGERPRINT_MISMATCH, fermati". Una linea sottile sotto i primi tre riquadri riporta l'etichetta "ogni passaggio disattiva definitivamente quello precedente".
Il primo avvio, dal terminale alla prima pagina Oggi, e i due punti in cui può interrompersi.

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

nexusctl 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

  1. 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.
  2. In Rivendica questa installazione, digitate il codice in Gruppo uno, Gruppo due e Gruppo tre, un gruppo di quattro caratteri in ciascuno.
  3. Confrontate l'Impronta digitale di questa installazione sulla pagina con il terminale, tutti gli otto gruppi, uno alla volta.
  4. Se ogni gruppo corrisponde, spuntate Tutti gli otto gruppi corrispondono a quanto mostrato dal mio terminale.
  5. Premete Rivendica questa installazione; la pagina confermerà la rivendicazione e vi reindirizzerà al primo amministratore.
Riscatta questa installazione
Riscatta questa installazione
La pagina di rivendicazione. Il codice va inserito in tre gruppi, l'impronta digitale completa è mostrata in otto gruppi di quattro per il confronto con il terminale e il riquadro a destra indica da dove proviene il codice e quanti tentativi rimangono.

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.

L'impronta digitale non corrisponde
L'impronta digitale non corrisponde
La pagina a cui porta un'impronta digitale non corrispondente. I gruppi diversi sono evidenziati e i passaggi consentono di verificare l'indirizzo e il certificato prima che venga digitato qualsiasi altro dato.

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

Il primo amministratore
Il primo amministratore
Il primo amministratore e l'organizzazione in un'unica pagina. Le due scelte che non potranno mai cambiare, il nome breve e dove sono conservati i dati, lo indicano accanto al campo, mentre l'accesso di emergenza è sigillato per la cassaforte.

La passkey: la seconda verifica

  1. Premete Configura la passkey e accedi.
  2. 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.
  3. 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.

Today, quando tutto è nuovo
Today, quando tutto è nuovo
La pagina Oggi il primo giorno. Ogni area vuota indica cosa apparirà al suo interno e come avviarla, mentre "Cosa è cambiato" contiene già la configurazione stessa.

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.

Sei cose prima che qualcuno acceda
Sei operazioni prima che chiunque effettui l'accesso
Sei controlli in qualsiasi ordine, contati a parole. Le scelte che diventano fisse una volta che le persone accedono sono elencate con la relativa motivazione, affinché nessuno lo scopra in seguito.

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.

  1. Scegliete il fornitore e lo standard che utilizza.
  2. 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.
  3. Indicate chi può accedere, ad esempio chiunque abbia un indirizzo @harrow.example.
  4. 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.
  5. 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.

Collegate il vostro identity provider
Collegate il vostro identity provider
Accesso aziendale con test. Il fornitore, lo standard scritto in piccolo e un test di accesso il cui risultato è espresso a parole prima che chiunque vi faccia affidamento.

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.

Invita un collega
Invita un collega
Un invito definisce il ruolo della persona prima del suo arrivo, Membro o Amministratore, e può includere una breve nota.

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.