SMTP Proxy
Relais email SMTP vers API
Le SMTP Proxy est un serveur SMTP local qui accepte les emails des applications et les transmet via les fournisseurs configurés (M365, Gmail, SMTP).
Aperçu
Le SMTP Proxy résout un problème courant : de nombreuses applications existantes ne peuvent envoyer que par SMTP, mais les services de messagerie modernes comme Microsoft 365 ou Google Gmail nécessitent des API basées sur OAuth.
Le SMTP Proxy écoute localement sur un port configurable (par défaut : 2525) et accepte les connexions SMTP standard. Les emails sont ensuite livrés via le fournisseur configuré.
Fonctionnement
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ │ Application │────▶│ SMTP Proxy │────▶│ Fournisseur │ │ (envoi SMTP) │ │ (Port 2525) │ │ • M365 Graph │ │ │ │ • Auth │ │ • Google Gmail │ │ Scanner │ │ • Parser │ │ • SMTP Relay │ │ ERP │ │ • Transférer │ │ │ │ Monitoring │ │ • Journaliser │ │ │ └─────────────────┘ └─────────────────┘ └─────────────────┘
Fonctionnalités
- Multi-fournisseur — Microsoft 365 (Graph API), Google Gmail (OAuth) ou relais SMTP direct.
- Pont SMTP vers API — Les applications existantes envoient par SMTP, le proxy transfère via des API modernes.
- Support des pièces jointes — Messages multipart et pièces jointes correctement traités.
- Authentification SMTP — Authentification PLAIN/LOGIN optionnelle.
- Validation des expéditeurs — Pour M365 : liste des expéditeurs autorisés.
- Surveillance d'expiration — Avertissement automatique avant l'expiration du secret client M365.
- Journal de livraison — Chaque email envoyé/échoué est enregistré en base.
- Test de connexion — Tester la connectivité du fournisseur.
- Statistiques — Temps de fonctionnement, total envoyé, taux d'erreur.
Utilisation
- Ouvrir le composant — Accéder à Composants > SMTP Proxy.
- Choisir le fournisseur — M365, Gmail ou SMTP direct.
- Configurer le fournisseur — Saisir les identifiants.
- Définir l'expéditeur — Adresse expéditeur par défaut.
- Tester la connexion — Envoyer un email de test.
- Définir l'adresse d'écoute — Par défaut :
127.0.0.1:2525. - Activer l'auth — Pour l'accès réseau : activer SMTP AUTH.
- Démarrer le proxy — Activer et démarrer.
- Configurer les applications — Configurer les applications pour envoyer via
host:2525.
Bonnes pratiques
- Préférer M365 — Meilleure délivrabilité, pas de ports SMTP ouverts nécessaires.
- Surveiller l'expiration du secret — Renouvelez le client secret M365 à temps.
- Activer l'authentification — Surtout si le proxy est accessible sur le réseau.
- Envoyer un email de test — Après chaque changement de configuration.
- Maintenir la liste d'expéditeurs — Pour M365 : définir les expéditeurs autorisés.
- Vérifier les logs — Le proxy journalise chaque email.
Exemples
1. Microsoft 365 comme fournisseur
Hôte : 127.0.0.1 Port : 2525 Fournisseur : m365 Tenant ID : xxxx-xxxx Client ID : yyyy-yyyy Client Secret : zzzz Expéditeur : noreply@entreprise.fr
2. Relais SMTP avec STARTTLS
Hôte : 127.0.0.1 Port : 2525 Fournisseur : smtp Hôte SMTP : mail.entreprise.fr Port SMTP : 587 STARTTLS : true