使用自訂連接器佈建

Microsoft Entra ID 包含可佈建到支援下列通訊協定和介面的應用程式連線：

• SCIM 2.0
• SQL
• LDAP
• REST
• SOAP
• PowerShell

為了連線到不支援上述任中一種通訊協定和介面的應用程式，客戶和合作夥伴已建置自訂的 ECMA 2.0 連接器，以便與 Microsoft Identity Manager (MIM) 2016 搭配使用。 這些相同的 ECMA2 連接器可用來佈建到具有 Microsoft Entra 佈建代理程式和可延伸連線能力 (ECMA) 連接器主機的應用程式，而不需要部署 MIM 同步處理。

匯出和匯入 MIM 連接器

如果您在 MIM 中有自訂 ECMA 2.0 連接器，您可以遵循這裡的指示匯出其組態。 您必須儲存連接器的 XML 檔案、DLL 和相關軟體。

若要匯入連接器，您可以使用這裡的指示。 您需要將連接器的 DLL 及其任何必要條件 DLL 複製到與服務目錄相同的 ECMA 子目錄。 匯入 xml 之後，請繼續執行精靈，並確定已填入所有必要的欄位。

更新自訂連接器 DLL

使用較新的組建更新連接器時，請確定所有必要位置的 DLL 皆已更新。 使用下列步驟來正確更新您的自訂連接器 DLL：

1. 關閉 [Microsoft ECMA2Host 設定精靈]。
2. 停止 [Microsoft ECMA2Host 服務]。
3. 將自訂連接器 DLL 手動更新至下列每個資料夾。
   1. ECMA
   2. ECMA > 快取 > {connector name}
   3. ECMA > 快取 > {connector name} > AutosyncService
4. 開始 [Microsoft ECMA2Host 服務]。

注意

如果多個連接器使用相同的自訂 DLL，您必須針對每個連接器完成步驟 3.ii 和 3.iii。

疑難排解

針對 MIM 建置的自訂連接器依賴 ECMA 架構。 如果您在匯入和使用連接器時遇到問題，請確定您已遵循最佳做法：

• 確保連接器中的方法宣告為公用
• 排除方法名稱中的前置詞。 例如：
  • 正確：public Schema GetSchema (KeyedCollection<string, ConfigParameter> configParameters)
  • 不正確：Schema PrefixGetSchema.GetSchema (KeyedCollection<string, ConfigParameter> configParameters)

下列表格包含與 MIM 和 Microsoft Entra 佈建代理程式不同之 ECMA 架構的功能。 如需 Microsoft Entra 佈建服務和內部部署應用程式佈建的已知限制清單，請參閱這裡。

功能	註解
Object type	佈建代理程式允許一個物件類型
資料分割	佈建代理程式允許一個磁碟分割
階層	佈建代理程式不使用
完整匯出	佈建代理程式不使用
ExportPasswordInFirstPass	不支援
正規化	佈建代理程式不使用
並行作業	佈建代理程式不使用
DeleteAddAsReplace	佈建代理程式不使用

下一步

• 應用程式佈建
• ECMA 連接器主機一般 SQL 連接器
• ECMA 連接器主機 LDAP 連接器