---
title: Messagerie et codes de sécurité
description: Configurer l'envoi des e-mails (SMTP ou Resend) et la clé des codes de sécurité, comprendre le résultat d'envoi inconnu et l'absence de repli.
---

# Messagerie et codes de sécurité

La connexion à 101Maintain exige un code de sécurité envoyé par e-mail. Sans messagerie fonctionnelle, personne ne peut se connecter. Cette page décrit la configuration de l'envoi et son comportement en cas de panne.

**Qui peut le faire :** l'exploitant.

## Ce qui passe par la messagerie

| Message | Destinataire |
| --- | --- |
| Code de sécurité (connexion, vérification récente, changement d'adresse) | La personne qui se connecte |
| Lien d'invitation | La personne invitée |
| Lien de réinitialisation du mot de passe | Le compte actif concerné |
| Lien et code de récupération nominative | L'adresse de remise vérifiée |
| Notification avant publication (canal e-mail) | Le compte vérifié configuré sur le dépôt |
| Alertes d'exploitation, si activées | Les Administrateurs actifs |

Le worker envoie tous ces messages. Le serveur web ne les envoie jamais directement.

## Configurer l'envoi

### Variables communes

| Variable | Valeur |
| --- | --- |
| `IDENTITY_ENABLED` | `true` |
| `OTP_HMAC_KEY` | Secret indépendant de `APP_KEY`, généré séparément |
| `MAIL_TRANSPORT` | `smtp` ou `resend` (`none` interdit tout envoi) |
| `MAIL_FROM` | Adresse d'expédition simple, par exemple `maintenance@maintain.example` |

`APP_URL` doit être l'origine HTTPS publique : elle sert aux liens envoyés et aux contrôles d'origine des formulaires.

### Option 1 — SMTP

| Variable | Valeur |
| --- | --- |
| `SMTP_HOST` | Nom du serveur SMTP |
| `SMTP_PORT` | Typiquement `465` en TLS implicite, `587` en STARTTLS |
| `SMTP_SECURE` | `true` pour TLS implicite ; `false` impose STARTTLS |
| `SMTP_USER`, `SMTP_PASSWORD` | À fournir ensemble, ou pas du tout |

Il n'existe aucun mode en clair, et la validation du certificat ne peut pas être désactivée.

### Option 2 — Resend

| Variable | Valeur |
| --- | --- |
| `RESEND_API_KEY` | Clé du fournisseur, en secret |
| `MAIL_FROM` | Adresse d'un domaine validé chez le fournisseur |

Chaque message porte une clé d'idempotence auprès du fournisseur.

### Après la configuration

1. Redéployez pour que le web et le worker lisent les mêmes valeurs.
2. Vérifiez `/readyz` : la capacité `identity` n'est prête que si la configuration est complète, la base et Redis répondent, et le worker de messagerie a émis un battement récent sans échec non suivi d'un succès.
3. Faites un essai réel : invitation ou connexion avec un compte de test.

`/readyz` à 200 ne prouve pas qu'un message arrive dans la boîte. La réception, le domaine d'envoi et ses enregistrements SPF, DKIM et DMARC se vérifient avec votre fournisseur.

## Règles des codes de sécurité

| Règle | Valeur |
| --- | --- |
| Format | 8 chiffres, aléatoire |
| Validité | 5 minutes, 5 essais |
| Délai entre deux envois | 60 secondes au moins |
| Envois par compte | 3 au plus en 15 minutes, tous usages confondus |
| Envois par connexion réseau | 15 au plus en 15 minutes |

Seul le dernier code envoyé est valable. Les codes sont conservés sous forme d'empreinte calculée avec `OTP_HMAC_KEY`, jamais en clair.

> [!WARNING]
> Changer `OTP_HMAC_KEY` invalide tous les codes en cours. Changer `APP_KEY` invalide les sessions et les liens, et rend illisibles les messages encore en file. Ne faites ni l'un ni l'autre pendant que des envois sont en attente, et gardez des valeurs identiques entre web et worker.

## Résultat d'envoi inconnu

L'acceptation par le serveur SMTP ou par l'API Resend ne prouve pas la réception. Si l'envoi échoue de façon incertaine (délai dépassé, exception, worker arrêté pendant l'envoi), le message passe à l'état **inconnu** :

- il n'est jamais renvoyé automatiquement ;
- son contenu est effacé ;
- le code concerné ne devient jamais utilisable.

La personne demande simplement un nouveau code après 60 secondes. Il remplace l'ancien.

## Pas de repli

Il n'existe aucun moyen de se connecter sans code de sécurité, même en cas de panne du fournisseur. Aucun compte ni projet ne devient accessible si l'envoi échoue. Pendant une panne de messagerie :

- les connexions nouvelles sont impossibles ;
- les sessions déjà ouvertes continuent jusqu'à leur expiration ;
- l'alerte **Messagerie indisponible** s'ouvre sur la [page Exploitation](../06-administration-et-supervision/08-page-exploitation.md), mais ne peut pas partir par e-mail.

L'arrêt global ne suspend jamais les e-mails de connexion : ils servent à le lever.

## Diagnostic

| Symptôme | Vérification | Action |
| --- | --- | --- |
| Personne ne reçoit de code | `/readyz`, alerte **Messagerie indisponible**, journaux `provider_call` du fournisseur `mail` | Corrigez les variables `MAIL_*` ou `SMTP_*`, puis redéployez. |
| Codes reçus en retard | Indicateur **Messages en file** et âge du plus ancien message | Vérifiez que le worker tourne. |
| Messages au résultat inconnu | Indicateur sur 24 h | Vérifiez le fournisseur ; les personnes redemandent un code. |

## Pour continuer

Raccordez GitHub et activez les fonctions avec [GitHub App et interrupteurs](06-github-app-et-fonctionnalites.md).
