Tutorial: Konfigurasikan Bpanda untuk provisi pengguna secara otomatis

Tutorial ini menjelaskan langkah-langkah yang perlu Anda lakukan di Bpanda dan MICROSOFT Entra ID untuk mengonfigurasi provisi pengguna otomatis. Saat dikonfigurasi, MICROSOFT Entra ID secara otomatis memprovisi dan mendeprovisi pengguna dan grup ke Bpanda 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.

Kapabilitas yang Didukung

• Buat pengguna di Bpanda
• Hapus pengguna di Bpanda saat mereka tidak memerlukan akses lagi
• Menjaga atribut pengguna tetap sinkron antara MICROSOFT Entra ID dan Bpanda
• Menyediakan akses anggota dan keanggotaan grup di Bpanda
• Masuk tunggal ke Bpanda (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.
• Ruang proses langganan cloud di Bpanda. Untuk lokal, lihat dokumentasi penginstalan kami.

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 Bpanda.

Langkah 2: Mengonfigurasi Bpanda untuk mendukung provisi dengan ID Microsoft Entra

1. Jangkau informasi support@mid.de selengkapnya tentang URL Penyewa autentikasi Anda.

2. Rahasia klien untuk menghasilkan token akses lebih lanjut. Rahasia ini pasti ditransmisikan kepada Anda dengan cara yang aman. Jangkau informasi support@mid.de lebih lanjut.

3. Untuk membuat koneksi yang berhasil antara MICROSOFT Entra ID dan Bpanda, token akses harus diambil dengan salah satu cara berikut.

• Gunakan perintah berikut ini di Linux

curl -u scim:{Your client secret} --location --request POST '{Your tenant specific authentication endpoint}/protocol/openid-connect/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials'

• atau perintah di PowerShell

$base64AuthInfo = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(("scim:{0}" -f {Your client secret})))    
$headers=@{}   
$headers.Add("Content-Type", "application/x-www-form-urlencoded")  
$headers.Add("Authorization", "Basic {0}" -f $base64AuthInfo)  
$response = Invoke-WebRequest -Uri "{Your tenant specific authentication endpoint}/protocol/openid-connect/token" -Method POST -Headers $headers -ContentType 'application/x-www-form-urlencoded' -Body 'grant_type=client_credentials' 

Nilai ini akan dimasukkan di bidang Token Rahasia di tab Provisi aplikasi Bpanda Anda.

Langkah 3: Tambahkan Bpanda dari galeri aplikasi Microsoft Entra

Tambahkan Bpanda dari galeri aplikasi Microsoft Entra untuk mulai mengelola provisi ke Bpanda. Jika sebelumnya Anda telah mengatur Bpanda 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 Bpanda

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

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

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

2. Telusuri aplikasi Identity>Applications>Enterprise

   

3. Di dalam daftar aplikasi, pilih Bpanda.

   

4. Pilih Provisi tab.

   

5. Atur Mode Provisi ke Otomatis.

   

6. Di bagian Kredensial Admin, masukkan URL Penyewa Bpanda Anda dalam format {Your authentication endpoint}/scim/v2 dan Token Rahasia. Klik Uji Koneksi untuk memastikan MICROSOFT Entra ID dapat tersambung ke Bpanda. Jika koneksi gagal, pastikan akun Bpanda Anda memiliki izin akses Admin, kemudian coba kembali.

   

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

   

8. Pilih Simpan.

9. Di bawah bagian Pemetaan , pilih Sinkronkan pengguna Microsoft Entra ke Bpanda.

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

    Atribut	Jenis	Didukung untuk Pemfilteran
    userName	String	✓
    active	Boolean
    displayName	String
    emails[type eq "work"].value	String
    name.givenName	String
    name.familyName	String
    phoneNumbers[type eq "work"].value	String
    phoneNumbers[type eq "mobile"].value	String
    externalId	String
    title	String
    preferredLanguage	String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department	String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:division	String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization	String

11. Di bawah bagian Pemetaan , pilih Sinkronkan grup Microsoft Entra ke Bpanda.

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

    Atribut	Jenis	Didukung untuk Pemfilteran
    displayName	String	✓
    externalId	String
    anggota	Referensi

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

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

    

15. Tentukan pengguna dan/atau grup yang ingin Anda provisikan ke Bpanda dengan memilih nilai yang diinginkan pada Cakupan di bagian Pengaturan.

    

16. Saat Anda siap untuk melakukan provisi, 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 dilakukan 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:

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

Sumber Daya Tambahan:

• 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