Tutorial: Mengonfigurasi Zendesk untuk provisi pengguna otomatis
Tutorial ini menjelaskan langkah-langkah yang perlu Anda lakukan di Zendesk dan ID Microsoft Entra untuk mengonfigurasi provisi pengguna otomatis. Saat dikonfigurasi, MICROSOFT Entra ID secara otomatis memprovisi dan mendeprovisi pengguna dan grup ke Zendesk menggunakan layanan provisi Microsoft Entra. Untuk detail penting tentang apa yang dilakukan layanan ini, cara kerjanya, dan tanya jawab umum, lihat Mengotomatiskan provisi dan deprovisi pengguna ke aplikasi SaaS dengan ID Microsoft Entra.
Kemampuan yang didukung
- Buat pengguna di Zendesk.
- Hapus pengguna di Zendesk saat mereka tidak memerlukan akses lagi.
- Menjaga atribut pengguna tetap sinkron antara MICROSOFT Entra ID dan Zendesk.
- Memprovisikan grup dan keanggotaan grup di Zendesk.
- Akses menyeluruh ke Zendesk (disarankan )
Prasyarat
Skenario yang diuraikan dalam tutorial ini mengasumsikan bahwa Anda sudah memiliki prasyarat berikut:
- Penyewa Microsoft Entra.
- Salah satu peran berikut: Administrator Aplikasi, Administrator Aplikasi Cloud, atau Pemilik Aplikasi.
- Akun pengguna di Zendesk dengan hak Admin.
- Penyewa Zendesk dengan dukungan paket Profesional atau yang lebih baik.
Langkah 1: Merencanakan penyebaran provisi Anda
- Pelajari tentang Cara kerja layanan provisi .
- Tentukan siapa yang akan berada dalam cakupan untuk provisi.
- Tentukan data apa yang akan dipetakan antara ID Microsoft Entra dan Zendesk.
Langkah 2: Mengonfigurasi Zendesk untuk mendukung provisi dengan ID Microsoft Entra
- Masuk ke Pusat Admin Zendesk.
- Navigasikan ke API Zendesk Aplikasi dan integrasi>>.
- Klik tab Pengaturan, dan pastikan Akses Token diaktifkan.
- Klik tombol Tambahkan token API di sebelah kanan Token ACTIVE API. Token dihasilkan dan ditampilkan.
- Masukkan deskripsi token API.
- Salin token dan tempelkan di tempat yang aman. Setelah Anda menutup jendela ini, token penuh tidak akan pernah ditampilkan lagi.
- Klik Simpan untuk kembali ke halaman API. Jika Anda mengeklik token untuk membukanya kembali, versi token yang dipotong akan ditampilkan.
Langkah 3: Tambahkan Zendesk dari galeri aplikasi Microsoft Entra
Tambahkan Zendesk dari galeri aplikasi Microsoft Entra untuk mulai mengelola provisi ke Zendesk. Jika sebelumnya Anda telah menyiapkan Zendesk untuk SSO, Anda dapat menggunakan aplikasi yang sama. Namun, Anda disarankan agar membuat aplikasi terpisah ketika menguji integrasi pada awalnya. Pelajari selengkapnya tentang cara menambahkan aplikasi dari galeri di sini.
Langkah 4 : Tentukan siapa yang akan berada dalam cakupan provisi
Layanan provisi Microsoft Entra memungkinkan Anda untuk mencakup siapa yang akan disediakan berdasarkan penugasan ke aplikasi dan atau berdasarkan atribut pengguna /grup. Jika Anda memilih untuk mencakup siapa saja yang akan diprovisi ke aplikasi berdasarkan penugasan, Anda dapat mengikuti langkah-langkah berikut untuk menetapkan pengguna dan grup ke aplikasi. Jika Anda memilih untuk mencakup siapa saja yang akan diprovisikan hanya berdasarkan pada atribut pengguna atau grup, Anda dapat menggunakan filter cakupan seperti yang dijelaskan di sini.
Mulai dari yang kecil. Lakukan pengujian pada set kecil pengguna dan grup sebelum meluncurkan ke semua orang. Saat cakupan provisi diatur ke pengguna dan grup yang telah ditetapkan, Anda dapat mengontrolnya dengan menetapkan satu atau dua pengguna atau grup ke aplikasi. Ketika cakupan diatur ke semua pengguna dan grup, Anda dapat menentukan filter cakupan berbasis atribut.
Jika Anda membutuhkan peran tambahan, Anda dapat memperbarui manifes aplikasi untuk menambahkan peran baru.
Langkah 5: Mengonfigurasi provisi pengguna otomatis ke Zendesk
Bagian ini memandu Anda melalui langkah-langkah untuk mengonfigurasi layanan provisi Microsoft Entra untuk membuat, memperbarui, dan menonaktifkan pengguna dan/atau grup di Zendesk berdasarkan penetapan pengguna dan/atau grup di ID Microsoft Entra.
Tip penting untuk menetapkan pengguna ke Zendesk
Saat ini, peran Zendesk diisi secara otomatis dan dinamis di UI portal Azure. Sebelum Anda menetapkan peran Zendesk kepada pengguna, pastikan bahwa sinkronisasi awal telah selesai terhadap Zendesk untuk mengambil peran terbaru dalam penyewa Zendesk Anda.
Kami menyarankan agar Anda menetapkan satu pengguna Microsoft Entra ke Zendesk untuk menguji konfigurasi provisi pengguna otomatis awal Anda. Anda dapat menetapkan pengguna atau grup tambahan nanti setelah pengujian berhasil.
Saat Anda menetapkan pengguna ke Zendesk, pilih peran khusus aplikasi yang valid, jika tersedia, dalam kotak dialog tugas. Pengguna dengan peran Akses Default dikecualikan dari provisi.
Mengonfigurasi provisi pengguna otomatis untuk Zendesk di MICROSOFT Entra ID
Masuk ke pusat admin Microsoft Entra sebagai setidaknya Administrator Aplikasi Cloud.
Telusuri aplikasi Identity>Applications>Enterprise
Dalam daftar aplikasi, pilih Zendesk.
Pilih Provisi tab.
Atur Mode Provisi ke Otomatis.
Pada bagian Kredensial Admin, masukkan nama pengguna admin, token rahasia, dan domain akun Zendesk Anda. Contoh nilai-nilai ini adalah:
Dalam kotak Nama Pengguna Admin, isi nama pengguna akun admin di penyewa Zendesk Anda. Contohnya admin@contoso.com.
Dalam kotak Token Rahasia, isi token rahasia seperti yang dijelaskan di Langkah 6.
Dalam kotak Domain, isi subdomain penyewa Zendesk Anda. Misalnya, untuk akun dengan URL penyewa
https://my-tenant.zendesk.com, subdomain Anda adalah penyewa-saya.
Token rahasia untuk akun Zendesk Anda dapat dihasilkan dengan mengikuti langkah-langkah yang disebutkan pada Langkah 2 di atas.
Setelah Anda mengisi kotak yang diperlihatkan di Langkah 5, pilih Uji Koneksi ion untuk memastikan bahwa ID Microsoft Entra dapat tersambung ke Zendesk. Jika koneksi gagal, pastikan akun Zendesk Anda memiliki izin admin lalu coba lagi.
Dalam kotak Email Pemberitahuan, masukkan alamat email seseorang atau grup yang seharusnya menerima pemberitahuan kesalahan provisi. Pilih kotak centang Kirim pemberitahuan surel saat kegagalan terjadi.
Pilih Simpan.
Di bawah bagian Pemetaan , pilih Sinkronkan pengguna Microsoft Entra ke Zendesk.
Tinjau atribut pengguna yang disinkronkan dari ID Microsoft Entra ke Zendesk di bagian Pemetaan Atribut. Atribut yang dipilih sebagai properti Pencocokan digunakan untuk mencocokkan akun pengguna di Zendesk untuk operasi pembaruan. Pilih Simpan untuk menyimpan setiap perubahan.
Di bawah bagian Pemetaan , pilih Sinkronkan grup Microsoft Entra ke Zendesk.
Tinjau atribut grup yang disinkronkan dari ID Microsoft Entra ke Zendesk di bagian Pemetaan Atribut. Atribut yang dipilih sebagai properti Pencocokan digunakan untuk mencocokkan akun pengguna di Zendesk untuk operasi pembaruan. Pilih Simpan untuk menyimpan setiap perubahan.
Untuk mengonfigurasikan filter pencakupan, ikuti instruksi dalam tutorial filter pencakupan.
Untuk mengaktifkan layanan provisi Microsoft Entra untuk Zendesk, di bagian Pengaturan, ubah Status Provisi menjadi Aktif.
Tentukan pengguna atau grup yang ingin Anda provisikan ke Zendesk. Di bagian Pengaturan, pilih nilai yang Anda inginkan dalam Cakupan.
Setelah Anda siap memprovisi, pilih Simpan.
Operasi ini memulai sinkronisasi awal dari semua pengguna atau grup yang ditentukan di Cakupan pada bagian Pengaturan . Sinkronisasi awal membutuhkan waktu lebih lama untuk dilakukan daripada sinkronisasi berikutnya. Mereka terjadi sekitar setiap 40 menit selama layanan provisi Microsoft Entra berjalan.
Gunakan bagian Detail Sinkronisasi untuk memantau kemajuan dan mengikuti tautan ke laporan aktivitas provisi. Laporan ini menjelaskan semua tindakan yang dilakukan oleh layanan provisi Microsoft Entra di Zendesk.
Untuk informasi tentang cara membaca log provisi Microsoft Entra, lihat Pelaporan tentang provisi akun pengguna otomatis.
Batasan konektor
Zendesk mendukung penggunaan grup hanya untuk pengguna dengan peran Agen. Untuk informasi selengkapnya, lihat dokumentasi Zendesk.
Saat peran kustom ditetapkan ke pengguna atau grup, layanan provisi pengguna otomatis Microsoft Entra juga menetapkan peran default Agent. Hanya Agen yang dapat diberi peran kustom. Untuk informasi selengkapnya, lihat dokumentasi Zendesk API.
Impor semua peran akan gagal jika salah satu peran kustom memiliki nama tampilan yang mirip dengan peran bawaan "agen" atau "pengguna akhir". Untuk menghindari hal ini, pastikan bahwa tidak ada peran kustom yang diimpor memiliki nama tampilan di atas.
Sumber daya lainnya
- Mengelola provisi akun pengguna untuk Aplikasi Perusahaan
- Apa itu akses aplikasi dan akses menyeluruh dengan MICROSOFT Entra ID?