企業內部的帳號驗證、員工資訊查詢,很多時候都繞不開 LDAP。本文以「從 LDAP Server 撈出 uid 為 kxh 的用戶資料」為目標,示範如何在 Node.js 裡完成一次完整的查詢流程。
假設要連接的目錄服務位址是 ldap://10.233.21.116:389。先在專案根目錄安裝 Node 端最常用的 LDAP 客戶端庫 ldapjs:
npm install ldapjs
接著在根目錄建立 app.js,把查詢邏輯寫進去。
var ldap = require("ldapjs");
// 建立 LDAP client,把伺服器位址傳進去
var client = ldap.createClient({
url: 'ldap://10.203.24.216:389'
});
// 查詢選項,filter 的作用等同 SQL 的 WHERE 條件
var opts = {
filter: '(uid=kxh)', // 只找 uid=kxh 這個節點
scope: 'sub', // 查詢範圍:子樹
timeLimit: 500 // 逾時毫秒數
};
// 綁定(登入)LDAP Server
// 第一個參數是帳號,必須寫成從根節點到用戶節點的完整 DN
// 第二個參數是密碼
client.bind('uid=supbind,cn=users,dc=tiger,dc=com', '123456', function (err, res1) {
client.search('DC=tiger,DC=com', opts, function (err, res2) {
// 每命中一筆就觸發一次
res2.on('searchEntry', function (entry) {
var user = entry.object;
console.log(JSON.stringify(user, null, 2));
});
// 目錄回傳的引用節點
res2.on('searchReference', function (referral) {
console.log('referral: ' + referral.uris.join());
});
// 查詢出錯
res2.on('error', function (err) {
console.error('error: ' + err.message);
client.unbind(); // 收尾一定要做
});
// 查詢結束
res2.on('end', function (result) {
console.log('search status: ' + result.status);
client.unbind(); // 收尾一定要做
});
});
});
client.search() 的第一個參數是「查詢基準路徑」,也就是告訴伺服器從哪個節點往下找,這裡從根 DC=tiger,DC=com 開始。bind 用的帳號則必須是完整 DN,少一層都會失敗。
另外,不論查詢成功或失敗,都記得呼叫 unbind() 釋放連線,否則長時間執行的服務很容易把連線數耗光。