一般 LDAP 連接器技術參考

本文說明一般 LDAP 連接器。 本文適用於下列產品:

針對MIM2016,連接器可從 Microsoft 下載中心下載。

提到 IETF RFC 時,本文件會使用 (RFC [RFC 編號]/[RFC 文件中的區段]) 格式,例如:(RFC 4512/4.3)。 您可以在 找到詳細資訊 https://tools.ietf.org/。 在左側面板中,於 [ 檔案擷取 ] 對話框中輸入 RFC 號碼,並進行測試以確定其有效。

注意

Microsoft Entra ID 現在提供輕量型代理程式型解決方案,可將使用者布建到 LDAPv3 伺服器,而不需要 MIM 同步部署。 建議您將其用於輸出使用者布建。 深入瞭解

一般 LDAP 連接器概觀

一般 LDAP 連接器可讓您整合同步處理服務與 LDAP v3 伺服器。

IETF RFC 中未指定某些作業和架構元素,例如執行差異匯入所需的作業和架構元素。 對於這些作業,只支援明確指定的 LDAP 目錄。

若要連線到目錄,我們會使用根/系統管理員帳戶進行測試。 若要使用不同的帳戶來套用更細微的許可權,您可能需要與LDAP目錄小組一起檢閱。

連接器的目前版本支援這些功能:

功能 支援
連接的資料來源 所有LDAP v3伺服器都支援連接器, (符合 RFC 4510 規範) ,除非呼叫為不支持的情況。 它已經過這些目錄伺服器的測試:
  • Microsoft Active Directory Lightweight Directory Services (AD LDS)
  • Microsoft Active Directory Global Catalog (AD GC)
  • 389 Directory Server
  • Apache Directory Server
  • IBM Tivoli DS
  • Isode Directory
  • NetIQ eDirectory
  • Novell eDirectory
  • Open DJ
  • Open DS
  • Open LDAP (openldap.org)
  • Oracle (之前為 Sun) Directory Server Enterprise Edition
  • RadiantOne Virtual Directory Server (VDS)
  • Sun One Directory Server
  • Microsoft Active Directory 網域服務 (AD DS)
    • 在大部分情況下,您必須改用內建 Active Directory 連接器,因為某些功能可能無法運作
    不支援值得注意的已知目錄或功能:
  • Microsoft Active Directory 網域服務 (AD DS)
    • 密碼變更通知服務 (PCNS)
    • Exchange 布建
    • 刪除作用中同步裝置
    • 支持 nTDescurityDescriptor
  • Oracle Internet Directory (OID)
  • 案例
  • 物件生命週期管理
  • 群組管理
  • 密碼管理
  • Operations 所有 LDAP 目錄都支援下列作業:
  • 完整匯入
  • 匯出
  • 僅在特定目錄上支援下列作業:
  • 差異匯入
  • 設定密碼、變更密碼
  • 結構描述
  • 從 LDAP 結構描述 (RFC3673 和 RFC4512/4.2) 中偵測到結構描述
  • 支援結構化類別、aux 類別和 extensibleObject 物件類別 (RFC4512/4.3)
  • 差異匯入和密碼管理支援

    支援差異匯入和密碼管理的目錄:

    • Microsoft Active Directory Lightweight Directory Services (AD LDS)
      • 支援所有作業進行差異匯入
      • 支援設定密碼
    • Microsoft Active Directory Global Catalog (AD GC)
      • 支援所有作業進行差異匯入
      • 支援設定密碼
    • 389 Directory Server
      • 支援所有作業進行差異匯入
      • 支援設定密碼和變更密碼
    • Apache Directory Server
      • 不支援差異匯入,因為此目錄沒有持續性變更記錄
      • 支援設定密碼
    • IBM Tivoli DS
      • 支援所有作業進行差異匯入
      • 支援設定密碼和變更密碼
    • Isode Directory
      • 支援所有作業進行差異匯入
      • 支援設定密碼和變更密碼
    • Novell eDirectory 和 NetIQ eDirectory
      • 支援 [新增]、[更新] 和 [重新命名] 作業進行差異匯入
      • 不支援刪除差異匯入的作業
      • 支援設定密碼和變更密碼
    • Open DJ
      • 支援所有作業進行差異匯入
      • 支援設定密碼和變更密碼
    • Open DS
      • 支援所有作業進行差異匯入
      • 支援設定密碼和變更密碼
    • Open LDAP (openldap.org)
      • 支援所有作業進行差異匯入
      • 支援設定密碼
      • 不支援變更密碼
    • Oracle (之前為 Sun) Directory Server Enterprise Edition
      • 支援所有作業進行差異匯入
      • 支援設定密碼和變更密碼
    • RadiantOne Virtual Directory Server (VDS)
      • 必須使用 7.1.1 版或更高版本
      • 支援所有作業進行差異匯入
      • 支援設定密碼和變更密碼
    • Sun One Directory Server
      • 支援所有作業進行差異匯入
      • 支援設定密碼和變更密碼

    必要條件

    在您使用連接器之前,請確定同步處理伺服器上有下列項目:

    • Microsoft .NET 4.5.2 Framework 或更新版本

    部署此連接器可能需要變更目錄伺服器的設定,以及 MIM 的組態變更。 對於涉及將 MIM 與生產環境中第三方目錄伺服器整合的部署,我們建議客戶與其目錄伺服器廠商合作,或部署夥伴以取得此整合的說明、指引和支援。

    偵測 LDAP 伺服器

    連接器會依賴各種技巧來偵測和識別 LDAP 伺服器。 連接器會使用根 DSE、廠商名稱/版本,而且檢查結構描述,以找出已知存在某些 LDAP 伺服器中的唯一物件和屬性。 如果找到此資料,則會用來預先填入連接器的設定選項。

    連接的資料來源權限

    若要在連接的目錄中的物件上執行匯入及匯出作業,連接器帳戶必須具有足夠的權限。 連接器需要寫入權限才能匯出,需要讀取權限才能匯入。 權限設定是在目標目錄本身的管理經驗內執行。

    連接埠和通訊協定

    連接器會使用組態中指定的連接埠號碼,依預設 LDAP 使用 389 及 LDAPS 使用 636 。

    對於 LDAPS,您必須使用 SSL 3.0 或 TLS。 不支援 SSL 2.0,而且無法啟動。

    必要的控制項和功能

    LDAP 伺服器必須提供下列 LDAP 控制項/功能,連接器才能正常運作:
    1.3.6.1.4.1.4203.1.5.3 True/False 篩選器

    True/False 篩選器通常因為由 LDAP 目錄所支援而不回報,而且可能會出現在 [找不到強制功能] 之下的 [全域頁面] 上。 它用於在 LDAP 查詢中建立 OR 篩選器,例如,當匯入多個物件類型時。 如果您可以匯入一種以上的物件類型,則 LDAP 伺服器會支援此功能。

    如果您使用唯一標識符為錨點的目錄,則下列功能也必須 (如需詳細資訊,請參閱 設定錨點 一節) :
    1.3.6.1.4.1.4203.1.5.1 所有操作屬性

    如果目錄中的物件數目超過在一次呼叫目錄時可容納的數目,則建議使用分頁。 您需使用下列其中一個選項,分頁才能運作:

    選項 1:
    1.2.840.113556.1.4.319 pagedResultsControl

    選項 2:
    2.16.840.1.113730.3.4.9 VLVControl
    1.2.840.113556.1.4.473 SortControl

    如果連接器組態中已啟用這兩個選項,則會使用 pagedResultsControl。

    1.2.840.113556.1.4.417 ShowDeletedControl

    只有在 ShowDeletedControl 搭配 USNChanged 差異匯入方法使用時,才能夠查看已刪除的物件。

    連接器會嘗試偵測選項是否出現在伺服器上。 如果偵測不到選項,則連接器屬性的 [全域] 頁面上會出現警告。 並非所有 LDAP 伺服器都會顯示其支援的所有控制項/功能,即使出現此警告,連接器也可能正常運作。

    差異匯入

    只有在偵測到支持差異的目錄時,才能使用差異匯入。 目前使用下列方法:

    不支援

    不支援下列 LDAP 功能:

    • 伺服器之間的 LDAP 轉介 (RFC 4511/4.1.10)

    建立新的連接器

    若要建立一般 LDAP 連接器,請在 [同步處理服務] 中選取 [管理代理程式] 和 [建立]。 選取 [一般 LDAP (Microsoft)] 連接器。

    MIM 同步 UI 以建立新的連接器

    連接性

    在 [連線能力] 頁面上,您必須指定 [主機]、[連接埠] 和 [繫結] 資訊。 視選取的 [繫結] 而定,下列各區段中可能會提供其他資訊。

    MIM 同步連接器設定連線機頁面

    • [連線逾時] 設定僅適用於偵測結構描述時的第一次伺服器連線。
    • 如果 [繫結] 為 [匿名],則不會使用使用者名稱 / 密碼或憑證。
    • 對於其他繫結,請在使用者名稱 / 密碼中輸入資訊或選取憑證。
    • 如果您使用 Kerberos 進行驗證,也要提供使用者的 [領域/網域]。

    [屬性別名] 文字方塊使用於以 RFC4522 語法在結構描述中定義的屬性。 在架構偵測期間無法偵測這些屬性,連接器需要個別設定這些屬性。 例如,必須在 [屬性別名] 方塊中輸入下列字串,才能正確地將userCertificate 屬性識別為二進位屬性:

    userCertificate;binary

    下表是此設定外觀的範例:

    具有屬性的 MIM 同步連接器設定連線頁面

    選取 [在結構描述中包含操作屬性] 核取方塊,也會包含伺服器所建立的屬性。 其中包含物件的建立時間和上次更新時間等屬性。

    若已使用可延伸物件 (RFC4512/4.3),則選取 [在結構描述中包含可延伸屬性] ,而且啟用此選項可讓每個屬性使用於所有物件上。 選取此選項會讓結構描述變得非常大,所以除非連接的目錄使用這項功能,否則建議不要選取這個選項。

    全域參數

    在 [全域參數] 頁面上,您可以設定差異變更記錄檔的 DN 和其他 LDAP 功能。 此頁面會預先填入以 LDAP 伺服器所提供的資訊。

    MIM 同步連接器設定全域參數頁面

    最上方區段顯示伺服器本身所提供的資訊,例如伺服器名稱。 連接器也會確認強制控制項是否位於根 DSE 中。 如果未列出這些控制件,則會顯示警告。 某些 LDAP 目錄不會列出根 DSE 中的所有功能,而即使出現警告,連接器也可能正常運作。

    [支援的控制項] 核取方塊可控制特定作業的行為:

    • 選取樹狀目錄刪除後,會透過一個 LDAP 呼叫來刪除階層。 若未選取樹狀目錄刪除,則連接器會視需要進行遞迴刪除。
    • 選取分頁結果後,連接器會以執行步驟上指定的大小進行分頁匯入。
    • VLVControl 和 SortControl 是 pagedResultsControl 的替代項目,可從 LDAP 目錄讀取資料。
    • 如果三個選項 (pagedResultsControl、VLVControl 和 SortControl) 均未選取,則連接器會在一項作業中匯入所有物件,而如果是大型目錄,則有可能失敗。
    • 只有在差異匯入方法是 USNChanged 時,才會使用 ShowDeletedControl。

    變更記錄檔 DN 是差異變更記錄檔所使用的命名內容,例如 cn=discovery。 必須指定此值,才能夠進行差異匯入。

    下表是預設變更記錄 DN 的清單:

    目錄 差異變更記錄檔
    Microsoft AD LDS 和 AD GC 自動偵測。 USNChanged。
    Apache Directory Server 不適用。
    Directory 389 變更記錄檔。 要使用的預設值: cn=changelog
    IBM Tivoli DS 變更記錄檔。 要使用的預設值: cn=changelog
    Isode Directory 變更記錄檔。 要使用的預設值: cn=changelog
    Novell/NetIQ eDirectory 不適用。 TimeStamp。 連接器會使用上次更新日期/時間來取得已新增和更新的記錄。
    Open DJ/DS 變更記錄檔。 要使用的預設值: cn=changelog
    Open LDAP 存取記錄檔。 要使用的預設值: cn=accesslog
    Oracle DSEE 變更記錄檔。 要使用的預設值: cn=changelog
    RadiantOne VDS 虛擬目錄。 取決於 VDS 連接的目錄。
    Sun One Directory Server 變更記錄檔。 要使用的預設值: cn=changelog

    密碼屬性是連接器在密碼變更和密碼設定作業中應用來設定密碼的屬性名稱。 此值預設為 userPassword ,但特定 LDAP 系統可以視需要進行變更。

    在其他資料分割清單中,可以新增其他未自動偵測到的命名空間。 比方說,如果有幾部應同時全部匯入的伺服器組成一個邏輯叢集,則可使用此設定。 就如同 Active Directory 可以在一個樹系中有多個網域,而所有網域都共用一個結構描述,在此方塊中輸入其他命名空間就可以模擬此狀況。 每個命名空間都可以從不同的伺服器匯入,並可在 [設定資料分割和階層] 頁面上進一步設定。 使用 Ctrl+Enter 來換行。

    設定佈建階層

    此頁面用來將 DN 元件 (例如 OU) 對應至應佈建的物件類型 (例如 organizationalUnit)。

    佈建階層

    藉由設定佈建階層,您可以設定連接器在必要時自動建立結構。 例如,如果有命名空間 dc=contoso,dc=com 和新的物件 cn=Joe、ou=Seattle、c=US、dc=contoso、dc=com 已布建,則連接器可以在美國建立類型國家/地區的物件,如果目錄中還不存在,則 Connector 可以建立適用於西雅圖的型別物件。

    設定分割區與階層

    在分割區和階層頁面上,選取含有您想要匯入和匯出之物件的所有命名空間。

    MIM 同步連接器設定數據分割頁面

    對於每個命名空間,也可以設定連線能力設定,以覆寫 [連線能力] 畫面上指定的值。 如果這些值保留為其預設的空白值,則會使用 [連線能力] 畫面中的資訊。

    此外,也可以選取連接器應匯入及匯出的容器和 OU。

    在執行搜尋時,這會對資料分割中的所有容器執行。 在有大量容器的情況下,這種行為會導致效能降低。

    注意

    從 2017 年 3 月的一般 LDAP 連接器更新開始,您已可將搜尋範圍限制在所選容器內。 藉由選取下圖所示的 [僅在所選容器中搜尋] 核取方塊,就能執行此操作。

    僅搜尋所選容器

    設定錨點

    此頁面一律具有預先設定的值,而且無法變更。 如果已識別出伺服器廠商,則錨點可能會填入不可變的屬性,例如物件的 GUID。 如果尚未偵測到或已知沒有不可變的屬性,則連接器會使用 dn (辨別名稱) 做為錨點。

    MIM 同步連接器設定錨點頁面

    下表是 LDAP 伺服器和所使用的錨點清單:

    目錄 錨點屬性
    Microsoft AD LDS 和 AD GC objectGUID
    389 Directory Server dn
    Apache Directory dn
    IBM Tivoli DS dn
    Isode Directory dn
    Novell/NetIQ eDirectory GUID
    Open DJ/DS dn
    Open LDAP dn
    Oracle ODSEE dn
    RadiantOne VDS dn
    Sun One Directory Server dn

    其他注意事項

    本節提供此連接器特用層面的資訊,或因為其他原因而需得知的重要資訊。

    差異匯入

    Open LDAP 中的差異浮水印是 UTC 日期/時間。 基於這個理由,FIM 同步處理服務與 Open LDAP 之間的時鐘必須同步。 如果沒有同步,則可能會省略差異變更記錄檔中的某些項目。

    針對 Novell eDirectory,差異匯入不會偵測任何對象刪除。 基於這個理由,必須定期執行完整匯入才可找到所有刪除的物件。

    對於差異變更記錄檔以日期 / 時間為基礎的目錄,強烈建議定期執行完整匯入。 此程序可讓同步處理引擎找出 LDAP 伺服器與連接器空間中目前內容之間的差異。

    疑難排解