Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Document-level controlli di accesso
<a name="google-drive-kb-acl"></a>

Admin-managed Le knowledge base di Google Drive includono il controllo degli accessi integrato a livello di documento. Amazon Quick sincronizza gli elenchi di controllo degli accessi (ACL) da Google Drive durante ogni scansione e verifica le autorizzazioni di ogni utente al momento della query, in modo che gli utenti vedano solo le risposte dai documenti a cui sono autorizzati ad accedere.

## Come funziona
<a name="google-drive-kb-acl-how-it-works"></a>

Quando un utente invia una richiesta a un agente Amazon Quick che utilizza una knowledge base di Google Drive gestita dall'amministratore, il sistema applica i controlli di accesso in due fasi:

1. **Pre-retrieval filtraggio**: Amazon Quick esegue una ricerca semantica nell'indice vettoriale per trovare i passaggi del documento più pertinenti. Il sistema applica elenchi di controllo degli accessi già memorizzati nell'indice. Questo produce una serie preliminare di documenti per i candidati. Questa fase è necessaria perché le chiamate API in tempo reale per ogni documento dell'indice sarebbero troppo costose su larga scala.

1. **Real-time verifica**: il sistema verifica i documenti candidati in tempo reale chiamando le API di Google Drive. Utilizza le credenziali dell'account di servizio fornite dall'amministratore per generare token di accesso specifici per l'utente tramite impersonificazione. Google Drive mantiene la fonte di verità per gli elenchi di controllo degli accessi associati a ciascun documento. Il sistema rimuove dal set di risultati tutti i documenti a cui l'utente non è autorizzato ad accedere.

Il sistema trasmette al modello solo i passaggi del documento verificati e autorizzati come contesto. Il modello utilizza questa conoscenza per generare una risposta. Questo approccio in due fasi fornisce garanzie di controllo degli accessi a livello di documento e mantiene le prestazioni su larga scala.

## Abilita la gestione ACL
<a name="google-drive-kb-acl-enable"></a>

Document-level il controllo degli accessi è abilitato automaticamente per tutte le knowledge base gestite dall'amministratore. e non sono necessarie ulteriori configurazioni.

Per ulteriori informazioni sulle best practice ACL, consulta. [Procedure consigliate per la gestione degli ACL nelle knowledge base](acl-best-practices-kb.md)