Manual Administrator – Sinkronisasi Pengguna pada Directory Hub

PBI/Modul: Identity – Directory Hubs – Detail – Synchronizations
Versi Dokumen: 1.0
Tanggal: 05 Mei 2026
Aplikasi: IdProo
Ditujukan untuk: Administrator

Dalam artikel ini

Gambaran Umum
Melakukan Sinkronisasi Pengguna
Mengonfigurasi Organization Unit (OU)
Solusi Masalah yang Sering Ditemui

Gambaran Umum

Synchronizations pada halaman detail Directory Hub digunakan untuk menyinkronkan data pengguna dari Active Directory (AD) ke sistem IdProo (Identity Access Management). Proses sinkronisasi memastikan data pengguna di kedua sistem selalu mutakhir dan konsisten.

Fungsi utama tab ini:

Menyinkronkan pengguna dari Active Directory ke IdProo melalui tombol Sync User.
Menentukan apakah pengguna yang sudah ada akan diperbarui datanya selama proses sinkronisasi.
Mengonfigurasi unit organisasi (Organization Unit/OU) sebagai target default untuk pengguna dengan status berbeda (aktif, tidak terdefinisi, terhapus).

⚠️ Peringatan: Proses sinkronisasi akan membaca dan memperbarui data pengguna sesuai dengan kondisi terkini di Active Directory. Pastikan konfigurasi Rest API sudah benar dan koneksi ke AD berjalan normal sebelum memulai sinkronisasi.

1. Melakukan Sinkronisasi Pengguna

Alur Proses

Buka Synchronizations → (Opsional) Aktifkan Update exist Users → Klik Sync User

Langkah-Langkah

Pada panel navigasi kiri, klik menu Directory Hubs di bawah bagian IDENTITY.
Dari daftar Directory Hub, klik nama hub yang ingin disinkronkan.
Pada panel navigasi kiri halaman detail, klik Synchronizations di bawah bagian MANAGE.
Panel kanan akan menampilkan halaman Synchronizations.

Tab Synchronizations pada Halaman Detail Directory Hub

Gambar 1: Tab Synchronizations – sinkronisasi pengguna dan konfigurasi Organization Unit

Apabila ingin memperbarui data pengguna yang sudah ada di IdProo selama proses sinkronisasi, centang kotak Update exist Users.
Klik tombol Sync User untuk memulai proses sinkronisasi.
Sistem akan menyinkronkan data pengguna antara Active Directory dan IdProo.

Opsi Update exist Users

Kondisi	Keterangan
Tidak dicentang (default)	Hanya pengguna baru dari AD yang akan ditambahkan ke IdProo. Data pengguna yang sudah ada tidak akan diubah.
Dicentang	Seluruh pengguna dari AD akan disinkronkan, termasuk memperbarui data pengguna yang sudah terdaftar di IdProo sesuai dengan data terkini di AD.

Catatan: Centang opsi Update exist Users apabila terdapat perubahan data pada pengguna yang sudah ada di AD (misalnya nama, jabatan, atau unit organisasi) dan perubahan tersebut perlu diterapkan ke IdProo.

2. Mengonfigurasi Organization Unit (OU)

Bagian Organization unit digunakan untuk menentukan unit organisasi (OU) target default yang akan digunakan saat proses sinkronisasi untuk mengelompokkan pengguna berdasarkan statusnya.

Penjelasan Field Organization Unit

Field	Keterangan
User	Nama OU yang menjadi target pengelompokan pengguna aktif yang berhasil disinkronkan
Undefined	Nama OU yang menjadi target pengelompokan pengguna yang tidak dapat dikategorikan atau tidak memiliki unit organisasi terdefinisi
Deleted	Nama OU yang menjadi target pengelompokan pengguna yang telah dihapus dari Active Directory
Organization	Nama organisasi atau unit organisasi induk yang menjadi konteks sinkronisasi

Langkah-Langkah Mengubah Konfigurasi Organization Unit

Pada tab Synchronizations, gulir ke bawah hingga bagian Organization unit.
Perbarui nilai pada field User, Undefined, Deleted, dan/atau Organization sesuai dengan struktur organisasi yang diinginkan.
Klik tombol Save untuk menyimpan konfigurasi.

Catatan: Nilai pada setiap field dapat disalin dengan mengklik ikon salin (⎘) yang berada di sebelah kanan kolom input.

Tips: Pastikan nama OU yang dimasukkan sesuai dengan struktur Organizational Unit yang telah dikonfigurasi pada Active Directory. Nama yang tidak sesuai dapat menyebabkan pengguna tidak terkelompokkan dengan benar setelah sinkronisasi.

3. Solusi Masalah yang Sering Ditemui

Masalah	Kemungkinan Penyebab	Solusi
Tombol Sync User tidak merespons atau sinkronisasi gagal	Koneksi Rest API terputus atau belum dikonfigurasi dengan benar	Periksa konfigurasi Rest API pada tab Rest API dan pastikan koneksi ke server AD berjalan normal
Data pengguna yang sudah ada tidak diperbarui setelah sinkronisasi	Opsi Update exist Users tidak diaktifkan	Centang opsi Update exist Users sebelum menjalankan Sync User
Pengguna baru dari AD tidak muncul di IdProo setelah sinkronisasi	Izin Read pada Rest API tidak diaktifkan	Periksa konfigurasi Permissions pada tab Rest API dan pastikan izin Read sudah aktif
Pengguna dikelompokkan ke OU yang salah setelah sinkronisasi	Nilai Organization Unit tidak sesuai dengan struktur AD	Perbarui nilai field Organization Unit agar sesuai dengan nama OU yang ada di Active Directory, lalu simpan dan lakukan sinkronisasi ulang
Konfigurasi Organization Unit tidak tersimpan setelah klik Save	Koneksi jaringan terputus saat penyimpanan	Periksa koneksi jaringan, muat ulang halaman, dan coba simpan kembali