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.
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 connexion | E-mails d'invitation | |
|---|---|---|
| Exemples | mot de passe oublié, vérification d'adresse, actions demandées par Keycloak | invitation à rejoindre l'application, relance, « invitation acceptée » envoyée à la personne qui a invité |
| Émetteur | Keycloak, realm du réseau de l'utilisateur | Wakastart, par l'API de Brevo |
| Réglage | par réseau et par environnement | par application et par environnement |
| Où | fiche du réseau, onglet Email | paramétrage de l'application, onglet Invitations, carte Compte d'envoi Brevo |
| Apparence | type email du thème de connexion | modè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 :
- 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.
- 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.