Bagikan melalui

Mengaktifkan autentikasi pengguna di Copilot Studio Kit

Copilot Studio Kit mendukung pengujian agen kustom dengan autentikasi pengguna saat Anda menggunakan Entra ID v2 sebagai penyedia layanan dengan SSO diaktifkan. Singkatnya, Anda membuat dan mengonfigurasi aplikasi yang diperlukan di portal Microsoft Azure lalu membuat konfigurasi agen di Copilot Studio Kit.

Untuk mengaktifkan autentikasi pengguna di Copilot Studio Kit:

  • Buat pendaftaran aplikasi khusus untuk tujuan autentikasi Copilot Studio Kit.
  • Buat pendaftaran aplikasi untuk autentikasi Copilot Studio.
  • Aktifkan autentikasi untuk agen Copilot Studio.
  • Buat konfigurasi agen di Copilot Studio Kit dengan autentikasi pengguna akhir diaktifkan.
  • Tautkan aplikasi sehingga Copilot Studio Kit dapat mengautentikasi ke Direct Line menggunakan autentikasi Copilot Studio.

Prasyarat

  • Instal Copilot Studio Kit jika Anda belum melakukannya.
  • Memiliki izin yang sesuai di penyewa Azure Active Directory Anda untuk membuat pendaftaran aplikasi.

Sebaiknya gunakan nilai berikut dalam langkah-langkah konfigurasi berikut:

  • Aplikasi autentikasi Copilot Studio Kit: KitAuthApp
  • Aplikasi autentikasi Copilot Studio: CopilotStudioAuthApp
  • Cakupan Copilot Studio: copilot.studio.scope

Membuat aplikasi autentikasi untuk Copilot Studio Kit

Untuk membuat aplikasi autentikasi untuk Copilot Studio Kit, ikuti langkah-langkah dalam Membuat pendaftaran aplikasi di ID Microsoft Entra untuk kanvas kustom Anda. Perhatikan langkah-langkah tambahan.

Anda perlu:

  1. Buat pendaftaran aplikasi di ID Microsoft Entra.

    (Disarankan) Beri nama aplikasi baru KitAuthApp.

    Selama proses pendaftaran, perhatikan ID Direktori (penyewa) dan ID Aplikasi (klien). Anda memerlukan nilai-nilai ini nanti saat membuat pendaftaran agen di Copilot Studio Kit dan mengaitkan Copilot Studio dengan aplikasi Copilot Studio Kit. Anda selalu bisa mendapatkan ID ini dari halaman Gambaran Umum untuk pendaftaran aplikasi.

  2. Menambahkan URL pengalihan

    Pastikan untuk mengarahkan ke URL lingkungan Dataverse Anda; misalnya https://<hostname>.crm.dynamics.com

  3. Sebagai langkah tambahan, buka Sertifikat & rahasia dan buat rahasia Klien baru.

    (Disarankan) Beri nama rahasia KitAuthApp.

    Simpan nilai rahasia ini dalam file sementara yang aman. Anda memerlukannya saat mengonfigurasi autentikasi agen Anda nanti.

  4. Dari izin API, pilih Berikan persetujuan admin untuk <nama> penyewa Anda, lalu pilih Ya. Jika tombol tidak tersedia, Anda mungkin perlu meminta administrator penyewa untuk memasukkannya untuk Anda.

Membuat aplikasi autentikasi untuk Copilot Studio

Untuk membuat aplikasi autentikasi untuk Copilot Studio, ikuti langkah-langkah dalam Mengonfigurasi autentikasi pengguna dengan ID Microsoft Entra.

Perhatikan langkah-langkah tambahan yang direkomendasikan .

Saat membuat pendaftaran aplikasi:

  • Beri nama aplikasi baru CopilotStudioAuthApp.

  • Di bawah Jenis akun yang didukung, pilih Akun di penyewa organisasi apa pun (direktori ID Microsoft Entra apa pun - multipenyewa) dan akun Microsoft pribadi (misalnya, Skype, Xbox).

  • Perhatikan ID Direktori (penyewa) dan ID Aplikasi (klien). Anda memerlukan nilai-nilai ini nanti saat mengaktifkan autentikasi pengguna akhir di Copilot Studio. Anda selalu bisa mendapatkan ID ini dari halaman Gambaran Umum untuk pendaftaran aplikasi.

Ketika mengonfigurasikan autentikasi manual:

  • Gunakan rahasia klien daripada kredensial federasi. Catat nilai rahasia Klien . Simpan dalam file sementara yang aman. Anda memerlukannya nanti saat mengaktifkan autentikasi pengguna akhir di Copilot Studio.

Saat menentukan cakupan kustom untuk agen Anda:

  • (Disarankan) Untuk Nama cakupan, gunakan copilot.studio.scope.

  • Perhatikan nama cakupan lengkap di bawah Scopes (format mirip dengan api://xxx/copilot.studio.scope). Anda memerlukan nilai ini nanti saat mengaktifkan autentikasi pengguna akhir di Copilot Studio.

  • Selesaikan langkah-langkah tambahan ini:

    1. Pilih Tambahkan aplikasi klien.
    2. Di ID Klien, masukkan ID Klien KitAuthApp yang Anda buat sebelumnya.
    3. Verifikasi bahwa cakupan di Cakupan Resmi adalah yang Anda buat sebelumnya (copilot.studio.scope). Aktifkan periksa cakupan tersebut.
    4. Pilih Tambahkan aplikasi.

Mengaktifkan autentikasi pengguna akhir pada agen kustom Anda

Untuk mengaktifkan autentikasi pengguna akhir untuk agen kustom Anda, ikuti langkah-langkah berikut:

  1. Di Copilot Studio, di bawah Pengaturan, pilih Keamanan > Autentikasi.
  2. Pilih Autentikasi secara manual.
  3. Biarkan aktif Mengharuskan pengguna untuk masuk.
  4. Jangan ubah URL Pengalihan. Pastikan penyedia Layanan adalah Azure Active Directory v2.
  5. Untuk ID Klien, masukkan ID Klien dari CopilotStudioAuthApp.
  6. Untuk Rahasia klien, masukkan Rahasia klien yang dibuat untuk CopilotStudioAuthApp.
  7. Di URL pertukaran token, masukkan nama lengkap cakupan (dengan format yang mirip api://xxx/copilot.studio.scope) yang dibuat untuk CopilotStudioAuthApp.
  8. (Opsional, diperlukan untuk sumber pengetahuan SharePoint) Pada Cakupan, tambahkan Files.Read.All.
  9. (Opsional, diperlukan untuk sumber pengetahuan SharePoint) Dalam Cakupan, tambahkan Sites.Read.All.
  10. Pilih Simpan, lalu pilih Simpan lagi dalam dialog.
  11. Tutup Pengaturan.
  12. Pilih Terbitkan, lalu pilih Terbitkan lagi dalam dialog.

Membuat konfigurasi agen dengan autentikasi pengguna akhir diaktifkan

Untuk membuat konfigurasi agen dengan autentikasi pengguna akhir diaktifkan, ikuti langkah-langkah berikut:

  1. Buka Copilot Studio Kit.
  2. Pilih Agen dari navigasi.
  3. Pilih Baru.
  4. Masukkan nama .
  5. Dari Jenis Konfigurasi, pilih Uji Otomatisasi.
  6. Isi Pengaturan Direct Line. Aktifkan Keamanan Saluran dan masukkan rahasia Direct Line.
  7. Untuk Autentikasi Pengguna, pilih Entra ID v2.
  8. Untuk ID Klien, masukkan ID Klien KitAuthApp.
  9. Untuk ID Penyewa, masukkan ID Direktori KitAuthApp.
  10. Untuk Cakupan, masukkan nama cakupan lengkap (format mirip dengan api://xxx/copilot.studio.scope) yang dibuat untuk CopilotStudioAuthApp.
  11. Pilih Simpan & Tutup.

Anda sekarang siap untuk menguji agen Anda dengan autentikasi pengguna akhir diaktifkan.

  • Last updated on