Déploiement et exploitation

Premier administrateur et récupération

Deux commandes s'exécutent sur le serveur, jamais depuis l'interface. identity:bootstrap crée le premier Administrateur d'une instance neuve. identity:recover rend l'accès à une personne qui a perdu sa boîte e-mail.

Qui peut le faire : l'exploitant, avec un accès au conteneur web. L'accès à l'hôte fait partie du périmètre de confiance : protégez-le en conséquence.

Prérequis communs#

  • Le premier déploiement est réussi : release_completed, web et worker healthy.
  • IDENTITY_ENABLED=true, OTP_HMAC_KEY renseignée.
  • Une messagerie fonctionnelle : MAIL_TRANSPORT vaut smtp ou resend. Sans elle, personne ne reçoit de code de sécurité et aucune connexion n'aboutit. Voir Messagerie et codes de sécurité.

Créer le premier administrateur#

La commande ne fonctionne qu'une fois par instance. Elle crée l'organisation, le compte Administrateur et son invitation.

  1. Ouvrez un terminal sur le serveur.
  2. Lancez :
bash
docker exec -it <conteneur-web> node apps/platform/build/ace.js identity:bootstrap
  1. Répondez aux trois questions : Adresse e-mail du premier administrateur, Nom du responsable, Nom de l'organisation. Aucun mot de passe n'est demandé.
  2. La commande affiche le chemin d'un fichier privé, par exemple …/storage/identity-bootstrap/invitation-<uuid>.txt. Le lien d'invitation n'est jamais affiché dans les journaux.
  3. Lisez le fichier depuis le conteneur, puis transmettez le lien à la personne par un canal privé :
bash
docker exec <conteneur-web> cat <chemin-affiché>
  1. La personne ouvre le lien dans les 24 heures, choisit son mot de passe, puis se connecte avec un code de sécurité. Voir Première connexion.
  2. Supprimez le fichier une fois le lien utilisé.

Le fichier se trouve dans le volume platform-storage, privé et sauvegardé. Le premier Administrateur invite ensuite les autres personnes depuis l'écran Utilisateurs : voir Comptes et invitations.

Si quelque chose échoue#

MessageSignificationQue faire
« Bootstrap refusé ou indisponible… »L'instance a déjà un premier compte, ou la base n'est pas prête.Vérifiez l'état. Il n'existe aucune remise à zéro.
« Compte créé, mais remise du fichier échouée… »Le compte existe mais le lien n'a pas été écrit.Ne relancez pas le bootstrap. Utilisez identity:recover ci-dessous.
« Le répertoire de remise doit être privé (0700)… »Droits incorrects sur le stockage.Corrigez les droits du volume (UID 1000).
Invitation expirée (plus de 24 heures)Le compte reste Invité.Utilisez identity:recover avec l'adresse du compte.

Récupérer un compte dont la boîte e-mail est perdue#

Cette procédure complète le récit côté Administrateur et utilisateur décrit dans Accès perdu et récupération.

Règle de l'autorisation nominative#

Avant toute commande :

  • l'identité de la personne a été vérifiée par un canal indépendant, selon votre procédure interne ;
  • un dossier d'autorisation existe, avec une référence ;
  • l'adresse de remise a été vérifiée indépendamment.

Une demande reçue par e-mail seul, ou une requête HTTP, ne suffit jamais. Le nom saisi dans la commande n'est pas une signature : c'est le contrôle d'accès à l'hôte et votre registre d'autorisation qui font foi.

Lancer la commande#

  1. Lancez :
bash
docker exec -it <conteneur-web> node apps/platform/build/ace.js identity:recover
  1. Répondez aux questions :
    • nom complet de la personne qui a vérifié l'identité ;
    • référence de l'autorisation conservée dans le registre ;
    • adresse actuelle du compte ;
    • adresse de remise vérifiée indépendamment.
  2. Confirmez l'autorisation nominative et la vérification indépendante.
  3. La commande affiche « Procédure enregistrée : » suivi d'un identifiant. Notez-le dans le dossier. Aucun lien ni code n'est affiché.

Ce qui se passe ensuite#

  • L'autorisation est valable 30 minutes.
  • Le worker envoie à l'adresse de remise un lien personnel et un code de 5 minutes.
  • La personne termine la récupération sur la page Récupération autorisée du compte.
  • L'adresse de remise devient l'adresse du compte. Sessions, clés API et liens en attente sont révoqués. L'ancienne adresse est informée.
  • La personne se reconnecte avec mot de passe et code de sécurité : aucune étape n'est désactivée.

Le journal des actions attribue l'opération au service d'identité, avec l'identifiant de procédure, sans prétendre qu'une session a authentifié l'exploitant.

Refus courants#

Message ou casCauseQue faire
« Transport e-mail indisponible. Aucune procédure créée. »Messagerie non configurée.Configurez la messagerie, puis recommencez.
« Procédure refusée ou indisponible… »Compte inconnu, Suspendu ou Supprimé, ou adresse invalide.Vérifiez les adresses et l’état du compte. Une adresse de remise déjà utilisée par un autre compte fait échouer la récupération à la dernière étape.
Code expiré ou envoi incertainLa personne n'a pas validé à temps.Relancez une procédure. Elle remplace la précédente.

Pour continuer#

Configurez l'envoi des e-mails avec Messagerie et codes de sécurité.