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#
- Redéployez pour que le web et le worker lisent les mêmes valeurs.
- Vérifiez
/readyz: la capacitéidentityn'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. - 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.
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, 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.