Aller au contenu principal

Référence : Paramètres SMTP

Cette page liste tous les paramètres nécessaires pour configurer votre application afin d'envoyer des emails via SendAs.me.

Paramètres de connexion

ParamètreValeur
Hôtesmtp.sendas.me
Port587 (STARTTLS) ou 465 (SSL)
ChiffrementSTARTTLS (port 587) ou SSL (port 465)
AuthentificationLOGIN ou PLAIN
Nom d'utilisateurIdentifiant de votre application (app_id, ex : monapp)
Mot de passeSend key générée par l'API (sek_...)

Détail des paramètres

Hôte

smtp.sendas.me

Adresse du serveur SMTP SendAs.me. Utilisez toujours le nom de domaine, pas une adresse IP.

Port

587  (STARTTLS — recommandé)
465 (SSL implicite)

SendAs.me accepte deux ports :

  • Port 587 avec STARTTLS (recommandé) : le chiffrement est négocié après la connexion initiale.
  • Port 465 avec SSL implicite : la connexion est chiffrée dès l'établissement.

Le port 25 (SMTP ouvert, sans authentification) n'est pas supporté.

Chiffrement

Le chiffrement est obligatoire. SendAs.me refuse toute connexion non chiffrée.

  • Port 587 — STARTTLS : Dans votre librairie, le paramètre secure doit être à false (le chiffrement est négocié après connexion). Exemples :

    • Python smtplib : server.starttls()
    • Nodemailer : secure: false (avec port 587)
    • PHPMailer : SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS
  • Port 465 — SSL implicite : Dans votre librairie, le paramètre secure doit être à true. Exemples :

    • Nodemailer : secure: true (avec port 465)
    • PHPMailer : SMTPSecure = PHPMailer::ENCRYPTION_SMTPS

Authentification

SendAs.me accepte deux mécanismes d'authentification SMTP standard :

  • AUTH LOGIN — identifiant et mot de passe encodés en base64, envoyés séparément
  • AUTH PLAIN — identifiant et mot de passe encodés ensemble en base64

La plupart des librairies SMTP choisissent automatiquement le mécanisme approprié. Vous n'avez généralement pas à spécifier manuellement LOGIN ou PLAIN.

Nom d'utilisateur (app_id)

monapp

L'app_id de votre application, généré automatiquement à la création à partir du nom (ex : « Mon App » → monapp). Il est affiché dans le portail et retourné par POST /apps.

Cet identifiant est constant : il est le même pour tous les emails envoyés par votre application, quel que soit l'utilisateur final concerné.

Mot de passe SMTP (send_key)

sek_8xK2mP9nQrTvWyZaBcDeFgH...

La send_key associée à votre application, préfixée sek_. Elle est :

  • Retournée à la création (POST /apps) et après régénération (POST /apps/<pk>/reset-send-key)
  • Récupérable à tout moment via GET /apps/<pk>/send-key (authentification subscriber requise)
  • Stockée chiffrée (Fernet) côté serveur — jamais en clair dans les logs
  • Propre à votre application — un seul mot de passe actif à la fois

En cas de compromission, régénérez-la via le portail ou POST /apps/<pk>/reset-send-key.

Adresse expéditeur (From:)

L'adresse From: de vos emails doit correspondre à l'adresse du compte OAuth connecté pour l'utilisateur concerné.

From: alice@gmail.com

ou avec nom affiché :

From: "Alice Dupont" <alice@gmail.com>

SendAs.me utilise l'adresse From: pour sélectionner le bon compte OAuth. Si l'adresse ne correspond à aucun compte connecté, la connexion SMTP est refusée avec un message d'erreur explicite.

Exemple de configuration complète

Voici les paramètres regroupés tels qu'ils apparaissent généralement dans une interface de configuration :

Serveur SMTP     : smtp.sendas.me
Port : 587 (STARTTLS) ou 465 (SSL)
Sécurité : STARTTLS ou SSL (selon le port)
Authentification : Activée
Identifiant : monapp (app_id)
Mot de passe : sek_8xK2mP9nQrT... (send_key)

Compatibilité

SendAs.me a été testé avec les librairies et applications suivantes :

Librairie / ApplicationLangageCompatible
smtplibPythonOui
NodemailerNode.jsOui
PHPMailerPHPOui
SwiftMailer / Symfony MailerPHPOui
JavaMail / Jakarta MailJavaOui
.NET SmtpClientC# / .NETOui
Go net/smtpGoOui
Postfix (relay)SystèmeOui

Si votre application ou librairie ne figure pas dans cette liste, elle est probablement compatible — tout client SMTP standard supportant STARTTLS et AUTH fonctionne avec SendAs.me.

Dépannage

Erreur "Authentication failed" : Vérifiez que l'app_id (nom d'utilisateur SMTP) et la send_key (mot de passe) sont corrects. La send_key est sensible à la casse. Si vous pensez l'avoir perdue, récupérez-la ou régénérez-la dans le portail (GET /apps/{pk}/send-key ou POST /apps/{pk}/reset-send-key).

Erreur "From address not authorized" : L'adresse From: de votre email ne correspond à aucun compte OAuth connecté à votre application. Vérifiez que l'utilisateur a bien connecté son compte via le lien d'autorisation.

Erreur "TLS required" : Votre client SMTP n'active pas STARTTLS. Activez le chiffrement dans la configuration de votre librairie.

Connexion refusée : Vérifiez que votre serveur ou hébergement peut accéder à smtp.sendas.me sur le port 587. Certains hébergeurs bloquent les ports SMTP sortants par défaut — contactez votre hébergeur si nécessaire.