Architecture du relais SMTP personnalisé
Par défaut, Passinstance envoie les notifications de livraison de passes, les e-mails de bienvenue et les campagnes via notre cluster optimisé d'infrastructure e-mail gérée en UE (eu-central-1 Francfort). Pour les organisations, institutions financières et agences en marque blanche qui exigent que l'ensemble des e-mails sortants provienne exclusivement de leurs propres serveurs de messagerie d'entreprise (tels que Google Workspace, Microsoft 365, SendGrid, Mailgun, Postmark ou un relais Postfix interne), Passinstance propose la fonctionnalité Relais SMTP personnalisé (Custom SMTP Relay).
Lorsqu'elle est activée, Passinstance achemine tous les envois transactionnels de passes et campagnes du Delivery Center via votre hôte SMTP désigné, assurant un alignement complet du domaine expéditeur, une signature DKIM propre et la conformité d'archivage interne :
Tarification & activation du module complémentaire
Le relais SMTP personnalisé est une capacité modulaire de l'espace de travail :
-
Tarification : disponible en tant que module complémentaire à 20 €/mois (
AddonType.OWN_SMTP, indicateur de fonctionnalitéownSmtp). -
Volumes inclus : lorsque vous routez les envois via votre propre serveur SMTP, vous ne consommez pas de frais d'envoi e-mail de la plateforme Passinstance ; les limites de débit dépendent uniquement de votre propre fournisseur de messagerie.
-
Activer le module complémentaire : accédez à Paramètres -> Espace de travail -> Modules complémentaires (Settings -> Workspace -> Add-ons) et activez Custom SMTP Relay.
Ports & modes de sécurité pris en charge
Le client SMTP de Passinstance (request payload) prend en charge les ports de soumission SMTP standards et alternatifs :
| Port | Protocole / Chiffrement | Recommandation de sécurité | Fournisseurs de messagerie typiques |
|---|---|---|---|
587 | STARTTLS (TLS explicite) | Recommandé (par défaut) : se connecte en clair puis bascule immédiatement vers TLS 1.3 avant l'authentification. | Google Workspace, Microsoft 365, SendGrid, Mailgun, Postmark |
465 | SMTPS (SSL/TLS implicite) | Sécurisé : la connexion est encapsulée dans TLS dès l'ouverture initiale du socket (secure: true). | SMTP de livraison e-mail gérée, serveurs mail privés avec certificats SSL dédiés |
2525 | STARTTLS alternatif | Adapté au cloud : idéal pour les environnements AWS, Azure ou Google Cloud où le port sortant 25 est bloqué ou limité. | SendGrid, Mailgun, SparkPost |
25 | Clair / TLS opportuniste | Déconseillé pour l'envoi sur Internet : souvent bloqué par les FAI et pare-feux cloud pour lutter contre le spam. | Relais mail internes hérités au sein de périmètres d'entreprise privés |
Validation de sécurité anti-SSRF sur l'hôte (validateSmtpHost)
Pour prévenir les attaques Server-Side Request Forgery (SSRF) et protéger l'infrastructure cloud interne, Passinstance vérifie chaque nom d'hôte SMTP configuré selon des frontières réseau strictes (validateSmtpHost dans smtp-config.service.ts) :
Règle de sécurité : toute tentative de configuration d'un hôte SMTP pointant vers une adresse IP interne, lien-local ou privée déclenche immédiatement l'erreur
BadRequestException: Invalid SMTP host address.
Les destinations suivantes sont bloquées de façon permanente :
-
1
Adresses de bouclage (loopback) :
127.0.0.1,localhost,::1. -
2
Plages IPv4 privées RFC 1918 :
- 10.0.0.0/8 (10.0.0.0 - 10.255.255.255) - 172.16.0.0/12 (172.16.0.0 - 172.31.255.255) - 192.168.0.0/16 (192.168.0.0 - 192.168.255.255)
-
3
Service de métadonnées d'instance AWS (IMDS) :
169.254.169.254ainsi que l'ensemble des plages lien-local169.254.0.0/16. -
4
Noms d'hôtes non résolvables : les noms d'hôtes dont la résolution DNS publique d'enregistrements A/AAAA échoue sont rejetés.
Stockage des identifiants dans le coffre de secrets chiffré
Passinstance applique une approche zéro confiance pour vos identifiants d'authentification SMTP :
-
Chiffrement en stockage sécurisé : lorsque vous enregistrez votre configuration SMTP, le mot de passe est chiffré et enregistré dans le stockage chiffré de secrets sous le chemin locataire
smtp/{customerId}. -
Aucun mot de passe en clair en base de données : la base de données principale conserve uniquement les métadonnées de connexion (hôte, port, nom d'utilisateur, adresse d'expéditeur, mode de chiffrement). Le champ mot de passe en base reste nul.
-
Masquage dans les réponses API : les endpoints GET (
GET /settings/smtp-config) renvoient"hasPassword": trueavec un mot de passe masqué"********". Les mots de passe ne sont jamais renvoyés au navigateur. -
Accès éphémère par le worker : lors de l'envoi d'un e-mail sortant, le worker de la file de tâches en arrière-plan récupère directement le secret depuis le stockage chiffré en mémoire temporaire et l'efface immédiatement après la fermeture de la session socket.
Configurer le SMTP personnalisé dans le tableau de bord
-
1
Accédez à Paramètres -> Messagerie -> SMTP personnalisé (
/settings/workspace/messaging/smtp). -
2
Renseignez les paramètres de connexion de votre serveur :
- Hôte SMTP : nom de domaine complet (FQDN) de votre serveur mail (par ex. smtp.sendgrid.net ou smtp.office365.com). - Port : 587 (STARTTLS) ou 465 (SSL). - Nom d'utilisateur : identifiant d'authentification SMTP ou clé API. - Mot de passe : mot de passe SMTP ou jeton API. - Adresse e-mail d'expéditeur : adresse d'émission (par ex. passes@yourbrand.com). - Nom d'expéditeur : nom affiché aux destinataires (par ex. YourBrand Wallet Support).
-
3
Cliquez sur Envoyer un e-mail de test (Send Test Email,
POST /settings/smtp-config/test). -
4
Indiquez une adresse e-mail à laquelle vous avez accès puis cliquez sur Envoyer. Passinstance teste la résolution DNS, la négociation TLS et l'authentification, puis envoie un e-mail de test.
-
5
Une fois le test réussi, cliquez sur Enregistrer la configuration (Save Configuration). Tous les e-mails suivants transiteront désormais par votre serveur.
Endpoints API REST du SMTP personnalisé
| Méthode | Chemin de l'endpoint | Portée d'authentification | Description |
|---|---|---|---|
| GET | /api/v1/settings/smtp-config | Clé API (settings) | Récupère la configuration SMTP actuelle de l'espace de travail (mot de passe masqué). |
| PUT | /api/v1/settings/smtp-config | Clé API (settings) | Met à jour les paramètres SMTP et chiffre le mot de passe dans le stockage sécurisé. |
| POST | /api/v1/settings/smtp-config/test | Clé API (settings) | Exécute un test de connexion socket en direct et expédie un e-mail de vérification. |
| DELETE | /api/v1/settings/smtp-config | Clé API (settings) | Supprime la configuration SMTP personnalisée et rétablit la livraison e-mail gérée. |
Exemple : tester la configuration SMTP avant enregistrement
POST /api/v1/settings/smtp-config/test HTTP/1.1
Host: api.passinstance.com
X-API-Key: <API_KEY>
Content-Type: application/json
{
"host": "smtp.mailgun.org",
"port": 587,
"user": "postmaster@mg.yourbrand.com",
"pass": "secret-api-key-99214",
"fromEmail": "passes@yourbrand.com",
"fromName": "YourBrand Wallet",
"secure": false,
"testRecipientEmail": "admin@yourbrand.com"
}
Réponse (200 OK) :
{
"success": true,
"message": "SMTP test email sent successfully",
"details": {
"response": "250 2.0.0 Ok: queued as 7F8E9A10",
"accepted": ["admin@yourbrand.com"],
"rejected": []
}
}
Authentification du domaine : alignement SPF, DKIM & DMARC
Pour garantir une excellente délivrabilité en boîte de réception et éviter le filtrage anti-spam lors d'envois via votre propre serveur SMTP, vérifiez que les enregistrements DNS de votre domaine sont correctement configurés :
1. Sender Policy Framework (SPF)
Ajoutez le mécanisme SPF de votre fournisseur SMTP dans l'enregistrement TXT de votre domaine racine :
v=spf1 include:mailgun.org include:_spf.google.com ~all
2. DomainKeys Identified Mail (DKIM)
Vérifiez que votre fournisseur de messagerie a généré des clés DKIM 2048 bits pour votre domaine d'envoi, puis publiez les enregistrements CNAME de clé publique correspondants dans votre DNS.
3. Alignement DMARC
Publiez un enregistrement de politique DMARC (_dmarc.yourbrand.com) afin d'imposer l'alignement entre l'adresse From: RFC 5322 et vos identifiants SPF/DKIM vérifiés :
v=DMARC1; p=quarantine; rua=mailto:dmarc-reports@yourbrand.com; pct=100
Documentation connexe
-
Envoi par e-mail & SMS — Campagnes, modèles et contrôles d'exécution d'envoi.
-
Marque blanche & personnalisation avancée — Domaines de téléchargement personnalisés et habillage du portail.
-
Distribution en libre-service — PassFlows, liens intelligents et distribution NFC.
