Configurare i controlli dell'accesso per le app

Questa pagina spiega come un amministratore di Gemini Enterprise può utilizzare l'API per gestire controllo dell'accesso granulare dell'accesso per singole app Gemini Enterprise.

Se devi configurare controlli degli accessi granulari a livello di risorsa sia per le app che per i datastore, consulta Configura controlli degli accessi granulari per app e datastore.

Per impostazione predefinita, le autorizzazioni IAM vengono spesso gestite a livello di progetto. IAM a livello di app consente un controllo più granulare, permettendo agli amministratori di:

  • Limita l'accesso degli utenti ad app specifiche all'interno dello stesso progetto Google Cloud .
  • Allinea le autorizzazioni alle esigenze dell'organizzazione e ai silos di dati per i tuoi deployment di Gemini Enterprise.

Ad esempio, considera un'organizzazione con un'app per le risorse RU e un'app a livello aziendale. Un membro del team delle RU con autorizzazioni a livello di progetto può accedere a entrambe le app. Al contrario, utilizzando una policy IAM a livello di app, puoi concedere a un membro del team di vendita l'accesso solo all'app aziendale, impedendogli di accedere all'app RU.

Diagramma di esempi di policy IAM a livello di app.

Prima di iniziare

  • Verifica di disporre del ruolo Amministratore Gemini Enterprise (roles/discoveryengine.agentspaceAdmin).

  • Verifica che tutti gli utenti aziendali di Gemini Enterprise dispongano di una licenza valida e che abbiano ricevuto il ruolo Gemini Enterprise Restricted User (roles/discoveryengine.agentspaceRestrictedUser) a livello di progetto. Per le istruzioni, vedi Concedi autorizzazioni agli utenti.

    Questo ruolo non concede l'accesso ad alcuna app. Fornisce l'accesso a livello di progetto di cui gli utenti hanno bisogno e poi tu concedi l'accesso alle singole app. Se utilizzi un ruolo personalizzato a livello di progetto anziché il ruolo predefinito roles/discoveryengine.agentspaceRestrictedUser, assicurati che il ruolo personalizzato includa le autorizzazioni discoveryengine.locations.buildAuthorizationUrl, discoveryengine.dataStores.get, discoveryengine.collections.get e discoveryengine.devToolsConfigs.get. L'omissione di discoveryengine.devToolsConfigs.get causa un errore 403 PERMISSION_DENIED in Cloud Audit Logs quando l'app web controlla devToolsConfig.

Transizione dall'accesso a livello di progetto all'accesso a livello di app

Per limitare gli utenti ad app specifiche, devi sostituire il loro ruolo utente aziendale Gemini Enterprise a livello di progetto con il ruolo Gemini Enterprise Restricted User, quindi concedere il ruolo utente aziendale Gemini Enterprise a livello di singola app.

Per eseguire la transizione di un utente dall'accesso a livello di progetto all'accesso a livello di app, segui questi passaggi. Utilizza la console Google Cloud per le modifiche a livello di progetto e l'API per la concessione a livello di app, che non è supportata dalla console Google Cloud .

  1. Nella console Google Cloud vai alla pagina IAM.
  2. Trova l'utente e rimuovi il ruolo Utente aziendale Gemini Enterprise (roles/discoveryengine.agentspaceUser) dalle sue autorizzazioni a livello di progetto.
  3. Se non l'hai ancora fatto, concedi all'utente il ruolo Gemini Enterprise Restricted User (roles/discoveryengine.agentspaceRestrictedUser) a livello di progetto.
  4. Utilizza il metodo setIamPolicy per concedere all'utente il ruolo Gemini Enterprise User (roles/discoveryengine.agentspaceUser) per ogni app specifica a cui deve accedere. Per saperne di più, consulta Gestisci le policy IAM per le app.

Gestisci le policy IAM per le app

Per gestire l'accesso alla tua app Gemini Enterprise, puoi utilizzare i metodi API getIamPolicy e setIamPolicy.

I passaggi seguenti mostrano come recuperare la policy attuale e aggiornarla per concedere o revocare l'accesso degli utenti.

Recupera la policy IAM dell'app

Recupera l'attuale policy IAM della tua app utilizzando il metodo getIamPolicy. Ti consigliamo di recuperare prima la policy esistente per evitare di sovrascrivere le autorizzazioni attuali.

REST

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID:getIamPolicy"

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto.
  • ENDPOINT_LOCATION: la località multiregionale per la richiesta API. Specifica uno dei seguenti valori:
    • us per la multi-regione Stati Uniti
    • eu per la multi-regione UE
    • global per la località globale
    Per saperne di più, consulta Specifica una multi-regione per il datastore.
  • LOCATION: la località multiregionale del datastore: global, us o eu
  • APP_ID: l'ID dell'app che vuoi configurare.

Aggiorna la policy IAM dell'app

Per concedere o revocare l'accesso degli utenti all'app, aggiorna la policy IAM dell'app utilizzando il metodo setIamPolicy.

La policy IAM utilizza il ruolo Gemini Enterprise User (roles/discoveryengine.agentspaceUser) per concedere agli utenti l'accesso diretto all'app.

REST

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{
      "policy": {
         "etag": "ETAG",
         "bindings": [
          {
            "role": "roles/discoveryengine.agentspaceUser",
            "members": [
              "user:USER_EMAIL",
              "group:GROUP_EMAIL",
              "principal://iam.googleapis.com/locations/global/workloadIdentityPools/POOL_ID/subject/SUBJECT_ID",
              "principalSet://iam.googleapis.com/locations/global/workloadIdentityPools/POOL_ID/attribute.NAME/VALUE"
            ]
          }
        ]
      }
    }' \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID:setIamPolicy"

Sostituisci quanto segue:

  • ETAG: il valore etag ottenuto come risposta quando hai utilizzato il metodo getIamPolicy.

  • USER_EMAIL, GROUP_EMAIL: uno o più indirizzi email di utenti o gruppi. Oltre a user e group, principal e principalSet sono tipi di membri validi per la federazione Workload Identity.

    • Per concedere l'accesso, aggiungi le entità all'array members. Ad esempio, "user:cloudysanfrancisco@gmail.com" o "group:mcymbalgroup@google.com".

    • Per revocare l'accesso, rimuovi le entità dall'array members.

  • POOL_ID: l'ID del pool di identità del workload.

  • SUBJECT_ID: l'identificatore del soggetto per un'identità specifica.

  • NAME: il nome di un attributo.

  • VALUE: il valore di un attributo.

  • PROJECT_ID: l'ID progetto.

  • ENDPOINT_LOCATION: la località multiregionale per la richiesta API. Specifica uno dei seguenti valori:

    • us per la multi-regione Stati Uniti
    • eu per la multi-regione UE
    • global per la località globale
    Per saperne di più, consulta Specifica una multi-regione per il datastore.

  • LOCATION: la località multiregionale del datastore: global, us o eu.

  • APP_ID: l'ID dell'app che vuoi configurare.

Passaggi successivi

Se vuoi eliminare un'app con una policy IAM, puoi rimuovere gli utenti dalla policy prima di eliminare l'app. Per saperne di più, consulta Best practice per l'eliminazione di un'app con una policy IAM.