Bereitstellung mit benutzerdefiniertem Connector

  • Artikel

Microsoft Entra ID beinhaltet Konnektivität zur Bereitstellung in Anwendungen, die die folgenden Protokolle und Schnittstellen unterstützen:

Um die Konnektivität mit Anwendungen zu ermöglichen, die die eine der oben genannten Protokolle und Schnittstellen nicht unterstützen, haben Kund*innen und Partner benutzerdefinierte ECMA 2.0-Connectors zur Verwendung mit Microsoft Identity Manager (MIM) 2016 entwickelt. Dieselben ECMA2-Connectors können zur Bereitstellung in Apps mit dem Microsoft Entra-Bereitstellungsagenten und Extensible Connectivity (ECMA)-Connectorhost verwendet werden, ohne dass die MIM-Synchronisierung bereitgestellt werden muss.

Exportieren und Importieren eines MIM-Connectors

Wenn Sie über einen benutzerdefinierten ECMA 2.0-Connector in MIM verfügen, können Sie seine Konfiguration anhand der hier verfügbaren Anweisungen exportieren. Sie müssen die XML-Datei, die DLL und die zugehörige Software für Ihren Connector speichern.

Ihren Connector können Sie mit den hier verfügbaren Anweisungen importieren. Kopieren Sie die DLL für Ihren Connector und alle weiteren erforderlichen DLLs in dasselbe ECMA-Unterverzeichnis des Dienstverzeichnisses. Fahren Sie nach dem Importieren der XML-Datei mit dem Assistenten fort, und stellen Sie sicher, dass alle erforderlichen Felder aufgefüllt sind.

Aktualisieren einer benutzerdefinierten Connector-DLL

Stellen Sie beim Aktualisieren eines Connectors mit neuerer Buildversion sicher, dass die DLL an allen erforderlichen Speicherorten aktualisiert wird. Führen Sie diese Schritte aus, um Ihre benutzerdefinierte Connector-DLL ordnungsgemäß zu aktualisieren:

  1. Schließen Sie den Microsoft ECMA2Host-Konfigurationsassistenten.
  2. Beenden Sie den Microsoft ECMA2Host-Dienst.
  3. Aktualisieren Sie die benutzerdefinierte Connector-DLL manuell in jedem der folgenden Ordner.
    1. ECMA
    2. ECMA > Cache > {Connectorname}
    3. ECMA > Cache > {Connectorname} > AutosyncService
  4. Starten Sie den Microsoft ECMA2Host-Dienst.

Hinweis

Wenn mehrere Connectors dieselbe benutzerdefinierte DLL verwenden, müssen Sie die Schritte 3.ii und 3.iii für jeden Connector ausführen.

Problembehandlung

Für MIM erstellte benutzerdefinierte Connectors basieren auf dem ECMA-Framework. Wenn Sie Schwierigkeiten beim Importieren und Verwenden eines Connectors haben, stellen Sie sicher, dass Sie die folgenden bewährten Methoden verwenden:

  • Sicherstellen, dass Methoden in Ihrem Connector als öffentlich deklariert werden
  • Ausschluss von Präfixen aus Methodennamen. Beispiel:
    • Richtig: public Schema GetSchema (KeyedCollection<string, ConfigParameter> configParameters)
    • Falsch: Schema PrefixGetSchema.GetSchema (KeyedCollection<string, ConfigParameter> configParameters)

Die folgende Tabelle enthält Funktionalitäten des ECMA-Frameworks, die sich zwischen MIM und dem Microsoft Entra-Bereitstellungs-Agenten unterscheiden. Eine Liste mit bekannten Einschränkungen des Microsoft Entra-Bereitstellungsdiensts und der lokalen Anwendungsbereitstellung finden Sie hier.

Funktion Kommentare
Objekttyp Der Bereitstellungs-Agent lässt einen Objekttyp zu.
Partitionen Der Bereitstellungs-Agent lässt eine Partition zu.
Hierarchien Wird vom Bereitstellungs-Agenten nicht verwendet.
Vollständiger Export Wird vom Bereitstellungs-Agenten nicht verwendet.
ExportPasswordInFirstPass Nicht unterstützt
Normalisierungen Wird vom Bereitstellungs-Agenten nicht verwendet.
Parallele Vorgänge Wird vom Bereitstellungs-Agenten nicht verwendet.
DeleteAddAsReplace Wird vom Bereitstellungs-Agenten nicht verwendet.

Nächste Schritte