Provisionnement avec des connecteurs personnalisés

  • Article

Microsoft Entra ID inclut la connectivité à provisionner dans des applications qui prennent en charge les protocoles et interfaces suivants :

Pour assurer la connectivité aux applications qui ne prennent pas en charge les protocoles et normes susmentionnés, les clients et les partenaires ont créé des connecteurs ECMA 2.0 personnalisés pour Microsoft Identity Manager (MIM) 2016. Ces mêmes connecteurs ECMA2 peuvent désormais être utilisés avec l’hôte connecteur ECMA (Extensible Connectivity) et l’agent d’approvisionnement léger Microsoft Entra, sans avoir une synchronisation Microsoft Identity Manager (MIM) déployée.

Exportation et importation d’un connecteur MIM

Si vous avez un connecteur ECMA 2.0 personnalisé dans MIM, vous pouvez l’exporter en suivant les instructions ici. Vous devez enregistrer le fichier XML, la bibliothèque de liens dynamiques (DLL) et les logiciels associés de votre connecteur.

Pour importer votre connecteur, vous pouvez utiliser les instructions ici. Vous devez copier la DLL de votre connecteur, ainsi que l’une de ses DLL prérequises, dans le même sous-répertoire ECMA du répertoire Service. Une fois le xml importé, continuer l’exécution de l’Assistant, puis vérifiez que tous les champs obligatoires sont renseignés.

Mise à jour d’une DLL de connecteur personnalisé

Lors de la mise à jour d’un connecteur, vérifiez que la DLL est mise à jour dans tous les emplacements requis. Suivez les étapes ci-dessous pour mettre à jour correctement votre DLL de connecteur personnalisé :

  1. Fermez l’Assistant Configuration Microsoft ECMA2Host.
  2. Arrêtez le service Microsoft ECMA2Host.
  3. Mettez à jour manuellement la DLL de connecteur personnalisé dans les dossiers suivants.
    1. ECMA
    2. ECMA > Cache > {nom du connecteur}
    3. ECMA > Cache > {nom du connecteur} > AutosyncService
  4. Démarrez le service Microsoft ECMA2Host.

Notes

Si plusieurs connecteurs utilisent la même DLL personnalisée, vous devez effectuer les étapes 3.ii et 3.iii pour chaque connecteur.

Dépannage

Les connecteurs personnalisés conçus pour MIM s’appuient sur le framework ECMA. Si vous rencontrez des difficultés pour importer et utiliser un connecteur, vérifiez que vous suivez les bonnes pratiques suivantes :

  • Vérifier que les méthodes de votre connecteur sont déclarées comme publiques
  • Exclusion des préfixes des noms de méthode. Par exemple :
    • Correct : public Schema GetSchema (KeyedCollection<string, ConfigParameter> configParameters)
    • Incorrect : Schema PrefixGetSchema.GetSchema (KeyedCollection<string, ConfigParameter> configParameters)

Le tableau suivant inclut des fonctionnalités de l’infrastructure ECMA qui diffèrent entre MIM et l’agent de provisionnement Microsoft Entra. Pour obtenir la liste des limitations connues du service de provisionnement Microsoft Entra et du provisionnement des applications sur site, voir ici.

Fonctionnalité Commentaires
Type d'objet L’agent d’approvisionnement autorise un type d’objet
Partitions L’agent d’approvisionnement autorise une partition
Hiérarchies Non utilisé par l’agent d’approvisionnement
Exportation complète Non utilisé par l’agent d’approvisionnement
ExportPasswordInFirstPass Non prise en charge
Normalizations Non utilisé par l’agent d’approvisionnement
Opérations simultanées Non utilisé par l’agent d’approvisionnement
DeleteAddAsReplace Non utilisé par l’agent d’approvisionnement

Étapes suivantes