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

Exchange - Configurare un connettore di ricezione

Vedi come Markdown

Posiziona un gateway antispam esterno davanti alla piattaforma Exchange OVHcloud grazie a un connettore di ricezione, creato e gestito con l'API OVHcloud

Obiettivo

Un connettore di ricezione indica alla tua piattaforma Exchange quali server sono autorizzati a consegnarle le email e a quali condizioni. Serve a posizionare una soluzione antispam esterna, detta anche gateway di filtraggio, davanti alla piattaforma Exchange: i record MX del tuo dominio puntano verso questo gateway, che filtra le email in entrata e poi le trasmette a Exchange.

Il connettore di ricezione è disponibile per Private Exchange e Trusted Exchange. Si crea e si gestisce esclusivamente con l'API OVHcloud.

Questa guida ti spiega come creare, modificare, disattivare ed eliminare un connettore di ricezione sulla tua piattaforma Exchange con l'API OVHcloud.

Info

Per far passare le email in uscita della tua piattaforma da un server esterno, utilizza invece un connettore di invio: consulta la nostra guida "Exchange - Configurare un connettore di invio".

Prerequisiti

  • Disporre di una piattaforma Private Exchange o Trusted Exchange.
  • Disporre di credenziali API create nella , con almeno il diritto GET su /email/exchange e i diritti GET, POST, PUT, PATCH e DELETE su /email/exchange/*. Consulta la nostra guida "Iniziare a utilizzare le API OVHcloud".
  • Conoscere gli indirizzi IP dei server della tua soluzione antispam esterna che consegneranno le email a Exchange. Richiedili al fornitore di questa soluzione.

Procedura

Comprendere il connettore di ricezione predefinito

Ogni piattaforma Exchange dispone di un connettore di ricezione predefinito. Appartiene a Exchange: non puoi né modificarlo né eliminarlo, ma solo attivarlo o disattivarlo. Nell'API, la sua proprietà default vale true.

Finché è attivo, la tua piattaforma accetta tutte le email in entrata, qualunque sia il server che le consegna: un connettore di ricezione che crei non ha quindi alcun effetto. Affinché solo il tuo gateway possa consegnare email a Exchange, disattiva manualmente il connettore predefinito. Non viene mai disattivato automaticamente, per evitare un'interruzione brusca della ricezione.

Warning

Disattiva il connettore predefinito per ultimo. Se non si applica nessun altro connettore attivo, la sua disattivazione interrompe la ricezione di tutte le email della piattaforma. Prima di disattivarlo, verifica che il tuo connettore di ricezione sia attivo e che i record MX del tuo dominio puntino verso il tuo gateway.

Trovare i parametri del percorso

Le chiamate del connettore di ricezione richiedono il nome dell'organizzazione (organizationName) e il nome del servizio (exchangeService) della tua piattaforma. Recuperali nell'ordine: la prima chiamata riportata di seguito fornisce l'organizzazione, necessaria per la seconda.

1. Organizzazione (organizationName)

Elenca le organizzazioni Exchange del tuo account con la chiamata API riportata di seguito:

GET/email/exchange

2. Servizio (exchangeService)

Elenca i servizi Exchange dell'organizzazione con la chiamata API riportata di seguito:

Creare un connettore di ricezione

Crea il connettore con la chiamata API riportata di seguito:

Compila i seguenti campi nel corpo della richiesta. Solo name, remoteIpRanges e requireTls sono obbligatori.

CampoTipoDescrizione
namestringNome del connettore, massimo 255 caratteri
remoteIpRangesstring[]Indirizzi IP dei server autorizzati a consegnare email tramite questo connettore (vedi sotto)
requireTlsbooleantrue per richiedere TLS per tutte le email ricevute da questo connettore
maxMessageSizelongFacoltativo. Dimensione massima di un'email ricevuta da questo connettore, in MB
enabledbooleanFacoltativo. true per attivare il connettore al momento della creazione (false per impostazione predefinita)

Ogni voce di remoteIpRanges può essere:

  • un singolo indirizzo IP, ad esempio 203.0.113.10;
  • una rete in notazione CIDR, ad esempio 203.0.113.0/28;
  • un intervallo di indirizzi "inizio-fine", estremi inclusi, ad esempio 203.0.113.10-203.0.113.20.

Sono accettati gli indirizzi IPv4 e IPv6.

Warning

Limiti di remoteIpRanges

  • Uno stesso indirizzo IP non può comparire in due connettori di ricezione della piattaforma.
  • L'elenco completo, una volta unite le sue voci con delle virgole, non deve superare i 255 caratteri. Preferisci una rete CIDR a un lungo elenco di singoli indirizzi.

La chiamata restituisce un task: il connettore viene creato una volta completato il task.

Elencare e consultare i connettori di ricezione

Elenca i connettori di ricezione della piattaforma, compreso il connettore predefinito, con la chiamata API riportata di seguito:

La chiamata restituisce l'elenco degli identificativi (id) dei connettori. Consulta i dettagli di un connettore con la chiamata API riportata di seguito:

Oltre ai campi di creazione, la risposta contiene id, l'identificativo del connettore, e default, che vale true per il connettore di ricezione predefinito.

Modificare un connettore di ricezione

Per modificare uno o più campi senza toccare gli altri, utilizza la chiamata API riportata di seguito:

Per sostituire l'intera configurazione del connettore, compila tutti i campi nella chiamata API riportata di seguito:

Info

Il campo remoteIpRanges sostituisce l'elenco registrato nella sua interezza. Per aggiungere un indirizzo IP, invia di nuovo l'elenco completo: gli indirizzi esistenti e quello nuovo.

Per attivare o disattivare un connettore, modifica il suo campo enabled. Sul connettore di ricezione predefinito, questo è l'unico campo che puoi modificare: prima di disattivarlo, consulta la sezione "Comprendere il connettore di ricezione predefinito".

Ogni modifica restituisce un task: viene applicata una volta completato il task.

Eliminare un connettore di ricezione

Elimina un connettore con la chiamata API riportata di seguito:

La chiamata restituisce un task: il connettore viene eliminato una volta completato il task. Non puoi eliminare il connettore di ricezione predefinito.

Se elimini l'ultimo connettore diverso da quello predefinito, il connettore predefinito viene riattivato automaticamente, per non bloccare la ricezione delle email. Questo comportamento dipende dal parametro enableDefaultReceiveConnector della chiamata (true per impostazione predefinita): con false, un connettore predefinito disattivato resta disattivato e la tua piattaforma non riceve più alcuna email.

Per saperne di più

Exchange - Configurare un connettore di invio

Modificare una zona DNS di OVHcloud

Guide Microsoft Exchange

Per prestazioni specializzate (referenziamento, sviluppo, ecc.), contatta i partner OVHcloud.

Per usufruire di un supporto per l'utilizzo e la configurazione delle soluzioni OVHcloud, è possibile consultare le nostre offerte di supporto.

Contatta la nostra Community di utenti.

Questa pagina ti è stata utile?