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á.
Document-level controles de acesso
Admin-managed OneDrive as bases de conhecimento incluem controle de acesso integrado em nível de documento. Como a configuração gerenciada pelo administrador rastreia o OneDrive conteúdo de cada usuário em sua organização, a ACL está sempre ativada e não pode ser desativada. O Amazon Quick sincroniza as listas de controle de acesso (ACLs) de cada OneDrive rastreamento. O sistema verifica as permissões de cada usuário no momento da consulta, para que os usuários só vejam as respostas dos documentos aos quais estão autorizados a acessar. OneDrive
Como funciona
Quando um usuário consulta um agente do Amazon Quick que usa uma base de OneDrive conhecimento gerenciada pelo administrador, o sistema aplica controles de acesso em dois estágios:
-
Pre-retrieval filtragem — O Amazon Quick realiza uma pesquisa semântica no índice vetorial para encontrar as passagens mais relevantes do documento. O sistema aplica listas de controle de acesso que foram sincronizadas OneDrive durante o último rastreamento. Isso produz um conjunto preliminar de documentos candidatos.
-
Real-time verificação — O sistema verifica os documentos do candidato em tempo real, verificando o acesso atual do usuário consultor. OneDrive Somente os documentos que o usuário está atualmente autorizado a acessar são incluídos na resposta.
Essa abordagem de dois estágios fornece controle de acesso em nível de documento que permanece atualizado mesmo quando OneDrive as permissões mudam entre as sincronizações.
Gerenciamento de ACL
Document-level o controle de acesso é ativado automaticamente para todas as bases de conhecimento gerenciadas pelo administrador OneDrive . Nenhuma configuração adicional é necessária e a configuração não pode ser desativada.
Para que a aplicação da ACL funcione, o registro do aplicativo Entra deve ter as seguintes permissões do aplicativo Microsoft Graph:
-
User.Read.AllGroup.Read.All, eGroupMember.Read.Allpara resolver a associação de usuários e grupos. -
Sites.Read.Allpara enumerar e ler as OneDrive unidades em que estão hospedadas. SharePoint
Para obter mais informações sobre as melhores práticas de ACL, consulteMelhores práticas para gerenciar ACLs em bases de conhecimento.
Real-time verificação de acesso
O estágio de verificação em tempo real usa um fluxo OAuth delegado gerenciado automaticamente pelo Amazon Quick. O Quick cria e gerencia um aplicativo Microsoft Entra separado especificamente para essa finalidade. Nenhuma configuração do cliente é necessária para este aplicativo. É diferente do registro de aplicativo gerenciado pelo administrador que você criou durante a configuração e de qualquer aplicativo OAuth gerenciado pelo usuário.
-
Um usuário faz uma pergunta no assistente de bate-papo rápido.
-
Se a resposta envolver OneDrive conteúdo de uma base de conhecimento gerenciada pelo administrador, o Quick solicita que o usuário faça login em. OneDrive
-
O usuário entra e aceita a caixa de diálogo de consentimento da Microsoft (se o consentimento do administrador não tiver sido concedido).
-
O Quick usa o token delegado do usuário para verificar o acesso a cada documento candidato em tempo real.
-
Somente os documentos aos quais o usuário tem acesso atualmente OneDrive são incluídos na resposta.
O login é uma etapa única. As credenciais delegadas usam um token de atualização e duram aproximadamente 90 dias.
Permissões delegadas
O aplicativo ACL em tempo real solicita as seguintes permissões delegadas:
| Permissão | Escopo | Finalidade |
|---|---|---|
| Leia itens em todos os conjuntos de sites | Sites.Read.All |
Verifique o acesso do usuário ao OneDrive conteúdo hospedado no SharePoint. |
| Tenha acesso total aos seus arquivos | Files.ReadWrite.All |
Verifique o acesso do usuário a arquivos específicos. |
| Veja seu perfil básico | User.Read |
Identifique o usuário conectado. |
| Mantenha o acesso aos dados aos quais você concedeu acesso | offline_access |
Atualize os tokens para que os usuários não precisem se autenticar novamente com frequência. |
Consentimento do administrador
A verificação de ACL em tempo real usa um aplicativo Microsoft Entra separado daquele usado na configuração gerenciada pelo usuário ou no registro do aplicativo gerenciado pelo administrador. Se sua organização exigir o consentimento do administrador, um administrador deverá conceder o consentimento para cada aplicativo de forma independente.
Quando você cria uma base de conhecimento gerenciada pelo administrador, o console Amazon Quick fornece um link direto para conceder o consentimento do administrador. Esse link é para o aplicativo ACL em tempo real. Se você for administrador do Microsoft 365, poderá conceder consentimento diretamente do console. Caso contrário, compartilhe o link com seu administrador.
Se o consentimento do administrador não for concedido, cada usuário verá a caixa de diálogo de consentimento na primeira consulta que envolve OneDrive conteúdo. Depois de aceitarem, eles não serão avisados novamente por aproximadamente 90 dias.
Para obter instruções detalhadas sobre como conceder o consentimento do administrador por meio da caixa de diálogo de consentimento ou do centro de administração do Microsoft Entra, consulteConceder consentimento do administrador em toda a organização.
Próximas etapas
Para obter mais informações sobre as melhores práticas de ACL, consulteMelhores práticas para gerenciar ACLs em bases de conhecimento. Para obter informações sobre a criação de bases de OneDrive conhecimento gerenciadas pelo administrador, consulte. Admin-managed configuração (credenciais de serviço)
