Skip to main content

OAuth 2.0 para Microsoft Dataverse

Configure o Alteryx One Platform para integrar com sua implantação do Microsoft Dataverse usando o OAuth 2.0 para autenticação.

Pré-requisitos

  • O OAuth 2.0 é compatível com o Microsoft Dataverse, que está disponível no Microsoft Azure.

  • A autenticação OAuth 2.0 deve estar habilitada no Alteryx One. Para obter mais informações, consulte Habilitar autenticação OAuth 2.0.

    Dica

    O OAuth 2.0 para Microsoft Dataverse pode funcionar em outros provedores de identidade baseados em locatário. Você pode usar essa solução como um modelo para criar os objetos necessários no console do provedor de identidade e no Alteryx One.

Criar o aplicativo de cliente OAuth 2.0 no Azure

No console do Azure, é necessário criar o aplicativo de cliente.

Etapas:

  1. Faça login no Azure: https://portal.azure.com/#home

  2. Clique em Azure Active Directory > Registros de aplicativos > Novo registro.

  3. Especifique os seguintes campos:

    Campo

    Descrição

    Nome

    O nome do aplicativo.

    Os tipos de conta compatíveis

    Selecione uma das opções:

    • Locatário único

    • Multilocatário

    URI de redirecionamento

    Especifique o URL no seguinte formato, dependendo do seu projeto ou login do espaço de trabalho:

    https://<Login_URL>/oauth2/callback

    Exemplo:

    https://ayxpreview.alteryxcloud.com/oauth2/callback

  4. Para criar o novo registro, clique em Registrar.

  5. Guia Visão geral:

    Nota

    Copie o valor do ID do aplicativo (cliente). Esse valor deve ser aplicado no Alteryx One.

  6. Guia Certificados e segredos: para criar um novo segredo do cliente:

    1. Selecione Novo segredo do cliente.

    2. Defina a opção "Expirar" como Nunca.

    3. Clique em Adicionar.

      Nota

      Copie o campo "Valor". Este valor é o segredo do cliente e deve ser aplicado no Alteryx One.

  7. Guia "Permissões de API":

    1. Clique em Adicionar uma permissão.

    2. Conceda estas permissões.

      API

      Nome das permissões

      Tipo

      Solicitação de consentimento do administrador

      Dynamics CRM

      user_impersonation

      Delegada

      Não

      Microsoft Graph

      Leitura do usuário

      Delegada

      Não

  8. Salve suas alterações.

Criar cliente OAuth 2.0 para o Microsoft Dataverse

Depois que o aplicativo de cliente do Microsoft Dataverse for criado, será necessário criar um cliente OAuth 2.0 no Alteryx One, que é usado para integrar com o aplicativo de cliente OAuth 2.0 criado no Azure.

Etapas:

  1. Faça login no Alteryx One como administrador do espaço de trabalho.

  2. No menu à esquerda, clique em Menu do usuário > Console de administração > Clientes OAuth 2.0.

  3. Na página "Clientes OAuth 2.0", clique em Registrar cliente OAuth 2.0.0.

  4. Especifique os campos para o novo cliente:

    Campo

    Descrição

    Tipo

    Microsoft Dataverse

    Nome

    Insira um nome para o cliente.

    ID do cliente

    Cole o valor do ID do aplicativo (cliente) que foi gerado ao criar o aplicativo de cliente no Azure.

    Segredo do cliente

    Cole o valor do segredo do cliente que foi gerado ao criar o aplicativo de cliente no Azure.

    URL da autorização

    Locatário único:

    https://login.microsoftonline.com/<tenant_identifier>/oauth2/v2.0/authorize

    Multilocatário:

    https://login.microsoftonline.com/common/oauth2/v2.0/authorize

    URL do token

    Locatário único:

    https://login.microsoftonline.com/<tenant_identifier>/oauth2/v2.0/token

    Multilocatário:

    https://login.microsoftonline.com/common/oauth2/v2.0/authorize

    Escopos

    Defina os escopos como os seguintes valores:

    Nota

    Os escopos individuais devem ser separados por um espaço.

    https://xxxxxx.crm.dynamics.com/user_impersonation offline_access

    O token de acesso expira em

    Defina esse valor como o seguinte: 3599999.

    O token de atualização expira em

    Defina esse valor como o seguinte: 7775999999.

  5. Para salvar o cliente OAuth 2.0, clique em Salvar.

Para obter mais informações, consulte Criar cliente OAuth2.

Criar conexão do Microsoft Dataverse

Depois de criar as duas referências de cliente OAuth 2.0, você pode criar uma conexão com seus dados do Microsoft Dataverse.

Nota

É necessário criar uma conexão separada para cada cliente OAuth 2.0 que está disponível no Alteryx One.

Para obter mais informações, consulte Conexões do Microsoft Dataverse.