Identity and Access Management (IAM)

Questa pagina descrive come controllare l'accesso e le autorizzazioni di Vertex AI Search per il commercio utilizzando Identity and Access Management (IAM).

Panoramica

Google Cloud offre Identity and Access Management (IAM), che ti consente di concedere un accesso più granulare a risorse specifiche Google Cloud e impedisce l'accesso indesiderato ad altre risorse. Questa pagina descrive i ruoli e le autorizzazioni IAM di Vertex AI Search for Commerce. Per una descrizione dettagliata di Google Cloud IAM, consulta la documentazione di IAM.

Vertex AI Search for Commerce fornisce un insieme di ruoli predefiniti progettati per aiutarti a controllare facilmente l'accesso alle risorse di Vertex AI Search for Commerce. Puoi anche creare i tuoi ruoli personalizzati, se i ruoli predefiniti non forniscono gli insiemi di autorizzazioni di cui hai bisogno. Inoltre, sono ancora disponibili anche i ruoli di base precedenti (Editor, Visualizzatore e Proprietario), anche se non offrono lo stesso controllo granulare dei ruoli di Vertex AI Search per il commercio. In particolare, i ruoli di base forniscono accesso alle risorse Google Cloud non solo per Vertex AI Search per il commercio. Per ulteriori informazioni, consulta la documentazione relativa ai ruoli di base.

Ruoli predefiniti

Vertex AI Search for Commerce fornisce alcuni ruoli predefiniti che puoi utilizzare per fornire alle entità autorizzazioni più granulari. Il ruolo concesso a un'entità controlla le azioni che può eseguire. Le entità possono essere persone fisiche, gruppi o account di servizio.

Puoi concedere più ruoli alla stessa entità e puoi modificare i ruoli concessi a un'entità in qualsiasi momento, a condizione di disporre delle autorizzazioni necessarie.

I ruoli più ampi includono quelli definiti in modo più limitato. Ad esempio, il ruolo Editor per la vendita al dettaglio include tutte le autorizzazioni del ruolo Visualizzatore per la vendita al dettaglio, oltre alle autorizzazioni aggiuntive del ruolo Editor per la vendita al dettaglio. Analogamente, il ruolo Amministratore della vendita al dettaglio include tutte le autorizzazioni del ruolo Editor della vendita al dettaglio, oltre alle autorizzazioni aggiuntive.

I ruoli di base (Proprietario, Editor, Visualizzatore) forniscono autorizzazioni per Google Cloud. I ruoli specifici di Vertex AI Search for Commerce forniscono solo le autorizzazioni di Vertex AI Search for Commerce, ad eccezione delle seguenti autorizzazioni Google Cloud (Google Cloud), necessarie per l'utilizzoGoogle Cloud generale:

  • resourcemanager.projects.get
  • resourcemanager.projects.list
  • serviceusage.services.list
  • serviceusage.services.get

La tabella seguente elenca i ruoli predefiniti disponibili per Vertex AI Search per il commercio, insieme alle relative autorizzazioni:

Nome Autorizzazioni di Vertex AI Search for Commerce Descrizione
Progetto > Proprietario All retail permissions Accesso e controllo completi per tutte le Google Cloud risorse; gestione dell'accesso degli utenti e configurazione della fatturazione per un progetto.
Progetto > Editor Tutte le autorizzazioni retail, ad eccezione di quelle nel ruolo Amministratore vendita al dettaglio. Accesso in lettura/scrittura a tutte le risorse Google Cloud e Vertex AI Search for Commerce (tranne la possibilità di modificare le autorizzazioni e la fatturazione).
Progetto > Visualizzatore retail.*.get
retail.*.list
 Accesso di sola lettura a tutte le Google Cloud risorse, incluse le risorse di Vertex AI Search per il commercio.
Retail Admin retail.retailProjects.acceptDataTerms
retail.products.purge
retail.products.setSponsorship
retail.userEvents.purge
retail.userEvents.rejoin
retail.attributesConfigs.removeCatalogAttribute
retail.attributesConfigs.batchRemoveCatalogAttributes

Questo ruolo include anche tutte le autorizzazioni dei ruoli Editor e Visualizzatore per la vendita al dettaglio.		 Controllo completo di tutte le risorse di Vertex AI Search for Commerce.
Retail Editor retail.catalogs.import
retail.catalogs.update
retail.products.create
retail.products.delete
retail.products.update
retail.products.import
retail.userEvents.create
retail.userEvents.import
retail.servingConfigs.create
retail.servingConfigs.update
retail.servingConfigs.delete
retail.controls.create
retail.controls.update
retail.controls.delete
retail.controls.import
retail.controls.export
retail.attributesConfigs.update
retail.attributesConfigs.addCatalogAttribute
retail.attributesConfigs.importCatalogAttributes
retail.attributesConfigs.exportCatalogAttributes
retail.attributesConfigs.replaceCatalogAttribute
retail.completionConfigs.update
retail.models.create
retail.models.delete
retail.models.update
retail.models.pause
retail.models.resume
retail.loggingConfigs.update

Questo ruolo include anche tutte le autorizzazioni del ruolo Visualizzatore di vendita al dettaglio.		 Può leggere tutte le risorse di Vertex AI Search for Commerce e scrivere products, events e altre risorse.
Retail Viewer retail.retailProjects.get
retail.attributesConfigs.exportCatalogAttributes
retail.catalogs.completeQuery
retail.catalogs.listProductAttributes
retail.controls.export
retail.placements.search
retail.placements.predict
retail.products.export
retail.userEvents.export
retail.*.get
retail.*.list
 Accesso di sola lettura a tutte le risorse di Vertex AI Search for Commerce.

Esegui la migrazione delle autorizzazioni dall'API Recommendations AI

Se esegui la migrazione dall'API Recommendations Engine precedente a Vertex AI Search for Commerce, tieni presente che i seguenti ruoli predefiniti includono anche le autorizzazioni per l'API precedente.

  • Amministratore di vendita al dettaglio: include tutte le autorizzazioni di amministratore dei consigli, ad eccezione delle autorizzazioni apiKeys.
  • Editor di negozi: include tutte le autorizzazioni di Recommendations Editor, nonché catalog.update, ed esclude le autorizzazioni apiKeys.
  • Retail Viewer: include tutte le autorizzazioni di Recommendations Viewer.

Gestire l'IAM di Vertex AI Search per il commercio

Puoi ottenere e impostare i criteri di autorizzazione IAM e i ruoli IAM utilizzando la Google Cloud console, i metodi IAM dell'API o Vertex AI Search for Commerce. Per ulteriori informazioni, consulta Concedere, modificare e revocare l'accesso.

Passaggi successivi