MAPI sobre HTTPMAPI over HTTP

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

Messaging Application Programming Interface (MAPI) sobre HTTP é um novo protocolo de transporte implementado no Microsoft Exchange Server 2013 Service Pack 1 (SP1). MAPI sobre HTTP melhora a confiabilidade e a estabilidade das conexões Outlook e Exchange ao mover a camada de transporte para o modelo HTTP padrão do setor. Isso permite que um nível mais alto de visibilidade de erros de transporte e capacidade de recuperação avançada. Funcionalidade adicional inclui suporte para uma função de pausar e continuar explícita. Isso permite que os clientes com suporte alterar redes ou retornar da hibernação, mantendo o mesmo contexto de servidor.Messaging Application Programming Interface (MAPI) over HTTP is a new transport protocol implemented in Microsoft Exchange Server 2013 Service Pack 1 (SP1). 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. This allows a higher level of visibility of transport errors and enhanced recoverability. Additional functionality includes support for an explicit pause-and-resume function. 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

MAPI sobre HTTP oferece os seguintes benefícios para clientes com suporte: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.

  • Oferece tempos de reconexão mais rápidos após uma interrupção nas comunicações porque somente conexões TCP, e não conexões RPC, precisam ser recriadas. Exemplos de uma interrupção de comunicação incluem:Provides faster reconnection times after a communications break because only TCP connections—not RPC connections—need to be rebuilt. 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. O servidor mantém o contexto de sessão por um período configurável, mesmo se o usuário trocar de redes.Offers a session context that is not dependent on the connection. 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.

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

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

  • Configuração Configurar os diretórios virtuais e habilite 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

  • RPCRPC

  • Outlook em Qualquer LugarOutlook Anywhere

  • RPCRPC

  • Outlook em Qualquer LugarOutlook Anywhere

Outlook 2013 RTMOutlook 2013 RTM

Outlook em Qualquer LugarOutlook Anywhere

Outlook em Qualquer LugarOutlook Anywhere

  • RPCRPC

  • Outlook em Qualquer LugarOutlook Anywhere

  • RPCRPC

  • Outlook em Qualquer LugarOutlook Anywhere

Outlook 2010 SP2 e atualizações KB2956191 e 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

  • RPCRPC

  • Outlook em Qualquer LugarOutlook Anywhere

  • RPCRPC

  • Outlook em Qualquer LugarOutlook Anywhere

Outlook 2010 SP2 e versões anterioresOutlook 2010 SP2 and earlier

Outlook em Qualquer LugarOutlook Anywhere

Outlook em Qualquer LugarOutlook Anywhere

  • RPCRPC

  • Outlook em Qualquer LugarOutlook Anywhere

  • RPCRPC

  • Outlook em Qualquer LugarOutlook Anywhere

Outlook 2007Outlook 2007

Outlook em Qualquer LugarOutlook Anywhere

Outlook em Qualquer LugarOutlook Anywhere

  • RPCRPC

  • Outlook em Qualquer LugarOutlook Anywhere

  • RPCRPC

  • 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. Atualize clientes do Outlook para o Outlook 2013 SP1 ou SP2 do Outlook 2010 e atualizações KB2956191 e 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 os servidores de acesso para cliente e caixa de correio para a atualização cumulativa Exchange 2013 (CU) mais recente. Para obter informações sobre como atualizar, consulte atualizar o Exchange 2013 para a atualização cumulativa mais recente ou o service pack.Upgrade Client Access and Mailbox servers to the latest Exchange 2013 cumulative update (CU). For information about how to upgrade, see Upgrade Exchange 2013 to the latest cumulative update or service pack.

    Observação

    Acesso para cliente todos os servidores devem ser atualizados para a CU de 2013 mais recente do Exchange ou a imediatamente anterior CU. caso contrário, o Outlook pode falhar para se conectar às caixas de correio.All Client Access servers must be upgraded to the latest Exchange 2013 CU, or the immediately previous CU. Otherwise, Outlook can fail to connect to mailboxes.
    Falha ao atualizar todos os servidores caixa de correio em um grupo de disponibilidade do banco de dados (DAG) pode resultar em atrasos de email e um requisito de cliente para reiniciar o Outlook em 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 o Microsoft .NET Framework versão com suporte a CU em execução no seu servidor do Exchange. Para obter mais informações, consulte Exchange Server Supportability Matrix e a instalação do .NET Framework.On all Exchange 2013 servers, install the Microsoft .NET Framework version supported by the CU running on your Exchange server. 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 do diretório virtual Por padrão, o Exchange 2013 SP1 cria um diretório virtual para MAPI sobre HTTP. Você pode usar o cmdlet Set-MapiVirtualDirectory para configurar o diretório virtual. Você deve configurar uma URL interna, uma URL externa ou ambos. Para mais informações, consulte Set-MapiVirtualDirectory.Virtual directory configuration By default, Exchange 2013 SP1 creates a virtual directory for MAPI over HTTP. You use the Set-MapiVirtualDirectory cmdlet to configure the virtual directory. You must configure an internal URL, an external URL, or both. For more information see, Set-MapiVirtualDirectory.

    Por exemplo, para configurar o diretório virtual do MAPI padrão no servidor Exchange local, definindo a URL interna valor para https://contoso.com/mapie o método de autenticação para 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 o mesmo InternalURL e os valores de ExternalURL que são definidos no diretório virtual MAPI. Para obter mais informações sobre o gerenciamento de certificados do Exchange 2013, consulte Digital certificates and SSL. Verifique se o certificado do Exchange é confiável na estação de trabalho cliente Outlook e que não há nenhum erro de certificado, especialmente quando você acessar as URLs configuradas 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. For more information on Exchange 2013 certificate management, see Digital certificates and SSL. 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 do servidor Verificar se seus balanceadores de carga, proxies reversos e firewalls estão configurados para permitir o acesso à MAPI sobre o diretório virtual 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:

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

  • % Caminhoinstalaçãoexchange % Logging\acesso para cliente MAPI\%ExchangeInstallPath%Logging\MAPI Client Access\

  • % Caminhoinstalaçãoexchange % 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: