MAPI sobre HTTPMAPI over HTTP

Aplica-se a: Exchange Server 2013Applies to: Exchange Server 2013

O Messaging Application Programming Interface (MAPI) sobre HTTP é um novo protocolo de transporte implementado no Microsoft Exchange Server 2013 Service Pack 1 (SP1).Messaging Application Programming Interface (MAPI) over HTTP is a new transport protocol implemented in Microsoft Exchange Server 2013 Service Pack 1 (SP1). 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.MAPI over HTTP improves the reliability and stability of the Outlook and Exchange connections by moving the transport layer to the industry-standard HTTP model. Isso permite um nível mais alto de visibilidade de erros de transporte e capacidade de recuperação avançada.This allows a higher level of visibility of transport errors and enhanced recoverability. A funcionalidade adicional inclui suporte para uma função explícita de pausar e retomar.Additional functionality includes support for an explicit pause-and-resume function. Isso permite que clientes compatíveis alterem redes ou retomem da hibernação enquanto mantêm o mesmo contexto de servidor.This enables supported clients to change networks or resume from hibernation while maintaining the same server context.

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.Implementing MAPI over HTTP does not mean that it is the only protocol that can be used for Outlook to access Exchange. Outlook clients that are not MAPI over HTTP capable can still use Outlook Anywhere (RPC over HTTP) to access Exchange through a MAPI-enabled Client Access server.

Benefícios de MAPI sobre HTTPBenefits of MAPI over HTTP

O MAPI sobre HTTP oferece os seguintes benefícios para os clientes que oferecem suporte a ele:MAPI over HTTP offers the following benefits to clients that support it:

  • Permite inovação futura em autenticação usando um protocolo baseado em HTTP.Enables future innovation in authentication by using an HTTP based protocol.

  • 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 recriadas.Provides faster reconnection times after a communications break because only TCP connections (not RPC connections) need to be rebuilt. Exemplos de uma interrupção de comunicação incluem:Examples of a communication break include:

    • Hibernação do dispositivoDevice hibernation

    • Alterar de uma rede com fio para uma rede sem fio ou celularChanging from a wired network to a wireless or cellular network

  • Oferece um contexto de sessão que não depende da conexão.Offers a session context that is not dependent on the connection. O servidor mantém o contexto da sessão por um período de tempo configurável, mesmo que o usuário altere as redes.The server maintains the session context for a configurable period of time, even if the user changes networks.

Implantar MAPI sobre HTTPDeploy MAPI over HTTP

Considere os seguintes requisitos para habilitar MAPI sobre HTTP.Consider the following requirements to enable MAPI over HTTP.

  • Capacidade de suporte: Verifique se as versões de configuração pretendidas são suportadas.Supportability: Verify that your intended configuration versions are supported.

  • Pré-requisitos: Verifique se o seu ambiente foi atualizado e se está preparado para MAPI sobre http.Prerequisites: Verify that your environment has been upgraded and prepared for MAPI over HTTP.

  • Configuração: Configure os diretórios virtuais e habilite o MAPI para sua organização.Configuration: Configure the virtual directories, and enable MAPI for your organization.

Capacidade de suporteSupportability

Use a matriz a seguir para verificar se seus clientes e servidores oferecem suporte a MAPI sobre HTTP.Use the following matrix to verify that your clients and servers support MAPI over HTTP.

ProdutoProduct Exchange 2013 SP1Exchange 2013 SP1 RTM do Exchange 2013Exchange 2013 RTM Exchange 2010 SP3Exchange 2010 SP3 Exchange 2007 SP3Exchange 2007 SP3

Outlook 2013 SP1Outlook 2013 SP1

  • MAPI sobre HTTPMAPI over HTTP

  • Outlook em Qualquer LugarOutlook Anywhere

Outlook em Qualquer LugarOutlook Anywhere

  • RPCsRPC

  • Outlook em Qualquer LugarOutlook Anywhere

  • RPCsRPC

  • Outlook em Qualquer LugarOutlook Anywhere

RTM do Outlook 2013Outlook 2013 RTM

Outlook em Qualquer LugarOutlook Anywhere

Outlook em Qualquer LugarOutlook Anywhere

  • RPCsRPC

  • Outlook em Qualquer LugarOutlook Anywhere

  • RPCsRPC

  • Outlook em Qualquer LugarOutlook Anywhere

Outlook 2010 SP2 e atualiza o KB2956191 e o KB2965295 (14 de abril de 2015)Outlook 2010 SP2 and updates KB2956191 and KB2965295 (April 14, 2015)

  • MAPI sobre HTTPMAPI over HTTP

  • Outlook em Qualquer LugarOutlook Anywhere

Outlook em Qualquer LugarOutlook Anywhere

  • RPCsRPC

  • Outlook em Qualquer LugarOutlook Anywhere

  • RPCsRPC

  • Outlook em Qualquer LugarOutlook Anywhere

Outlook 2010 SP2 e anteriorOutlook 2010 SP2 and earlier

Outlook em Qualquer LugarOutlook Anywhere

Outlook em Qualquer LugarOutlook Anywhere

  • RPCsRPC

  • Outlook em Qualquer LugarOutlook Anywhere

  • RPCsRPC

  • Outlook em Qualquer LugarOutlook Anywhere

Outlook 2007Outlook 2007

Outlook em Qualquer LugarOutlook Anywhere

Outlook em Qualquer LugarOutlook Anywhere

  • RPCsRPC

  • Outlook em Qualquer LugarOutlook Anywhere

  • RPCsRPC

  • Outlook em Qualquer LugarOutlook Anywhere

Pré-requisitosPrerequisites

Conclua as etapas a seguir para preparar os clientes e servidores para oferecer suporte a MAPI sobre HTTP.Complete the following steps to prepare the clients and servers to support MAPI over HTTP.

  1. Atualizar os clientes do Outlook para o Outlook 2013 SP1 ou o Outlook 2010 SP2 e atualiza o KB2956191 e o KB2965295 (14 de abril de 2015).Upgrade Outlook clients to Outlook 2013 SP1 or Outlook 2010 SP2 and updates KB2956191 and KB2965295 (April 14, 2015).

  2. Atualize o acesso para cliente e servidores de caixa de correio para a atualização cumulativa mais recente do Exchange 2013 (CU).Upgrade Client Access and Mailbox servers to the latest Exchange 2013 cumulative update (CU). Para obter informações sobre como atualizar, consulte Atualizar o Exchange 2013 para a atualização cumulativa ou pacote de serviço mais recente.For information about how to upgrade, see Upgrade Exchange 2013 to the latest cumulative update or service pack.

    Observação

    Todos os servidores de acesso para cliente devem ser atualizados para o Exchange 2013 CU mais recente ou para a CU imediatamente anterior.All Client Access servers must be upgraded to the latest Exchange 2013 CU, or the immediately previous CU. Caso contrário, poderá ocorrer uma falha durante a conexão do Outlook a caixas de correio.Otherwise, Outlook can fail to connect to mailboxes.
    A falha na atualização de todos os servidores de caixa de correio em um grupo de disponibilidade de banco de dados (DAG) pode resultar em atrasos de email e um requisito de cliente para reiniciar o Outlook no caso de um failover de banco de dados.Failure to upgrade the all the Mailbox servers in a Database Availability Group (DAG) can result in email delays and a client requirement to restart Outlook in case of a database failover.

  3. Em todos os servidores do Exchange 2013, instale a versão do Microsoft .NET Framework suportada pela CU em execução no seu servidor Exchange.On all Exchange 2013 servers, install the Microsoft .NET Framework version supported by the CU running on your Exchange server. Para obter mais informações, consulte matriz de suporte do Exchange Server e instalando o .NET Framework.For more information see Exchange Server Supportability Matrix and Installing the .NET Framework.

ConfiguraçãoConfiguration

Conclua as etapas a seguir para configurar MAPI sobre HTTP para sua organização.Complete the following steps to configure MAPI over HTTP for your organization.

  1. Configuração de diretório virtual: por padrão, o Exchange 2013 SP1 cria um diretório virtual para MAPI sobre http.Virtual directory configuration: By default, Exchange 2013 SP1 creates a virtual directory for MAPI over HTTP. Use o cmdlet Set-MapiVirtualDirectory para configurar o diretório virtual.You use the Set-MapiVirtualDirectory cmdlet to configure the virtual directory. Você deve configurar uma URL interna, uma URL externa ou ambas.You must configure an internal URL, an external URL, or both. Para mais informações, consulte Set-MapiVirtualDirectory.For more information see, 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/mapie o método de autenticação como Negotiate, execute o seguinte comando:For example, to configure the default MAPI virtual directory on the local Exchange server by setting the internal URL value to https://contoso.com/mapi, and the authentication method to Negotiate, run the following command:

    Set-MapiVirtualDirectory -Identity "Contoso\mapi (Default Web Site)" -InternalUrl https://Contoso.com/mapi -IISAuthenticationMethods Negotiate
    
  2. Configuração de certificado: o certificado digital usado pelo seu ambiente do Exchange deve incluir os mesmos valores InternalURL e EXTERNALURL definidos no diretório virtual MAPI.Certificate configuration: The digital certificate used by your Exchange environment must include the same InternalURL and ExternalURL values that are defined on the MAPI virtual directory. Para obter mais informações sobre o gerenciamento de certificados do Exchange 2013, consulte certificados digitais e SSL.For more information on Exchange 2013 certificate management, see Digital certificates and 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.Make sure the Exchange certificate is trusted on the Outlook client workstation and that there are no certificate errors, especially when you access the URLs configured on the MAPI virtual directory.

  3. Atualizar regras de servidor: Verifique se seus balanceadores de carga, proxies reversos e firewalls estão configurados para permitir o acesso ao diretório virtual MAPI sobre http.Update server rules: Verify that your load balancers, reverse proxies, and firewalls are configured to allow access to the MAPI over HTTP virtual directory.

  4. Habilitar MAPI sobre HTTP em sua organização do ExchangeEnable MAPI over HTTP in your Exchange Organization

    Execute o seguinte comando:Run the following command:

    Set-OrganizationConfig -MapiHttpEnabled $true
    

Testar conexões MAPI sobre HTTPTest MAPI over HTTP connections

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.You can test the end-to-end MAPI over HTTP connection by using the Test-OutlookConnectivity cmdlet. To use the Test-OutlookConnectivity cmdlet, the Microsoft Exchange Health Manager (MSExchangeHM) service must be started.

O exemplo a seguir testa a conexão MAPI sobre HTTP do servidor Exchange chamado ContosoMail.The following example tests the MAPI over HTTP connection from the Exchange server named ContosoMail.

Test-OutlookConnectivity -RunFromServerId ContosoMail -ProbeIdentity OutlookMapiHttpSelfTestProbe

Um teste bem-sucedido retorna um resultado semelhante ao exemplo a seguir:A successful test returns output that's similar to the following example:

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.For more information, see Test-OutlookConnectivity.

Os logs da atividade de MAPI sobre HTTP estão nos seguintes locais:Logs for MAPI over HTTP activity are at the following locations:

  • % ExchangeInstallPath% registrar\serviço de catálogo de endereços MAPI%ExchangeInstallPath%Logging\MAPI Address Book Service\

  • % ExchangeInstallPath% de\registro em log do acesso para cliente MAPI%ExchangeInstallPath%Logging\MAPI Client Access\

  • % ExchangeInstallPath% Logging\HttpProxy\MAPI%ExchangeInstallPath%Logging\HttpProxy\Mapi\

Gerenciar MAPI sobre HTTPManage MAPI over HTTP

Você pode gerenciar a configuração de MAPI sobre HTTP usando os seguintes cmdlets:You can manage the configuration of MAPI over HTTP by using the following cmdlets: