Skip to content
Guide du centre d'aide · Distribution des passes
6 min de lectureVérifié 2026-11-16

Votre propre adresse d'expéditeur et SMTP personnalisé

Configurez un serveur relais SMTP personnalisé pour envoyer des e-mails de cartes depuis votre domaine d'entreprise avec stockage chiffré des identifiants et sécurité anti-SSRF.

Dans ce guide

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 :

FLUX ARCHITECTURE SYSTÈME
ARCHITECTURE INTERACTIVE
FLUX D'ARCHITECTURE SYSTÈME : RELAIS SMTP PERSONNALISÉ & CHIFFREMENT DES SECRETS
ÉTAPE 01 RÉPARTITEUR D'ENVOI E-MAIL PASSINSTANCE
Déclenché à la création du passe, via le Delivery Center ou la page de téléch.
ÉTAPE 02 ROUTAGE DE PASSERELLE & CONTRÔLE D'AUTORISATION
Vérifie le droit espace : AddonType.OWN_SMTP (20 €/mois) ou flag ownSmtp
Garde d'hôte anti-SSRF : validateSmtpHost vérifie l'adresse IP cible
ÉTAPE 03 HYDRATATION D'IDENTIFIANTS CHIFFRÉS
Récupère le mot de passe SMTP depuis le stockage chiffré : smtp/{customerId}
Déchiffré en mémoire éphémère ; jamais journalisé ni stocké en clair en BDD
ÉTAPE 04 SERVEUR RELAIS SMTP D'ENTREPRISE DU CLIENT
Hôte : smtp.yourbrand.com | Ports : 587 (STARTTLS), 465 (SSL) ou 2525
Expédie le message avec les signatures DKIM, SPF et DMARC du client
ÉTAPE 05 BOÎTE DE RÉCEPTION DU DESTINATAIRE
Livré depuis : passes@yourbrand.com (identité expéditeur 100 % à votre marque)

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 :

PortProtocole / ChiffrementRecommandation de sécuritéFournisseurs de messagerie typiques
587STARTTLS (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
465SMTPS (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
2525STARTTLS alternatifAdapté au cloud : idéal pour les environnements AWS, Azure ou Google Cloud où le port sortant 25 est bloqué ou limité.SendGrid, Mailgun, SparkPost
25Clair / TLS opportunisteDé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. 1
    Adresses de bouclage (loopback) : 127.0.0.1, localhost, ::1.
  2. 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)

  1. 3
    Service de métadonnées d'instance AWS (IMDS) : 169.254.169.254 ainsi que l'ensemble des plages lien-local 169.254.0.0/16.
  2. 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": true avec 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. 1
    Accédez à Paramètres -> Messagerie -> SMTP personnalisé (/settings/workspace/messaging/smtp).
  2. 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).

  1. 3
    Cliquez sur Envoyer un e-mail de test (Send Test Email, POST /settings/smtp-config/test).
  2. 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.
  3. 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éthodeChemin de l'endpointPortée d'authentificationDescription
GET/api/v1/settings/smtp-configClé API (settings)Récupère la configuration SMTP actuelle de l'espace de travail (mot de passe masqué).
PUT/api/v1/settings/smtp-configClé 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/testClé 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-configClé 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

HTTP
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) :

JSON
{
  "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 :

TEXT
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 :

TEXT
v=DMARC1; p=quarantine; rua=mailto:dmarc-reports@yourbrand.com; pct=100

Documentation connexe

Prêt à lancer votre premier programme de cartes Wallet ?

Créez votre espace de travail, configurez votre modèle et testez une vraie carte dans Apple Wallet et Google Wallet avant de déployer à grande échelle.