Mengonfigurasi Sistem Rhombus untuk provisi pengguna otomatis dengan MICROSOFT Entra ID

2025-05-20

Artikel ini menjelaskan langkah-langkah yang perlu Anda lakukan di Sistem Rhombus dan ID Microsoft Entra untuk mengonfigurasi provisi pengguna otomatis. Saat dikonfigurasi, MICROSOFT Entra ID secara otomatis memprovisi dan mendeprovisi pengguna ke Sistem Rhombus 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 Sistem Rhombus.
Hapus pengguna di Sistem Rhombus saat mereka tidak memerlukan akses lagi.
Menjaga atribut pengguna tetap sinkron antara ID Microsoft Entra dan Sistem Rhombus.
Akses menyeluruh ke Sistem Rhombus (disarankan).

Prasyarat

Skenario yang diuraikan dalam artikel 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 Sistem Rhombus dengan izin Admin.

Langkah 1: Rencanakan penyediaan layanan Anda

Pelajari tentang cara kerja layanan provisi.
Tentukan siapa yang masuk dalam cakupan penyediaan.
Tentukan data apa yang akan dipetakan antara ID Microsoft Entra dan Sistem Rhombus.

Langkah 2: Mengonfigurasi Sistem Rhombus untuk mendukung provisi dengan ID Microsoft Entra

Hubungi dukungan Sistem Rhombus untuk mengonfigurasi Sistem Rhombus untuk mendukung provisi dengan ID Microsoft Entra.

Langkah 3: Tambahkan Sistem Rhombus dari galeri aplikasi Microsoft Entra

Tambahkan Sistem Rhombus dari galeri aplikasi Microsoft Entra untuk mulai mengelola penyediaan ke Sistem Rhombus. Jika sebelumnya Anda telah mengatur Sistem Rhombus untuk SSO, Anda dapat menggunakan aplikasi yang sama. Namun disarankan agar Anda membuat aplikasi terpisah saat menguji integrasi pada awalnya. Pelajari selengkapnya tentang menambahkan aplikasi dari galeri di sini.

Langkah 4: Tentukan siapa yang berada dalam cakupan provisi

Layanan provisi Microsoft Entra memungkinkan Anda untuk mencakup siapa yang disediakan berdasarkan penugasan ke aplikasi, atau berdasarkan atribut pengguna atau grup. Jika Anda memilih untuk mencakup siapa yang diprovisikan ke aplikasi Anda berdasarkan penugasan, Anda dapat menggunakan langkah-langkah untuk menetapkan pengguna dan grup ke aplikasi. Jika Anda memilih untuk mencakup siapa yang disediakan hanya berdasarkan atribut pengguna atau grup, Anda dapat menggunakan filter cakupan.

Mulai dari yang kecil. Uji dengan sekumpulan kecil pengguna dan grup sebelum diluncurkan ke semua orang. Saat cakupan provisi diatur ke pengguna dan grup yang ditetapkan, Anda dapat mengontrolnya dengan menetapkan satu atau dua pengguna atau grup ke aplikasi. Saat cakupan diatur ke semua pengguna dan grup, Anda dapat menentukan filter cakupan berbasis atribut.
Jika Anda memerlukan peran tambahan, Anda dapat memperbarui manifes aplikasi untuk menambahkan peran baru.

Langkah 5: Mengonfigurasi provisi pengguna otomatis ke Sistem Rhombus

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

Untuk mengonfigurasi provisi pengguna otomatis untuk Sistem Rhombus di ID Microsoft Entra:

Masuk ke pusat admin Microsoft Entra sebagai setidaknya Administrator Aplikasi Cloud.
Telusuri ke aplikasi Entra ID>Enterprise
Dalam daftar aplikasi, pilih Sistem Rhombus.
Pilih tab Provisioning.
Atur Mode Penyediaan ke Otomatis.
Di bawah bagian Kredensial Admin, masukkan URL Penyewa Rhombus Systems dan Token Rahasia Anda. Pilih Uji Koneksi untuk memastikan ID Microsoft Entra dapat tersambung ke Sistem Rhombus. Jika koneksi gagal, pastikan akun Sistem Rhombus Anda memiliki izin Admin, lalu coba lagi.
Di bidang Email Pemberitahuan , masukkan alamat email seseorang yang harus menerima pemberitahuan kesalahan provisi dan pilih kotak centang Kirim pemberitahuan email saat kegagalan terjadi .
Pilih Simpan.
Di bawah bagian Pemetaan , pilih Sinkronkan pengguna Microsoft Entra ke Sistem Rhombus.

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

Karakteristik	Tipe	Didukung untuk pemfilteran	Diperlukan oleh Sistem Rhombus
userName	string	✓	✓
aktif	Boolean (tipe data yang hanya memiliki dua nilai: true atau false)		✓
namaDepan	string		✓
nama.keluarga	string		✓
peran[utama sama dengan "Ya"].nilai	string		✓

Untuk mengonfigurasi filter cakupan, lihat instruksi berikut yang disediakan dalam artikel Filter cakupan.
Untuk mengaktifkan layanan provisi Microsoft Entra untuk Sistem Rhombus, ubah Status Provisi menjadi Aktif di bagian Pengaturan .
Tentukan pengguna yang ingin Anda provisikan ke Sistem Rhombus dengan memilih nilai yang diinginkan dalam Cakupan di bagian Pengaturan .
Saat Anda siap untuk memprovisikan, pilih Simpan.

Operasi ini memulai siklus sinkronisasi awal semua pengguna 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 penyediaan, gunakan sumber daya berikut untuk memantau penyebaran Anda.

Gunakan log provisi untuk menentukan pengguna mana yang berhasil disediakan atau tidak berhasil
Periksa bilah kemajuan untuk melihat status siklus provisi dan seberapa dekat penyelesaiannya
Jika konfigurasi provisi tampaknya dalam keadaan tidak sehat, aplikasi masuk ke karantina. Pelajari lebih lanjut tentang status karantina penyediaan aplikasi di artikel status karantina .

Sumber daya lainnya

Pelajari cara meninjau log dan mendapatkan laporan tentang aktivitas provisi