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.
O Amazon Quick oferece suporte a vários métodos de autenticação para a Microsoft OneDrive. Escolha o método que melhor se adapta aos requisitos de segurança da sua organização.
-
Aplicativo OAuth padrão — usa um aplicativo OAuth AWS gerenciado. Nenhuma credencial adicional é necessária. Os usuários se autenticam diretamente com sua conta da Microsoft.
-
Aplicativo OAuth personalizado — usa um aplicativo gerenciado pelo cliente registrado no Microsoft Entra. Essa opção dá à sua organização controle total sobre a configuração do OAuth. Os usuários se autenticam em nome de um usuário conectado (permissões delegadas).
-
Service-to-Service OAuth — usa credenciais do cliente para autenticação de servidor a servidor sem interação do usuário (permissões do aplicativo). Adequado para fluxos de trabalho automatizados.
Para obter mais 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.
-
Uma conta Microsoft 365 com OneDrive acesso.
-
Para aplicativo OAuth personalizado ou Service-to-Service OAuth: acesso ao centro de administração do Microsoft Entra no
site da Microsoft com pelo menos permissões de desenvolvedor de aplicativos. -
Para obter os requisitos de assinatura, consulteConfigurar integrações no console.
Configurar o Microsoft Entra
Se você estiver usando a autenticação padrão do aplicativo OAuth, pule esta seção e prossiga para. Configurando o conector no Amazon Quick
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
Registre o aplicativo
-
No painel de navegação à esquerda, escolha Inserir ID e, em seguida, escolha Registros de aplicativos.
-
Escolha Novo registro.
-
Em Nome, insira um nome descritivo para sua integração.
-
Para Tipos de conta compatíveis, escolha Contas somente neste diretório organizacional.
-
Em URI de redirecionamento, selecione Web e insira
https://.{region}.quicksight.aws.amazon.com/sn/oauthcallback{region}Substitua pela AWS região em que sua instância Amazon Quick está implantada. -
Escolha Registrar.
-
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.
-
No registro do seu aplicativo, escolha Certificados e segredos.
-
Escolha Novo segredo do cliente.
-
Insira uma descrição e escolha um período de expiração.
-
Escolha Adicionar.
-
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
-
No registro do seu aplicativo, escolha as permissões da API.
-
Escolha Adicionar uma permissão e, em seguida, escolha Microsoft Graph.
-
Escolha Permissões delegadas e adicione as permissões da tabela abaixo.
-
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
| 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.
| 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 |
Configurando o conector no Amazon Quick
Conecte-se a partir da guia Disponível
Se quiser usar a autenticação padrão do aplicativo OAuth, você pode se conectar diretamente da guia Disponível sem configuração adicional.
-
No console do Amazon Quick, escolha Conectores.
-
Na guia Disponível, OneDrivelocalize e escolha Connect.
-
Conclua o fluxo de login da Microsoft e conceda as permissões solicitadas.
Para configurar um conector com o aplicativo OAuth personalizado ou Service-to-Service OAuth em vez disso, use a guia Criar para sua equipe, conforme descrito abaixo.
Crie a partir da guia Criar para sua equipe
Depois de concluir qualquer configuração necessária do Entra, crie o conector no Amazon Quick.
-
No console do Amazon Quick, escolha Conectores.
-
Escolha a guia Criar para sua equipe.
-
Encontre e escolha Microsoft OneDrive.
nota
Se já existir um OneDrive conector Microsoft, uma caixa de diálogo será exibida com seus conectores existentes. Para usar um conector existente, escolha-o. Para criar um novo, escolha Não, criar novo.
-
Na página Tipo de integração, selecione Executar ações na Microsoft OneDrive e escolha Avançar.
-
Insira um nome para seu conector. Opcionalmente, escolha + Adicionar descrição para adicionar uma descrição.
-
Em Tipo de conexão, escolha Rede pública.
-
Para Configuração do OAuth, escolha um dos métodos de autenticação a seguir e configure os campos obrigatórios.
-
Para o aplicativo OAuth padrão:
Nenhuma credencial adicional é necessária. Escolha Próximo para continuar.
-
Para o aplicativo OAuth personalizado (autenticação do usuário com permissões delegadas), configure os seguintes campos:
-
URL base (opcional) — A URL base da API do Microsoft Graph. Exemplo:
https://graph.microsoft.com/v1.0 -
ID do cliente — O ID do aplicativo (cliente) do seu registro no aplicativo Entra.
-
Segredo do cliente — O valor secreto do cliente do registro do seu aplicativo Entra.
-
URL do token — O endpoint do token. Exemplo:
https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token -
URL de autorização — O endpoint de autorização. Exemplo:
https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorize -
URL de redirecionamento — Pre-filled com o URL de retorno de chamada do Amazon Quick.
-
-
Para Service-to-ServiceOAuth (autenticação de serviço com permissões do aplicativo), configure os seguintes campos:
-
URL base (opcional) — A URL base da API do Microsoft Graph. Exemplo:
https://graph.microsoft.com/v1.0 -
ID do cliente — O ID do aplicativo (cliente) do seu registro no aplicativo Entra.
-
Segredo do cliente — O valor secreto do cliente do registro do seu aplicativo Entra.
-
URL do token — O endpoint do token. Exemplo:
https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token
nota
O escopo da solicitação de token de credenciais do cliente (
https://graph.microsoft.com/.default) é definido automaticamente pelo Amazon Quick. Você não precisa configurá-lo manualmente. -
-
-
Escolha Próximo.
-
Se você escolher Aplicativo OAuth padrão ou Aplicativo OAuth personalizado, uma janela de autorização da Microsoft será aberta. Revise as permissões solicitadas e escolha Aceitar.
Se você ver um erro em vez da caixa de diálogo de consentimento, sua organização pode restringir o acesso a aplicativos de terceiros. Consulte Consentimento do administrador para o Microsoft 365.
-
Na página Revisar, revise as ações disponíveis para o conector. Escolha Próximo.
-
Na página Publicar, escolha quem pode acessar o conector. Você pode habilitar o acesso para todos em sua organização ou pesquisar equipes ou grupos específicos.
-
Selecione Publish.
Ações disponíveis
Depois de configurar a integração, as ações a seguir estarão disponíveis.
| 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.
Consentimento do administrador para o Microsoft 365
Quando você usa o método de autenticação padrão do aplicativo OAuth, o Amazon Quick usa um aplicativo AWS gerenciado para acessar a Microsoft OneDrive em nome do usuário conectado. A maioria dos usuários pode concluir a configuração sem nenhuma etapa extra. No entanto, se seu inquilino do Microsoft 365 restringir o acesso a aplicativos de terceiros, um administrador do Microsoft 365 deverá conceder um consentimento único antes que os usuários possam se conectar.
Se você ver um erro ao entrar durante a configuração do conector, sua organização poderá restringir o acesso a aplicativos de terceiros. Compartilhe as seguintes informações com seu administrador do Microsoft 365:
-
O que fazer: conceda o consentimento do administrador para o aplicativo de OneDrive integração Amazon Quick Microsoft.
-
Por quê: O Amazon Quick precisa de acesso delegado a OneDrive arquivos, pastas e pastas de trabalho do Excel para realizar ações em nome dos usuários.
Um administrador pode conceder consentimento de uma das seguintes formas:
-
Por meio da caixa de diálogo de consentimento — um administrador global ou administrador de função privilegiada inicia o fluxo de configuração do conector. Na caixa de diálogo de login da Microsoft, eles marcam a caixa de seleção Consentimento em nome da sua organização e escolhem Aceitar.
-
Por meio do centro de administração do Microsoft Entra — Entre no centro de administração do Microsoft Entra
no site da Microsoft. Escolha Aplicativos corporativos, localize o aplicativo Amazon Quick, escolha Permissões e escolha Conceder consentimento do administrador para Your Organization.
Depois que o consentimento for concedido, qualquer usuário da sua organização poderá se conectar sem ser solicitado o consentimento individual.
nota
Para verificar se seu inquilino restringe o consentimento do usuário, acesse o centro de administração do Microsoft Entra e escolha Aplicativos corporativos, Consentimento e permissões, Configurações de consentimento do usuário. Se a configuração for Não permitir o consentimento do usuário, um administrador deverá conceder o consentimento antes que os usuários possam usar o conector.
