For AI agents: the complete documentation index is available at https://docs.ovhcloud.com/fr/llms.txt, the full documentation bundle is available at https://docs.ovhcloud.com/fr/llms-full.txt, and this page is available as Markdown at https://docs.ovhcloud.com/fr/guides/web-cloud/email-and-collaborative-solutions/microsoft-exchange/feature-receive-connector.md.
Aller au contenu

Exchange - Configurer un connecteur de réception

Voir en Markdown

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.

Info

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 GET sur /email/exchange et les droits GET, POST, PUT, PATCH et DELETE sur /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.

Warning

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 :

GET/email/exchange

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.

ChampTypeDescription
namestringNom du connecteur, 255 caractères au maximum
remoteIpRangesstring[]Adresses IP des serveurs autorisés à remettre des e-mails par ce connecteur (voir ci-dessous)
requireTlsbooleantrue pour exiger TLS pour tous les e-mails reçus par ce connecteur
maxMessageSizelongFacultatif. Taille maximale d'un e-mail reçu par ce connecteur, en Mo
enabledbooleanFacultatif. true pour activer le connecteur dès sa création (false par défaut)

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.

Warning

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 :

Info

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

Éditer une zone DNS OVHcloud

Guides Microsoft 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.

Cette page vous a-t-elle aidé ?