Tutorial: Mengonfigurasi Cerby untuk provisi pengguna otomatis

Tutorial ini menjelaskan langkah-langkah yang perlu Anda lakukan di Cerby dan ID Microsoft Entra untuk mengonfigurasi provisi pengguna otomatis. Saat dikonfigurasi, ID Microsoft Entra secara otomatis memprovisikan dan mendeprovisi pengguna dan grup ke Cerby 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 dalam Cerby
• Menghapus pengguna di Cerby saat mereka tidak memerlukan akses lagi
• Menjaga atribut pengguna tetap sinkron antara MICROSOFT Entra ID dan Cerby
• Memprovisikan grup dan keanggotaan grup di Cerby.
• Akses menyeluruh ke Cerby (disarankan).

Prasyarat

Skenario yang diuraikan dalam tutorial ini mengasumsikan bahwa Anda sudah memiliki prasyarat berikut:

• Penyewa Microsoft Entra
• Akun pengguna di MICROSOFT Entra ID dengan izin untuk mengonfigurasi provisi (misalnya, Administrator Aplikasi, Administrator Aplikasi Cloud, Pemilik Aplikasi, atau Administrator Global).
• Akun pengguna di Cerby dengan peran Pemilik Ruang Kerja.
• Integrasi berbasis Cerby SAML2 harus disiapkan. Ikuti instruksi di artikel Cara Mengonfigurasi Aplikasi SAML Cerby App Gallery dengan penyewa Microsoft Entra Anda untuk menyiapkan integrasi.

Langkah 1: Merencanakan penyebaran provisi Anda

1. Pelajari tentang Cara kerja layanan provisi .
2. Tentukan siapa yang akan berada dalam cakupan untuk provisi.
3. Tentukan data apa yang akan dipetakan antara ID Microsoft Entra dan Cerby.

Langkah 2: Mengonfigurasi Cerby untuk mendukung provisi dengan MICROSOFT Entra ID

Cerby telah diaktifkan secara default dukungan provisi untuk ID Microsoft Entra. Anda hanya boleh mengambil token autentikasi SCIM API dengan menyelesaikan langkah-langkah berikut:

1. Masuk ke ruang kerja Cerby yang sesuai.

2. Klik tombol Hi there < user >! yang terletak di bagian bawah menu navigasi sisi kiri. Menu drop-down ditampilkan.

3. Pilih opsi Konfigurasi Ruang Kerja yang terkait dengan akun Anda dari menu drop-down. Halaman Konfigurasi Ruang Kerja ditampilkan.

4. Aktifkan tab Pengaturan IDP.

5. Klik tombol Tampilkan Token yang terletak di bagian Directory Sync pada tab Pengaturan IDP. Jendela pop-up ditampilkan menunggu untuk mengonfirmasi identitas Anda, dan pemberitahuan push dikirim ke aplikasi seluler Cerby Anda. PENTING: Untuk mengonfirmasi identitas Anda, Anda harus telah memasang dan masuk ke aplikasi seluler Cerby untuk menerima pemberitahuan push.

6. Klik tombol It’s me! di layar Permintaan Konfirmasi aplikasi seluler Cerby Anda untuk mengonfirmasi identitas Anda. Jendela pop-up di ruang kerja Cerby Anda ditutup, dan jendela pop-up Tampilkan Token ditampilkan.

7. Klik tombol Salin untuk menyalin token SCIM ke clipboard.

   Tip

   Biarkan jendela pop-up Tampilkan Token terbuka untuk menyalin token kapan saja. Anda memerlukan token untuk mengonfigurasi provisi dengan ID Microsoft Entra.

Langkah 3: Tambahkan Cerby dari galeri aplikasi Microsoft Entra

Tambahkan Cerby dari galeri aplikasi Microsoft Entra untuk mulai mengelola provisi ke Cerby. Jika sebelumnya Anda telah mengatur Cerby untuk SSO, Anda dapat menggunakan aplikasi yang sama. Tetapi, sebaiknya Anda membuat aplikasi terpisah saat 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 dan 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 Cerby

Bagian ini memandu Anda melalui langkah-langkah untuk mengonfigurasi layanan provisi Microsoft Entra untuk membuat, memperbarui, dan menonaktifkan pengguna dan grup di Cerby berdasarkan penetapan pengguna dan grup di ID Microsoft Entra.

Untuk mengonfigurasi provisi pengguna otomatis untuk Cerby di MICROSOFT Entra ID:

1. Masuk ke pusat admin Microsoft Entra sebagai setidaknya Administrator Aplikasi Cloud.

2. Telusuri aplikasi Identity>Applications>Enterprise

   

3. Dalam daftar aplikasi, pilih Cerby.

   

4. Pilih Provisi tab.

   

5. Atur Mode Provisi ke Otomatis.

   

6. Di bagian kredensial Admin, masukkan https://api.cerby.com/v1/scim/v2 sebagai URL Penyewa Cerby dan token autentikasi API SCIM yang sebelumnya telah Anda ambil.

7. Klik Uji Koneksi ion untuk memastikan MICROSOFT Entra ID dapat tersambung ke Cerby. Jika sambungan gagal, pastikan akun Cerby Anda memiliki izin Admin dan coba kembali.

   

8. Di bidang Surel Pemberitahuan, masukkan alamat surel seseorang atau grup penerima pemberitahuan kesalahan provisi dan pilih kotak centang Kirim pemberitahuan surel ketika kegagalan terjadi.

   

9. Pilih Simpan.

10. Di bagian Pemetaan , pilih Sinkronkan pengguna Microsoft Entra ke Cerby.

11. Tinjau atribut pengguna yang disinkronkan dari ID Microsoft Entra ke Cerby di bagian Pemetaan Atribut. Atribut yang dipilih sebagai properti Pencocokan digunakan untuk mencocokkan akun pengguna pada Cerby untuk operasi pembaruan. Jika Anda memilih untuk mengubah atribut target yang cocok, Anda harus memastikan bahwa API Cerby mendukung pemfilteran pengguna berdasarkan atribut tersebut. Pilih tombol Simpan untuk menerapkan perubahan apa pun.

    Atribut	Jenis	Didukung untuk pemfilteran	Diperlukan oleh Cerby
    userName	String	✓	✓
    emails[type eq "work"].value	String	✓	✓
    active	Boolean		✓
    name.givenName	String		✓
    name.familyName	String		✓
    externalId	String

12. Di bawah bagian Pemetaan , pilih Sinkronkan grup Microsoft Entra ke Cerby.

13. Tinjau atribut grup yang disinkronkan dari ID Microsoft Entra ke Cerby di bagian Pemetaan Atribut. Atribut yang dipilih sebagai properti Pencocokan digunakan untuk mencocokkan grup di Cerby untuk operasi pembaruan. Pilih tombol Simpan untuk menerapkan perubahan apa pun.

    Atribut	Jenis	Didukung untuk pemfilteran	Diperlukan oleh Cerby
    displayName	String	✓	✓
    externalId	String
    anggota	Referensi

14. Untuk mengonfigurasi filter cakupan, lihat instruksi berikut yang disediakan dalam Tutorial filter cakupan.

15. Untuk mengaktifkan layanan provisi Microsoft Entra untuk Cerby, ubah Status Provisi menjadi Aktif di bagian Pengaturan.

    

16. Tentukan pengguna dan grup yang ingin Anda provisikan ke Cerby dengan memilih nilai yang diinginkan di Cakupan di bagian Pengaturan.

    

17. Ketika Anda siap untuk memprovisi, klik Simpan.

    

Operasi ini memulai siklus sinkronisasi awal semua pengguna dan grup yang ditentukan dalam Cakupan di bagian Pengaturan. Siklus awal membutuhkan waktu lebih lama untuk diselesaikan daripada siklus berikutnya, yang terjadi sekitar setiap 40 menit selama layanan provisi Microsoft Entra berjalan.

Langkah 6: Memantau penyebaran Anda

Setelah Anda mengonfigurasi provisi, gunakan sumber daya berikut untuk memantau penyebaran Anda:

• Gunakan log provisi untuk menentukan pengguna mana yang telah berhasil atau gagal diprovisi
• Periksa bilah progres untuk melihat status siklus provisi dan seberapa lama penyelesaiannya
• Jika konfigurasi provisi tampaknya dalam keadaan buruk, aplikasi akan masuk ke karantina. Pelajari selengkapnya status karantina di sini.

Tips Pemecahan Masalah

Jika Anda perlu meregenerasi token autentikasi API SCIM, selesaikan langkah-langkah berikut:

1. Kirim email dengan permintaan Anda ke Tim Dukungan Cerby. Tim Cerby meregenerasi token autentikasi API SCIM.

2. Terima email respons dari Cerby untuk mengonfirmasi bahwa token berhasil diregenerasi.

3. Selesaikan instruksi dari artikel Cara Mengambil Token Autentikasi API SCIM dari Cerby untuk mengambil token baru.

   Catatan

   Tim Cerby saat ini sedang mengembangkan solusi layanan mandiri untuk meregenerasi token autentikasi API SCIM. Untuk meregenerasi token, anggota tim Cerby harus memvalidasi identitas mereka.

Log Perubahan 

• 01/02/2024 - Menambahkan dukungan untuk Provisi Grup.

Sumber daya lainnya

• Mengelola provisi akun pengguna untuk Aplikasi Perusahaan
• Apa itu akses aplikasi dan akses menyeluruh dengan MICROSOFT Entra ID?

Langkah berikutnya

• Mempelajari cara mengulas log dan mendapatkan laporan tentang aktivitas provisi