Skip to content

Integrasi FreeRADIUS dengan Carbonio (Zimbra) LDAP: Solusi Kasus Autentikasi Gagal

TL;DR: FreeRADIUS gagal autentikasi user MikroTik ke Carbonio LDAP karena modul ldap di bagian authorize ter-comment, menyebabkan fallback ke PAP lokal yang tidak bisa memverifikasi hash SSHA Carbonio. Solusi: aktifkan ldap di authorize dan set Auth-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 (UID aldy, OU people)

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 (aldy setelah realm stripping @student.stiq.assyifa.ac.id)
  • Password user benar (terverifikasi via ldapsearch bind 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

TahapYang TerjadiHasil
AuthorizeModul ldap tidak dipanggil (di-comment)Tidak ada Auth-Type := LDAP diset
AuthenticateFreeRADIUS fallback ke Auth-Type PAPModul pap mengambil userPassword (hash SSHA) dari LDAP via admin bind
PAP CompareBandingkan plaintext 12345678 dengan hash SSHASELALU 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 ldap bind langsung (modul ldap aktif di authorize), ATAU
  • Ada saslauthd sebagai 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)

  1. Gunakan LDAPS:


    server = 'ldaps://144.79.202.76'

    Atau aktifkan start_tls = yes dengan ldap://.


  2. Pastikan CA cert valid jika pakai self-signed:


    tls {
    ca_file = /etc/ssl/certs/ca-certificates.crt
    # cert_file / key_file jika mutual TLS
    }

  3. EAP/PEAP/MSCHAPv2 jika MikroTik pakai WPA-Enterprise:

    • Aktifkan mods-enabled/eap dan mods-enabled/mschap
    • Pastikan Auth-Type := LDAP tetap dipakai di dalam EAP-TTLS/PEAP inner tunnel.

Ringkasan Perubahan

FilePerubahan
/etc/freeradius/3.0/sites-enabled/defaultUncomment 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?

KemungkinanPenjelasan
Format password bedaZimbra mungkin simpan {CRYPT} atau cleartext yang PAP pahami
Config bedaSaat Zimbra, ldap di authorize mungkin tidak di-comment
Ada saslauthdFreeRADIUS → 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.

Leave a Reply

Your email address will not be published. Required fields are marked *

freeradius-carbonio-ldap-integration