MAPI sobre HTTP

Artigo
04/04/2023

Aplica-se a: Exchange Server 2013

A MAPI (Interface de Programação de Aplicativo de Mensagens) sobre HTTP é um novo protocolo de transporte implementado no Microsoft Exchange Server Service Pack 1 (SP1) de 2013. O MAPI sobre HTTP aumenta a confiabilidade e a estabilidade das conexões do Outlook e do Exchange movendo a camada de transporte para o modelo HTTP padrão da indústria. Isso permite um nível mais alto de visibilidade de erros de transporte e capacidade de recuperação avançada. A funcionalidade adicional inclui suporte para uma função explícita de pausar e retomar. Isso permite que clientes compatíveis alterem redes ou retomem da hibernação enquanto mantêm o mesmo contexto de servidor.

A implementação de MAPI sobre HTTP não significa que esse é o único protocolo que pode ser usado para o Outlook acessar o Exchange. Os clientes do Outlook que não são compatíveis com MAPI sobre HTTP ainda podem usar o Outlook em Qualquer Lugar (RPC sobre HTTP) para acessar o Exchange por meio de um servidor de Acesso para Cliente habilitado para MAPI.

Benefícios de MAPI sobre HTTP

MAPI over HTTP oferece os seguintes benefícios aos clientes que dão suporte a ele:

Permite inovação futura em autenticação usando um protocolo baseado em HTTP.
Fornece tempos de reconexão mais rápidos após uma interrupção de comunicação porque apenas conexões TCP (não conexões RPC) precisam ser reconstruídas. Exemplos de uma interrupção de comunicação incluem:
- Hibernação do dispositivo
- Alterar de uma rede com fio para uma rede sem fio ou celular
Oferece um contexto de sessão que não depende da conexão. O servidor mantém o contexto de sessão por um período configurável de tempo, mesmo que o usuário altere as redes.

Implantar MAPI sobre HTTP

Considere os seguintes requisitos para habilitar MAPI sobre HTTP.

Capacidade de suporte: verifique se as versões de configuração pretendidas têm suporte.
Pré-requisitos: verifique se o ambiente foi atualizado e preparado para MAPI por HTTP.
Configuração: configure os diretórios virtuais e habilite o MAPI para sua organização.

Capacidade de suporte

Use a matriz a seguir para verificar se seus clientes e servidores oferecem suporte a MAPI sobre HTTP.

Produto	Exchange 2013 SP1	Exchange 2013 RTM	Exchange 2010 SP3	Exchange 2007 SP3
Outlook 2013 SP1	MAPI sobre HTTP Outlook em Qualquer Lugar	Outlook em Qualquer Lugar	RPC Outlook em Qualquer Lugar	RPC Outlook em Qualquer Lugar
Outlook 2013 RTM	Outlook em Qualquer Lugar	Outlook em Qualquer Lugar	RPC Outlook em Qualquer Lugar	RPC Outlook em Qualquer Lugar
Outlook 2010 SP2 e atualizações KB2956191 e KB2965295 (14 de abril de 2015)	MAPI sobre HTTP Outlook em Qualquer Lugar	Outlook em Qualquer Lugar	RPC Outlook em Qualquer Lugar	RPC Outlook em Qualquer Lugar
Outlook 2010 SP2 e anterior	Outlook em Qualquer Lugar	Outlook em Qualquer Lugar	RPC Outlook em Qualquer Lugar	RPC Outlook em Qualquer Lugar
Outlook 2007	Outlook em Qualquer Lugar	Outlook em Qualquer Lugar	RPC Outlook em Qualquer Lugar	RPC Outlook em Qualquer Lugar

Pré-requisitos

Conclua as etapas a seguir para preparar os clientes e servidores para oferecer suporte a MAPI sobre HTTP.

Atualize os clientes do Outlook para o Outlook 2013 SP1 ou Outlook 2010 SP2 e atualize KB2956191 e KB2965295 (14 de abril de 2015).
Atualize os servidores de Acesso ao Cliente e caixa de correio para a cu (atualização cumulativa do Exchange 2013) mais recente. Para obter informações sobre como atualizar, consulte Atualizar o Exchange 2013 para a atualização cumulativa ou pacote de serviço mais recente.

Observação

Todos os servidores de Acesso ao Cliente devem ser atualizados para a CU mais recente do Exchange 2013 ou para a CU imediatamente anterior. Caso contrário, poderá ocorrer uma falha durante a conexão do Outlook a caixas de correio.

A falha na atualização de todos os servidores da caixa de correio em um DAG (Grupo de Disponibilidade de Banco de Dados) pode resultar em atrasos de email e um requisito do cliente para reiniciar o Outlook no caso de um failover de banco de dados.
Em todos os servidores do Exchange 2013, instale a versão do Microsoft .NET Framework com suporte da CU em execução no servidor exchange. Para obter mais informações, consulte Exchange Server Matriz de Suporte e Instalação do .NET Framework.

Configuração

Conclua as etapas a seguir para configurar MAPI sobre HTTP para sua organização.

Configuração do diretório virtual: por padrão, o Exchange 2013 SP1 cria um diretório virtual para MAPI por HTTP. Use o cmdlet Set-MapiVirtualDirectory para configurar o diretório virtual. Você deve configurar uma URL interna, uma URL externa ou ambas. Para mais informações, consulte Set-MapiVirtualDirectory.

Por exemplo, para configurar o diretório virtual MAPI padrão no servidor exchange local definindo o valor da URL interna como https://contoso.com/mapi, e o método de autenticação para Negotiate, execute o seguinte comando:
```
Set-MapiVirtualDirectory -Identity "Contoso\mapi (Default Web Site)" -InternalUrl https://Contoso.com/mapi -IISAuthenticationMethods Negotiate
```
Configuração do certificado: o certificado digital usado pelo ambiente do Exchange deve incluir os mesmos valores InternalURL e ExternalURL definidos no diretório virtual MAPI. Para obter mais informações sobre o gerenciamento de certificados do Exchange 2013, consulte Certificados digitais e SSL. Verifique se o certificado do Exchange é confiável na estação de trabalho cliente do Outlook e se não há erros de certificados, especialmente quando você acessa as URLs configuradas no diretório virtual MAPI.
Atualizar regras do servidor: verifique se os balanceadores de carga, proxies reversos e firewalls estão configurados para permitir o acesso ao MAPI por meio do diretório virtual HTTP.
Habilitar MAPI sobre HTTP em sua organização do Exchange

Execute o seguinte comando:
```
Set-OrganizationConfig -MapiHttpEnabled $true
```

Testar conexões MAPI sobre HTTP

Você pode testar a conexão MAPI sobre HTTP de ponta a ponta usando o cmdlet Test-OutlookConnectivity. Para usar o cmdlet Test-OutlookConnectivity, o serviço Gerenciador de Integridade do Microsoft Exchange (MSExchangeHM) deve ser iniciado.

O exemplo a seguir testa a conexão MAPI sobre HTTP do servidor Exchange chamado ContosoMail.

Test-OutlookConnectivity -RunFromServerId ContosoMail -ProbeIdentity OutlookMapiHttpSelfTestProbe

Um teste bem-sucedido retorna um resultado semelhante ao exemplo a seguir:

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 obter mais informações, consulte Test-OutlookConnectivity.

Os logs da atividade de MAPI sobre HTTP estão nos seguintes locais:

%CaminhoInstalaçãoExchange%Logging\MAPI Address Book Service\
%CaminhoInstalaçãoExchange%Logging\MAPI Client Access\
%ExchangeInstallPath%Logging\HttpProxy\Mapi\

Gerenciar MAPI sobre HTTP

Você pode gerenciar a configuração de MAPI sobre HTTP usando os seguintes cmdlets:

Compartilhar via