LDAP認證

1

版本。

2

應用場景。

1. 使用者在 LDAP 認證伺服器儲存了較為完整的員工資訊，且已經使用它進行了多個線上系統的認證。

2. 使用者需要在數據決策系統中使用同樣的認證方法，可在數據決策系統的【管理系統】→【使用者管理】→【全域設定】處開啓 LDAP 認證。

3

功能簡介。

1. 平台提供 LDAP 認證，使用者可按照本文方法在數據決策系統中設定 LDAP 認證。

2. LDAP 認證，使用者登入時，平台將輸入使用者名資訊到設定的 LDAP 系統進行認證。

   若 LDAP 系統認證失敗，則平台判斷認證失敗；

   若 LDAP 系統認證成功，但是對應的使用者不存在於平台使用者中，則平台判斷認證失敗；

   若 LDAP 系統認證成功，且對應的使用者存在於平台使用者中，則平台判斷認證成功，可進入平台，按照該使用者在平台中的權限進行相應操作。

注：超級管理者不受 LDAP 認證的影響，依舊使用平台內建認證。

1

配置 LDAP 認證。

1. 以管理者身分進入數據決策系統，點選【管理系統】→【使用者管理】→【全域設定】，可分別為【同步使用者】和【匯出/新增的使用者】選擇認證方式。如下圖一所示。

2. 認證方式選擇【LDAP 認證】，輸入各個參數，點選【儲存】按鈕，跳出數據決策系統，需重新登入。如下圖二所示。

3. 參數填寫完成後，點選【測試連結】，連結成功後，點選【儲存】，即配置認證方式成功。

注：若連結失敗，則跳出提示：未能成功連結LDAP認證，請應答相關配置準確後再次儲存。如下圖四所示。

LDAP 認證時各參數項說明如下表所示。

2

添加使用者。

1. LDAP 伺服器裏一般存儲着使用者的員工列表，想要其中的某使用者能在平台使用 LDAP 認證登入，平台也需要添加一個同名使用者，因為綁定郵箱、分配權限等平台操作都是以平台使用者為作用對象的。

2. 當平台裏的對應使用者存在時，可以認為啟用 LDAP 認證僅是將該平台使用者的密碼認證從預設的平台內建認證改成了 LDAP 伺服器認證。

3. 點擊【管理系統】→【使用者管理】→【添加使用者】，添加使用者【test001】，如下圖所示。
   

注1：LDAP 認證配置【添加使用者】時，不需要配置密碼。帆軟中用 123456 的預設密碼來存儲，實際認證走 LDAP 密碼認證。

注2：同步的使用者，匯出/添加的使用者，可分别選擇不同的認證方式。

3

效果查看。

1. 使用者輸入LDAP伺服器中存儲的使用者名、LDAP伺服器中的密碼，若 LDAP 系統認證成功，且對應的使用者存在於平台使用者中，則平台判斷認證成功，可進入資料決策系統，按照該使用者在平台中的權限進行相應操作。如下圖所示。

注1：若在平台中不存在輸入使用者名，或平台中對應的使用者被禁用，或開啓了平台使用使用者限制且不包含使用者，則不與 LDAP伺服器進行通訊，直接提示【使用者名或密碼錯誤】或【使用者不可用】。

注2：LDAP 伺服器中儲存的使用者名，不可使用雙位元組日語、繁體中文或朝鮮文字元。否則在平台登入時提示【使用者名或密碼錯誤】。

         LDAP 伺服器中儲存的密碼，不可使用雙位元組日語、繁體中文、簡體中文或朝鮮文字元。否則在平台登入時提示【使用者名或密碼錯誤】。

1

測試 LDAP 連結成功。

1. 10.0.18 之前的報表工程，在數據決策系統中配置 LDAP 認證後，不能確定 LDAP 連結是否成功，執行本文 第二章第3節時，可能會出現使用者無法正常登入或登入緩慢的問題，可按照本章方法定位問題。

2. 下載右側壓縮包并解壓：LDAPDemo.zip。

3. 開啟【LDAPDemo.java】檔案，根據實際情況修改平台 LDAP 配置頁面的配置項，如下圖一所示。

4. 切換到 LDAP 檔案目錄下，執行：【javac -encoding utf-8 LDAPDemo.java】，生成一個【LDAPDemo.class】；然後再執行：【java LDAPDemo】，如果傳回的是【測試結束】，則表示 LDAP 認證正常，否則根據提示進一步定位問題。如下圖二、三所示。

注1：确保本地有 Java 環境。

注2：管理者名稱中若包含以下字元： '"'， '+'，','，';'，'<'，'>'，'\' ，在 LDAPDemo 中需要轉義。

例：使用者名為 fanruan\admin，LDAPDemo 中需要輸入 fanruan\\admin。決策平台輸入無需轉義，直接輸入 fanruan\admin 即可。

2

9.0 升級 10.0 後 LDAP 認證失敗。

1. 問題描述：
   

   FineReport 由 9.0 升級到 10.0 之後，使用者使用 LDAP 認證登入失敗，登入頁面顯示報錯資訊【username does not exist】。

2. 原因分析：

   9.0 升級到 10.0 後 LDAP 登入認證邏輯發生了改變。

   以使用者名User，LDAP 認證後綴 【fr.com】 為例對認證邏輯進行分析：
   

   FineReport 9.0：首先将使用者名 User 加上後綴 fr.com 檢索平台是否存在該使用者，然後進行 LDAP 認證流程。

   FineReport 10.0：首先根據使用者名 User 檢索是否存在該使用者，然後再加上後綴 fr.com 進行LDAP認證流程。

3. 解決方案：

   方案一：将【使用者管理下】 LDAP 配置頁面的【使用者名後綴】去掉不用，使用者使用【使用者名@後綴名】即可正常登入。

   方案二：将每個使用者的【使用者後綴名】都去掉，使用者使用使用者名即可正常登入。

3

配置 LDAP 認證使用者名登入搜索字段。

1. 超級管理員可透過【fine_conf_entity可視化配置插件】自訂配置LDAP認證使用者名登錄搜索字段。重啓伺服器後設定生效。

注：修改 FineDB 資料庫表字段值的方法請參考 FineDB 常用表字段修改 。