Configura l'autenticazione per il selettore file

Quando interagiscono con l'assistente Gemini Enterprise, gli utenti possono allegare file utilizzando il selettore file. L'assistente supporta tre origini file: file locali, file di Google Drive e file di Microsoft OneDrive. Questa pagina descrive come gli amministratori configurano questo comportamento.

Se vuoi che gli utenti finali selezionino i file da Google Drive e OneDrive, puoi controllare il modo in cui accedono riutilizzando la configurazione del datastore che hai impostato durante la configurazione del datastore di Google Drive e del datastore di OneDrive. In questo modo, puoi controllare:

  • Quale app di accesso utilizza il selettore. Un selettore può riutilizzare l'applicazione Microsoft Entra (precedentemente Azure AD) o Google che configuri sul connettore anziché l'applicazione predefinita gestita da Google.
  • Quale tenant Microsoft Entra utilizza il selettore di OneDrive. Il selettore di OneDrive può far accedere gli utenti al tuo tenant Microsoft Entra specifico.

Per l'esperienza dell'utente finale relativa all'allegato e alla chat sui file, consulta Carica e chatta sui file.

Come funzionano i selettori file

Se hai configurato i datastore di Google Drive e OneDrive in modo che utilizzino le stesse configurazioni di autorizzazione per il selettore file, quest'ultimo utilizza le stesse impostazioni per autenticare gli utenti. La seguente tabella riassume i due controlli e i selettori interessati.

Controllo Funzione Applicabile a
App di accesso personalizzata Per autenticare gli utenti quando allegano file all'assistente utilizzando il selettore file, Gemini Enterprise può utilizzare le configurazioni Microsoft Entra ID o Google Identity esistenti del datastore anziché l'applicazione predefinita gestita da Google. Google Drive e OneDrive
Applicazione forzata del tenant Il selettore di OneDrive richiede agli utenti di accedere al tuo tenant Microsoft Entra specifico (https://login.microsoftonline.com/{your-tenant}/...) anziché all'endpoint di accesso condiviso (/common/), in modo che gli utenti di altri tenant non possano autenticarsi. Il tenant viene letto dal connettore OneDrive collegato. Solo OneDrive

Gli amministratori collegano i connettori a un'app per configurare questo comportamento.

Quando designi un provider di configurazione, si applicano le seguenti regole:

  • Un provider per tipo di connettore. Puoi collegare a un'app un solo provider di configurazione OneDrive e un solo provider di configurazione Google Drive alla volta. Il contrassegno di un secondo connettore dello stesso tipo di un provider viene rifiutato con un errore di argomento non valido.
  • Il provider deve essere un connettore abilitato per le azioni. Il provider di configurazione deve essere un connettore OneDrive o Google Drive che supporta le azioni o l'accesso federato. Un connettore di sola importazione non può essere un provider di configurazione. Per saperne di più, consulta Gestisci azioni.

Prima di iniziare

Prima di configurare i selettori file, verifica quanto segue:

  • Accesso amministratore. Concedi il ruolo Discovery Engine Editor (roles/discoveryengine.editor). Questo ruolo è necessario per consentire all'utente di creare il datastore. Per concedere questo ruolo:
    1. Nella console Google Cloud vai alla pagina IAM.

      Vai a IAM

    2. Individua l'account utente e fai clic su edit Modifica.
    3. Concedi all'utente il ruolo Discovery Engine Editor. Per saperne di più, consulta Ruoli e autorizzazioni IAM.
  • App di accesso a OneDrive personalizzata. Assicurati di avere un'applicazione Microsoft Entra ID che controlli, inclusi l'ID client, il client secret e l'ID tenant, nonché un account OneDrive all'interno del tenant per i test. Per saperne di più, consulta Registrare un'applicazione con Microsoft Identity Platform.
  • Datastore configurato. Configura un datastore OneDrive o un datastore Google Drive. Durante la configurazione del datastore, configuri le impostazioni di autenticazione che includono l'ID client, il client secret e l'ID tenant per il datastore OneDrive. Per ulteriori informazioni, consulta:
  • Datastore collegato. Collega il datastore OneDrive o Google Drive alla tua app Gemini Enterprise. Per ulteriori informazioni, vedi Collega un datastore a un'app.

Utilizza la tua app di accesso

Per impostazione predefinita, il selettore utilizza l'applicazione gestita da Google per l'accesso. Puoi fare in modo che il selettore utilizzi il tuo Microsoft Entra ID o Google Identity designando un connettore come provider di configurazione del selettore.

Se hai già configurato un datastore OneDrive o Google Drive, segui questi passaggi:

  1. Nella console Google Cloud , vai alla pagina Gemini Enterprise.

    Gemini Enterprise

  2. Seleziona o crea un Google Cloud progetto.

  3. Nel menu di navigazione, fai clic su Datastore.

  4. Cerca il tuo datastore e fai clic sul suo nome.

  5. Fai clic su Visualizza/modifica parametri.

  6. Seleziona l'opzione Picker Config Provider (Provider di configurazione del selettore).

  7. Fai clic su Salva.

Ripristina le modifiche per utilizzare l'applicazione gestita da Google

Per tornare a utilizzare l'applicazione predefinita gestita da Google per l'autenticazione del selettore file, segui questi passaggi:

  1. Nella console Google Cloud , vai alla pagina Gemini Enterprise.

    Gemini Enterprise

  2. Selezionare il tuo progetto Google Cloud .

  3. Nel menu di navigazione, fai clic su Datastore.

  4. Fai clic sul nome del tuo datastore.

  5. Fai clic su Visualizza/modifica parametri.

  6. Cancella il campo Picker Config Provider (Provider di configurazione del selettore).

  7. Fai clic su Salva.

Esperienza utente finale

Dopo aver configurato i selettori, gli utenti finali avranno la seguente esperienza:

  • Per OneDrive, agli utenti viene chiesto di accedere al tenant Microsoft della tua organizzazione. Gli account di altri tenant vengono rifiutati.
  • L'accesso utilizza l'applicazione che hai configurato: l'applicazione gestita da Google per impostazione predefinita o la tua applicazione se hai impostato un provider di configurazione.
  • Dopo il primo accesso riuscito, la connessione viene memorizzata per le selezioni di file successive.

Per saperne di più sull'esperienza dell'utente finale, consulta Carica file e usali in chat.

Risoluzione dei problemi

Sintomo Causa probabile Risoluzione
Contrassegnare un connettore come **Picker Config Provider** non riesce con Cannot enable picker_config_provider on data connector '...' because another connector in the same engine is already the picker config provider: '...'. An engine can have at most one picker_config_provider connector; disable it on the other connector first. Un altro connettore nello stesso motore è già il provider di configurazione del selettore. Un motore può averne al massimo uno. Cancella il parametro **Picker Config Provider** sull'altro connettore, quindi riprova.
Accesso a OneDrive non riuscito con AADSTS50020: User account 'user@domain.com' from identity provider '...' does not exist in tenant '...' L'account dell'utente si trova in un tenant Microsoft Entra diverso da quello configurato sul connettore. L'endpoint di accesso specifico del tenant rifiuta l'account. L'applicazione forzata del tenant funziona come previsto. Chiedi all'utente di accedere con un account nel tenant configurato o aggiorna l'ID tenant del connettore.
OneDrive continua a richiedere l'endpoint di accesso condiviso. Il tenant non è ancora configurato o la modifica non è stata propagata. Conferma l'ID tenant del connettore. L'applicazione delle modifiche alla configurazione può richiedere fino a circa 3 minuti. Attendi e riprova.

Passaggi successivi