I Controlli di servizio VPC possono aiutarti a mitigare il rischio di esfiltrazione di dati da CX Agent Studio. Utilizza i Controlli di servizio VPC per creare un perimetro di servizio che protegga le risorse e i dati che specifichi. Ad esempio, quando utilizzi i Controlli di servizio VPC per proteggere CX Agent Studio, i seguenti artefatti non possono uscire dal perimetro di servizio:
- Dati dell'applicazione dell'agente
- Richieste e risposte runSession
CX Agent Studio consente di interagire con altre risorseGoogle Cloud , come i template di oscuramento DLP, BigQuery per l'esportazione delle conversazioni e i datastore. Queste risorse sono sotto il tuo controllo e devono essere disponibili nello stesso perimetro VPC-SC dell'applicazione dell'agente.
Limitazioni
Si applicano le seguenti limitazioni:
- Gli strumenti e i callback non possono inviare richieste a endpoint HTTP o HTTPS arbitrari quando i Controlli di servizio VPC sono abilitati, in quanto ciò potrebbe comportare il rischio di esfiltrazione di dati al di fuori del perimetro dei Controlli di servizio VPC. Per consentire le richieste in uscita, devi configurare Service Directory per l'accesso alla rete privata per i target VPC privati o aggiungere domini esterni alle origini consentite nelle impostazioni della località del progetto.
- Le registrazioni audio non possono essere scritte nei bucket Cloud Storage al di fuori del perimetro.
- Le conversazioni non possono essere scritte nei set di dati BigQuery all'esterno del perimetro.
- I template di oscuramento di Sensitive Data Protection all'esterno del perimetro causano errori nell'oscuramento dei contenuti delle conversazioni.
- Gli strumenti OpenAPI non possono fare riferimento alle chiavi di autenticazione utilizzando secret esterni al perimetro.
- Gli strumenti del datastore che specificano un datastore esterno al perimetro non vengono eseguiti.
- Gli agenti basati su flusso che specificano una risorsa agente all'esterno del perimetro non funzionano quando vengono chiamati.
- Il tentativo di importare un'applicazione agente da un bucket Cloud Storage all'esterno del perimetro non riesce.
- Il tentativo di esportare un'applicazione dell'agente in un bucket Cloud Storage esterno al perimetro non va a buon fine.
Creazione del perimetro di servizio
Quando crei un perimetro di servizio, includi sia CX Agent Studio (ces.googleapis.com) sia CX Insights (contactcenterinsights.googleapis.com) come servizi protetti.
Includi tutti i servizi che vuoi limitare (ad esempio, storage.googleapis.com, bigquery.googleapis.com) nel riquadro Servizi limitati.
Per saperne di più sulla creazione di un perimetro di servizio, consulta Creazione di un perimetro di servizio nella documentazione dei Controlli di servizio VPC.
Documentazione dei Controlli di servizio VPC per le dipendenze facoltative:
Consenti endpoint esterni utilizzando Origini consentite
Quando i Controlli di servizio VPC sono abilitati, gli strumenti e i callback che chiamano URL HTTP o HTTPS esterni senza utilizzare Service Directory vengono bloccati con un errore 403, a meno che non aggiungi ogni origine esterna (inclusi eventuali endpoint di token OAuth esterni) alle Origini consentite per il progetto e la località.
Per visualizzare e aggiornare le origini consentite, concedi il ruolo predefinito di Identity and Access Management Gemini Enterprise for Customer Experience Security Settings Editor (roles/ces.securitySettingsEditor) o un ruolo personalizzato con ces.securitySettings.get e ces.securitySettings.update (incluso anche in roles/ces.admin). Inserisci le origini esatte con lo schema, il dominio e la porta facoltativa (ad esempio https://api.example.com o https://api.example.com:8443), senza percorsi dell'URL, barre finali o caratteri jolly.
Puoi configurare le origini consentite nella console o utilizzando l'API REST:
- Console: apri la console CX Agent Studio, seleziona il progetto e la località, fai clic sull'icona delle impostazioni , aggiungi ogni origine in Origini consentite e fai clic su Salva (vedi Impostazioni della località del progetto).
- API REST: chiama
projects.locations.updateSecuritySettingsper aggiornareendpointControlPolicy.allowedOriginssulla risorsaSecuritySettingsdella località del progetto.
Utilizzo di Service Directory per l'accesso alla rete privata
CX Agent Studio si integra con l'accesso alla rete privata di Service Directory, in modo da potersi connettere ai target degli strumenti OpenAPI all'interno della tua rete VPC. In questo modo, il traffico viene mantenuto all'interno della rete Google Cloud e vengono applicati Identity and Access Management e i Controlli di servizio VPC.
Per configurare uno strumento che ha come target una rete privata:
Segui la configurazione della rete privata di Service Directory per configurare la rete VPC e l'endpoint Service Directory.
Per il progetto dell'agente deve esistere il service account Customer Engagement Suite Service Agent con il seguente indirizzo:
service-agent-project-number@gcp-sa-ces.iam.gserviceaccount.com
Concedi i seguenti ruoli all'account di servizio Customer Engagement Suite Service Agent nel progetto in cui si trova Service Directory:
servicedirectory.viewerservicedirectory.pscAuthorizedService
Inoltre, se Service Directory si trova in un progetto diverso da quello dell'applicazione dell'agente, devi concedere il ruolo
servicedirectory.vieweranche all'account dell'agente di servizio Customer Engagement Suite nel progetto che ospita l'applicazione dell'agente.Quando crei lo strumento, fornisci il servizio Service Directory insieme all'URL e alle informazioni di autenticazione facoltative. Questo campo è disponibile nelle impostazioni avanzate dello strumento.
Per risolvere i problemi, puoi configurare un controllo di uptime privato per verificare che Service Directory sia configurato correttamente.