View a markdown version of this page

Aktifkan otentikasi pelanggan untuk widget komunikasi yang dihosting - Pelanggan Amazon Connect
Kebijakan IAM yang diperlukanAktifkan otentikasi pelanggan di instans AndaAktifkan pesan otentikasi

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Aktifkan otentikasi pelanggan untuk widget komunikasi yang dihosting

Topik ini menjelaskan cara mengatur autentikasi jika Anda menggunakan widget komunikasi yang dihosting Connect Customer untuk obrolan. Anda mengaktifkan autentikasi pelanggan untuk instans Connect Customer, lalu mengaktifkan pesan autentikasi yang menampilkan tautan yang membuka popup ke UI yang dihosting Amazon Cognito.

Kebijakan IAM yang diperlukan

Jika Anda menggunakan kebijakan IAM khusus untuk mengelola akses ke konsol Connect Customer, lihat daftar izin yang diperlukan Izin yang diperlukan untuk kebijakan IAM kustom untuk mengakses halaman autentikasi Pelanggan.

Aktifkan autentikasi pelanggan di instans Connect Customer

  1. Buka konsol Connect Customer di https://console.aws.amazon.com/connect/.

  2. Pada halaman instance, pilih alias instance. Alias instance juga merupakan nama instans Anda, yang muncul di URL Connect Customer Anda. Gambar berikut menunjukkan halaman instance pusat kontak virtual Connect Customer, dengan kotak di sekitar alias instance.

    Halaman instans pusat kontak virtual Connect Customer, alias instance.

  3. Pada menu navigasi sebelah kiri, pilih Applications, Customer Authentication. Jika Anda tidak melihat opsi ini, opsi ini mungkin tidak tersedia di AWS Wilayah Anda. Untuk informasi tentang tempat otentikasi pelanggan tersedia, lihatKetersediaan otentikasi pelanggan menurut Wilayah.

  4. Pada halaman otentikasi pelanggan, pilih Buat kumpulan pengguna di Amazon Cognito. Ini membuka konsol Amazon Cognito.

  5. Buat kumpulan pengguna baru dengan penyedia identitas Anda. Untuk petunjuknya, lihat Memulai kumpulan pengguna di Panduan Pengembang Amazon Cognito.

    catatan

    Anda harus memilih Jangan buat rahasia klien saat mengonfigurasi klien aplikasi Amazon Cognito Anda. Hanya klien aplikasi Amazon Cognito tanpa rahasia klien yang didukung. Untuk informasi selengkapnya, lihat Application-specific pengaturan dengan klien aplikasi di Panduan Pengembang Amazon Cognito.

  6. Setelah Anda membuat kumpulan pengguna Amazon Cognito, kembali ke halaman otentikasi Pelanggan dan pilih Kumpulan Pengguna Rekanan.

  7. Di bagian User Pool, pilih kumpulan pengguna yang Anda buat dari menu tarik-turun, lalu pilih Konfirmasi.

    Ini mengaitkan kumpulan pengguna ke instans Connect Customer Anda. Ini memungkinkan blok Otentikasi Pelanggan aliran untuk mengakses kumpulan pengguna.

  8. Lanjutkan ke langkah berikutnya:Aktifkan pesan otentikasi.

Aktifkan pesan otentikasi

Untuk mengaktifkan pesan otentikasi, tambahkan variabel cuplikan parameter otentikasi di akhir cuplikan Anda. Untuk informasi tentang menambahkan variabel cuplikan, lihat. Bidang cuplikan widget yang didukung di Connect Customer yang dapat disesuaikan Kode berikut adalah contoh cuplikan parameter otentikasi yang perlu Anda tambahkan.

amazon_connect('authenticationParameters', { 
    redirectUri: 'your_redirect_url', // https://example.com 
    identityProvider: 'your_identity_provider_name' //optional
 });

Di mana:

  • redirectUriadalah URI pengalihan yang Anda konfigurasikan di IDP (Penyedia Identitas) dan Amazon Cognito. Di sinilah pelanggan Anda diarahkan secara otomatis setelah masuk. Di halaman ini Anda dapat memeriksa parameter URL dan jika ada kode dan status, Anda dapat memanggil UpdateParticipantAuthenticationAPI dengan nilai-nilai tersebut. Setelah panggilan API selesai, tutup popup; pelanggan dikembalikan ke pengalaman obrolan.

  • identityProvideradalah nama penyedia identitas yang Anda konfigurasikan di Amazon Cognito. Ini adalah bidang opsional. Jika nilai diberikan, maka tautan masuk secara otomatis mengarahkan pelanggan ke halaman login penyedia identitas alih-alih ke halaman Cognito-managed login Amazon di mana mereka harus memilih penyedia identitas yang akan digunakan untuk login.

Saat alur mencapai Otentikasi Pelanggan blok, Anda dapat mendaftarkan callback dan menyimpan status secara lokal untuk memvalidasi dalam URI pengalihan, seperti yang ditunjukkan dalam contoh cuplikan kode berikut:

amazon_connect('registerCallback', {
       'AUTHENTICATION_INITIATED' : (eventName, data) => {
            console.log(data.state)
        },
      });

Setelah Anda mengaktifkan otentikasi pelanggan, tambahkan Otentikasi Pelanggan blok ke alur Anda. Blok ini mengautentikasi kontak obrolan selama alur, dan merutekan mereka ke jalur tertentu berdasarkan hasil otentikasi.