カスタム コネクタを使用したプロビジョニング
Microsoft Entra ID には、次のプロトコルとインターフェイスをサポートするアプリケーションにプロビジョニングするための接続が含まれています。
前述のプロトコルやインターフェイスのいずれかをサポートしていないアプリケーションに接続するために、顧客とパートナーは、Microsoft Identity Manager (MIM) 2016 で使用するカスタム ECMA 2.0 コネクタが構築されています。 これらの同じ ECMA2 コネクタを使用して、MIM 同期を展開する必要なく、Microsoft Entra プロビジョニング エージェントおよび Extensible Connectivity (ECMA) コネクタ ホストを使用してアプリにプロビジョニングできます。
MIM コネクタのエクスポートとインポート
MIM にカスタム ECMA 2.0 コネクタがある場合は、こちらの手順に従ってその構成をエクスポートできます。 コネクタの XML ファイル、DLL、および関連ソフトウェアを保存する必要があります。
コネクタをインポートするには、こちらの手順を使用できます。 コネクタの DLL とその前提条件の DLL のすべてを、サービス ディレクトリの同じ ECMA サブディレクトリにコピーする必要があります。 XML がインポートされたら、ウィザードを続行し、すべての必須フィールドが設定されていることを確認します。
カスタム コネクタ DLL の更新
コネクタを新しいビルドで更新する場合は、必要なすべての場所で DLL が更新されていることを確認します。 これらの手順を使用してカスタム コネクタ DLL を適切に更新します。
- Microsoft ECMA2Host 構成ウィザードを閉じます。
- Microsoft ECMA2Host サービスを停止します。
- カスタム コネクタ DLL をそれぞれ次のフォルダーに手動で更新します。
- ECMA
- ECMA > キャッシュ > {コネクタ名}
- ECMA > キャッシュ > {コネクタ名} > AutosyncService
- Microsoft ECMA2Host サービスを開始します。
Note
複数のコネクタが同じカスタム 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 プロビジョニング サービスとオンプレミス アプリケーション プロビジョニングに関する既知の制限事項の一覧については、こちらを参照してください。
| 機能 | コメント |
|---|---|
| オブジェクトの種類 | プロビジョニング エージェントが 1 つのオブジェクトの種類を許可する |
| メジャー グループ | プロビジョニング エージェントが 1 つのパーティションを許可する |
| Hierarchies (階層) | プロビジョニングエージェントでは使用されません |
| 完全エクスポート | プロビジョニングエージェントでは使用されません |
| ExportPasswordInFirstPass | サポートされていません |
| 正規化 | プロビジョニングエージェントでは使用されません |
| 同時実行の操作 | プロビジョニングエージェントでは使用されません |
| DeleteAddAsReplace | プロビジョニングエージェントでは使用されません |