MAPI sobre HTTP

Artículo
04/04/2023

Se aplica a: Exchange Server 2013

Messaging Application Programming Interface (MAPI) over HTTP es un nuevo protocolo de transporte implementado en Microsoft Exchange Server 2013 Service Pack 1 (SP1). MAPI sobre HTTP traslada la capa de transporte al modelo HTTP estándar de la industria para mejorar la confiabilidad y la estabilidad de las conexiones de Outlook y Exchange, lo que permite un mayor nivel de visibilidad de los errores de transporte y una mayor capacidad de recuperación. La funcionalidad adicional incluye compatibilidad con una función explícita de pausa y reanudación. Una de las características adicionales es la compatibilidad con una función de pausa y reanudación explícitas. Esto permite a los clientes compatibles cambiar de red o reanudarse después de la hibernación manteniendo el mismo contexto de servidor.

Implementar MAPI sobre HTTP no significa que sea el único protocolo que se puede usar para que Outlook acceda a Exchange. Los clientes de Outlook que no sean compatibles con MAPI sobre HTTP pueden seguir usando Outlook en cualquier lugar (RPC sobre HTTP) para acceder a Exchange a través de un servidor de acceso de cliente habilitado para MAPI.

Ventajas de MAPI sobre HTTP

MAPI sobre HTTP ofrece las siguientes ventajas a los clientes compatibles:

Permite innovar en la autenticación en el futuro usando un protocolo basado en HTTP.
Proporciona tiempos de reconexión más rápidos después de un salto de comunicaciones porque solo es necesario volver a generar las conexiones TCP (no las conexiones RPC). Algunos ejemplos de una interrupción de las comunicaciones son:
- Hibernación de dispositivos
- Cambio de una red cableada a una red inalámbrica o móvil
Ofrece un contexto de sesión que no depende de la conexión. El servidor mantiene el contexto de sesión durante un período de tiempo configurable, incluso si el usuario cambia de red.

Implementación de MAPI a través de HTTP

Tenga en cuenta los siguientes requisitos para habilitar MAPI sobre HTTP.

Compatibilidad: compruebe que se admiten las versiones de configuración previstas.
Requisitos previos: compruebe que el entorno se ha actualizado y preparado para MAPI a través de HTTP.
Configuración: configure los directorios virtuales y habilite MAPI para su organización.

Compatibilidad

Use la siguiente matriz para comprobar que sus clientes y servidores admiten MAPI sobre HTTP.

Producto	Exchange 2013 SP1	Exchange 2013 RTM	Exchange 2010 SP3	Exchange 2007 SP3
Outlook 2013 SP1	MAPI sobre HTTP Outlook en cualquier lugar	Outlook en cualquier lugar	RPC Outlook en cualquier lugar	RPC Outlook en cualquier lugar
Outlook 2013 RTM	Outlook en cualquier lugar	Outlook en cualquier lugar	RPC Outlook en cualquier lugar	RPC Outlook en cualquier lugar
Outlook 2010SP2 y actualizaciones KB2956191 y KB2965295 (14 de abril de 2015)	MAPI a través de HTTP Outlook en cualquier lugar	Outlook en cualquier lugar	RPC Outlook en cualquier lugar	RPC Outlook en cualquier lugar
Outlook 2010 SP2 y versiones anteriores	Outlook en cualquier lugar	Outlook en cualquier lugar	RPC Outlook en cualquier lugar	RPC Outlook en cualquier lugar
Outlook 2007	Outlook en cualquier lugar	Outlook en cualquier lugar	RPC Outlook en cualquier lugar	RPC Outlook en cualquier lugar

Requisitos previos

Complete los pasos siguientes para preparar los clientes y servidores para admitir MAPI a través de HTTP.

Actualice los clientes de Outlook a Outlook 2013 SP1 o Outlook 2010 SP2 y actualice KB2956191 y KB2965295 (14 de abril de 2015).
Actualice los servidores de acceso de cliente y buzón a la actualización acumulativa (CU) de Exchange 2013 más reciente. Para obtener información sobre cómo actualizar, consulte Actualización de Exchange 2013 a la actualización acumulativa más reciente o Service Pack.

Nota:

Todos los servidores de acceso de cliente deben actualizarse a la versión más reciente de Exchange 2013 CU o al CU inmediatamente anterior. De lo contrario, Outlook puede no conectarse a buzones.

El error al actualizar todos los servidores de buzones de un grupo de disponibilidad de base de datos (DAG) puede provocar retrasos en el correo electrónico y un requisito de cliente para reiniciar Outlook en caso de una conmutación por error de base de datos.
En todos los servidores de Exchange 2013, instale la versión de Microsoft .NET Framework compatible con la CU que se ejecuta en el servidor exchange. Para obtener más información, vea Exchange Server Matriz de compatibilidad e Instalación de .NET Framework.

Configuración

Complete los pasos siguientes para configurar MAPI a través de HTTP para su organización.

Configuración del directorio virtual: de forma predeterminada, Exchange 2013 SP1 crea un directorio virtual para MAPI a través de HTTP. Use el cmdlet Set-MapiVirtualDirectory para configurar el directorio virtual. Debe configurar una dirección URL interna, una dirección URL externa o ambas. Para obtener más información, vea Set-MapiVirtualDirectory.

Por ejemplo, para configurar el directorio virtual MAPI predeterminado en el servidor exchange local estableciendo el valor https://contoso.com/mapide dirección URL interna en y el método de autenticación en Negotiate, ejecute el siguiente comando:
```
Set-MapiVirtualDirectory -Identity "Contoso\mapi (Default Web Site)" -InternalUrl https://Contoso.com/mapi -IISAuthenticationMethods Negotiate
```
Configuración del certificado: el certificado digital que usa el entorno de Exchange debe incluir los mismos valores InternalURL y ExternalURL definidos en el directorio virtual MAPI. Para obtener más información sobre la administración de certificados de Exchange 2013, consulte Certificados digitales y SSL. Asegúrese de que el certificado de Exchange es de confianza en la estación de trabajo cliente de Outlook y de que no hay errores de certificado, especialmente cuando accede a las direcciones URL configuradas en el directorio virtual MAPI.
Actualizar reglas de servidor: compruebe que los equilibradores de carga, los servidores proxy inversos y los firewalls están configurados para permitir el acceso a MAPI a través del directorio virtual HTTP.
Habilitación de MAPI a través de HTTP en la organización de Exchange

Ejecute el comando siguiente:
```
Set-OrganizationConfig -MapiHttpEnabled $true
```

Prueba de MAPI a través de conexiones HTTP

Puede probar mapi de un extremo a otro a través de la conexión HTTP mediante el cmdlet Test-OutlookConnectivity . Para usar el cmdlet Test-OutlookConnectivity , se debe iniciar el servicio Microsoft Exchange Health Manager (MSExchangeHM).

En el ejemplo siguiente se prueba la conexión MAPI a través de HTTP desde el servidor Exchange denominado ContosoMail.

Test-OutlookConnectivity -RunFromServerId ContosoMail -ProbeIdentity OutlookMapiHttpSelfTestProbe

Una prueba correcta devuelve una salida similar a la del ejemplo siguiente:

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

Para obtener más información, vea Test-OutlookConnectivity.

Los registros de la actividad MAPI a través de HTTP se encuentran en las siguientes ubicaciones:

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

Administración de MAPI a través de HTTP

Puede administrar la configuración de MAPI a través de HTTP mediante los siguientes cmdlets:

Compartir a través de