Connector 3-legged OAuth 2.0 in Jitterbit Studio

Übersicht

Die Authentifizierung einer Verbindung mit 3-legged OAuth 2.0 (3LO) ist für bestimmte Studio-Connectors bei Verwendung von Agent-Version 10.83 / 11.21 oder später verfügbar. 3LO ermöglicht unterstützten Connectoren, auf Ressourcen im Namen eines Benutzers zuzugreifen (ohne direkt auf die Benutzeranmeldedaten zuzugreifen), indem eine Cloud-Anwendung oder eine private Anwendung verwendet wird.

Cloud-Anwendungen sind von Jitterbit bereitgestellte 3-legged-OAuth-Anwendungen.

Private Anwendungen sind 3-legged-OAuth-Anwendungen, die Sie im Endpoint konfigurieren und besitzen und dann in der Management Console auf der Seite App-Registrierungen mit diesen Werten aus der 3-legged-OAuth-Anwendung registrieren:

Client-ID und Client-Secret
Bereiche
Autorisierungs-URL
Zugriffstokenbeziehungs-URL
Aktualisierungstokenbeziehungs-URL

Nach der Registrierung der 3-legged-OAuth-Anwendung auf der Seite App-Registrierungen kann sie im Menü OAuth-Anwendung unter Private Anwendungen in der Verbindungskonfiguration ausgewählt werden. Weitere Informationen zum Konfigurieren einer 3LO-Verbindung finden Sie in der Dokumentation zum einzelnen Connector.

Von 3LO unterstützte Connectors

Derzeit unterstützen diese Connectors die Authentifizierung mit 3-legged OAuth 2.0:

Systemarchitektur

Diese Schritte beschreiben, wie eine 3LO-Verbindung innerhalb der Systemarchitektur verarbeitet wird, wenn ein unterstützter Connector mit einer OAuth-2.0-App-Registrierung authentifiziert wird:

Während der Verbindung zum Endpoint wird der Benutzer zur Autorisierungs-URL des OAuth-Anbieters weitergeleitet.
Unter der Autorisierungs-URL wird der Benutzer aufgefordert, Anmeldedaten zu überprüfen und der Autorisierungsanforderung von Harmony zuzustimmen.
Nach erfolgreichster Autorisierung der Anforderung stellt der OAuth-Anbieter einen Autorisierungscode für Harmony aus.
Harmony tauscht den Autorisierungscode gegen ein Zugriffstokenbeziehung vom OAuth-Anbieter aus.
Harmony verwendet das Zugriffstokenbeziehung, um die erforderliche Ressource aus der API des Connectors abzurufen.

Wichtige Hinweise

Beachten Sie Folgendes, wenn Sie die 3-legged-OAuth-Authentifizierung verwenden:

Globale Endpoints: Die Authentifizierung mit 3-legged OAuth wird für globale Endpoints nicht unterstützt.
Zugriffstokenbeziehung-Ungültigmachung: Die 3LO-Implementierung von Jitterbit unterstützt keine Anbieter, die alle zuvor ausgegebenen Zugriffstokenbeziehungen ungültig machen, wenn ein neues Zugriffstokenbeziehung ausgegeben wird (z. B. durch eine Aktualisierung). Pro Aktualisierungstokenbeziehung kann zu einem bestimmten Zeitpunkt nur ein Zugriffstokenbeziehung gültig sein.
Ablauf der Aktualisierungstokenbeziehung bei Inaktivität: Einige Anbieter (z. B. Microsoft) lassen ein Aktualisierungstokenbeziehung nach einer Inaktivitätszeit ablaufen, z. B. nach 90 Tagen ohne Verwendung. Das Aufrufen des Aktualisierungstokenbeziehung-Endpunkts nach einem Zeitplan zum Zurücksetzen der Inaktivitätsuhr und zum Verhindern des Ablaufs wird durch die 3LO-Implementierung von Jitterbit nicht unterstützt. Aktualisierungstokenbeziehungen werden nur verwendet, wenn ein Vorgang Zugriff auf den Endpoint erfordert.
Projektübertragung: Jeder Endpoint wählt seine eigene OAuth-Anwendung (App-Registrierung) aus. Das gleiche Projekt kann daher in jedem Environment eine andere OAuth-Anwendung verwenden (z. B. eine für Entwicklung und eine andere für Produktion). Wenn Sie Komponenten in ein anderes Environment übertragen, bleibt die von einem Endpoint im Zielumgebung verwendete OAuth-Anwendung erhalten, es sei denn, Sie wählen für den Endpoint Anwendung übertragen aus.

Endpunkte verwalten

Nach der Konfigurierung der Verbindung können Sie die Seite Projekte der Verwaltungskonsole nutzen, um bereitgestellte Endpunkte anzuzeigen, für die 3-Leg-OAuth für ein Projekt konfiguriert wurde (siehe Reiter Endpunkte).