id›Guides›Use Cases›Ldap Integration

Integrasi LDAP

Panduan ini menjelaskan cara mengintegrasikan NQRust-Identity dengan server direktori LDAP (misalnya OpenLDAP atau Active Directory). Setelah menyelesaikan tutorial ini, pengguna dari direktori LDAP dapat melakukan autentikasi melalui NQRust-Identity.

Prasyarat

NQRust-Identity sudah terinstal dan berjalan. Lihat Fase 1: Instalasi Identity.
Server LDAP dapat dijangkau dari host NQRust-Identity.
Anda memiliki detail koneksi LDAP: host, port, bind DN, dan kredensial bind.
Akses Admin Console di https://<host-anda>:<port>/auth/admin.

Langkah 1: Buka pengaturan User Federation

Navigasi ke User Federation

Login ke Admin Console.
Pilih realm target dari dropdown di pojok kiri atas.
Di sidebar kiri, klik User Federation.

Tambahkan provider LDAP

Klik Add provider dan pilih ldap dari dropdown.

Langkah 2: Konfigurasi koneksi LDAP

Isi bagian Required Settings:

Field	Deskripsi	Contoh
UI display name	Label yang ditampilkan di Admin Console	`LDAP Perusahaan`
Vendor	Pilih yang paling sesuai dengan server LDAP Anda	`Other` / `Active Directory` / `Red Hat Directory Server`
Connection URL	Alamat server LDAP	`ldap://ldap.example.com:389`
Enable StartTLS	Upgrade koneksi ke TLS setelah handshake awal	`Off` (aktifkan untuk produksi)
Use Truststore SPI	Apakah menggunakan server truststore untuk verifikasi TLS	`Only for ldaps`
Bind type	Metode autentikasi untuk akun bind	`simple`
Bind DN	Distinguished name akun servis	`cn=admin,dc=example,dc=com`
Bind credentials	Password untuk akun bind	`••••••••`

Klik Test connection untuk memverifikasi bahwa NQRust-Identity dapat menjangkau server LDAP sebelum melanjutkan.

Kemudian isi bagian LDAP searching and updating:

Field	Deskripsi	Contoh
Edit mode	Apakah pengguna dapat memperbarui profil mereka melalui NQRust-Identity	`READ_ONLY`
Users DN	Base DN tempat entri pengguna berada	`ou=users,dc=example,dc=com`
Username LDAP attribute	Atribut LDAP yang dipetakan ke username NQRust-Identity	`uid` (OpenLDAP) atau `sAMAccountName` (AD)
RDN LDAP attribute	Atribut relative distinguished name	`uid`
UUID LDAP attribute	Atribut pengenal unik	`entryUUID` (OpenLDAP) atau `objectGUID` (AD)
User object classes	Object class yang mendefinisikan entri pengguna	`inetOrgPerson, organizationalPerson`

Klik Test authentication untuk memverifikasi bahwa kredensial bind diterima oleh server LDAP.

Klik Save untuk membuat provider LDAP.

Langkah 3: Sinkronisasi pengguna

Setelah menyimpan provider, Anda dapat mengimpor pengguna dari LDAP ke dalam database NQRust-Identity.

Jalankan full sync

Di halaman provider LDAP, gulir ke bawah ke bagian Sync Settings dan klik Synchronize all users.

Pesan status akan mengonfirmasi jumlah pengguna yang diimpor:

Added X users, Updated Y users, Removed Z users

Verifikasi pengguna yang diimpor

Di sidebar kiri, klik Users.
Klik View all users.
Pastikan pengguna LDAP muncul dalam daftar. Kolom Origin mereka menampilkan nama provider federasi LDAP (misalnya LDAP Perusahaan).

⚠️

NQRust-Identity menyimpan salinan lokal data pengguna dari LDAP. Validasi password untuk pengguna LDAP selalu didelegasikan kembali ke server LDAP — password tidak pernah disimpan di NQRust-Identity.

Langkah 4: Konfigurasi mapper atribut

Mapper mendefinisikan bagaimana atribut LDAP diterjemahkan ke dalam field profil pengguna NQRust-Identity.

Buka tab Mappers

Di halaman provider LDAP, klik tab Mappers. NQRust-Identity secara otomatis membuat beberapa mapper default (misalnya username, email, first name, last name).

Tinjau mapper default

Pastikan mapper-mapper ini menunjuk ke atribut LDAP yang benar untuk direktori Anda:

Nama mapper	Atribut LDAP	Field NQRust-Identity
`username`	`uid` / `sAMAccountName`	username
`email`	`mail`	email
`first name`	`givenName`	firstName
`last name`	`sn`	lastName

Tambahkan mapper kustom (opsional)

Untuk memetakan atribut LDAP tambahan (misalnya departemen):

Klik Add mapper.
Atur Mapper type ke user-attribute-ldap-mapper.
Isi:
- Name: department
- User Model Attribute: department
- LDAP Attribute: departmentNumber
Klik Save.

Langkah 5: Verifikasi login dengan akun LDAP

Buka Account Console

Navigasi ke https://<host-anda>:<port>/auth/realms/<realm>/account.

Login

Masukkan kredensial pengguna LDAP. NQRust-Identity mendelegasikan autentikasi ke server LDAP.

Jika berhasil, pengguna diarahkan ke halaman akun mereka dan data profil (nama, email) terisi dari atribut LDAP yang dipetakan.

Konfirmasi sumber federasi di Admin Console

Buka Users di Admin Console.
Buka pengguna yang baru saja login.
Di tab Details, pastikan User federation link menampilkan nama provider LDAP.

Jika login gagal, periksa log server NQRust-Identity untuk error terkait LDAP. Penyebab umum adalah Users DN yang salah, atribut Username LDAP yang tidak cocok, atau firewall yang memblokir koneksi.

Sinkronisasi berkala (opsional)

Untuk menjaga daftar pengguna NQRust-Identity tetap sinkron dengan perubahan di LDAP secara otomatis:

Di halaman provider LDAP, gulir ke Sync Settings.
Aktifkan Periodic full sync dan atur Full sync period (dalam detik, misalnya 86400 untuk harian).
Aktifkan Periodic changed users sync dan atur Changed users sync period (misalnya 3600 untuk per jam).
Klik Save.

NQRust-Identity akan menjalankan job sync di background sesuai jadwal yang dikonfigurasi.

Ikhtisar