Skip to main content

OAuth 2.0 para o OneDrive

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

Pré-requisitos

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

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

Criar o aplicativo de cliente OAuth 2.0 no Azure

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

  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://us1.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 Marca: (opcional) especifique os seguintes campos:

    Campo

    Descrição

    Nome

    O nome do aplicativo deve corresponder ao valor especificado anteriormente.

    Logotipo

    Carregue um logotipo de sua preferência para o aplicativo.

    URL da página inicial

    Defina esse valor como o seguinte:

    https://trifacta.com

    URL dos Termos de serviço

    Defina esse valor como o seguinte:

    https://www.trifacta.com/terms-conditions/

    Política de privacidade

    Defina esse valor como o seguinte:

    https://www.trifacta.com/privacy-policy/

    Domínio do publicador

    Defina esse valor como o seguinte:

    trifacta.com

    ID MPN

    Se você for um parceiro da Microsoft, poderá especificar seu ID MPN (Microsoft Partner Network).

  7. 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.

  8. Guia "Permissões de API":

    1. Clique em Adicionar uma permissão.

    2. Clique em Microsoft Graph.

    3. Clique em Permissões delegadas.

    4. Use a barra de pesquisa para pesquisar por Arquivos e, em seguida, selecione as permissões apropriadas. As permissões recomendadas são:

      1. Files.Read.All: garante que todos os usuários possam ingerir todos os arquivos aos quais têm acesso.

      2. Files.readWrite.all: permite que os usuários gravem em pastas e arquivos aos quais têm acesso. Isso inclui pastas que eles próprios possuam, bem como pastas compartilhadas com eles.

      Nota

      Essas recomendações servem apenas para garantir aos seus usuários a melhor experiência no Alteryx One. Use as políticas de acesso da sua organização para orientar sua seleção de permissão.

      Como alternativa, você pode criar aplicativos OAuth separados para acesso somente leitura e de leitura/gravação:

      • Acesso somente leitura (use Files.Read.All)

      • Acesso de leitura/gravação (use Files.ReadWrite.All)

      Você pode então criar duas conexões separadas para o OneDrive no Alteryx One. Depois, conceda acesso às conexões apropriadas para os respectivos usuários.

  9. Salve suas alterações.

Criar cliente OAuth 2.0 para o OneDrive

Depois que o aplicativo de cliente do OneDrive 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

    onedrive

    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/token

    Escopos

    Defina os escopos como os seguintes valores:

    • https://graph.microsoft.com/.default

    • offline_access

    Importante

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

    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, acesse Criar cliente OAuth2.

Criar conexão com o OneDrive

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

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, acesse Conexões do Microsoft OneDrive.

Solucionar problemas de acesso

Nas etapas acima, você criou um aplicativo OAuth no portal do Azure. No entanto, a menos que usuários individuais ou grupos de usuários tenham direito a acessar e usar este aplicativo, eles podem não conseguir usá-lo com conexões criadas no Alteryx One. Siga estas etapas para adicionar usuários ao aplicativo:

  1. No portal do Azure, acesse Aplicativo corporativo.

  2. Procure o aplicativo OAuth que você criou.

  3. No aplicativo OAuth, siga as opções a OU b:

    1. Selecione Usuários e grupos no painel de navegação esquerdo e adicione os usuários e grupos de usuários apropriados.

    2. No painel de navegação esquerdo, clique em Propriedades e defina Atribuição obrigatória? como Não. Isso dá acesso aos usuários sem precisar de atribuição explícita ao aplicativo.

Nesta secção: