Kontrol akses

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

Catatan: Developer harus menghindari penggunaan agen yang sama pada waktu yang sama. Hal ini dapat menyebabkan konflik saat menyimpan dan melatih agen.

Jika Anda 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.

Anda dapat mengontrol akses menggunakan Identity and Access Management (IAM) atau Konsol Dialogflow.

Konsol Dialogflow menyediakan peran Admin Agen kepada pengguna yang membuat agen. Pengguna ini akan otomatis mendapatkan peran IAM Project Owner di project yang terkait dengan agen.

Admin Agen dapat menambahkan Developer dan Peninjau ke agen di Konsol Dialogflow. Saat peran Developer atau Peninjau diberikan di Konsol Dialogflow, pengguna akan mendapatkan peran IAM Project Editor atau IAM Project Viewer. Cara alternatif untuk menambahkan Developer dan Peninjau ke agen adalah dengan memberikan peran IAM Project Editor atau IAM Project Viewer yang sesuai kepada pengguna di konsol Google Cloud .

Ada beberapa situasi yang mengharuskan Anda menggunakan konsol Google Cloud :

• Jika Anda ingin mengubah Admin, menambahkan beberapa Admin untuk satu agen, atau menghapus Admin untuk agen, Anda harus menggunakan konsol Google Cloud .
• Jika Anda memiliki integrasi dengan Google Cloud resource lain, seperti Cloud Functions, dan Anda tidak ingin memberikan akses project penuh ke aplikasi, Anda harus menetapkan peran Dialogflow API (Admin, Klien, atau Pembaca) di konsol Google Cloud untuk IAM.
• Sebagian peran IAM memiliki peran Konsol Dialogflow yang sesuai. Jika Anda ingin memberikan peran yang tidak ada di Konsol Dialogflow, Anda harus menggunakan konsol Google Cloud .

Peran

Tabel berikut mencantumkan peran umum yang relevan dengan Dialogflow, korelasi antara peran Konsol Dialogflow dan peran IAM, serta detail tentang izin.

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 untuk resource hanya runtime selama percakapan seperti mendeteksi niat, memperbarui konteks, memperbarui entity sesi, atau interaksi percakapan Agent Assist. Akses ini memberikan subset izin yang ditemukan dalam akses penuh dan edit.
• 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 dengan konsol, Anda memerlukan peran yang memberikan akses penuh ke agen. Untuk menghapus agen dengan API, Anda memerlukan peran yang memberikan akses penuh atau akses edit ke agen.

Catatan: Simulator konsol memanggil metode API detectIntent 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 Konsol Dialogflow	Peran IAM	Ringkasan Izin	Detail Izin
Admin	Project > Pemilik	Berikan kepada pemilik project yang memerlukan akses penuh ke semua resource Google Cloud dan Dialogflow: Akses penuh ke semua resource project Google Cloud menggunakan konsol Google Cloud atau API. Akses penuh ke agen menggunakan Konsol Dialogflow. Dapat mendeteksi maksud menggunakan API. Dapat mengubah edisi agen di Konsol Dialogflow atau menggunakan API.	Lihat Definisi peran dasar IAM.
Developer	Project > Editor	Memberi editor project yang memerlukan akses edit ke semua Google Cloud dan resource Dialogflow: Mengedit akses ke semua resource project Google Cloud menggunakan Google Cloud konsol atau API. Mengedit akses ke agen menggunakan Konsol Dialogflow. Dapat mendeteksi maksud menggunakan API.	Lihat Definisi peran dasar IAM.
Reviewer	Project > Viewer	Berikan akses baca ke semua resource Dialogflow dan Google Cloud kepada pelihat project yang memerlukannya: Akses baca ke semua resource project Google Cloud menggunakan konsol Google Cloud atau API. Akses baca ke agen menggunakan Konsol atau API Dialogflow, tidak dapat menggunakan simulator. Tidak dapat mendeteksi maksud menggunakan API.	Lihat Definisi peran dasar IAM.
T/A	Project > Browser	Berikan kepada penjelajah project yang memerlukan akses baca untuk menelusuri hierarki dalam suatu project, termasuk folder, organisasi, dan kebijakan IAM: Akses baca ke hierarki project Google Cloud . Tidak ada akses ke agen menggunakan Konsol Dialogflow. Tidak dapat mendeteksi maksud menggunakan API.	Lihat Definisi peran project IAM.
T/A	Dialogflow > Dialogflow API Admin	Berikan kepada admin Dialogflow API yang memerlukan akses penuh ke resource khusus Dialogflow: Akses penuh ke semua resource Dialogflow menggunakan Google Cloud konsol atau API. Akses baca ke agen menggunakan Konsol Dialogflow. Dapat mendeteksi maksud menggunakan API.	Lihat Definisi peran IAM Dialogflow.
T/A	Dialogflow > Dialogflow API Client	Memberikan izin kepada klien Dialogflow API yang melakukan panggilan deteksi maksud menggunakan API: Akses sesi ke resource Dialogflow runtime menggunakan simulator atau API Dialogflow. Akses terbatas ke agen menggunakan Konsol Dialogflow. Dapat mendeteksi maksud menggunakan API.	Lihat Definisi peran IAM Dialogflow.
T/A	Dialogflow > Dialogflow Console Agent Editor	Memberi akses kepada editor Konsol Dialogflow yang mengedit agen yang ada: Akses penuh ke semua resource Dialogflow menggunakan konsol Google Cloud . Edit akses ke sebagian besar data agen menggunakan Konsol Dialogflow. Tidak dapat mengakses Editor Inline untuk integrasi Cloud Functions atau Asisten Google. Dapat mendeteksi maksud menggunakan API.	Lihat Definisi peran IAM Dialogflow.
T/A	Dialogflow > Dialogflow API Reader	Memberikan izin kepada klien Dialogflow API yang melakukan panggilan hanya baca khusus Dialogflow menggunakan API: Akses baca ke semua resource Dialogflow menggunakan Google Cloud konsol atau API. Akses baca ke agen menggunakan Konsol Dialogflow, tidak dapat menggunakan simulator. Tidak dapat mendeteksi maksud menggunakan API.	Lihat Definisi peran IAM Dialogflow.

Mengontrol akses dengan konsol Google Cloud

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

Untuk mengakses setelan di bawah, buka halaman IAM di konsol Google Cloud .

Menambahkan akun pengguna atau 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 terkaitnya. Anda perlu menambahkan anggota akun layanan jika ingin menggunakan satu akun layanan untuk beberapa project dan agen. Untuk menemukan alamat email yang terkait dengan akun layanan Anda, lihat halaman Service Accounts IAM di konsol Google Cloud .

Untuk menambahkan anggota:

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

Ubah izin

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

Menghapus anggota

1. Klik tombol hapus untuk anggota.

Mengontrol akses dengan Konsol Dialogflow

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

1. Buka konsol Dialogflow ES.
2. Pilih agen Anda di dekat bagian atas menu sidebar kiri.
3. Klik tombol setelan di samping nama agen.
4. Klik tab Bagikan. Jika Anda tidak melihat tab Bagikan, hal ini karena Anda tidak memiliki peran Admin Agen yang diperlukan.

Menambahkan pengguna

1. Masukkan alamat email pengguna di bagian Undang Orang Baru.
2. Pilih peran.
3. Klik Tambahkan.
4. Klik Simpan.

Ubah izin

1. Temukan pengguna dalam daftar.
2. Pilih peran lain.
3. Klik Simpan.

Menghapus pengguna

1. Temukan pengguna dalam daftar.

   Catatan: Jika pengguna tercantum dengan awalan deleted:user:, pengguna ini telah dihapus dari organisasi Anda. Konsol Dialogflow tidak dapat menghapus pengguna ini. Anda harus menggunakan Konsol Cloud untuk menghapus pengguna ini.

2. Klik tombol hapus untuk pengguna.

3. Klik Simpan.

Catatan: Setelah Anda memberikan atau mengubah izin, mungkin ada penundaan sebelum perubahan berlaku.

Akun layanan yang dibuat secara otomatis

Saat Anda membuat dan menggunakan agen, Dialogflow akan membuat beberapa agen layanan secara otomatis.

Untuk melihat peran yang diberikan kepada agen layanan ini, aktifkan opsi Sertakan pemberian peran yang disediakan Google di halaman IAM.

Anda tidak boleh menghapus, mengedit, atau mendownload kunci untuk agen layanan ini, dan Anda juga tidak boleh menggunakan agen layanan ini untuk melakukan panggilan API langsung. Kredensial ini hanya digunakan oleh layanan Dialogflow untuk terhubung ke berbagai layanan Google Cloud yang digunakan oleh agen Anda. Anda mungkin perlu merujuk agen layanan ini melalui email saat mengonfigurasi fitur Dialogflow tertentu.

Tabel berikut menjelaskan beberapa agen layanan ini:

Formulir email IAM	Tujuan
service-project-number @gcp-sa-dialogflow.iam.gserviceaccount.com	Digunakan untuk menghubungkan agen Anda ke layanan yang menangani traffic integrasi.
firebase-adminsdk-alphanum @project-id.iam.gserviceaccount.com	Digunakan untuk menghubungkan agen Anda ke layanan yang menangani traffic integrasi Asisten Google.
project-id @appspot.gserviceaccount.com	Digunakan untuk menghubungkan agen Anda ke layanan yang menangani traffic integrasi Asisten Google.

Mentransfer peran admin

Untuk mentransfer peran admin agen, admin yang ada harus mengikuti langkah-langkah di atas untuk menambahkan admin baru. Setelah admin baru menerima peran yang diberikan, admin lama dapat dihapus dengan aman.

Jika admin yang ada tidak lagi bekerja di organisasi Anda, dan Anda perlu mengalihkan peran admin kepada karyawan lain, Anda memiliki dua opsi:

• Administrator organisasi yang terkait dengan project agen memiliki izin untuk mengubah admin agen.
• Jika memiliki izin baca untuk agen, Anda dapat mengekspor agen dan mengimpornya ke agen tempat karyawan yang diinginkan menjadi admin. Hal ini dapat menyebabkan periode nonaktif untuk agen produksi aktif saat agen dimigrasikan dan integrasi diperbarui.

OAuth

Jika Anda menggunakan library klien Google untuk mengakses Dialogflow, Anda tidak perlu menggunakan OAuth secara langsung, karena library ini menangani implementasinya untuk Anda. Namun, jika Anda menerapkan klien sendiri, Anda mungkin perlu menerapkan alur OAuth Anda sendiri. Akses ke Dialogflow 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)

Permintaan yang melibatkan akses Cloud Storage

Beberapa permintaan Dialogflow mengakses objek di Cloud Storage untuk membaca atau menulis data. Saat Anda memanggil salah satu permintaan ini, Dialogflow akan mengakses data Cloud Storage atas nama pemanggil. Artinya, autentikasi permintaan Anda harus memiliki izin untuk mengakses Dialogflow 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)