MAPI su HTTP

Articolo
04/04/2023

Si applica a: Exchange Server 2013

Messaging Application Programming Interface (MAPI) su HTTP è un nuovo protocollo di trasporto implementato in Microsoft Exchange Server 2013 Service Pack 1 (SP1). Il MAPI su HTTP migliora l'affidabilità e la stabilità delle connessioni Outlook e Exchange spostando il livello di trasporto su modelli HTTP standard. In questo modo si consente un livello di visibilità superiore di errori di trasporto e recuperabilità avanzata. La funzionalità aggiuntiva include supporto per una funzione esplicita Sospendi o Riprendi. In questo modo si abilitano i client supportati a modificare le reti o a riprendere dalla sospensione durante il mantenimento delle stesso contesto di server.

L'implementazione del MAPI su HTTP non indica che si tratti dell'unico protocollo utilizzabile da Outlook per accedere a Exchange. I client Outlook che non dispongono della capacità di eseguire MAPI su HTTP possono comunque utilizzare Outlook via Internet (RPC su HTTP) per accedere a Exchange tramite server Accesso client abilitato per MAPI.

Vantaggi di MAPI su HTTP

MAPI su HTTP offre i seguenti vantaggi per i client da cui è supportato:

Abilita future innovazioni nell'autenticazione utilizzando il protocollo basato su HTTP.
Offre tempi di riconnessione più rapidi dopo un'interruzione delle comunicazioni perché è necessario ricompilare solo le connessioni TCP (non le connessioni RPC). Di seguito sono riportati alcuni esempi di un'interruzione di comunicazione:
- Sospensione del dispositivo
- Il passaggio da rete cablata a rete senza fili o cellulare
Offre un contesto di sessione non dipendente dalla connessione. Il server mantiene il contesto di sessione per un periodo di tempo configurabile, anche se l'utente modifica le reti.

Distribuire MAPI su HTTP

Considerare i requisiti seguenti per attivare MAPI su HTTP.

Supporto: verificare che le versioni di configurazione previste siano supportate.
Prerequisiti: verificare che l'ambiente sia stato aggiornato e preparato per MAPI tramite HTTP.
Configurazione: configurare le directory virtuali e abilitare MAPI per l'organizzazione.

Supporto

Utilizzare la matrice seguente per verificare che i client e i server supportino l'interfaccia MAPI su HTTP.

Prodotto	Exchange 2013 SP1	Exchange 2013 RTM	Exchange 2010 SP3	Exchange 2007 SP3
Outlook 2013 SP1	MAPI su HTTP Outlook via Internet	Outlook via Internet	RPC Outlook via Internet	RPC Outlook via Internet
Outlook 2013 RTM	Outlook via Internet	Outlook via Internet	RPC Outlook via Internet	RPC Outlook via Internet
Outlook 2010 SP2 e aggiornamenti KB2956191 e KB2965295 (14 aprile 2015)	MAPI su HTTP Outlook via Internet	Outlook via Internet	RPC Outlook via Internet	RPC Outlook via Internet
Outlook 2010 SP2 e versioni precedenti	Outlook via Internet	Outlook via Internet	RPC Outlook via Internet	RPC Outlook via Internet
Outlook 2007	Outlook via Internet	Outlook via Internet	RPC Outlook via Internet	RPC Outlook via Internet

Prerequisiti

Completare la procedura seguente per preparare i client e i server a supportare MAPI su HTTP.

Aggiornare i client di Outlook a Outlook 2013 SP1 o Outlook 2010 SP2 e gli aggiornamenti KB2956191 e KB2965295 (14 aprile 2015).
Aggiornare i server Accesso client e Cassette postali all'aggiornamento cumulativo (CU) di Exchange 2013 più recente. Per informazioni su come eseguire l'aggiornamento, vedere Aggiornare Exchange 2013 all'aggiornamento cumulativo o al Service Pack più recente.

Nota

Tutti i server Accesso client devono essere aggiornati alla versione più recente di Exchange 2013 CU o all'CU immediatamente precedente. In caso contrario, Outlook potrebbe non riuscire a connettersi alle cassette postali.

La mancata aggiornamento di tutti i server Cassette postali in un gruppo di disponibilità del database può causare ritardi nella posta elettronica e un requisito client per riavviare Outlook in caso di failover del database.
In tutti i server Exchange 2013 installare la versione di Microsoft .NET Framework supportata dall'cu in esecuzione nel server Exchange. Per altre informazioni, vedere Exchange Server Matrice di supporto e Installazione di .NET Framework.

Configurazione

Completare la procedura seguente per configurare MAPI su HTTP per l'organizzazione.

Configurazione della directory virtuale: per impostazione predefinita, Exchange 2013 SP1 crea una directory virtuale per MAPI su HTTP. È possibile utilizzare il cmdlet Set-MapiVirtualDirectory per configurare la directory virtuale. È necessario configurare un URL interno, un URL esterno o entrambi. Per ulteriori informazioni, vedere Set-MapiVirtualDirectory.

Ad esempio, per configurare la directory virtuale MAPI predefinita nel server Exchange locale impostando il valore dell'URL interno su https://contoso.com/mapie il metodo di autenticazione su Negotiate, eseguire il comando seguente:
```
Set-MapiVirtualDirectory -Identity "Contoso\mapi (Default Web Site)" -InternalUrl https://Contoso.com/mapi -IISAuthenticationMethods Negotiate
```
Configurazione del certificato: il certificato digitale usato dall'ambiente Exchange deve includere gli stessi valori InternalURL ed ExternalURL definiti nella directory virtuale MAPI. Per altre informazioni sulla gestione dei certificati di Exchange 2013, vedere Certificati digitali e SSL. Assicurarsi che il certificato Exchange sia affidabile sulla workstation client Outlook e che non vi siano errori del certificato, in particolar modo quando si accede agli URL configurati sulla directory virtuale MAPI.
Aggiornare le regole del server: verificare che i servizi di bilanciamento del carico, i proxy inversi e i firewall siano configurati per consentire l'accesso al MAPI tramite la directory virtuale HTTP.
Abilitare MAPI su HTTP nell'organizzazione di Exchange

Eseguire il comando riportato di seguito:
```
Set-OrganizationConfig -MapiHttpEnabled $true
```

Verificare MAPI su connessioni HTTP

È possibile testare l'interfaccia MAPI end-to-end tramite connessione HTTP utilizzando il cmdlet Test-OutlookConnectivity. Per utilizzare il cmdlet Test-OutlookConnectivity, deve essere avviato il servizio Microsoft Exchange Health Manager (MSExchangeHM).

L'esempio seguente prova l'interfaccia MAPI su connessione HTTP dal server di Exchange denominato ContosoMail.

Test-OutlookConnectivity -RunFromServerId ContosoMail -ProbeIdentity OutlookMapiHttpSelfTestProbe

Un test riuscito restituisce un output simile all'esempio seguente:

MonitorIdentity                                        StartTime              EndTime                Result      Error     Exception
---------------                                        ---------              -------                ------      -----     ---------
OutlookMapiHttp.Protocol\OutlookMapiHttpSelfTestProbe  2/14/2014 7:15:00 AM   2/14/2014 7:15:10 AM   Succeeded

Per ulteriori informazioni, vedere Test-OutlookConnectivity.

I registri per MAPI su attività HTTP si trovano nelle posizioni seguenti:

%ExchangeInstallPath%Logging\MAPI Address Book Service\
%ExchangeInstallPath%Logging\MAPI Client Access\
%ExchangeInstallPath%Logging\HttpProxy\Mapi\

Gestire MAPI su HTTP

È possibile gestire la configurazione di MAPI su HTTP utilizzando i cmdlet seguenti:

Share via