Exchange - Configurer un connecteur de réception
Placez une passerelle antispam externe devant votre plateforme Exchange OVHcloud grâce à un connecteur de réception, créé et géré avec l'API OVHcloud
Objectif
Un connecteur de réception indique à votre plateforme Exchange quels serveurs sont autorisés à lui remettre des e-mails, et à quelles conditions. Il sert à placer une solution antispam externe, aussi appelée passerelle de filtrage, devant votre plateforme Exchange : les enregistrements MX de votre nom de domaine pointent vers cette passerelle, qui filtre les e-mails entrants puis les transmet à Exchange.
Le connecteur de réception est disponible pour Private Exchange et Trusted Exchange. Il se crée et se gère uniquement avec l'API OVHcloud.
Ce guide vous explique comment créer, modifier, désactiver et supprimer un connecteur de réception sur votre plateforme Exchange avec l'API OVHcloud.
Pour faire passer les e-mails sortants de votre plateforme par un serveur externe, utilisez plutôt un connecteur d'envoi : consultez notre guide « Exchange - Configurer un connecteur d'envoi ».
Prérequis
- Disposer d'une plateforme Private Exchange ou Trusted Exchange.
- Disposer d'identifiants API créés sur la , avec au minimum le droit
GETsur/email/exchangeet les droitsGET,POST,PUT,PATCHetDELETEsur/email/exchange/*. Consultez notre guide « Premiers pas avec les API OVHcloud ». - Connaître les adresses IP des serveurs de votre solution antispam externe qui remettront les e-mails à Exchange. Demandez-les au prestataire de cette solution.
En pratique
Comprendre le connecteur de réception par défaut
Chaque plateforme Exchange dispose d'un connecteur de réception par défaut. Il appartient à Exchange : vous ne pouvez ni le modifier ni le supprimer, seulement l'activer ou le désactiver. Dans l'API, sa propriété default vaut true.
Tant qu'il est activé, votre plateforme accepte tous les e-mails entrants, quel que soit le serveur qui les remet : un connecteur de réception que vous créez n'a alors aucun effet. Pour que seule votre passerelle puisse remettre des e-mails à Exchange, désactivez vous-même le connecteur par défaut. Il n'est jamais désactivé automatiquement, afin d'éviter une coupure brutale de la réception.
Désactivez le connecteur par défaut en dernier. Si aucun autre connecteur activé ne s'applique, sa désactivation coupe la réception de tous les e-mails de la plateforme. Avant de le désactiver, vérifiez que votre connecteur de réception est activé et que les enregistrements MX de votre nom de domaine pointent vers votre passerelle.
Trouver les paramètres de chemin
Les appels du connecteur de réception ont besoin du nom de l'organisation (organizationName) et du nom du service (exchangeService) de votre plateforme. Récupérez-les dans l'ordre : le premier appel ci-dessous fournit l'organisation, nécessaire au second.
1. Organisation (organizationName)
Listez les organisations Exchange de votre compte avec l'appel API ci-dessous :
2. Service (exchangeService)
Listez les services Exchange de l'organisation avec l'appel API ci-dessous :
Créer un connecteur de réception
Créez le connecteur avec l'appel API ci-dessous :
Renseignez les champs suivants dans le corps de la requête. Seuls name, remoteIpRanges et requireTls sont obligatoires.
Chaque entrée de remoteIpRanges peut être :
- une adresse IP seule, par exemple
203.0.113.10; - un réseau en notation CIDR, par exemple
203.0.113.0/28; - une plage d'adresses « début-fin », bornes incluses, par exemple
203.0.113.10-203.0.113.20.
Les adresses IPv4 et IPv6 sont acceptées.
Limites de remoteIpRanges
- Une même adresse IP ne peut pas figurer dans deux connecteurs de réception de la plateforme.
- La liste complète, une fois ses entrées jointes par des virgules, ne doit pas dépasser 255 caractères. Préférez un réseau CIDR à une longue liste d'adresses seules.
L'appel renvoie une tâche : le connecteur est créé une fois cette tâche terminée.
Lister et consulter les connecteurs de réception
Listez les connecteurs de réception de la plateforme, connecteur par défaut compris, avec l'appel API ci-dessous :
L'appel renvoie la liste des identifiants (id) des connecteurs. Consultez le détail d'un connecteur avec l'appel API ci-dessous :
En plus des champs de création, la réponse contient id, l'identifiant du connecteur, et default, qui vaut true pour le connecteur de réception par défaut.
Modifier un connecteur de réception
Pour modifier un ou plusieurs champs sans toucher aux autres, utilisez l'appel API ci-dessous :
Pour remplacer toute la configuration du connecteur, renseignez tous les champs dans l'appel API ci-dessous :
Le champ remoteIpRanges remplace la liste enregistrée dans son ensemble. Pour ajouter une adresse IP, renvoyez la liste complète : les adresses existantes et la nouvelle.
Pour activer ou désactiver un connecteur, modifiez son champ enabled. Sur le connecteur de réception par défaut, c'est le seul champ que vous pouvez modifier : avant de le désactiver, consultez la section « Comprendre le connecteur de réception par défaut ».
Chaque modification renvoie une tâche : elle s'applique une fois cette tâche terminée.
Supprimer un connecteur de réception
Supprimez un connecteur avec l'appel API ci-dessous :
L'appel renvoie une tâche : le connecteur est supprimé une fois cette tâche terminée. Vous ne pouvez pas supprimer le connecteur de réception par défaut.
Si vous supprimez le dernier connecteur autre que celui par défaut, le connecteur par défaut est réactivé automatiquement, pour ne pas bloquer la réception des e-mails. Ce comportement dépend du paramètre enableDefaultReceiveConnector de l'appel (true par défaut) : à false, un connecteur par défaut désactivé le reste, et votre plateforme ne reçoit plus aucun e-mail.
Aller plus loin
Exchange - Configurer un connecteur d'envoi
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.