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

Use o conector de SharePoint ação da Microsoft para gerenciar listas, itens, arquivos 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.

• Uma conta Microsoft 365 com SharePoint acesso.

• Acesso ao centro de administração do Microsoft Entra com pelo menos permissões de desenvolvedor de aplicativos.

• Para obter os requisitos de assinatura, consulteConfigurar integrações no console.

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

O Microsoft Graph oferece suporte a dois tipos de permissão para essa integração. As permissões delegadas permitem que o aplicativo atue em nome de um usuário conectado. As permissões do aplicativo permitem que o aplicativo atue sem 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 escolha Microsoft Graph.

3. Escolha Permissões delegadas ou Permissões de aplicativos com base no seu método de autenticação e adicione as permissões da tabela apropriada abaixo.

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

Para autenticação do usuário (permissões delegadas):

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.

SharePoint 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.
Sites.ReadWrite.All	Permite que o aplicativo edite ou exclua documentos e itens de lista em todos os conjuntos de sites 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.

Para autenticação de serviços (permissões do aplicativo):

Adicione o seguinte como permissões do aplicativo no registro do aplicativo Entra.

SharePoint integração de ações — permissões do aplicativo

Permissão	Description
Sites.ReadWrite.All	Permite que o aplicativo crie, leia, atualize e exclua documentos e itens de lista em todos os conjuntos de sites sem um usuário conectado.

Importante

Com a autenticação de serviço, todas as ações são executadas como a conta de serviço. Qualquer usuário com acesso a essa integração pode realizar ações em todos os conjuntos de sites que a conta de serviço pode acessar. Defina o escopo das permissões do aplicativo de acordo com os requisitos de segurança da sua organização.

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 SharePoint e escolha o botão Adicionar (mais “+”).

3. Escolha a guia Ações.

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

5. Preencha os detalhes da integração:

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

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

6. Escolha seu tipo de conexão e preencha as configurações de conexão:

   1. Para autenticação do usuário (OAuth), configure os seguintes campos:

      • 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

   2. Para autenticação de serviço, configure os seguintes campos:

      • 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

      • Escopo: .default

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 SharePoint disponíveis da Microsoft

Categoria	Ação	Description
Listas e itens	Exibir itens	Obtenha a coleção de itens em uma lista.
Listas e itens	Obter item	Retorna os metadados de um item em uma lista.
Listas e itens	Obter lista	Retorna os metadados de uma lista.
Listas e itens	Atualizar item	Atualize as propriedades em um item da lista.
Listas e itens	Excluir item	Remove um item de uma lista.
Arquivos	Carregar arquivo	Carregue um novo arquivo ou atualize um arquivo existente. Suporta arquivos de até 250 MB.
Arquivos	Pesquisar itens do Site Drive	Pesquise a hierarquia dos itens que correspondem a uma consulta.
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.