Compartilhar via


Autenticação Moderna Híbrida (HMA) para o Exchange local

O Dynamics 365 pode se conectar a caixas de correio hospedadas no Exchange Server (local) usando a autenticação moderna híbrida (HMA). A sincronização no servidor autenticará em relação ao Microsoft Entra usando um certificado fornecido por você e armazenado com segurança no Azure Key Vault. Você precisará estabelecer um registro de aplicativo protegido por um segredo do cliente para permitir que o Dynamics 365 acesse o certificado no Key Vault. Quando o Dynamics 365 puder recuperar o certificado, este será usado para autenticação como um aplicativo específico e acesso ao recurso do Exchange (local).

Versões do Exchange com suporte

A HMA estará disponível apenas a partir do Exchange 2013 (CU19+) ou do Exchange 2016 (CU8+). Mais informações: Anunciando a Autenticação Moderna Híbrida para o Exchange local (blog)

Pré-requisitos

Para implantar a HMA com o Dynamics 365, você precisará atender aos seguintes requisitos:

Configuração

Siga as etapas abaixo para configurar a HMA para o Exchange (local).

Disponibilizar um certificado no Key Vault

  1. No portal do Azure, abra o Key Vault e vá para a seção Certificados.

  2. Selecione Gerar/Importar.

    Captura de tela mostrando a opção Gerar/Importar selecionada.

  3. Neste momento, um certificado pode ser gerado ou importado. Especifique um nome de certificado e, em seguida, selecione Criar.

O nome de certificado será usado posteriormente para fazer referência ao certificado. Neste exemplo, o certificado é denominado HMA-Cert.

Criar um novo registro de aplicativo para acesso ao Key Vault

Crie um novo registro de aplicativo no portal do Azure no locatário onde reside o Key Vault. Para este exemplo, o aplicativo será denominado KV-App durante o processo de configuração. Mais informações: Início Rápido: Registrar um aplicativo na plataforma de identidade da Microsoft

Adicionar um segredo do cliente para o KV-App

O segredo do cliente será usado pelo Dynamics 365 para autenticar o aplicativo e recuperar o certificado. Mais informações: Adicionar um segredo do cliente

Adicionar o KV-App às políticas de acesso do Key Vault

  1. No portal do Azure, abra o Key Vault e vá para a seção Políticas de acesso.

  2. Selecione Adicionar Política de Acesso.

    Captura de tela do Azure Key Vault com a opção Adicionar política de acesso selecionada.

  3. Para Selecionar entidade de segurança, selecione uma entidade de segurança. Para este exemplo, selecionaremos KV-App.

  4. Selecione permissões. Lembre-se de adicionar Obter permissão em Permissões do segredo e Permissões de certificado. Ambas são necessárias para que o KV-App possa acessar o certificado.

    Captura de tela de configuração de permissões para a política de acesso no Key Vault.

  5. Selecione Adicionar.

Criar um novo registro de aplicativo para acesso à HMA

Crie um novo registro de aplicativo no portal do Azure no locatário onde o Exchange é hibridado.

Neste exemplo, o aplicativo será denominado HMA-App durante esse processo de configuração e representará o aplicativo real que o Dynamics 365 usará para interagir com os recursos do Exchange (local). Mais informações: Início Rápido: Registrar um aplicativo na plataforma de identidade da Microsoft

Adicionar o certificado para o HMA-App

Ele será usado pelo Dynamics 365 para autenticar o HMA-App. A HMA só oferece suporte ao uso de certificado para autenticar um aplicativo; portanto, um certificado é necessário para este esquema de autenticação.

Adicione o HMA-Cert provisionado anteriormente no Key Vault. Mais informações: Adicionar um certificado

Adicionar permissão de API

Para permitir que o HMA-App tenha acesso ao Exchange (local), conceda a permissão de API do Office 365 Exchange Online.

  1. No portal do Azure, abra Registros de aplicativo e selecione HMA-App.

  2. Selecione Permissões de API>Adicionar uma permissão.

    Captura de tela de adição de permissões de API ao aplicativo.

  3. Selecione APIs que a minha organização usa.

  4. Insira Office 365 Exchange Online e selecione-o.

  5. Selecione Permissões de aplicativo.

  6. Marque a caixa de seleção full_access_as_app para permitir que o aplicativo tenha acesso completo a todas as caixas de correio e, em seguida, selecione Adicionar permissões.

    Captura de tela de atribuição de permissões de API de acesso completo ao aplicativo.

    Observação

    Se ter um aplicativo com acesso completo em todas as caixas de correio não estiver de acordo com seus requisitos comerciais, o administrador do Exchange (local) pode definir o escopo das caixas de correio que o aplicativo pode acessar configurando a função ApplicationImpersonation no Exchange. Mais informações: Configurar representação

  7. Selecione Conceder consentimento do administrador.

    Captura de tela de concessão de acesso de administrador à permissão de API para o aplicativo.

Perfil do servidor de email com tipo de autenticação Autenticação Moderna Híbrida (HMA) do Exchange

Antes de criar um perfil do servidor de email no Dynamics 365 usando a Autenticação Moderna Híbrida (HMA) do Exchange, você precisa coletar as seguintes informações no portal do Azure:

  • URL do EWS: o ponto de extremidade do EWS (Serviços Web do Exchange) onde o Exchange (local) está localizado, que deve ser acessível publicamente do Dynamics 365.

  • Recurso do Microsoft Entra: a ID do recurso do Azure ao qual o aplicativo HMA solicitará acesso. Geralmente é a parte do host da URL do ponto de extremidade do EWS.

  • TenantId: a ID do locatário onde o Exchange (local) está configurado com a autenticação de passagem do Microsoft Entra ID.

  • ID do aplicativo HMA: a ID do aplicativo HMA-App. Ela pode ser encontrada na página principal do registro de aplicativo do HMA-App.

  • URI do Key Vault: o URI do Key Vault usado para armazenamento de certificados.

  • KeyName do Key Vault: o nome de certificado usado no Key Vault.

  • ID do aplicativo Key Vault: a ID do aplicativo KV-App usado pelo Dynamics para recuperar o certificado do Key Vault.

  • Segredo do Cliente do Key Vault: o segredo do cliente do KV-App usado pelo Dynamics 365.

    Captura de tela do perfil do servidor de email da Autenticação Moderna Híbrida (HMA) do Exchange.