Kontrol akses

Beberapa anggota tim biasanya berkolaborasi dalam membangun agen dan layanan untuk mengakses agen. Dengan menggunakan peran, Anda dapat mengontrol akses dan izin yang diberikan kepada akun utama.

Anda dapat mengonfigurasi akses menggunakan konsol Conversational Agents atau menggunakan konsol Google Cloud (buka dokumentasi, buka konsol) dengan Identity and Access Management (IAM). Konsol Google Cloud digunakan untuk memberikan peran IAM kepada akun utama, sementara konsol Conversational Agents digunakan untuk memberikan peran agen Dialogflow CX kepada akun utama. Peran agen Dialogflow CX adalah peran bawaan yang praktis dan ditentukan oleh Dialogflow CX yang membatasi akses ke satu agen atau resource turunan dari agen tertentu.

Ada beberapa situasi saat Anda harus menggunakan konsol Google Cloud :

• Peran IAM Project Owner secara default diberikan kepada pengguna yang membuat project yang memiliki agen. Pemilik ini memiliki akses penuh ke semua agen dalam project. Jika ingin mengubah Project Owner, Anda harus menggunakan konsol Google Cloud .
• Hanya akses tingkat agen yang dapat dikonfigurasi melalui konsol Dialogflow CX. Jika ingin mengonfigurasi akses tingkat project, Anda harus menggunakan konsol Google Cloud .
• Sebagian peran IAM memiliki peran agen Dialogflow CX yang sesuai. Jika Anda ingin memberikan peran level project atau level agen yang tidak ada di konsol Dialogflow CX, Anda harus menggunakan konsol Google Cloud .
• Jika Anda membuat agen penyimpanan data dengan antarmuka pengguna Vertex AI Agents, Anda harus menggunakan konsol Google Cloud .

Jika menggunakan API, Anda mungkin juga memiliki satu atau beberapa aplikasi yang mengirim permintaan ke agen. Dalam hal ini, Anda dapat mengontrol akses dengan akun layanan.

Mengontrol akses dengan konsol Conversational Agents

Konsol Conversational Agents memungkinkan Anda menerapkan peran agen yang praktis, yang dikonfigurasi untuk berbagi di tingkat agen. Peran ini berkorelasi dengan peran IAM dengan kondisi IAM yang membatasi akses ke agen tertentu atau subset resource turunan dari agen.

Untuk mengakses konfigurasi peran agen dari konsol Conversational Agents, Anda harus diberi peran Project IAM Admin untuk project terkait. Peran ini diberikan dari konsol Google Cloud .

Catatan: Konsol Conversational Agents hanya akan menampilkan akun utama dengan peran khusus ini dan kondisi khusus agen. Jika Anda telah menggunakan konsol Google Cloud untuk menambahkan akun utama dengan peran atau kondisi apa pun, akun utama tersebut tidak akan muncul di konsol Conversational Agents.

Peran agen Dialogflow CX	Ringkasan	Peran IAM
Pembaca Percakapan	Memberikan akses baca untuk mengkueri (bukan mendeteksi intent) agen dari konsol atau API.	Dialogflow > Dialogflow API Reader
Admin Percakapan	Memberikan akses penuh untuk membuat, memperbarui, mengkueri, mendeteksi intent, dan menghapus agen dari konsol atau API.	Dialogflow > Dialogflow API Admin
Klien Percakapan	Memberikan akses untuk mendeteksi intent dari konsol atau API.	Dialogflow > Dialogflow API Client
Agen Layanan	Lihat Agen Layanan	Lihat Agen Layanan
Editor alur	Memberikan akses untuk memperbarui, mengkueri alur tertentu, dan membuat, memperbarui, menghapus, atau mengkueri resource alur (halaman, grup rute, dan versi) dari konsol atau API.	Dialogflow > Dialogflow Flow editor
Editor lingkungan	Memberikan akses untuk memperbarui, mengkueri lingkungan tertentu, dan membuat, memperbarui, menghapus, atau mengkueri resource lingkungan (eksperimen) dari konsol atau API.	Dialogflow > Dialogflow Environment editor
Entity Type Admin	Memberikan akses untuk membuat, memperbarui, menghapus, atau mengkueri jenis entity agen dari konsol atau API.	Dialogflow > Dialogflow Entity Type Admin
Intent Admin	Memberikan akses untuk membuat, memperbarui, menghapus, atau mengkueri intent agen dari konsol atau API.	Dialogflow > Dialogflow Intent Admin
Admin Kasus Pengujian	Memberikan akses untuk membuat, memperbarui, menghapus, atau mengkueri kasus pengujian agen dari konsol atau API.	Dialogflow > Dialogflow Test Case Admin
Admin Webhook	Memberikan akses untuk membuat, memperbarui, menghapus, atau mengkueri webhook agen dari konsol atau API.	Dialogflow > Dialogflow Webhook Admin

Opsi berbagi dapat ditemukan di setelan agen. Untuk membuka setelan berbagi agen:

1. Buka konsol Dialogflow CX.
2. Pilih project Google Cloud Anda.
3. Pilih agen Anda.
4. Klik Agent Settings.
5. Klik tab Bagikan.

Menambahkan akun utama

1. Klik Tambahkan.
2. Masukkan alamat email untuk pengguna, grup, atau akun layanan.
3. Pilih User, Group, atau Service Account untuk jenis email.
4. Peran Dialogflow Reader ditambahkan secara default, yang diperlukan agar pengguna dapat mengakses konsol Conversational Agents.
5. Klik Add role di bagian Assign roles.
6. Pilih jenis peran di bagian Jenis.
7. Untuk peran Flow Editor dan Environment Editor, pilih alur atau lingkungan tertentu atau tetap gunakan opsi All default.
8. Jika perlu, tetapkan tanggal habis masa berlaku untuk peran tersebut.
9. Klik Simpan.

Mengubah peran akun utama

1. Klik akun utama dalam daftar.
2. Perbarui peran untuk akun utama ini di pop-up.
3. Klik Simpan.

Menghapus akun utama

1. Temukan akun utama dalam daftar.
2. Klik tombol hapus untuk akun utama.
3. Klik Ok.

Catatan: Setelah Anda menerapkan perubahan peran akun utama, mungkin ada penundaan sebelum perubahan diterapkan.

Mengontrol akses dengan konsol Google Cloud

Anda dapat mengontrol akses dengan setelan IAM. Lihat panduan memulai IAM untuk mengetahui petunjuk mendetail tentang cara menambahkan, mengedit, dan menghapus izin.

Menambahkan pengguna atau akun layanan ke project

Anda dapat memberikan izin kepada pengguna atau akun layanan dengan memberikan peran kepada mereka di project Google Cloud Anda. Pengguna ditambahkan dengan memberikan alamat email mereka. Akun layanan juga ditambahkan dengan memberikan alamat email terkait. Anda perlu menambahkan akun layanan jika ingin menggunakan satu akun layanan untuk beberapa project. Untuk menemukan alamat email yang terkait dengan akun layanan Anda, lihat halaman Service Accounts IAM di konsol Google Cloud .

Untuk menambahkan akun utama:

1. Klik tombol tambahkan di bagian atas halaman.
2. Masukkan alamat email akun utama.
3. Pilih peran.
4. Klik Simpan.

Ubah izin

1. Klik tombol edit untuk akun utama.
2. Pilih peran lain.
3. Klik Simpan.

Menghapus akun utama

1. Klik tombol hapus untuk akun utama.

Menambahkan kondisi untuk membatasi akses ke satu agen

Saat menambahkan atau mengedit akun utama, Anda dapat membuat kondisi IAM yang membatasi akses ke satu agen.

Catatan: Berikan peran agen ke email pengguna untuk akses konsol Dialogflow CX langsung di konsol Conversational Agents.

Contoh:

{
    "expression": "resource.name.startsWith(\"projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID\")",
    "title": "For Dialogflow CX Agent AGENT_ID"
}

Kondisi ini memberi Anda akses dasar ke agen tertentu. Misalnya, akun layanan dengan kondisi ini hanya dapat memanggil Dialogflow CX API untuk mengakses agen yang ditentukan dalam kondisi untuk project, tetapi tidak untuk agen lain dalam project.

Untuk menambahkan kondisi ini ke peran yang diberikan kepada akun utama:

1. Pilih akun utama.
2. Klik tombol edit untuk akun utama.
3. Klik Add condition.
4. Di kolom Title, masukkan For Dialogflow CX Agent AGENT_ID dan ganti AGENT_ID dengan ID agen Anda.
5. Anda dapat menambahkan deskripsi apa pun.
6. Pilih Editor kondisi untuk membuat kondisi Anda.
7. Tambahkan ekspresi resource.name.startsWith("projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID"), dengan mengganti AGENT_ID dengan ID agen Anda dan PROJECT_ID dengan project ID Anda.
8. Klik Simpan.

Peran IAM

Tabel berikut mencantumkan peran IAM umum yang relevan dengan Dialogflow CX. Ringkasan izin dalam tabel menggunakan istilah berikut:

• Akses penuh: Izin untuk mengubah akses, membuat, menghapus, mengedit, dan membaca resource apa pun.
• Akses edit: Izin untuk membuat, menghapus, mengedit, dan membaca resource apa pun.
• Akses sesi: Izin untuk memanggil metode bagi resource khusus runtime selama percakapan seperti mendeteksi intent, memperbarui konteks, memperbarui entity sesi, atau interaksi percakapan Agent Assist.
• Akses baca: Izin untuk membaca resource apa pun.

Catatan: Untuk mengubah akses agen, Anda memerlukan peran yang memberikan akses penuh ke agen. Untuk menghapus agen, Anda memerlukan peran yang memberikan akses penuh atau akses edit ke agen.

Catatan: Simulator konsol memanggil metode detectIntent API selama percakapan. Metode ini melakukan penulisan pada status sesi. Untuk menggunakan konsol atau memanggil metode detectIntent/streamingDetectIntent API, Anda memerlukan peran yang memberikan akses penuh, akses edit, atau akses sesi.

Peran IAM	Ringkasan Izin	Detail Izin
Project > Owner	Berikan kepada Project Owner yang memerlukan akses penuh ke semua resource Google Cloud dan Dialogflow CX: Akses penuh ke semua resource project Google Cloud menggunakan konsol atau API Google Cloud . Akses penuh ke agen menggunakan konsol Conversational Agents. Dapat mendeteksi intent menggunakan API.	Lihat definisi peran dasar IAM.
Project > Editor	Berikan kepada editor project yang memerlukan akses edit ke semua resource Google Cloud dan Dialogflow CX: Edit akses ke semua resource project Google Cloud menggunakan konsol atau API Google Cloud . Mengedit akses ke agen menggunakan konsol Conversational Agents. Dapat mendeteksi intent menggunakan API.	Lihat definisi peran dasar IAM.
Project > Viewer	Berikan kepada pelihat project yang memerlukan akses baca ke semua resource Google Cloud dan Dialogflow CX: Akses baca ke semua resource project Google Cloud menggunakan konsol atau API Google Cloud . Akses baca ke agen menggunakan konsol atau API Conversational Agents, tidak dapat menggunakan simulator. Tidak dapat mendeteksi intent menggunakan API.	Lihat definisi peran dasar IAM.
Project > IAM Admin	Berikan kepada admin IAM project yang memerlukan akses edit ke konfigurasi peran agen Dialogflow CX.	Lihat definisi peran resource manager IAM.
Project > Browser	Berikan kepada browser project yang memerlukan akses baca untuk menjelajahi hierarki dalam suatu project, termasuk folder, organisasi, dan kebijakan IAM: Akses baca ke hierarki project Google Cloud . Tidak ada akses ke agen yang menggunakan konsol Conversational Agents. Tidak dapat mendeteksi intent menggunakan API.	Lihat Definisi peran project IAM.
Dialogflow > Dialogflow API Admin	Berikan kepada admin Dialogflow CX API yang memerlukan akses penuh ke resource khusus Dialogflow CX: Akses penuh ke semua resource Dialogflow CX menggunakan konsol atau API Google Cloud . Akses penuh ke agen menggunakan konsol Conversational Agents. Dapat mendeteksi intent menggunakan API.	Lihat definisi peran IAM Dialogflow.
Dialogflow > Dialogflow API Client	Berikan kepada klien API Dialogflow CX yang melakukan panggilan deteksi intent menggunakan API: Akses sesi ke resource Dialogflow CX runtime menggunakan simulator atau API Dialogflow CX. Akses terbatas ke agen menggunakan konsol Conversational Agents. Dapat mendeteksi intent menggunakan API.	Lihat definisi peran IAM Dialogflow.
Dialogflow > Editor Agen konsol Conversational Agents	Berikan kepada editor konsol Conversational Agents yang mengedit agen yang ada: Akses penuh ke semua resource Dialogflow CX menggunakan konsol Google Cloud . Edit akses ke sebagian besar data agen menggunakan konsol Conversational Agents. Dapat mendeteksi intent menggunakan API.	Lihat definisi peran IAM Dialogflow.
Dialogflow > Dialogflow API Reader	Berikan kepada klien Dialogflow API yang melakukan panggilan hanya baca khusus Dialogflow CX menggunakan API: Akses baca ke semua resource Dialogflow CX menggunakan konsol atau API Google Cloud . Akses baca ke agen menggunakan konsol Conversational Agents, tidak dapat menggunakan simulator. Tidak dapat mendeteksi intent menggunakan API.	Lihat definisi peran IAM Dialogflow.
Discovery Engine Admin	Berikan kepada pengguna yang membuat agen penyimpanan data dengan antarmuka pengguna Vertex AI Agents.	Lihat definisi peran IAM Discovery Engine.

OAuth

Jika Anda menggunakan library klien Google untuk mengakses Dialogflow CX, Anda tidak perlu menggunakan OAuth secara langsung, karena library ini menangani implementasinya untuk Anda. Namun, jika Anda menerapkan klien Anda sendiri, Anda mungkin perlu menerapkan alur OAuth Anda sendiri. Akses ke Dialogflow CX API memerlukan salah satu cakupan OAuth berikut:

• https://www.googleapis.com/auth/cloud-platform (akses ke semua resource project)
• https://www.googleapis.com/auth/dialogflow (akses ke resource Dialogflow CX)

Permintaan yang melibatkan akses Cloud Storage

Beberapa permintaan Dialogflow CX mengakses objek di Cloud Storage untuk membaca atau menulis data. Saat Anda memanggil salah satu permintaan ini, Dialogflow CX akan mengakses data Cloud Storage atas nama pemanggil. Artinya, autentikasi permintaan Anda harus memiliki izin untuk mengakses Dialogflow CX serta objek Cloud Storage.

Saat menggunakan library klien Google dan peran IAM, lihat panduan kontrol akses Cloud Storage untuk mengetahui informasi tentang peran Cloud Storage.

Saat menerapkan klien Anda sendiri dan menggunakan OAuth, Anda harus menggunakan cakupan OAuth berikut:

• https://www.googleapis.com/auth/cloud-platform (akses ke semua resource project)

Peran khusus untuk akses alat playbook

Anda dapat memberikan kontrol akses terperinci untuk alat playbook menggunakan izin dan peran khusus.

Anda dapat mencantumkan izin yang tersedia dengan membuka alat penelusuran izin dan menelusuri dialogflow.tools.

Dengan menggunakan izin tersebut, Anda dapat membuat peran khusus.