Aller au contenu

Expéditeurs et environnements

Quel compte envoie les e-mails de connexion et d'invitation, avec quelle adresse d'expéditeur, et pourquoi chaque environnement a ses propres réglages.

ConceptAdministrateur
Voir en Markdown

Un e-mail arrive dans une boîte de réception avec une adresse d'expéditeur et un nom. Ces deux informations, et le compte qui l'envoie, dépendent du type d'e-mail et de l'environnement.

Deux canaux

E-mails de connexionE-mails d'invitation
Exemplesmot de passe oublié, vérification d'adresse, actions demandées par Keycloakinvitation à rejoindre l'application, relance, « invitation acceptée » envoyée à la personne qui a invité
ÉmetteurKeycloak, realm du réseau de l'utilisateurWakastart, par l'API de Brevo
Réglagepar réseau et par environnementpar application et par environnement
Oùfiche du réseau, onglet Emailparamétrage de l'application, onglet Invitations, carte Compte d'envoi Brevo
Apparencetype email du thème de connexionmodèle Wakastart, logo de l'application

Un réglage par environnement

Chaque environnement de votre application, dev, staging et prod, a sa propre instance Keycloak et ses propres envois. Un réglage ne vaut donc que pour l'environnement choisi : configurer le compte Brevo de prod ne change rien en dev. Cela permet de tester un nouveau compte en dev sans risquer d'envoyer de vrais e-mails depuis la mauvaise adresse en production.

Qui envoie les invitations

Pour chaque invitation, Wakastart choisit l'expéditeur dans cet ordre :

  1. Compte Brevo de l'application activé pour l'environnement : l'e-mail part de ce compte, avec l'adresse et le nom configurés. Une adresse demandée dans la requête d'invitation est ignorée. L'adresse de réponse est celle de la configuration, sinon celle de la personne qui invite.
  2. Sinon, l'e-mail part du compte Brevo de Wakastart, avec l'adresse demandée dans la requête si elle est fournie, sinon l'adresse de la plateforme, sous le nom « WakaStart ».

Important

Quand le compte de l'application est activé, Wakastart ne se replie jamais sur son propre compte. Si votre clé Brevo est refusée, l'invitation n'est pas envoyée. Ce choix évite d'envoyer vos e-mails depuis une adresse qui n'est pas la vôtre sans que personne ne s'en aperçoive.

Les modèles d'invitation

Les e-mails d'invitation utilisent un modèle fourni par Wakastart, disponible en sept langues : fr, en, es, de, nl, it, pt. La langue est celle demandée à la création de l'invitation, le français par défaut. Le modèle reprend le nom et le logo de l'application, le nom de la personne qui invite et, si elle en a saisi un, son message personnalisé. Le lien d'invitation expire par défaut au bout de 10 jours.

Quand l'option Notification à l'inviteur est cochée dans l'onglet Invitations, la personne qui a invité reçoit aussi un e-mail lorsque l'invitation est acceptée.

Qui envoie les e-mails de connexion

Chaque réseau utilise, pour chaque environnement, un serveur SMTP enregistré par Wakastart. Sans réglage propre au réseau, le serveur par défaut de la plateforme s'applique. La console affiche l'état de ce réglage dans l'onglet Email du réseau.

Pour aller plus loin