Mengonfigurasi Kontrol Layanan VPC untuk CX Agent Studio

Kontrol Layanan VPC dapat membantu Anda mengurangi risiko pemindahan data yang tidak sah dari CX Agent Studio. Gunakan Kontrol Layanan VPC untuk membuat perimeter layanan yang melindungi resource dan data yang Anda tentukan. Misalnya, saat Anda menggunakan Kontrol Layanan VPC untuk melindungi CX Agent Studio, artefak berikut tidak dapat keluar dari perimeter layanan Anda:

  • Data aplikasi agen
  • Permintaan dan respons runSession

CX Agent Studio memungkinkan interaksi dengan resource Google Cloud lain seperti template penyuntingan DLP, BigQuery untuk ekspor percakapan, dan Penyimpanan Data. Resource ini berada dalam kendali Anda dan harus tersedia di perimeter VPC-SC yang sama dengan aplikasi agen.

Batasan

Batasan berikut berlaku:

  • Alat dan callback tidak dapat mengirim permintaan ke endpoint HTTP atau HTTPS arbitrer saat Kontrol Layanan VPC diaktifkan, karena hal ini dapat berisiko mengeksfiltrasi data di luar perimeter Kontrol Layanan VPC. Untuk mengizinkan permintaan keluar, Anda harus mengonfigurasi Direktori Layanan untuk akses jaringan pribadi bagi target VPC pribadi atau menambahkan domain eksternal ke Origin yang diizinkan di setelan lokasi project Anda.
  • Rekaman audio tidak dapat ditulis ke bucket Cloud Storage di luar perimeter.
  • Percakapan tidak dapat ditulis ke set data BigQuery di luar perimeter.
  • Template penyuntingan Sensitive Data Protection di luar perimeter menyebabkan kegagalan dalam menyunting konten percakapan.
  • Alat OpenAPI tidak dapat mereferensikan kunci autentikasi menggunakan secret yang berada di luar perimeter.
  • Alat Datastore yang menentukan penyimpanan data di luar perimeter gagal dieksekusi.
  • Agen berbasis alur yang menentukan resource agen di luar perimeter akan gagal saat dipanggil.
  • Upaya untuk mengimpor aplikasi agen dari bucket Cloud Storage di luar perimeter akan gagal.
  • Upaya mengekspor aplikasi agen ke bucket Cloud Storage di luar perimeter akan gagal.

Pembuatan perimeter layanan

Saat Anda membuat perimeter layanan, sertakan CX Agent Studio (ces.googleapis.com) dan CX Insights (contactcenterinsights.googleapis.com) sebagai layanan yang dilindungi. Sertakan layanan apa pun yang ingin Anda batasi (misalnya, storage.googleapis.com, bigquery.googleapis.com) di panel Restricted services.

Untuk mengetahui informasi selengkapnya tentang pembuatan perimeter layanan, lihat Membuat perimeter layanan dalam dokumentasi Kontrol Layanan VPC.

Dokumentasi Kontrol Layanan VPC untuk dependensi opsional:

Mengizinkan endpoint eksternal menggunakan Origin yang diizinkan

Jika Kontrol Layanan VPC diaktifkan, alat dan callback yang memanggil URL HTTP atau HTTPS eksternal tanpa menggunakan Direktori Layanan akan diblokir dengan error 403, kecuali jika Anda menambahkan setiap origin eksternal (termasuk endpoint token OAuth eksternal) ke Origin yang diizinkan untuk project dan lokasi Anda.

Untuk melihat dan memperbarui Origin yang diizinkan, berikan peran Identity and Access Management yang telah ditetapkan Gemini Enterprise for Customer Experience Security Settings Editor (roles/ces.securitySettingsEditor), atau peran khusus dengan ces.securitySettings.get dan ces.securitySettings.update (juga disertakan dalam roles/ces.admin). Masukkan origin yang tepat dengan skema, domain, dan port opsional (misalnya, https://api.example.com atau https://api.example.com:8443), tanpa jalur URL, garis miring di akhir, atau karakter pengganti.

Anda dapat mengonfigurasi Origin yang diizinkan di konsol atau menggunakan REST API:

Menggunakan Direktori Layanan untuk akses jaringan pribadi

CX Agent Studio terintegrasi dengan akses jaringan pribadi Direktori Layanan, sehingga dapat terhubung ke target alat OpenAPI di dalam jaringan VPC Anda. Hal ini menjaga traffic tetap berada dalam jaringan Google Cloud dan menerapkan Identity and Access Management dan Kontrol Layanan VPC.

Untuk menyiapkan alat yang menargetkan jaringan pribadi:

  1. Ikuti Konfigurasi jaringan pribadi Direktori Layanan untuk mengonfigurasi jaringan VPC dan endpoint Direktori Layanan Anda.

  2. Akun layanan Customer Engagement Suite Service Agent dengan alamat berikut harus ada untuk project agen Anda:

    service-agent-project-number@gcp-sa-ces.iam.gserviceaccount.com

    Berikan peran berikut ke akun layanan Customer Engagement Suite Service Agent dalam project tempat Direktori Layanan Anda berada:

    • servicedirectory.viewer
    • servicedirectory.pscAuthorizedService

    Selain itu, jika Direktori Layanan Anda berada di project yang berbeda dengan aplikasi agen, Anda juga perlu memberikan peran servicedirectory.viewer ke akun Agen Layanan Customer Engagement Suite di project yang menghosting aplikasi agen Anda.

  3. Berikan layanan Direktori Layanan beserta URL dan informasi autentikasi opsional saat membuat alat. Kolom ini tersedia di setelan lanjutan untuk alat tersebut.

Untuk memecahkan masalah, Anda dapat menyiapkan cek uptime pribadi untuk memeriksa apakah Direktori Layanan Anda dikonfigurasi dengan benar.