Integrasi FreeRADIUS dengan Carbonio (Zimbra) LDAP: Solusi Kasus Autentikasi Gagal
TL;DR: FreeRADIUS gagal autentikasi user MikroTik ke Carbonio LDAP karena modul
ldapdi bagianauthorizeter-comment, menyebabkan fallback ke PAP lokal yang tidak bisa memverifikasi hash SSHA Carbonio. Solusi: aktifkanldapdiauthorizedan setAuth-Type := LDAP.
Latar Belakang
- Migrasi: Zimbra → Carbonio Mail (
mail.assyifa.ac.id) - FreeRADIUS: Versi 3.0 di Ubuntu (
freeradius-stiq-222) - Klien: MikroTik (PPPoE/WPA-Enterprise) mengirim
User-Name = aldy@student.stiq.assyifa.ac.id - LDAP Server: Carbonio di
144.79.202.76 - User test:
aldy@student.stiq.assyifa.ac.id(UIDaldy, OUpeople)
Gejala
Log FreeRADIUS menampilkan:
Thu Nov 19 10:24:53 2026 : Auth: (24850) Login incorrect (pap: Cleartext password does not match "known good" password): [aldy/12345678] (from client radius-stiq-mikrotik-kumpay port 2158064897 cli 48:BC:0E:1C:EB:1A)
- Username sudah benar (
aldysetelah realm stripping@student.stiq.assyifa.ac.id) - Password user benar (terverifikasi via
ldapsearchbind langsung) - Tapi FreeRADIUS tetap menolak dengan pesan “Cleartext password does not match”
Investigasi
1. Verifikasi LDAP (Berhasil)
# Search sebagai admin Zimbra/Carbonio
ldapsearch -x -H ldap://144.79.202.76 \
-D 'uid=zimbra,cn=admins,cn=zimbra' -w 'passwd' \
-b 'dc=student,dc=stiq,dc=assyifa,dc=ac,dc=id' '(uid=aldy)' \
dn uid mail zimbraMailDeliveryAddress
# Hasil: uid=aldy ditemukan di ou=people, email cocok
# Bind sebagai user aldy (verifikasi password)
ldapsearch -x -H ldap://144.79.202.76 \
-D 'uid=aldy,ou=people,dc=student,dc=stiq,dc=assyifa,dc=ac,dc=id' \
-w 'passwdx' -b 'uid=aldy,ou=people,dc=student,dc=stiq,dc=assyifa,dc=ac,dc=id' uid
# Hasil: Bind berhasil → password user valid
Kesimpulan: LDAP server berfungsi, user ada, password benar.
2. Cek Konfigurasi FreeRADIUS
File: /etc/freeradius/3.0/sites-enabled/default
# Di bagian authorize:
# -ldap ← TER-COMMENT (diawali tanda strip)
# Di bagian authenticate:
# Auth-Type LDAP { ldap } ← TIDAK ADA
3. Analisis Alur Autentikasi
| Tahap | Yang Terjadi | Hasil |
|---|---|---|
| Authorize | Modul ldap tidak dipanggil (di-comment) | Tidak ada Auth-Type := LDAP diset |
| Authenticate | FreeRADIUS fallback ke Auth-Type PAP | Modul pap mengambil userPassword (hash SSHA) dari LDAP via admin bind |
| PAP Compare | Bandingkan plaintext 12345678 dengan hash SSHA | SELALU GAGAL — PAP tidak tahu cara verifikasi SSHA |
Root Cause
Carbonio menyimpan password sebagai hash SSHA (standar Zimbra/Carbonio). Modul pap FreeRADIUS hanya bisa membandingkan password cleartext atau hash sederhana ({CRYPT}, {MD5}, dll), tidak SSHA.
Saat Zimbra dulu, kemungkinan:
- Zimbra menyimpan password dalam format yang PAP pahami, ATAU
- Config FreeRADIUS saat itu memang pakai
ldapbind langsung (modulldapaktif diauthorize), ATAU - Ada
saslauthdsebagai perantara yang handle verifikasi SSHA.
Sekarang di Carbonio, karena ldap di-comment, FreeRADIUS tidak pernah melakukan LDAP bind sebagai user, jadi verifikasi hash SSHA tidak pernah terjadi di server LDAP.
Solusi
1. Aktifkan modul ldap di bagian authorize
Edit /etc/freeradius/3.0/sites-enabled/default:
authorize {
...
- -ldap
+ ldap
...
+
+ update control {
+ Auth-Type := LDAP
+ }
}
2. Tambahkan handler Auth-Type LDAP di bagian authenticate
authenticate {
...
+ Auth-Type LDAP {
+ ldap
+ }
...
}
3. Restart FreeRADIUS
systemctl restart freeradius
4. Verifikasi dengan debug mode
freeradius -X
Coba login dari MikroTik. Output yang diharapkan:
(24850) ldap: Performing user authorization for aldy
(24850) ldap: Waiting for bind result...
(24850) ldap: Bind successful
(24850) Login OK: [aldy/12345678] (from client radius-stiq-mikrotik-kumpay ...)
Konfigurasi LDAP Modul (Referensi)
File: /etc/freeradius/3.0/mods-enabled/ldap
ldap {
server = 'ldap://144.79.202.76' # Ganti ke ldaps:// untuk produksi
identity = 'uid=zimbra,cn=admins,cn=zimbra'
password = '<password_admin_zimbra>'
base_dn = 'dc=student,dc=stiq,dc=assyifa,dc=ac,dc=id'
filter = '(|(uid=%{%{Stripped-User-Name}:-%{User-Name}})(zimbraMailDeliveryAddress=%{User-Name}))'
# start_tls = yes # Aktifkan jika pakai ldap://
}
Catatan: realm suffix (delimiter @) sudah aktif dari sebelumnya, jadi aldy@student.stiq.assyifa.ac.id → Stripped-User-Name = aldy.
Hardening Produksi (Opsional tapi Disarankan)
Gunakan LDAPS:
server = 'ldaps://144.79.202.76'Atau aktifkan
start_tls = yesdenganldap://.Pastikan CA cert valid jika pakai self-signed:
tls {
ca_file = /etc/ssl/certs/ca-certificates.crt
# cert_file / key_file jika mutual TLS
}EAP/PEAP/MSCHAPv2 jika MikroTik pakai WPA-Enterprise:
- Aktifkan
mods-enabled/eapdanmods-enabled/mschap - Pastikan
Auth-Type := LDAPtetap dipakai di dalam EAP-TTLS/PEAP inner tunnel.
- Aktifkan
Ringkasan Perubahan
| File | Perubahan |
|---|---|
/etc/freeradius/3.0/sites-enabled/default | Uncomment ldap di authorize, tambah Auth-Type := LDAP, tambah block Auth-Type LDAP { ldap } di authenticate |
/etc/freeradius/3.0/mods-enabled/ldap | (Opsional) Ganti ldap:// ke ldaps:// atau tambah start_tls = yes |
Kenapa Zimbra Dulu Jalan?
| Kemungkinan | Penjelasan |
|---|---|
| Format password beda | Zimbra mungkin simpan {CRYPT} atau cleartext yang PAP pahami |
| Config beda | Saat Zimbra, ldap di authorize mungkin tidak di-comment |
Ada saslauthd | FreeRADIUS → saslauthd (PAM) → Zimbra LDAP, bukan direct bind |
Carbonio default lebih ketat: hanya SSHA, dan tidak jalanin saslauthd default. Oleh karena itu LDAP bind langsung (Auth-Type LDAP) adalah cara yang benar dan portable.
Referensi
Dokumentasi ini dibuat berdasarkan kasus nyata migrasi Zimbra → Carbonio di Yayasan Assyifa, November 2026.
