Microsoft Entra ID Connector für Jitterbit Integration Studio

Zusammenfassung

Der Microsoft Entra ID Connector ermöglicht den Zugriff auf Microsoft Entra ID.

So stellen Sie eine Verbindung zu lokalen Instanzen von Microsoft Active Directory her, verwenden Sie den Active Directory v2-Konnektor.

Der Microsoft Entra ID Connector bietet eine Schnittstelle zum Erstellen einer Microsoft Entra ID Verbindung, die die Grundlage für die Generierung von Instanzen von Microsoft Entra ID Aktivitäten bildet. Nach der Konfiguration interagieren diese Aktivitäten über die Verbindung mit Microsoft Entra ID.

Der Zugriff auf den Microsoft Entra ID Konnektor erfolgt über die Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Komponentenpalette).

Connector-Übersicht

Dieser Connector wird verwendet, um zunächst eine Microsoft Entra ID Verbindung zu konfigurieren. Mit dieser Verbindung verknüpfte Aktivitätstypen werden dann verwendet, um Instanzen von Aktivitäten zu erstellen, die als Quellen (zum Bereitstellen von Daten in einer Operation) oder Ziele (zum Verbrauchen von Daten in einer Operation) verwendet werden sollen.

Zusammen werden eine bestimmte Microsoft Entra ID Verbindung und ihre Aktivitäten als Entra ID- Endpoint bezeichnet:

• Abfrage: Fragt Objektdaten in Microsoft Entra ID ab und ist zur Verwendung als Quelle in einer Operation vorgesehen.

• Erstellen: Erstellt Objektdaten in Microsoft Entra ID und ist zur Verwendung als Ziel in einer Operation vorgesehen.

• Aktualisieren: Aktualisiert Objektdaten in Microsoft Entra ID und ist zur Verwendung als Ziel in einer Operation vorgesehen.

• Löschen: Löscht Objektdaten aus der Microsoft Entra ID und ist zur Verwendung als Ziel in einer Operation vorgesehen.

Voraussetzungen und unterstützte API Versionen

Für den Microsoft Entra ID Connector müssen Sie eine registrierte App erstellen, um eine erfolgreiche Verbindung mit der Microsoft Entra ID herzustellen.

Der Microsoft Entra ID Connector erfordert die Verwendung eines Agenten der Version 10.1 oder höher. Diese Agent-Versionen laden bei Bedarf automatisch die neueste Version des Connectors herunter.

Der Microsoft Entra ID Connector verwendet die Microsoft Graph API v1.0. Informationen zu den Schema und -feldern finden Sie in der API Dokumentation.

Fehlerbehebung

Wenn Probleme mit dem Microsoft Entra ID Connector auftreten, werden die folgenden Schritte zur Fehlerbehebung empfohlen:

1. Klicken Sie in der Verbindungskonfiguration auf die Schaltfläche Test um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agenten heruntergeladen wird (es sei denn, Sie verwenden die Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren).

2. Stellen Sie sicher, dass alle mit der Verbindung verknüpften Microsoft Entra ID -App-Registrierungen nicht den veralteten Azure AD Graph verwenden..

3. Überprüfen Sie die Operation für alle Informationen, die während der Ausführung der Operation geschrieben werden.

4. Aktivieren Sie die debuggen Protokollierung für Operation (für Cloud-Agenten oder für private Vertreter), um zusätzliche Protokolldateien und Daten zu generieren.

5. Bei Verwendung privater Agenten können Sie die ausführliche Protokollierung des Connectors aktivieren für diesen Connector, indem Sie diesen Logger-Konfigurationseintrag zu Ihrem privaten Agenten hinzufügen logback.xml Datei:

   <logger name="org.jitterbit.connector.active.directory" level="DEBUG"/>
   

   Weitere Informationen zur ausführlichen Protokollierung von Konnektoren finden Sie unter Ausführliche Protokollierung für Konnektoren mit privaten Jitterbit-Agenten.

6. Wenn Sie private Agenten verwenden, können Sie die Agentenprotokolle überprüfen für weitere Informationen.

7. Wenn Fehler auftreten, die darauf zurückzuführen sind, dass Typnamen nicht mit den Metadaten kompatibel sind, versuchen Sie, die Option OData-Typ für Payload festlegen unter Optionale Einstellungen in der Verbindungskonfiguration zu aktivieren.

8. Abfrageaktivität: Stellen Sie sicher, dass die Parameter Top und Page Size nicht zusammen in einer einzigen Abfrage verwendet werden. Andernfalls tritt ein Fehler auf.

9. Weitere Hinweise zur Fehlerbehebung finden Sie unter Fehlerbehebung beim Betrieb.