---
title: Premier administrateur et récupération
description: Créer une seule fois le premier Administrateur avec identity:bootstrap, puis récupérer un compte dont la boîte e-mail est perdue avec identity:recover.
---

# 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é](05-messagerie-et-codes.md).

## 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
```

3. 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é.
4. 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.
5. Lisez le fichier depuis le conteneur, puis transmettez le lien à la personne par un canal privé :

```bash
docker exec <conteneur-web> cat <chemin-affiché>
```

6. 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](../01-prise-en-main/04-premiere-connexion.md).
7. Supprimez le fichier une fois le lien utilisé.

> [!WARNING]
> La commande suivante supprime définitivement le fichier d'invitation. Ne la lancez qu'après la première connexion réussie.
>
> `docker exec <conteneur-web> rm <chemin-affiché>`

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](../06-administration-et-supervision/01-comptes-et-invitations.md).

### 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](../06-administration-et-supervision/04-acces-perdu-et-recuperation.md).

### 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
```

2. 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.
3. Confirmez l'autorisation nominative et la vérification indépendante.
4. 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é](05-messagerie-et-codes.md).
