Ir para o conteúdo

Guia de Conexão do Microsoft Exchange

Visão Geral

Este guia descreve os requisitos do sistema e as instruções para conectar App Builder TM para Microsoft Exchange como um Data Server. Esta conexão faz uso do fluxo Client Credentials OAuth.

Credenciais do cliente referem-se a um fluxo no OAuth onde não há autenticação direta do usuário ocorrendo. Em vez disso, credenciais são criadas apenas para o aplicativo em si. Todas as tarefas realizadas pelo aplicativo são feitas sem um contexto de usuário padrão. Isso torna o fluxo de autenticação um pouco diferente do padrão. Todas as permissões relacionadas ao fluxo do cliente Oauth exigem o consentimento do administrador.

Requisitos do Sistema

  • Microsoft Exchange

  • Portal do Azure

Navegador da Web do Cliente

  • Chrome: 84+

  • Firefox: 73+

  • Safari: 13.0.1+

  • Borda: 84+

Limitações e Recursos Suportados

Pode haver limitações em torno dos IDs de chave primária do Microsoft Exchange com o banco de dados do SQL Server. A chave primária é uma longa sequência alfanumérica e percorrerá az, 0-1, AZ incrementalmente para novos emails. O problema com isso é que o SQL Server é, por padrão, insensível a maiúsculas e minúsculas, então dois emails com PKs "1234a" e "1234A" são os mesmos para App Builder. Uma solução alternativa é aproveitar a coluna changeKey, que em combinação com id sempre será única.

Instruções de Conexão

Pré-requisitos para Configurar no Portal do Azure

Antes de configurar a conexão do Microsoft Exchange Data Server em App Builder, você precisará primeiro configurar as seguintes informações no seu portal do Azure.

  • Crie um aplicativo OAuth personalizado no Portal do Azure : https://cdn.cdata.com/help/CEH/ado/pg_oauthcustomappcreate.htm

  • No registro do aplicativo, selecione Tokens de acesso (usados para fluxos implícitos) na seção Autenticação.

    anexo

  • Navegue até Certificados e segredos e crie um valor de segredo do cliente

    Nota

    Certifique-se de copiar o valor secreto do cliente e armazená-lo onde você possa acessá-lo* ao configurar o App Builder passos.

    anexo

  • Navegue até Permissões de API e selecione Permissões do Microsoft Graph. Há dois conjuntos distintos de permissões - Permissões delegadas e Aplicativo. As permissões usadas durante a autenticação de credenciais do cliente estão em Permissões do aplicativo. Selecione as permissões aplicáveis que você precisa para sua integração.

  • Configure as seguintes permissões de API, bem como conceda consentimento do administrador para essas permissões.

    anexo

Configurar em App Builder

Crie um Provedor de Segurança OAuth

  1. Navegue até App Builder IDE

  2. Clique no botão Provedores de segurança

  3. Clique no botão + Autenticação do usuário

  4. Atribua o Nome como algo identificável. Por exemplo: Microsoft Exchange Connector

  5. Defina o tipo como OAuth

  6. Defina o tipo de autenticação como OAuth

  7. Defina a Concessão OAuth como Credenciais do Cliente

  8. Defina a autenticação do cliente OAuth como Básica

  9. Defina a autenticação de recurso OAuth como Bearer

  10. Defina o proprietário do token como Cliente

  11. Clique no botão + Endpoint e crie um registro:

    • Tipo = Endpoint do token

    • URL = https://login.microsoftonline.com/{{ TenantID }}/oauth2/v2.0/token

    Nota

    Substitua o TenantID na sequência de URL fornecida adequadamente

    anexo

  12. Clique no botão + Credenciais e crie um registro usando o valor do ID do aplicativo (cliente) criado no Azure. Essas informações são armazenadas na página Visão geral do aplicativo do Azure:

    1. Defina o Tipo como Cliente

    2. Forneça o Nome de usuário. Este é o valor do ID do aplicativo (cliente) encontrado na página Visão geral do aplicativo do Azure.

    3. Forneça a Senha. Este é o valor do Segredo do Cliente criado anteriormente.

    4. Clique no botão Salvar

    anexo

  13. Clique no botão + Propriedade e crie um registro de Escopos:

    • Defina o Parâmetro como Escopos

    • Defina o Valor como o valor de permissões padrão para o Microsoft Graph

    anexo

  14. Marque o campo Enabled em Provider Settings para habilitar isso como um provedor de segurança

Crie o Microsoft Exchange Data Server

  1. Navegue até App Builder IDE

  2. Clique no botão Servidores de dados

  3. Clique no botão + Servidor

  4. Atribua um Nome do Servidor. Por exemplo: Driver do Exchange

  5. Defina o Tipo como Microsoft Exchange

    anexo

  6. Clique para expandir as Configurações de segurança

  7. Defina o Security Provider para o Security Provider que criamos. Por exemplo: Microsoft Exchange Connector

  8. Clique no botão Salvar

  9. Clique para expandir as Configurações do servidor

  10. Clique no botão Configurações avançadas

  11. No campo Avançado, você precisa especificar um Usuário do Tenant para o qual você deseja acessar os recursos do Outlook. O formato deve ser: UserID={{ UserEmail }}

    • Se você tiver vários Tenants configurados, aqui você precisará especificar qual tenant também. Se não for especificado, seu Tenant padrão será usado.

    attachment

Nesta seção, vincularemos a fonte do Exchange Data Server que criamos ao nosso App Builder aplicativo.

  1. Do seu App Builder aplicativo, navegue até o App Workbench

  2. Clique no ficha Fontes de dados

  3. Clique no botão + Fonte

  4. Selecione Link para fonte existente

  5. Clique em Avançar

  6. Localize o Driver de troca

  7. Verifique o campo Selecionado

  8. Clique no botão Link 1 Source

  9. Clique em Concluído

  10. Clique no ficha Tabelas

  11. Selecione Exchange Driver como o valor App Data Sources

  12. Confirme que agora você pode visualizar todas as tabelas associadas à fonte de dados do driver do Exchange para o usuário especificado

    anexo