View a markdown version of this page

Configuração gerenciada pelo usuário - Amazon Quick

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

Configuração gerenciada pelo usuário

Com a configuração gerenciada pelo usuário, você faz login SharePoint diretamente e o Amazon Quick gerencia a autenticação. A maioria dos usuários pode concluir a configuração em alguns minutos.

Pré-requisitos

Antes de começar, você deve ter o seguinte:

  • Uma conta Microsoft 365 com acesso aos SharePoint sites que você deseja indexar.

  • Acesso ao Amazon Quick com permissões para criar bases de conhecimento.

  • Um navegador que permite pop-ups do domínio do console Amazon Quick.

Importante

A configuração gerenciada pelo usuário não oferece suporte ao controle de acesso (ACL) em nível de documento. Todo o conteúdo indexado pode ser acessado por qualquer usuário que tenha acesso à base de conhecimento no Amazon Quick. As permissões individuais de SharePoint entrada não são aplicadas. Analise cuidadosamente o conteúdo que você inclui ao criar uma base de conhecimento. Se você precisar de controle de acesso em nível de documento, use Configuração gerenciada pelo administrador (credenciais de serviço) em vez disso.

Crie a base de SharePoint conhecimento

Navegue até as integrações

  1. No Amazon Quick, escolha Integrações no painel de navegação esquerdo.

  2. Na página Integrações, escolha a guia Bases de conhecimento.

  3. Em Configurar nova base de conhecimento, localize Microsoft SharePoint Online e escolha o ícone +.

Faça login em SharePoint

O assistente Criar base de SharePoint conhecimento é aberto na etapa Método de autenticação. A configuração rápida é selecionada por padrão.

  1. Em Configuração rápida, escolha Entrar em SharePoint.

  2. Uma janela de login da Microsoft é aberta. Insira suas credenciais do Microsoft 365.

  3. Se uma caixa de diálogo de consentimento de permissões for exibida, revise as permissões 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.

  4. Após a autenticação bem-sucedida, escolha Avançar.

Escolha o conteúdo

  1. Insira um nome e uma descrição opcional para sua base de conhecimento.

  2. Na seção Conteúdo, escolha Adicionar conteúdo.

  3. Uma caixa de diálogo é aberta mostrando SharePoint sites e conteúdos acessíveis à sua conta. Selecione as páginas, listas, arquivos ou pastas que você deseja indexar.

  4. Escolha Adicionar para confirmar suas seleções. Você pode adicionar mais conteúdo ou remover itens antes de continuar.

  5. Escolha Criar.

dica

Se o site que você está procurando não aparecer na caixa de diálogo, escolha o link de pesquisa na parte superior da seção Conteúdo. Insira o URL completo do SharePoint site (por exemplo,https://contoso.sharepoint.com/sites/marketing) e escolha Procurar. Em seguida, a caixa de diálogo exibe as bibliotecas de documentos, listas, páginas, pastas e arquivos desse site. A seleção de uma pasta inclui todos os arquivos e subpastas dentro dela.

Sincronização inicial

Depois de escolher Criar, você retornará à página da lista da base de conhecimento. A base de conhecimento pode levar alguns minutos para concluir o provisionamento. Quando a criação estiver concluída, uma sincronização inicial será acionada automaticamente.

A maioria dos usuários conclui a configuração sem nenhuma etapa extra. No entanto, se seu inquilino do Microsoft 365 restringir o acesso a aplicativos de terceiros, você poderá ver um erro ao entrar. Nesse caso, um administrador do Microsoft 365 precisa conceder um consentimento único para o aplicativo Amazon Quick. Depois que o consentimento for concedido, qualquer usuário da sua organização poderá se conectar.

Se você não for administrador do Microsoft 365, compartilhe as seguintes informações com seu administrador:

  • O que fazer: conceda o consentimento do administrador para o aplicativo de SharePoint integração Amazon Quick.

  • Por quê: O Amazon Quick precisa de acesso delegado de leitura a SharePoint sites e arquivos para indexar conteúdo para bases de conhecimento.

Alguns recursos do Amazon Quick exigem permissões delegadas do Microsoft Entra. Por padrão, cada usuário vê uma caixa de diálogo de consentimento da Microsoft na primeira vez que usa o recurso. Um administrador do Microsoft 365 pode pré-consentir em nome de toda a organização para que usuários individuais não sejam avisados. Essa é uma ação única por aplicativo.

nota

Se seu inquilino do Microsoft 365 estiver configurado para restringir o consentimento do usuário para aplicativos de terceiros, o consentimento do administrador é obrigatório, não opcional. Sem ele, os usuários veem um erro ao tentar usar o recurso.

A tabela a seguir descreve a experiência do usuário com e sem o consentimento do administrador.

Cenários de consentimento do administrador
Cenário Experiência do usuário
Consentimento do administrador não concedido Cada usuário vê a caixa de diálogo de consentimento de permissões da Microsoft no primeiro uso. Os usuários podem ser bloqueados se seu inquilino restringir o consentimento do usuário para aplicativos de terceiros.
Consentimento do administrador concedido O consentimento dos usuários não é solicitado. O recurso funciona imediatamente para todos os usuários da organização.

A maneira mais simples de conceder o consentimento do administrador é por meio da caixa de diálogo de consentimento da Microsoft que aparece durante o fluxo do recurso.

Para conceder consentimento por meio da caixa de diálogo de consentimento
  1. Faça com que um administrador global ou administrador de função privilegiada inicie o fluxo de recursos que aciona a caixa de diálogo de consentimento.

  2. Na caixa de diálogo de login da Microsoft, marque a caixa de seleção Consentimento em nome da sua organização.

  3. Escolha Accept (Aceitar).

Isso concede consentimento para as permissões delegadas solicitadas para todos os usuários em seu locatário do Microsoft 365.

Os administradores também podem conceder consentimento diretamente do centro de administração do Microsoft Entra.

Para conceder consentimento por meio do centro de administração do Microsoft Entra
  1. Faça login no centro de administração do Microsoft Entra.

  2. No painel de navegação esquerdo, expanda Inserir ID e escolha Aplicativos corporativos.

  3. Localize o aplicativo corporativo para o recurso Amazon Quick.

    nota

    O nome do aplicativo aparece na caixa de diálogo de consentimento que os usuários veem quando usam o recurso pela primeira vez.

  4. No painel de navegação esquerdo, escolha Permissões.

  5. Escolha Conceder consentimento do administrador para Your Organization.

  6. Confirme o consentimento.

Depois de conceder o consentimento, a página Permissões do aplicativo corporativo mostra todas as permissões delegadas com um indicador de status na coluna Consentimento do administrador.

nota

Quando um administrador concede o consentimento organizacional, o Microsoft Entra cria automaticamente um Aplicativo Corporativo (responsável pelo serviço) em seu locatário. Para revogar o acesso, desative ou exclua esse serviço principal dos aplicativos corporativos no centro de administração do Microsoft Entra.

Para verificar se seu inquilino restringe o consentimento do usuário, conclua as etapas a seguir.

Para verificar as configurações de consentimento do inquilino
  1. No centro de administração do Microsoft Entra, escolha Entra ID, Aplicativos corporativos, Consentimento e permissões, Configurações de consentimento do usuário.

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

Permissões solicitadas

As seguintes permissões delegadas são solicitadas quando um usuário faz login. Compartilhe essa lista com seu administrador se ele precisar revisar as permissões antes de conceder o consentimento.

Configuração gerenciada pelo usuário — permissões
Permissão solicitações de Tipo Description
Files.Read.All Microsoft Graph Delegado Leia todos os arquivos que o usuário conectado pode acessar.
Notes.Read.All Microsoft Graph Delegado Leia todos os OneNote cadernos que o usuário conectado pode acessar.
User.Read Microsoft Graph Delegado Faça login e leia o perfil do usuário.
Sites.Read.All Microsoft Graph Delegado Leia documentos e itens de lista em todos os conjuntos de sites.
offline_access Microsoft Graph Delegado Mantenha o acesso usando tokens de atualização.
AllSites.Read Office 365 SharePoint Online Delegado Leia itens em todos os conjuntos de sites.

Gerencie e solucione problemas de conexões gerenciadas pelo usuário

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

  • Aplicativo bloqueado pelo administrador — Seu inquilino do Microsoft 365 restringe o acesso a aplicativos de terceiros. Peça ao administrador do Microsoft 365 que conceda o consentimento do administrador. Para obter mais informações, consulte Consentimento do administrador para o Microsoft 365.

  • A janela de login fecha sem ser concluída — Verifique se seu navegador permite pop-ups do domínio do console Amazon Quick e se os cookies de terceiros estão habilitados.

  • O token expirou — as credenciais delegadas duram aproximadamente 90 dias. Se as sincronizações falharem após esse período, você precisará se autenticar novamente. Para obter mais informações, consulte Atualização do token com configuração gerenciada pelo usuário.

  • Conteúdo ausente — Verifique se a conta que você usou para autenticação tem acesso aos arquivos e pastas que você selecionou. O conteúdo compartilhado com você após a sincronização inicial requer uma ressincronização para ser indexado.

Para obter mais soluções de problemas, incluindo monitoramento de sincronização e relatórios, consulteBases de SharePoint conhecimento sobre solução de.

Próximas etapas

Depois que sua base de conhecimento for criada e a sincronização inicial for concluída, você poderá usá-la no Amazon Quick para responder às perguntas do seu SharePoint conteúdo. Para gerenciar sua base de conhecimento, consulteGerenciando integrações existentes.