Compartir vía

Configuración de MAPI a través de HTTP en Exchange Server

  • Artículo

En Exchange 2016 y Exchange 2019, puede configurar MAPI a través de HTTP en el nivel de organización o en el nivel de buzón individual. La configuración de nivel de buzón siempre tiene prioridad sobre la configuración de toda la organización.

Los escenarios en los que MAPI a través de HTTP está habilitado o deshabilitado de forma predeterminada en el nivel de organización se describen en la tabla siguiente:

Escenario Exchange 2019 Exchange 2016
Actualización desde un entorno de Exchange 2016 MAPI a través de HTTP está habilitado de forma predeterminada No aplicable
Actualización desde un entorno que contiene cualquier servidor de Exchange 2013 MAPI a través de HTTP está deshabilitado de forma predeterminada MAPI a través de HTTP está deshabilitado de forma predeterminada
Actualización desde un entorno de Exchange 2010 No aplicable MAPI a través de HTTP está habilitado de forma predeterminada

Nota:

Cuando MAPI a través de HTTP está habilitado en el nivel de organización, el valor de propiedad MapiHttpEnabled devuelto por el cmdlet Get-OrganizationConfig es True.

En este tema se describe cómo configurar y habilitar MAPI a través de HTTP para organizaciones de Exchange que contienen servidores de Exchange 2013 o para cualquier topología en la que MAPI a través de HTTP se haya deshabilitado previamente. También puede usar los procedimientos de este artículo para deshabilitar MAPI a través de HTTP en el nivel de organización.

En este tema también se describe cómo habilitar o deshabilitar MAPI a través de HTTP para un buzón individual. En el nivel de buzón, tiene la capacidad de permitir o bloquear MAPI a través de conexiones HTTP internamente, externamente o ambas. En todos los casos, cuando MAPI a través de HTTP está deshabilitado, las conexiones se realizarán con Outlook En cualquier lugar.

Configurar MAPI sobre HTTP

Complete los pasos siguientes para configurar MAPI a través de HTTP para su organización. En estos pasos se supone que ya ha configurado los requisitos previos descritos en MAPI sobre HTTP en Exchange Server. Una vez configurado (pasos del 1 al 3), use el paso 4 para habilitar o deshabilitar escenarios de permisos específicos en el nivel de organización, en el nivel de buzón o en ambos.

  1. Configuración del directorio virtual: de forma predeterminada, Exchange 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

  2. 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, consulte Certificados digitales y cifrado en Exchange Server. 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.

  3. 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.

  4. Siga estos pasos para habilitar MAPI a través de HTTP en toda la organización de Exchange o habilite MAPI a través de HTTP para uno o varios buzones individuales.

    Nota:

    Después de ejecutar los comandos siguientes, los clientes de Outlook con MAPI a través de HTTP habilitado verán un mensaje para reiniciar Outlook para usar MAPI a través de HTTP.

    Habilite MAPI a través de HTTP en la organización de Exchange:

    Para habilitar o deshabilitar MAPI a través de HTTP en el nivel de organización, use el cmdlet Set-OrganizationConfig con el parámetro MapiHttpEnabled . Los valores admitidos son:

    • $true: se permiten conexiones MAPI a través de HTTP para todos los buzones de la organización (a menos que MAPI sobre HTTP esté deshabilitado en un buzón específico).

    • $false: las conexiones MAPI a través de HTTP no se permiten para todos los buzones de la organización (a menos que MAPI a través de HTTP esté habilitado en un buzón específico).

    En el ejemplo siguiente se habilita MAPI a través de conexiones HTTP para toda la organización:

    Set-OrganizationConfig -MapiHttpEnabled $true

    Habilite MAPI a través de HTTP para un buzón de correo individual:

    Para habilitar o deshabilitar MAPI a través de HTTP en el nivel de buzón, use el cmdlet Set-CasMailbox con el parámetro MapiHttpEnabled . Los valores admitidos son:

    • $null: el buzón sigue la configuración de nivel de organización. Este es el valor predeterminado.

    • $true: habilite MAPI a través de HTTP para el buzón. Si MAPI a través de HTTP está deshabilitado en el nivel organizativo, está habilitado para el buzón.

    • $false: deshabilite MAPI a través de HTTP para el buzón. Si MAPI a través de HTTP está habilitado en el nivel organizativo, está deshabilitado para el buzón, por lo que el buzón usará conexiones de Outlook En cualquier lugar.

    En el ejemplo siguiente se habilita MAPI a través de conexiones HTTP para un único buzón:

    Set-CasMailbox <user or mailbox ID> -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/2018 7:15:00 AM   2/14/2018 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\

Combinación de MAPI a través de configuraciones HTTP y conexiones internas o externas

Además de la configuración de organización y buzón descrita anteriormente en este tema, puede usar el parámetro MapiBlockOutlookExternalConnectivity en el cmdlet Set-CasMailbox para permitir o denegar conexiones externas de Outlook Anywhere o MAPI a través de HTTP a un buzón específico. Los valores admitidos son:

  • True: solo se permiten conexiones internas al buzón de correo.

  • False: se permiten conexiones internas y externas al buzón de correo. Este es el valor predeterminado.

En la tabla siguiente se resumen los resultados de las distintas combinaciones de configuración en el nivel de organización y en buzones individuales.

Valor mapiHttpEnabled en Set-OrganizationConfig Valor mapiHttpEnabled en Set-CasMailbox Valor mapiBlockOutlookExternalConnectivity en Set-CasMailbox Resultado de detección automática
$true $null $false MAPI a través de HTTP, interno y externo
$true $null $true MAPI a través de HTTP, solo interno
$true $true $false MAPI a través de HTTP, interno y externo
$true $true $true MAPI a través de HTTP, solo interno
$true $false $false Outlook en cualquier lugar, interno y externo
$true $false $true Outlook En cualquier lugar, solo interno
$false $null $false Outlook en cualquier lugar, interno y externo
$false $null $true Outlook En cualquier lugar, solo interno
$false $true $false MAPI a través de HTTP, interno y externo
$false $true $true MAPI a través de HTTP, solo interno
$false $false $false Outlook en cualquier lugar, interno y externo
$false $false $true Outlook En cualquier lugar, solo interno

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: