Configurer un connecteur d'envoi sur votre plateforme Private ou Trusted Exchange

Objectif

Ajouter un connecteur d'envoi SMTP à votre plateforme Exchange permet, pour une ou plusieurs adresses e-mail Exchange, d'envoyer des e-mails en passant par un serveur d'envoi externe à votre plateforme Exchange. Il peut être utilisé, par exemple, dans le cadre de campagne d'envoi massif d'e-mail, ou encore d'utiliser une solution antispam externe. Seules les adresses e-mail attachées au connecteur d'envoi utiliseront ce dernier.

Découvrez comment configurer un connecteur d'envoi sur votre plateforme Private Exchange.

Exemple

L'adresse e-mail newsletter@mydomain.ovh est attachée au connecteur d'envoi (Send Connector) configuré sur la plateforme Exchange. L'adresse contact@mydomain.ovh n'est pas rattachée au connecteur d'envoi.

Voici le contexte du schéma ci-dessus:

• contact@mydomain.ovh envoie un e-mail à l'adresse mary.johnson@guides.ovh : il s'agit d'un envoi classique, car le connecteur d'envoi n'a pas été attaché à l'adresse contact@mydomain.ovh. mary.johnson@guides.ovh reçoit donc l'e-mail en provenance du serveur d'envoi de la plateforme Exchange (Outgoing mail server).
• newsletter@mydomain.ovh envoie un e-mail à l'adresse john.smith@guides.ovh : newsletter@mydomain.ovh a été attaché au connecteur d'envoi, john.smith@guides.ovh recevra l'e-mail en provenance du serveur d'envoi du connecteur (Send Connector) paramétré sur la plateforme Exchange.

Prérequis

• Avoir souscrit à une plateforme Private Exchange OVHcloud ou Trusted Exchange OVHcloud.
• Être connecté à l'espace client OVHcloud.
• Être connecté aux API OVHcloud.
• Disposer des paramètres nécessaires au paramétrage du connecteur d'envoi. Rapprochez-vous du prestataire qui vous délivre le service.

En pratique

La mise en place d'un connecteur d'envoi se fait en 3 étapes.

• 1. Ajouter le connecteur d'envoi à votre plateforme : Vous entrez les paramètres du connecteur d'envoi que votre prestataire vous a transmis.
• 2. Configurer une adresse e-mail sur un connecteur d'envoi : Vous attachez le connecteur d'envoi à une ou plusieurs adresses e-mail afin qu'elles envoient au travers de ce connecteur lors d'un envoi.
• 3. Vérifier que votre adresse e-mail utilise le connecteur d'envoi : réaliser un envoi depuis une adresse e-mail paramétrée avec un connecteur et récupérer l'en-tête de l'e-mail depuis l'adresse e-mail de réception pour vérifier que l'e-mail est bien passé au travers du connecteur d'envoi.

Vous trouverez aussi dans ce guide d'autres opérations utiles concernant les connecteurs d'envoi.

• Retirer un connecteur d'envoi attaché à une adresse e-mail
• Définir un connecteur d'envoi comme serveur d'envoi par défaut
• Listes des autres appels API en lien avec les connecteurs d'envoi

Ajouter un connecteur d'envoi à votre plateforme Exchange

Avant de commencer, munissez-vous des informations suivantes. Elles doivent être fournies par le prestataire délivrant le connecteur d'envoi.

• L'adresse du serveur d'envoi (SMTP)
• Le port utilisé pour l'envoi (exemple: 587)
• Le nom d'utilisateur associé (exemple: une adresse e-mail) , peut être optionnel selon votre connecteur d'envoi.
• Le mot de passe associé au nom d'utilisateur , peut être optionnel selon votre connecteur d'envoi.

Ensuite, connectez-vous aux API OVHcloud avec vos identifiants. N'hésitez pas à vous appuyer de notre guide Premiers pas avec les API OVHcloud.

Pour ajouter un connecteur d'envoi à votre plateforme Exchange, utilisez l'appel API suivant :

Dans la section PATH PARAMETERS:

• exchangeService : Saisissez le nom de votre plateforme Exchange se présentant sous la forme « private-zz111111-1 » ou « dedicated-zz111111-1 ».
• organizationName : Saisissez le nom de votre plateforme Exchange se présentant sous la forme « private-zz111111-1 » ou « dedicated-zz111111-1 ».

Depuis l'onglet EXAMPLE dans la section REQUEST BODY, complétez les champs avec vos valeurs :

• displayName : Nom d'affichage de votre connecteur d'envoi.
• maxSendSize : Taille maximale, en MB, d'un e-mail lors d'un envoi (100MB maximum et par défaut si vous ne mettez rien).
• password : Mot de passe attaché à l'utilisateur du connecteur d'envoi.
• port : Port utilisé pour l'envoi.
• requireTLS : Utilisez le protocole de sécurité TLS à l'envoi.
• smartHost : Adresse du connecteur d'envoi (SMTP).
• smartHostAuthMechanism : Mécanisme d'authentification utilisé pour le connecteur d'envoi.
• user : Utilisateur associé au connecteur d'envoi.

Cliquez sur Execute pour lancer l'appel API.

Vous obtenez ce type de résultat :

{
    todoDate: "2023-09-25T14:06:02+02:00"
    id: 113924189
    finishDate: null
    function: "addSendConnector"
    status: "todo"
}

Une fois le connecteur d'envoi créé, utilisez l'appel API suivant pour récupérer son ID (identifiant) :

Dans la section PATH PARAMETERS:

• exchangeService : Saisissez le nom de votre plateforme Exchange se présentant sous la forme « private-zz111111-1 » ou « dedicated-zz111111-1 ».
• organizationName : Saisissez le nom de votre plateforme Exchange se présentant sous la forme « private-zz111111-1 » ou « dedicated-zz111111-1 ».

Cliquez sur Execute pour lancer l'appel API.

Vous obtenez ce type de résultat :

[
    29
]

Vous pouvez retrouver le détail de votre connecteur d'envoi en utilisant cette API :

Dans la section PATH PARAMETERS:

• exchangeService : Saisissez le nom de votre plateforme Exchange se présentant sous la forme « private-zz111111-1 » ou « dedicated-zz111111-1 ».
• id : Saisissez l'ID de votre connecteur d'envoi, obtenu sous forme de numéro à l'étape précédente.
• organizationName : Saisissez le nom de votre plateforme Exchange se présentant sous la forme « private-zz111111-1 » ou « dedicated-zz111111-1 ».

Cliquez sur Execute pour lancer l'appel API.

Vous obtenez ce type de résultat :

{
    smartHost: "smtp-relay.example.com"
    displayName: "testconnector"
    state: "ok"
    maxSendSize: 100
    smartHostAuthMechanism: "basicAuthRequireTLS"
    port: 587
    lastUpdateDate: null
    creationDate: "2023-09-25T14:06:02+02:00"
    taskPendingId: 0
    id: 29
    requireTLS: true
}

Configurer une adresse e-mail pour utiliser un connecteur d'envoi

Pour pouvoir envoyer des e-mails via un connecteur d'envoi, il faut l'associer à une ou plusieurs adresses e-mail.

Utilisez l'appel API de paramétrage d'un compte Exchange afin d'ajouter l'ID de votre connecteur d'envoi sur une adresse e-mail :

Dans la section PATH PARAMETERS:

• exchangeService : Saisissez le nom de votre plateforme Exchange se présentant sous la forme « private-zz111111-1 » ou « dedicated-zz111111-1 ».
• organizationName : Saisissez le nom de votre plateforme Exchange se présentant sous la forme « private-zz111111-1 » ou « dedicated-zz111111-1 ».
• primaryEmailAddress : Saisissez une des adresses e-mail de votre plateforme Exchange, sur laquelle vous souhaitez attacher le connecteur d'envoi.

Depuis l'onglet EXAMPLE dans la section REQUEST BODY, modifiez les valeurs des deux champs ci-dessous :

• sendConnectorId : Saisissez l'ID de votre connecteur d'envoi, obtenu sous forme de numéro à l'étape précédente.
• deleteVirus : Saisissez « true » à la place de « false » pour ne pas obtenir d'erreur lors de l'exécution de l'appel API.

Cliquez sur Execute pour lancer l'appel API.

Vous obtenez le résultat suivant :

{
    null
}

Tester votre connecteur d'envoi

Si votre configuration est conforme aux informations transmises par le fournisseur du connecteur d'envoi, votre adresse e-mail enverra ses e-mails au travers de ce connecteur d'envoi. Il n'y a pas de manipulation particulière à faire pour l'envoi, simplement envoyer depuis la ou les adresses e-mails attachées au connecteur d'envoi.

Pour tester votre envoi, envoyez un e-mail depuis une adresse qui est attachée au connecteur d'envoi vers une adresse de test que vous aurez choisi et que vous pouvez consulter. Une fois l'e-mail de test envoyé, connectez-vous à l'adresse destinataire et observez l'en-tête de l'e-mail pour vérifier que l'envoi s'est bien fait au travers du connecteur d'envoi. Si besoin , consultez notre guide Récupérer l'en-tête d'un e-mail.

Exemple d'en-tête

l'adresse e-mail newsletter@mydomain.ovh envoie un e-mail à l'adresse john.smith@guides.ovh. L'adresse e-mail newsletter@mydomain.ovh a été attachée au connecteur d'envoi. Le connecteur d'envoi a pour nom de domaine sender-id.example.com

Voici un exemple d'en-tête d'un e-mail envoyé depuis un Private Exchange qui utilise un connecteur d'envoi, dans le contexte cité précédemment:

<robert@hisdomain.ovh>

Return-Path: <bounces-249164590-newsletter=mydomain.ovh@sender-id.example.com>
Delivered-To: john.smith@guides.ovh
Received: from localhost (HELO queue) (127.0.0.1)
    by localhost with SMTP; 28 Feb 2023 09:51:02 +0200
Received: from unknown (HELO output28.mail.ovh.net) (192.168.11.93)
    by 192.168.1.2 with AES256-GCM-SHA384 encrypted SMTP; 28 Feb 2023 09:51:02 +0200
Received: from vr45.mail.ovh.net (unknown [10.101.8.45])
    by out28.mail.ovh.net (Postfix) with ESMTP id 4PQqLG4KHRzRxRQZj
    for <john.smith@guides.ovh>; Tue, 28 Feb 2023 07:51:02 +0000 (UTC)
Received: from in31.mail.ovh.net (unknown [10.101.4.31])
    by vr45.mail.ovh.net (Postfix) with ESMTP id 4PQqLF6ZBMz37ZHNP
    for <john.smith@guides.ovh>; Tue, 28 Feb 2023 07:51:01 +0000 (UTC)
Received-SPF: Pass (mailfrom) identity=mailfrom; client-ip=11.22.333.44; helo=sender-id.example.com; envelope-from=bounces-249164590-newsletter=mydomain.ovh@sender-id.example.com; receiver=john.smith@guides.ovh
Authentication-Results: in31.mail.ovh.net;
    dkim=pass (1024-bit key; unprotected) header.d=smtp.example.com header.i=@smtp.example.com header.b="HDetLEPl";
    dkim-atps=neutral
Received: from sender-id.example.com (sender-id.example.com [11.22.333.44])
    by in31.mail.ovh.net (Postfix) with ESMTPS id 4PQsPF43SEm78WdxQ
    for <john.smith@guides.ovh>; Tue, 28 Feb 2023 07:51:01 +0000 (UTC)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=smtp.example.com;
    q=dns/txt; s=mail; bh=gZnUUk4TldsnAE7L+M9zwjuOeOmD6FwV4Yyq99XN2a0=;
    h=from:subject:date:to:mime-version:content-type:list-unsubscribe:x-csa-complaints:list-unsubscribe-post;
    b=HDiySKAl0J78ByyGlPjCVc+zvEv/DP9NkfUdso8DkB5z1Lig4rfbqCLnD6SE6wh7sjsZMsae0gk
    Muy0Uur0tw2nWq/WI94O4grD/KAWWC+jo2w/1+0ol1VCQN2+zQEhM+HJj4pcnn+MfU/RrXLkXfDV
    BLfqJiRcWJCQ3fy3Gag=
Received: by smtp-relay.smtp.example.com with ESMTP id 12185513-794a-4762-b3ee-a4044d30975e; Tue Feb 28 2023 07:51:00 GMT+0000
X-Mailin-EID: MjAxMTY0NTkwfm5vLXJlcGx5QHRlc3QtbXV0dS5jb21%2BPDE2N2U1NdkfOTQ3MzQ1YWFiNzY3NWY3ZmJkMWUzZGJkQHRlYW1qZXJlbS5vdmg%2B25ead5LmQuc2VuZGVyLXNpYi5jb20%3D
To: <john.smith@guides.ovh>
Date: Tue, 28 Feb 2023 07:50:56 +0000
Subject: Test SBR 3 (SIB)
Message-Id: <12185193-354a-4762-b3ee-a40484d30975e@smtp-relay.smtp.example.com>
Origin-messageId: <167e568a947345aab7675f7fbd1e3dbd@mydomain.ovh>
Thread-Index: AQHZS0ljK1OFDltwD80S81Qo68wiBIQ==
Accept-Language: fr-FR, en-US
Content-Language: fr-FR
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
x-mclm-sbr-processed: true
MIME-Version: 1.0
X-sib-id: 8dUZE2ztHUSpKwRy5O0fOawZARq-Dh8BNrytyOAwG9i3ybk5nxMfOvwZLeo778wLsYKejwcxuIEci6PKSzh3d4X7w126g-32syWTSQKRPQZTyxdXonPcl3lqm3pXkNolSaGbfG4dHY38OoEF7aXWMGvRsJtNlvsy1sEx8vGFOpxg_3cK
X-CSA-Complaints: csa-complaints@eco.de
From: <newsletter@mydomain.ovh>

Retirer un connecteur d'envoi attaché à une adresse e-mail

Pour retirer un connecteur d'envoi attaché sur un compte de la plateforme Exchange, utilisez l'appel API de paramétrage du compte Exchange concerné afin de changer l'ID de votre connecteur d'envoi par l'ID du serveur d'envoi de votre plateforme Exchange :

Dans la section PATH PARAMETERS:

• exchangeService : Saisissez le nom de votre plateforme Exchange se présentant sous la forme « private-zz111111-1 » ou « dedicated-zz111111-1 ».
• organizationName : Saisissez le nom de votre plateforme Exchange se présentant sous la forme « private-zz111111-1 » ou « dedicated-zz111111-1 ».
• primaryEmailAddress : Saisissez une des adresses e-mail de votre plateforme Exchange, sur laquelle vous souhaitez attacher le connecteur d'envoi.

Depuis l'onglet EXAMPLE dans la section REQUEST BODY, modifiez les valeurs des deux champs ci-dessous :

• sendConnectorId : Saisissez l'ID de votre connecteur d'envoi, obtenu sous forme de numéro à l'étape précédente.
• deleteVirus : Saisissez « true » à la place de « false » pour ne pas obtenir d'erreur lors de l'exécution de l'appel API.

Cliquez sur Execute pour lancer l'appel API.

Vous obtenez le résultat suivant :

{
    null
}

Définir un connecteur d'envoi comme serveur d'envoi par défaut

Il est possible d'attacher automatiquement un connecteur d'envoi à chaque fois que vous ajoutez un compte Exchange sur votre plateforme. De cette manière, tous les comptes qui seront ajoutés passeront par défaut par le connecteur d'envoi que vous aurez défini.

Pour cela, utilisez l'appel API suivant:

Dans la section PATH PARAMETERS:

• domainName : Saisissez le nom de domaine qui bénéficiera du connecteur d'envoi.
• exchangeService : Saisissez le nom de votre plateforme Exchange se présentant sous la forme « private-zz111111-1 » ou « dedicated-zz111111-1 ».
• organizationName : Saisissez le nom de votre plateforme Exchange se présentant sous la forme « private-zz111111-1 » ou « dedicated-zz111111-1 ».

Depuis l'onglet EXAMPLE dans la section REQUEST BODY, complétez les champs avec vos valeurs:

• sbrDefault : Laissez la valeur par défaut.
• sendConnectorIdDefault : Saisissez l'ID de votre connecteur d'envoi, obtenu sous forme de numéro à cette étape.

Cliquez sur Execute pour lancer l'appel API.

Vous obtenez le résultat suivant :

{
    null
}

Listes des autres appels API en lien avec les connecteurs d'envoi

• Récupérer les connecteurs d'envoi déjà créés sur un service Exchange:

• Supprimer un connecteur d'envoi existant:

• Récupérer les détails d'un connecteur d'envoi existant:

• Éditer un connecteur d'envoi existant:

• Changer la méthode d'authentification d'un connecteur d'envoi existant:

Aller plus loin

Éditer une zone DNS

Ajouter un nom de domaine sur son service Exchange

Pour des prestations spécialisées (référencement, développement, etc), contactez les partenaires OVHcloud.

Si vous souhaitez bénéficier d'une assistance à l'usage et à la configuration de vos solutions OVHcloud, nous vous proposons de consulter nos différentes offres de support.

Échangez avec notre communauté d'utilisateurs.