Déploiement et exploitation

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#

MessageDestinataire
Code de sécurité (connexion, vérification récente, changement d'adresse)La personne qui se connecte
Lien d'invitationLa personne invitée
Lien de réinitialisation du mot de passeLe compte actif concerné
Lien et code de récupération nominativeL'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éesLes Administrateurs actifs

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

Configurer l'envoi#

Variables communes#

VariableValeur
IDENTITY_ENABLEDtrue
OTP_HMAC_KEYSecret indépendant de APP_KEY, généré séparément
MAIL_TRANSPORTsmtp ou resend (none interdit tout envoi)
MAIL_FROMAdresse 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#

VariableValeur
SMTP_HOSTNom du serveur SMTP
SMTP_PORTTypiquement 465 en TLS implicite, 587 en STARTTLS
SMTP_SECUREtrue 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#

VariableValeur
RESEND_API_KEYClé du fournisseur, en secret
MAIL_FROMAdresse 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ègleValeur
Format8 chiffres, aléatoire
Validité5 minutes, 5 essais
Délai entre deux envois60 secondes au moins
Envois par compte3 au plus en 15 minutes, tous usages confondus
Envois par connexion réseau15 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ômeVérificationAction
Personne ne reçoit de code/readyz, alerte Messagerie indisponible, journaux provider_call du fournisseur mailCorrigez les variables MAIL_* ou SMTP_*, puis redéployez.
Codes reçus en retardIndicateur Messages en file et âge du plus ancien messageVérifiez que le worker tourne.
Messages au résultat inconnuIndicateur sur 24 hVérifiez le fournisseur ; les personnes redemandent un code.

Pour continuer#

Raccordez GitHub et activez les fonctions avec GitHub App et interrupteurs.