View a markdown version of this page

OneDrive Integração de ações da Microsoft - Amazon Quick
Antes de começarConfigurar o Microsoft EntraConfigure a integração no Amazon QuickAções disponíveisGerenciar e solucionar problemas

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

OneDrive Integração de ações da Microsoft

Use o conector de OneDrive ação da Microsoft para gerenciar OneDrive arquivos, pastas e pastas de trabalho do Excel diretamente no Amazon Quick por meio de linguagem natural.

A configuração dessa integração envolve duas etapas. Primeiro, você registra um aplicativo no Microsoft Entra e configura suas permissões. Em seguida, você cria a integração no Amazon Quick e a conecta ao seu aplicativo Entra. Para obter informações sobre os métodos de autenticação compatíveis com o Amazon Quick, consulteMétodos de autenticação.

Antes de começar

Certifique-se de ter o seguinte antes de configurar a integração.

Configurar o Microsoft Entra

Antes de configurar o Amazon Quick, crie um registro de aplicativo no Microsoft Entra. Conclua todas as etapas a seguir no Entra antes de migrar para o console do Amazon Quick.

Para obter mais informações sobre registros de aplicativos, consulte Registrar um aplicativo na plataforma de identidade da Microsoft na documentação da Microsoft.

Registre o aplicativo

  1. Abra o centro de administração do Microsoft Entra.

  2. No painel de navegação à esquerda, escolha Inserir ID e, em seguida, escolha Registros de aplicativos.

  3. Escolha Novo registro.

  4. Em Nome, insira um nome descritivo para sua integração.

  5. Para Tipos de conta compatíveis, escolha Contas somente neste diretório organizacional.

  6. Em URI de redirecionamento, selecione Web e insirahttps://{region}.quicksight.aws.amazon.com/sn/oauthcallback. {region}Substitua pela AWS região em que sua instância Amazon Quick está implantada.

  7. Escolha Registrar.

  8. Na página de visão geral, copie o ID do aplicativo (cliente) e o ID do diretório (locatário). Você precisa desses valores para a configuração do Amazon Quick.

Crie um segredo de cliente

O Amazon Quick precisa de um segredo de cliente para se autenticar com o Microsoft Entra. Esse segredo funciona como uma senha para o registro do aplicativo.

  1. No registro do seu aplicativo, escolha Certificados e segredos.

  2. Escolha Novo segredo do cliente.

  3. Insira uma descrição e escolha um período de expiração.

  4. Escolha Adicionar.

  5. Copie o valor imediatamente. Esse valor só é exibido uma vez.

Importante

Copie o valor secreto, não o ID secreto. O valor é a string mais longa usada para autenticação.

Configurar permissões de API

Essa integração usa permissões delegadas, que permitem que o aplicativo atue em nome de um usuário conectado. Para obter mais informações, consulte Visão geral das permissões do Microsoft Graph na documentação da Microsoft.

  1. No registro do seu aplicativo, escolha as permissões da API.

  2. Escolha Adicionar uma permissão e, em seguida, escolha Microsoft Graph.

  3. Escolha Permissões delegadas e adicione as permissões da tabela abaixo.

  4. Escolha Conceder consentimento do administrador para [nome do seu inquilino] para aprovar as permissões.

Adicione o seguinte como permissões delegadas no registro do aplicativo Entra. Para obter a referência completa de permissões, consulte a referência de permissões do Microsoft Graph na documentação da Microsoft.

OneDrive integração de ações — permissões delegadas
Permissão Description
Files.ReadWrite Permite que o aplicativo leia, crie, atualize e exclua os arquivos do usuário conectado.
User.Read.All Permite que o aplicativo leia o conjunto completo de propriedades do perfil de todos os usuários na organização em nome do usuário conectado.
offline_access Permite que o aplicativo atualize os tokens de acesso sem exigir que o usuário faça login novamente. Isso reduz a frequência com que os usuários precisam se autenticar novamente.

Registre suas credenciais

Antes de sair do centro de administração do Microsoft Entra, confirme se você tem os seguintes valores. Você precisa deles para a configuração do Amazon Quick.

Credenciais exigidas da Microsoft Entra
Valor Onde encontrá-lo
ID da aplicação (cliente) Página de visão geral do registro do aplicativo
ID do diretório (locatário) Página de visão geral do registro do aplicativo
Valor do segredo do cliente Página de certificados e segredos

Configure a integração no Amazon Quick

Depois de concluir a configuração do Entra, crie a integração no Amazon Quick.

  1. No console do Amazon Quick, escolha Integrações.

  2. Escolha Microsoft OneDrive e escolha o botão Adicionar (mais “+”).

  3. Escolha a guia Ações.

  4. Escolha Executar ações na Microsoft OneDrive.

  5. Preencha os detalhes da integração:

    • Nome — Nome descritivo da sua OneDrive integração.

    • Descrição (opcional) — Objetivo da integração.

  6. Preencha as configurações de conexão:

    • URL base — https://graph.microsoft.com/v1.0

    • ID do cliente — ID do aplicativo (cliente) do registro do aplicativo Entra.

    • Segredo do cliente — Valor secreto do cliente do registro do seu aplicativo Entra.

    • URL do token — https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token

    • URL de autenticação — https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorize

    • URL de redirecionamento — https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

  7. Escolha Criar e continuar.

  8. Escolha usuários com os quais compartilhar a integração.

  9. Escolha Próximo.

Ações disponíveis

Depois de configurar a integração, as ações a seguir estarão disponíveis.

Ações OneDrive disponíveis da Microsoft
Categoria Ação Description
Drive e itens Obtenha o Drive Recupere as propriedades e os relacionamentos de uma unidade.
Drive e itens Item da lista Obtenha todos os itens contidos na unidade.
Drive e itens Obter item Obtenha um item contido na unidade.
Drive e itens Criar pasta Crie uma nova pasta no drive do usuário.
Drive e itens Atualizar item Atualize os metadados de um arquivo ou pasta.
Drive e itens Excluir item Exclua um arquivo ou uma pasta. Move o item para a lixeira.
Drive e itens Listar pastas secundárias Retorne uma coleção de itens nos filhos de uma pasta.
Drive e itens Copiar item Crie uma cópia de um arquivo ou pasta em outro local.
Drive e itens Adicionar permissões Envie um convite de compartilhamento para um arquivo ou pasta.
Drive e itens Carregar arquivo Carregue um novo arquivo ou atualize um arquivo existente. Suporta arquivos de até 250 MB.
Pastas de trabalho do Excel Listar planilhas Recupere uma lista de objetos da planilha.
Pastas de trabalho do Excel Adicionar planilha Adicione uma nova planilha à pasta de trabalho.
Pastas de trabalho do Excel Leia a planilha Recupere as propriedades de um objeto de planilha.
Pastas de trabalho do Excel Folha de atualização Atualize as propriedades de um objeto de planilha.
Pastas de trabalho do Excel Excluir planilha Exclua a planilha da pasta de trabalho.
Pastas de trabalho do Excel Célula de leitura Obtenha o valor de uma única célula por número de linha e coluna.
Pastas de trabalho do Excel Célula de gravação Defina o valor de uma única célula por número de linha e coluna.
Pastas de trabalho do Excel Alcance de leitura Obtenha os valores de um intervalo.
Pastas de trabalho do Excel Intervalo de gravação Atualize os valores de um intervalo.
Pastas de trabalho do Excel Alcance claro Limpe valores de intervalo, formato, preenchimento e borda.
Pastas de trabalho do Excel Excluir intervalo Exclua as células associadas ao intervalo.
Pastas de trabalho do Excel Get Used Range Obtenha o menor intervalo que engloba células com um valor ou formatação.

Gerenciar e solucionar problemas

Para editar, compartilhar ou excluir sua integração, consulteGerenciando integrações existentes.

Problemas de autenticação

  • Registro de aplicativo incorreto — Verifique se o registro do aplicativo no Microsoft Entra inclui as permissões de API necessárias e se o consentimento do administrador foi concedido.

  • Segredo do cliente expirado — Verifique se o segredo do cliente expirou em Certificados e segredos e gere um novo, se necessário.

  • URI de redirecionamento incorreto — Verifique se o URI de redirecionamento no Microsoft Entra corresponde. https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

Mensagens de erro comuns

  • Access denied. You do not have permission to perform this action— O usuário autenticado não tem as permissões necessárias. Entre em contato com seu administrador para verificar e conceder as permissões apropriadas.

  • AADSTS50020: User account from identity provider does not exist in tenant— A conta do usuário não está configurada no inquilino correto do Microsoft Entra. Verifique se a conta de usuário existe no inquilino que corresponde à ID do diretório (inquilino) no registro do seu aplicativo.