Voraussetzungen für 2-legged OAuth 2.0 bei Salesforce-basierten Connectors in Jitterbit Studio

Einführung

Dies sind die Voraussetzungen für die Verwendung von 2-legged OAuth 2.0 mit den Connectors Salesforce, Salesforce Einstein Analytics, Salesforce Events, Salesforce Service Cloud und ServiceMax. Sie benötigen die URL Ihrer Salesforce-Instanz, eine Client-ID und ein Client-Secret für eine erfolgreiche Verbindung mit 2-legged OAuth 2.0-Authentifizierung.

Instanz-URL

Die Salesforce-Instanz-URL hängt von der My Domain-Einstellung Ihrer Organisation ab:

• Falls My Domain aktiviert ist (Standard), ist die Instanz-URL https://exampleDomain.my.salesforce.com.
• Falls My Domain deaktiviert ist, ist die Instanz-URL https://exampleInstance.salesforce.com.

Externe Client-App

Verwenden Sie eine externe Client-App, falls Sie nicht bereits eine vorhandene Salesforce-Connected-App für diesen Zweck konfiguriert haben. Um eine externe Salesforce-Client-App zu erstellen und zu konfigurieren, um die erforderlichen Client-Anmeldedaten zu erhalten, führen Sie diese Schritte aus:

1. Erstellen Sie eine externe Client-App.

2. Konfigurieren Sie die OAuth-Einstellungen der externen Client-App

   • Legen Sie die Callback URL auf eine der folgenden URLs fest (abhängig von der Region Ihrer Organisation):

     Region	URL
     APAC	https://apps.apac-southeast.jitterbit.com/design-studio/api/v1/oauth/authcode
     EMEA	https://apps.emea-west.jitterbit.com/design-studio/api/v1/oauth/authcode
     NA	https://apps.na-east.jitterbit.com/design-studio/api/v1/oauth/authcode

   • Wählen Sie unter OAuth Scopes die Option Manage user data via APIs (api) aus. Berücksichtigen Sie zusätzliche OAuth-Bereiche, die Ihre Implementierung möglicherweise benötigt. Beispielsweise Access the identity URL service (id, profile, email, address, phone).

   • Wählen Sie Enable Client Credentials Flow aus.

3. Konfigurieren Sie die Client Credentials Flow-Richtlinien der externen Client-App

   • Öffnen Sie die App und wählen Sie die Registerkarte Policies aus, klicken Sie dann auf Edit.

   • Wählen Sie Enable Client Credentials Flow aus.

   • Geben Sie den Benutzernamen des Salesforce-Benutzers ein, als der die Verbindung läuft (der Ausführungsbenutzer). Jeder mit dem Consumer Key und Consumer Secret kann Ihre Org im Namen dieses Benutzers aufrufen. Die Berechtigungen dieses Benutzers in Salesforce bestimmen, auf welche Daten die Verbindung zugreifen kann. Der Benutzer muss daher die erforderlichen Berechtigungen für die in Ihrem Studio-Projekt verwendeten Aktivitäten haben. Ein breiter OAuth-Umfang erweitert dies nicht: Der Zugriff ist immer auf das beschränkt, was der Ausführungsbenutzer in Salesforce durchführen darf.

• Klicken Sie auf Speichern.

• Öffnen Sie die App, wählen Sie die Registerkarte Settings aus, erweitern Sie OAuth Settings, und klicken Sie auf Consumer Key and Secret. Notieren Sie die Werte für Consumer Key und Consumer Secret, um diese während der Salesforce-Verbindungskonfiguration als Client-ID und Client-Secret einzugeben.

Connected App

Wenn Sie eine zuvor konfigurierte Salesforce Connected App haben, bestätigen Sie, dass diese für den OAuth 2.0 Client Credentials Flow konfiguriert ist:

• Bestätigen Sie unter den OAuth-Einstellungen der Connected App, dass Enable Client Credentials Flow ausgewählt ist.

• Klicken Sie auf der Detailseite der Connected App auf Manage, dann auf Edit Policies. Bestätigen Sie unter Client Credentials Flow, dass einem Benutzer Run As zugewiesen ist (für Enterprise Edition Orgs empfiehlt Salesforce einen Benutzer mit der Berechtigung API Only User). Die Salesforce-Berechtigungen dieses Benutzers bestimmen, worauf die Verbindung zugreifen kann. Der Benutzer muss daher die für die in Ihrem Studio-Projekt verwendeten Aktivitäten erforderlichen Berechtigungen haben. Richtlinien für Permitted Users (z. B. Admin approved users are pre-authorized) gelten nicht für diesen Benutzer.

Weitere Informationen finden Sie in der Salesforce-Dokumentation Configure a Connected App for the OAuth 2.0 Client Credentials Flow.

Navigieren Sie zur App, und klicken Sie auf Manage Consumer Details. Notieren Sie die Werte für Consumer Key und Consumer Secret, um diese während der Salesforce-Verbindungskonfiguration als Client-ID und Client-Secret einzugeben.

Nächste Schritte

Verwenden Sie die Instanz-URL, die Client-ID und das Client-Secret, um eine Salesforce-Verbindung mit OAuth 2.0-Authentifizierung mit zwei Beinen zu konfigurieren.