ConnexionPlanifier un briefing

Chapitre 2.12

Le premier lancement

D'une installation non revendiquée jusqu'aux équipes au travail. Générez le code de revendication, revendiquez l'installation dans un navigateur, créez le premier administrateur avec une clé d'accès, puis connectez l'authentification d'entreprise et invitez tous les autres collaborateurs.

Cette page a été traduite par l'IA à partir de l'original en anglais. En cas de doute, la page en anglais fait foi. Lire cette page en anglais

18 minutes de lecture

Lorsqu'une installation se termine, elle n'appartient à personne. Elle ne comporte ni organisation, ni utilisateur, ni session, et personne ne peut s'y connecter. Elle attend qu'une personne prouve, dans un navigateur, qu'elle s'adresse bien à l'installation qui vient d'être créée. Chez Harrow Port Authority, cette personne était Aoife Brennan, directrice informatique, accompagnée de Tomás Reilly au terminal. Ce chapitre retrace leurs vingt premières minutes.

L'ordre est fixe, et chaque étape referme définitivement la précédente : revendiquer l'installation, créer le premier administrateur et l'organisation, configurer une clé d'accès (passkey) et arriver sur la page Aujourd'hui. Viennent ensuite les six éléments à préparer, la connexion d'entreprise et l'invitation des autres utilisateurs, dans l'ordre qui vous convient.

Une chaîne d'encadrés de gauche à droite : « nexusctl claim-code (terminal) », « Revendiquer cette installation (navigateur : code + empreinte) », « Le premier administrateur et l'organisation », « Clé d'accès (deuxième vérification) », « Aujourd'hui, quand tout est neuf », « Six éléments avant toute connexion », « Inviter des personnes ». Sous l'encadré de revendication, deux branches rouges descendent : « code trop ancien : CLAIM_CODE_EXPIRED, générer un nouveau code » et « empreintes différentes : CLAIM_FINGERPRINT_MISMATCH, arrêter ». Une fine ligne sous les trois premiers encadrés porte la mention « chaque étape désactive définitivement la précédente ».
Le premier démarrage, du terminal à la première page Aujourd'hui, et les deux endroits où il peut s'arrêter.

Générer le code de revendication

Le code de revendication prouve que la personne devant le navigateur peut également voir le terminal d'une personne ayant accès au cluster. Seule une telle personne peut en générer un. Exécutez cette commande là où votre kubeconfig accède au cluster :

nexusctl claim-code --administrator aoife.brennan@harrow.example

nexusctl claim-code demande au service de clés de l'installation, nexus-keys, de générer le code. Sans nexusctl, la même commande s'exécute dans le propre pod du service de clés :

kubectl -n nexus exec deploy/nexus-keys -- nexus-keys claim-code \
  --administrator aoife.brennan@harrow.example --source "Tomás Reilly, ops terminal"

--source correspond à quelques mots indiquant qui a généré le code. La page de revendication les affiche sous « Créé par », afin que la personne qui revendique l'installation sache d'où provient le code.

 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

Trois éléments concernant ce code sont importants.

  • Il est valable 30 minutes. Un code aperçu par-dessus l'épaule de quelqu'un devient vite inutile.
  • Il autorise 5 essais. Après la cinquième tentative erronée, il est épuisé, quel que soit le temps restant.
  • Il est destiné à une seule personne. L'adresse e-mail que vous indiquez est celle du premier administrateur. Elle accompagne la revendication, et le formulaire du premier administrateur l'affiche comme un champ fixe, sans qu'il soit nécessaire de la ressaisir.

L'empreinte est composée de huit groupes de quatre caractères ; c'est l'identité propre de l'installation. Laissez-la affichée à l'écran. Vous la comparerez, groupe par groupe, dans le navigateur.

Revendiquer l'installation

  1. Sur l'ordinateur que vous utiliserez en tant que premier administrateur, ouvrez l'adresse d'installation de la console, ici https://console.harrow.example/install. Elle vous renvoie vers la page correspondant à l'état de l'installation : la page de revendication tant qu'elle est ouverte, la page du premier administrateur une fois l'installation revendiquée, et la console si vous êtes déjà connecté.
  2. Sur la page Revendiquer cette installation, saisissez le code dans Groupe un, Groupe deux et Groupe trois, à raison d'un groupe de quatre caractères par champ.
  3. Comparez l'Empreinte de cette installation affichée sur la page avec celle du terminal, pour les huit groupes, un par un.
  4. Si tous les groupes correspondent, cochez Les huit groupes correspondent à ce qu'affiche mon terminal.
  5. Appuyez sur Revendiquer cette installation ; la page confirme la revendication et vous redirige vers la création du premier administrateur.
Réclamer cette installation
Réclamer cette installation
La page de revendication. Le code se saisit en trois groupes, l'empreinte complète est affichée en huit groupes de quatre caractères pour être comparée avec le terminal, et l'encadré de droite indique d'où provient le code et combien d'essais il reste.

La revendication accomplit trois choses. Elle fait de ce navigateur le seul endroit où le premier administrateur peut être créé. Elle enregistre qui a revendiqué l'installation, et quand, dans le journal d'audit. Enfin, elle désactive définitivement la page de revendication. Dès lors, l'adresse de revendication répond que l'installation a déjà été revendiquée.

Si l'empreinte ne correspond pas, arrêtez-vous

Une empreinte différente signifie qu'une autre installation répond à cette adresse. Il peut s'agir d'une adresse mal saisie, d'un enregistrement DNS (Domain Name System) obsolète ou d'une machine configurée pour intercepter le premier administrateur. Si vous la revendiquiez, cette machine détiendrait votre organisation.

Ne revendiquez pas l'installation et ne saisissez pas le code sur cette page. Fermez la page, puis vérifiez deux éléments : que console.harrow.example résout bien vers votre ingress, et que le certificat affiché par le navigateur est émis par l'autorité de certification (CA) attendue. Votre propre installation reste inchangée et toujours non revendiquée.

Si une revendication est envoyée avec une empreinte qui n'est pas celle de l'installation, le service de clés la refuse avec l'erreur CLAIM_FINGERPRINT_MISMATCH (403). Rien n'est revendiqué. La page affiche alors les deux empreintes côte à côte en marquant les groupes qui diffèrent, ainsi que les étapes permettant de vérifier l'adresse et le certificat.

L'empreinte ne correspond pas
L'empreinte ne correspond pas
La page vers laquelle mène une empreinte non concordante. Les groupes qui diffèrent sont marqués, et les étapes invitent à vérifier l'adresse et le certificat avant toute autre saisie.

Créer le premier administrateur et l'organisation

La page suivante s'intitule « Deux courts formulaires, et vous êtes connecté ». Le premier administrateur peut ajouter toutes les autres personnes, et presque tout ce qui figure ici pourra être modifié ultérieurement. Deux éléments ne peuvent pas l'être, et la page les signale.

Champ Ce qui est renseigné Modifiable ultérieurement ?
Nom complet Votre nom Oui
E-mail professionnel L'adresse pour laquelle le code de revendication a été généré, affichée sans être ressaisie C'est l'adresse de l'administrateur
Rôle dans Nexus Administrateur de l'organisation. La première personne est toujours un administrateur. Non choisi ici
Deuxième vérification Clé d'accès sur cet ordinateur portable Oui, d'autres peuvent être ajoutées
Nom (de l'organisation) Harrow Port Authority Oui
Pays Lieu où est basée l'organisation Oui
Nom court dans les adresses Généré à partir du nom, par exemple harrow-port-authority Non. Les liens et les exportations l'utilisent.
Lieu de conservation des données Cette installation Non. Le modifier ultérieurement implique une nouvelle installation.
Langue et dates Anglais (Royaume-Uni), avec la date du jour Oui
Fuseau horaire Le fuseau horaire du serveur Chaque personne voit les heures dans son propre fuseau

Le nom court est composé de lettres minuscules, de chiffres et de traits d'union, jusqu'à 100 caractères, généré à partir du nom de l'organisation sans les accents. Vérifiez-le bien avant de valider. Il apparaît dans chaque lien partagé et dans chaque exportation effectuée, aussi longtemps que l'organisation existe.

Vous définissez également un mot de passe sur cette page. Il ne suffit jamais à lui seul : un administrateur ne se connecte jamais uniquement avec un mot de passe. La deuxième vérification, ci-dessous, est ce qui permet de vous connecter.

Un accès administrateur d'urgence est créé en même temps. Il est scellé et imprimé une seule fois, pour être placé au coffre-fort. Il ne fonctionne que lorsque la connexion d'entreprise est hors service, et chaque utilisation est enregistrée et signalée à tous les administrateurs. Mettez-le au coffre-fort le jour même de son impression.

La page précise également qu'Adverant n'est pas informé de votre identité. Ces informations restent sur l'installation. Une licence mentionne le nom de l'entreprise, jamais celui des personnes qui la composent.

Appuyez sur Créer et se connecter. La création de l'administrateur et de l'organisation prend quelques secondes. La page répond : « Créé pour aoife.brennan@harrow.example. Configurez maintenant votre clé d'accès : c'est ainsi que vous vous connectez. »

Le premier administrateur
Le premier administrateur
Le premier administrateur et l'organisation sur une seule page. Les deux choix qui ne peuvent jamais être modifiés, le nom court et le lieu de conservation des données, sont indiqués comme tels à côté du champ, et l'accès d'urgence est scellé pour le coffre-fort.

La clé d'accès : la seconde vérification

  1. Appuyez sur Configurer la clé d'accès et se connecter.
  2. Votre navigateur vous demande de créer une clé d'accès. Sur un ordinateur portable équipé de Touch ID ou de Windows Hello, confirmez avec votre empreinte digitale, votre visage ou votre code PIN. Si l'ordinateur ne peut pas créer de clé d'accès lui-même, le navigateur affiche un code QR (quick response) : pointez l'appareil photo de votre téléphone vers celui-ci et suivez les instructions sur le téléphone.
  3. La page répond « Votre clé d'accès est configurée et vous êtes connecté en tant que aoife.brennan@harrow.example. » et ouvre la console.

Vous disposez de dix minutes à compter du clic sur Créer et se connecter pour créer la clé d'accès, dans le même navigateur. Passé ce délai, la configuration est fermée et l'administrateur existe sans clé d'accès. Un opérateur doit alors intervenir, comme décrit dans la section sur les nouvelles tentatives ci-dessous.

Désormais, le premier administrateur se connecte avec cette clé d'accès. Le mot de passe d'un administrateur complet, saisi seul, n'ouvre jamais de session : le service de connexion répond en demandant la deuxième vérification. C'est une propriété inhérente à la conception du système, et la raison pour laquelle la clé d'accès est essentielle. Une clé d'accès perdue est un moyen d'accès perdu ; ajoutez-en donc une deuxième, sur un téléphone ou une clé de sécurité, dès le premier jour.

Par la suite, les utilisateurs se connectent à l'installation avec une clé d'accès, avec Google, avec GitHub ou avec la connexion de leur entreprise, selon ce que l'organisation autorise.

Code Ce que cela signifie Que faire
PASSKEY_UNSUPPORTED Ce navigateur ne peut pas créer de clé d'accès. Rien n'a été configuré. Ouvrez la page dans un navigateur prenant en charge les clés d'accès, sur le même ordinateur.
PASSKEY_CANCELLED L'invite a été fermée ou aucune option n'a été choisie à temps. Rien n'a été envoyé. Appuyez à nouveau sur le bouton.

La première page Aujourd'hui

La console s'ouvre sur la page Aujourd'hui, et le premier jour, presque tout y est vide. Chaque zone vide indique ce qui y apparaîtra et propose le bouton permettant de lancer l'action ; ainsi, « Nécessite un administrateur » précise que les demandes y seront en attente une fois que des personnes auront rejoint l'organisation, avec le bouton Inviter des personnes juste à côté. La liste de contrôle de configuration indique combien d'étapes sont terminées, dans n'importe quel ordre. Le seul véritable historique, la configuration elle-même, figure déjà sous « Ce qui a changé » : l'installation configurée et la clé d'accès du premier administrateur créée.

Aujourd'hui, quand tout est nouveau
Aujourd'hui, quand tout est nouveau
La page Aujourd'hui le premier jour. Chaque zone vide explique ce qui y apparaîtra et comment démarrer, et « Ce qui a changé » contient déjà la configuration initiale.

Six étapes avant que quiconque ne se connecte

La page Six éléments avant toute connexion répertorie les conditions qui doivent être remplies avant d'inviter des utilisateurs. Ce n'est pas un assistant étape par étape. Effectuez ces tâches dans n'importe quel ordre ; la page les comptabilise (« Trois sur six validés »).

Élément Condition de validation
Licence Une licence Enterprise importée. Voir le chapitre 2.13, Licences. L'édition Community ne nécessite aucune licence.
Adresse et certificat L'adresse publique répond avec un certificat dont la chaîne est complète.
Sauvegardes Une planification de sauvegarde définie, avec une cible accessible en écriture.
Connexion d'entreprise Connectée et testée. D'ici là, les utilisateurs se servent de clés d'accès.
Messagerie Un serveur de messagerie configuré. D'ici là, les invitations ne peuvent pas être envoyées.
Modèle d'IA Un modèle d'IA (intelligence artificielle) : une clé de modèle de l'organisation, ou un modèle hébergé sur votre propre matériel. D'ici là, l'assistant patiente. Voir le chapitre 2.14, Fournisseurs et modèles d'IA.

Le bouton Inviter des personnes devient actif lorsque les six conditions sont remplies.

La même page répertorie ce qui devient fixe une fois que les utilisateurs se connectent, avec la raison pour chaque élément : le nom court dans les adresses, le lieu de conservation des données et le dépositaire des clés (les clés peuvent passer d'un dépositaire logiciel à un dépositaire matériel, mais jamais l'inverse). Le nom de l'organisation y figure également, car il vaut la peine d'être vérifié, bien qu'il puisse être modifié.

Nexus ne répondra à aucune requête d'IA tant que l'organisation ne disposera pas d'un modèle. Il n'y a ni clé partagée derrière une installation ni solution de repli ; une organisation sans clé de modèle reçoit donc un simple refus indiquant à un administrateur ce qu'il doit ajouter.

Six éléments avant toute connexion
Six étapes avant que quiconque ne se connecte
Six vérifications dans n'importe quel ordre, comptabilisées en toutes lettres. Les choix qui deviennent définitifs dès la connexion des utilisateurs sont listés avec leur justification, afin que personne ne le découvre trop tard.

Authentification d'entreprise

La plupart des organisations souhaitent que leurs collaborateurs se connectent avec les comptes qu'ils possèdent déjà. Connectez votre fournisseur d'identité sur la page de connexion d'entreprise : via OIDC (OpenID Connect) sur l'édition Community, ou via OIDC ou SAML (Security Assertion Markup Language) sur l'édition Enterprise.

  1. Choisissez le fournisseur et le standard qu'il utilise.
  2. Saisissez l'identifiant d'application et le secret d'application fournis par votre fournisseur d'identité. Le secret n'est plus jamais affiché une fois que vous l'avez enregistré.
  3. Indiquez qui peut se connecter, par exemple toute personne disposant d'une adresse en @harrow.example.
  4. Appuyez sur Tester la connexion et connectez-vous avec votre propre compte. Le résultat indique, en toutes lettres, qui s'est connecté et ce que le fournisseur a envoyé.
  5. Enregistrez.

L'édition Community dispose d'une seule connexion d'entreprise pour l'organisation. L'édition Enterprise ajoute l'application forcée et la synchronisation d'annuaire. L'application forcée désactive les mots de passe, obligeant tout le monde à utiliser la connexion d'entreprise ; toute tentative par mot de passe est refusée avec le code SSO_REQUIRED et un bouton renvoyant vers la bonne méthode de connexion. La synchronisation d'annuaire copie les personnes et les groupes depuis votre annuaire toutes les 15 minutes, et peut désigner des administrateurs à partir d'un groupe nommé.

Lorsque la connexion d'entreprise ne répond plus, les personnes déjà connectées le restent, et toute nouvelle connexion est refusée avec l'erreur IDP_UNREACHABLE (503). Un administrateur peut alors utiliser l'accès administrateur d'urgence conservé au coffre-fort, conjointement avec sa clé d'accès. Chaque utilisation est inscrite dans le journal d'audit, notifiée à tous les administrateurs, et prend fin au bout de quatre heures ou dès le rétablissement de la connexion d'entreprise.

Connecter votre fournisseur d'identité
Connecter votre fournisseur d'identité
Connexion d'entreprise avec test intégré. Le fournisseur, le standard en petits caractères, et un test de connexion dont le résultat s'affiche en toutes lettres avant que quiconque n'en dépende.

Inviter des collaborateurs

Une fois la messagerie configurée, invitez des collaborateurs depuis la page Personnes. Pour chacun, indiquez son adresse e-mail et un rôle :

  • Le Membre utilise tout ce dont dispose l'organisation et ne modifie aucun paramètre.
  • L'Administrateur gère également les personnes, les modèles, les budgets et les paramètres.

Une invitation est valable 7 jours. La personne l'ouvre, voit qui l'a invitée, son rôle et ce à quoi elle aura accès, puis se connecte. Une deuxième vérification lui est demandée lors de sa première connexion.

Les membres invités se connectent à la console et y effectuent leur travail quotidien : Aujourd'hui, l'assistant, la messagerie d'équipe, les fichiers et la recherche, les carnets (notebooks), les agents et les flux de travail (workflows), selon ce que leur rôle autorise. Les administrateurs voient également les pages d'administration. Un membre qui ouvre une page d'administration arrive sur la page « Vous n'êtes pas administrateur ». Elle affiche les paramètres en lecture seule, explique pourquoi et propose de faire une demande à un administrateur.

Inviter un collègue
Inviter un collègue
Une invitation définit le rôle de la personne avant son arrivée, Membre ou Administrateur, et peut être accompagnée d'une courte note.

Les inscriptions nécessitent une approbation

Les utilisateurs peuvent également demander à rejoindre l'organisation en s'inscrivant eux-mêmes. Sur une installation, l'inscription d'un inconnu ne crée pas de compte fonctionnel. nexus-auth la refuse avec le code SIGNUP_REQUIRES_APPROVAL (403) et la met en attente de l'approbation d'un administrateur.

Deux autres contrôles d'inscription existent sur le service hébergé d'Adverant et sont désactivés sur chaque installation, sans possibilité de les activer. Le CAPTCHA nécessiterait un accès à Internet à chaque inscription. Le filtrage réseau à l'inscription nécessiterait une base de données de géolocalisation sous licence que l'installation n'embarque pas. L'approbation constitue le garde-fou de l'installation.

Nouvelles tentatives, codes expirés et autres refus

Chaque refus lors du premier démarrage explique ce qui s'est passé, précise que rien n'a été modifié lorsque c'est le cas, et indique la marche à suivre.

Code Statut Situation Que faire
CLAIM_CODE_EXPIRED 410 Les 30 minutes sont écoulées. Rien n'a été revendiqué et rien n'a changé. Générez un nouveau code avec nexusctl claim-code --administrator <email>, puis appuyez sur J'ai un nouveau code.
CLAIM_FINGERPRINT_MISMATCH 403 L'empreinte envoyée n'est pas celle de cette installation. Arrêtez-vous. Vérifiez l'adresse et le certificat.
TRANSITION_NOT_PERMITTED 409 Une étape déjà effectuée a été demandée une nouvelle fois : la revendication sur une installation déjà revendiquée, ou la création du premier administrateur une seconde fois. Connectez-vous à la console ; c'est le premier administrateur qui ajoute toutes les autres personnes.
TRANSITION_NOT_PERMITTED 409 L'étape de la clé d'accès, depuis un navigateur où aucun premier administrateur n'est en attente, ou après le délai de dix minutes. Voir ci-dessous.
RATE_LIMITED 429 Trop de tentatives sur les pages de premier démarrage en une minute. Rien n'a été envoyé. Patientez le nombre de secondes indiqué sur la page, puis réessayez.

Un code dont tous les essais ont été utilisés affiche « Ce code n'a plus d'essais disponibles ». Générez-en un nouveau, comme pour un code expiré. Seule une personne ayant accès au cluster peut le faire, ce qui est précisément le but recherché.

Les pages de premier démarrage acceptent un total de 20 tentatives par minute. Si vous n'êtes pas à l'origine de ces tentatives, quelqu'un d'autre sur votre réseau essaie d'accéder à la page, et il est bon de le savoir.

Lorsque l'étape de la clé d'accès a été manquée

Si le premier administrateur a été créé mais qu'aucune clé d'accès n'a été configurée dans les dix minutes, ou si le navigateur a été fermé, l'administrateur existe sans moyen de se connecter. L'étape de la clé d'accès renvoie le code TRANSITION_NOT_PERMITTED accompagné du message « Si vous avez créé le premier administrateur dans ce navigateur il y a plus de dix minutes, adressez-vous à un opérateur : l'administrateur existe et n'a pas encore de clé d'accès ». À ce stade, la revendication est consommée ; un nouveau code de revendication sera donc inutile. Adressez-vous à l'opérateur qui a exécuté l'installation avant de tenter quoi que ce soit d'autre.

Lorsque le navigateur a perdu la revendication

La revendication réside dans le navigateur qui l'a effectuée, au sein d'un cookie que la page ne peut pas lire. Si ce navigateur la perd entre la revendication et la création du premier administrateur, par exemple dans une fenêtre de navigation privée qui a été fermée, le formulaire du premier administrateur accepte également le fichier de revendication et son secret de configuration, collés manuellement.

Une fois qu'Aoife a eu sa clé d'accès, Tomás a fermé son terminal. La page de revendication était désactivée, le premier administrateur existait, et tous les autres accès passaient désormais par elle.