Exchange - Configurar um conector de receção
Coloque uma gateway antispam externa à frente da sua plataforma Exchange OVHcloud com um conector de receção, criado e gerido com a API OVHcloud
Objetivo
Um conector de receção indica à sua plataforma Exchange quais os servidores autorizados a entregar-lhe e-mails e em que condições. Serve para colocar uma solução antispam externa, também chamada gateway de filtragem, à frente da sua plataforma Exchange: os registos MX do seu nome de domínio apontam para esta gateway, que filtra os e-mails de entrada e, em seguida, os transmite ao Exchange.
O conector de receção está disponível para Private Exchange e Trusted Exchange. Só pode ser criado e gerido com a API OVHcloud.
Este guia explica como criar, modificar, desativar e eliminar um conector de receção na sua plataforma Exchange com a API OVHcloud.
Para fazer passar os e-mails de saída da sua plataforma por um servidor externo, utilize antes um conector de envio: consulte o nosso guia "Exchange - Configurar um conector de envio".
Requisitos
- Dispor de uma plataforma Private Exchange ou Trusted Exchange.
- Dispor de credenciais API geradas na , com, no mínimo, o direito
GETem/email/exchangee os direitosGET,POST,PUT,PATCHeDELETEem/email/exchange/*. Consulte o nosso guia "Primeiros passos com as API OVHcloud". - Conhecer os endereços IP dos servidores da sua solução antispam externa que vão entregar os e-mails ao Exchange. Peça-os ao prestador desta solução.
Instruções
Compreender o conector de receção predefinido
Cada plataforma Exchange dispõe de um conector de receção predefinido. Pertence ao Exchange: não o pode modificar nem eliminar, apenas ativar ou desativar. Na API, a sua propriedade default tem o valor true.
Enquanto estiver ativado, a sua plataforma aceita todos os e-mails de entrada, seja qual for o servidor que os entrega: um conector de receção que crie não tem, nesse caso, qualquer efeito. Para que apenas a sua gateway possa entregar e-mails ao Exchange, desative manualmente o conector predefinido. Este nunca é desativado automaticamente, para evitar uma interrupção brusca da receção.
Desative o conector predefinido em último lugar. Se nenhum outro conector ativado se aplicar, a sua desativação interrompe a receção de todos os e-mails da plataforma. Antes de o desativar, verifique se o seu conector de receção está ativado e se os registos MX do seu nome de domínio apontam para a sua gateway.
Encontrar os parâmetros de caminho
As chamadas do conector de receção precisam do nome da organização (organizationName) e do nome do serviço (exchangeService) da sua plataforma. Obtenha-os por ordem: a primeira chamada abaixo fornece a organização, necessária para a segunda.
1. Organização (organizationName)
Liste as organizações Exchange da sua conta com a chamada API abaixo:
2. Serviço (exchangeService)
Liste os serviços Exchange da organização com a chamada API abaixo:
Criar um conector de receção
Crie o conector com a chamada API abaixo:
Preencha os seguintes campos no corpo do pedido. Apenas name, remoteIpRanges e requireTls são obrigatórios.
Cada entrada de remoteIpRanges pode ser:
- um único endereço IP, por exemplo
203.0.113.10; - uma rede em notação CIDR, por exemplo
203.0.113.0/28; - um intervalo de endereços "início-fim", com ambos os limites incluídos, por exemplo
203.0.113.10-203.0.113.20.
São aceites endereços IPv4 e IPv6.
Limites de remoteIpRanges
- Um mesmo endereço IP não pode constar de dois conectores de receção da plataforma.
- A lista completa, depois de unidas as suas entradas por vírgulas, não pode exceder 255 caracteres. Prefira uma rede CIDR a uma longa lista de endereços individuais.
A chamada devolve uma tarefa: o conector é criado quando esta tarefa estiver concluída.
Listar e consultar os conectores de receção
Liste os conectores de receção da plataforma, incluindo o conector predefinido, com a chamada API abaixo:
A chamada devolve a lista dos identificadores (id) dos conectores. Consulte os detalhes de um conector com a chamada API abaixo:
Além dos campos de criação, a resposta contém id, o identificador do conector, e default, que tem o valor true para o conector de receção predefinido.
Modificar um conector de receção
Para modificar um ou vários campos sem alterar os restantes, utilize a chamada API abaixo:
Para substituir toda a configuração do conector, preencha todos os campos na chamada API abaixo:
O campo remoteIpRanges substitui a lista registada na sua totalidade. Para adicionar um endereço IP, envie novamente a lista completa: os endereços existentes e o novo.
Para ativar ou desativar um conector, modifique o seu campo enabled. No conector de receção predefinido, é o único campo que pode modificar: antes de o desativar, consulte a secção "Compreender o conector de receção predefinido".
Cada modificação devolve uma tarefa: é aplicada quando esta tarefa estiver concluída.
Eliminar um conector de receção
Elimine um conector com a chamada API abaixo:
A chamada devolve uma tarefa: o conector é eliminado quando esta tarefa estiver concluída. Não pode eliminar o conector de receção predefinido.
Se eliminar o último conector que não seja o predefinido, o conector predefinido é reativado automaticamente, para não bloquear a receção dos e-mails. Este comportamento depende do parâmetro enableDefaultReceiveConnector da chamada (true por predefinição): com false, um conector predefinido desativado permanece desativado e a sua plataforma deixa de receber e-mails.
Quer saber mais?
Exchange - Configurar um conector de envio
Editar uma zona DNS da OVHcloud
Para serviços especializados (referenciamento, desenvolvimento, etc.), contacte os parceiros OVHcloud.
Se pretender usufruir de uma assistência na utilização e na configuração das suas soluções OVHcloud, consulte as nossas diferentes ofertas de suporte.
Fale com a nossa comunidade de utilizadores.