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,webetworkerhealthy. IDENTITY_ENABLED=true,OTP_HMAC_KEYrenseignée.- Une messagerie fonctionnelle :
MAIL_TRANSPORTvautsmtpouresend. 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.
- Ouvrez un terminal sur le serveur.
- Lancez :
docker exec -it <conteneur-web> node apps/platform/build/ace.js identity:bootstrap- 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é.
- 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. - Lisez le fichier depuis le conteneur, puis transmettez le lien à la personne par un canal privé :
docker exec <conteneur-web> cat <chemin-affiché>- 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.
- 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#
| Message | Signification | Que 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#
- Lancez :
docker exec -it <conteneur-web> node apps/platform/build/ace.js identity:recover- 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.
- Confirmez l'autorisation nominative et la vérification indépendante.
- 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 cas | Cause | Que 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 incertain | La 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é.