For AI agents: the complete documentation index is available at https://docs.ovhcloud.com/pt/llms.txt, the full documentation bundle is available at https://docs.ovhcloud.com/pt/llms-full.txt, and this page is available as Markdown at https://docs.ovhcloud.com/pt/guides/web-cloud/email-and-collaborative-solutions/microsoft-exchange/feature-receive-connector.md.
Ir para o conteúdo

Exchange - Configurar um conector de receção

Ver como Markdown

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.

Info

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 GET em /email/exchange e os direitos GET, POST, PUT, PATCH e DELETE em /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.

Warning

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:

GET/email/exchange

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.

CampoTipoDescrição
namestringNome do conector, 255 caracteres no máximo
remoteIpRangesstring[]Endereços IP dos servidores autorizados a entregar e-mails através deste conector (ver abaixo)
requireTlsbooleantrue para exigir TLS para todos os e-mails recebidos por este conector
maxMessageSizelongOpcional. Tamanho máximo de um e-mail recebido por este conector, em MB
enabledbooleanOpcional. true para ativar o conector logo após a sua criação (false por predefinição)

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.

Warning

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:

Info

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

Guias Microsoft Exchange

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.

Esta página foi útil?