---
title: "Exchange - Configurare un connettore di ricezione"
description: "Posiziona un gateway antispam esterno davanti alla piattaforma Exchange OVHcloud grazie a un connettore di ricezione, creato e gestito con l'API OVHcloud"
url: https://docs.ovhcloud.com/it/guides/web-cloud/email-and-collaborative-solutions/microsoft-exchange/feature-receive-connector
lang: it
lastUpdated: 2026-11-16
---
> 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.

# Exchange - Configurare un connettore di ricezione

## 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](https://www.ovhcloud.com/it/emails/private-exchange/) e [Trusted Exchange](https://www.ovhcloud.com/it/enterprise/products/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.**

**Nota:** 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](https://docs.ovhcloud.com/it/guides/web-cloud/email-and-collaborative-solutions/microsoft-exchange/feature-send-connector.md)".

## Prerequisiti

- Disporre di una piattaforma [Private Exchange](https://www.ovhcloud.com/it/emails/private-exchange/) o [Trusted Exchange](https://www.ovhcloud.com/it/enterprise/products/trusted-exchange/).
- Disporre di credenziali API create nella pagina di generazione dei token OVHcloud, 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](https://docs.ovhcloud.com/it/guides/manage-and-operate/api/first-steps.md)".
- 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.

**Attenzione:** **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](https://api.eu.ovhcloud.com/console/?section=/email/exchange&branch=v1#get-/email/exchange)

**2. Servizio** (`exchangeService`)

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

[GET /email/exchange/{organizationName}/service](https://api.eu.ovhcloud.com/console/?section=/email/exchange&branch=v1#get-/email/exchange/-organizationName-/service)

### Creare un connettore di ricezione

Crea il connettore con la chiamata API riportata di seguito:

[POST /email/exchange/{organizationName}/service/{exchangeService}/receiveConnector](https://api.eu.ovhcloud.com/console/?section=/email/exchange&branch=v1#post-/email/exchange/-organizationName-/service/-exchangeService-/receiveConnector)

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

| Campo            | Tipo      | Descrizione                                                                                                      |
| ---------------- | --------- | ---------------------------------------------------------------------------------------------------------------- |
| `name`           | string    | Nome del connettore, massimo 255 caratteri                                                                       |
| `remoteIpRanges` | string\[] | Indirizzi IP dei server autorizzati a consegnare email tramite questo connettore (vedi sotto)                    |
| `requireTls`     | boolean   | `true` per richiedere TLS per tutte le email ricevute da questo connettore                                       |
| `maxMessageSize` | long      | Facoltativo. Dimensione massima di un'email ricevuta da questo connettore, in MB                                 |
| `enabled`        | boolean   | Facoltativo. `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.

**Attenzione:** **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:

[GET /email/exchange/{organizationName}/service/{exchangeService}/receiveConnector](https://api.eu.ovhcloud.com/console/?section=/email/exchange&branch=v1#get-/email/exchange/-organizationName-/service/-exchangeService-/receiveConnector)

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

[GET /email/exchange/{organizationName}/service/{exchangeService}/receiveConnector/{id}](https://api.eu.ovhcloud.com/console/?section=/email/exchange&branch=v1#get-/email/exchange/-organizationName-/service/-exchangeService-/receiveConnector/-id-)

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:

[PATCH /email/exchange/{organizationName}/service/{exchangeService}/receiveConnector/{id}](https://api.eu.ovhcloud.com/console/?section=/email/exchange&branch=v1#patch-/email/exchange/-organizationName-/service/-exchangeService-/receiveConnector/-id-)

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

[PUT /email/exchange/{organizationName}/service/{exchangeService}/receiveConnector/{id}](https://api.eu.ovhcloud.com/console/?section=/email/exchange&branch=v1#put-/email/exchange/-organizationName-/service/-exchangeService-/receiveConnector/-id-)

**Nota:** 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](#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:

[DELETE /email/exchange/{organizationName}/service/{exchangeService}/receiveConnector/{id}](https://api.eu.ovhcloud.com/console/?section=/email/exchange&branch=v1#delete-/email/exchange/-organizationName-/service/-exchangeService-/receiveConnector/-id-)

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](https://docs.ovhcloud.com/it/guides/web-cloud/email-and-collaborative-solutions/microsoft-exchange/feature-send-connector.md)

[Modificare una zona DNS di OVHcloud](https://docs.ovhcloud.com/it/guides/web-cloud/domains/dns-zone-edit.md)

[Guide Microsoft Exchange](https://docs.ovhcloud.com/it/guides/web-cloud/email-and-collaborative-solutions/microsoft-exchange/landing-page-microsoft-exchange.md)

Per prestazioni specializzate (referenziamento, sviluppo, ecc.), contatta i [partner OVHcloud](https://partner.ovhcloud.com/it/directory/).

Per usufruire di un supporto per l'utilizzo e la configurazione delle soluzioni OVHcloud, è possibile consultare le nostre [offerte di supporto](https://www.ovhcloud.com/it/support-levels/).

Contatta la nostra [Community di utenti](https://community.ovhcloud.com/).
