Umstieg auf OAuth 2.0 für den Salesforce-Connector in Jitterbit Studio

Einführung

Salesforce stellt die SOAP-API-Authentifizierungsmethode login() (Benutzername, Passwort und Sicherheits-Token) ein. Jede Salesforce-Verbindung, die mit Basisauthentifizierung konfiguriert ist, nutzt diese Methode und muss auf OAuth 2.0 Client Credentials umgestellt werden, um weiterhin zu funktionieren.

Salesforce stellt die SOAP-API insgesamt nicht ein. Nur der Anmeldeschritt ändert sich – von einem SOAP-basierten login()-Aufruf zu einer OAuth 2.0-Token-Anfrage – daher funktionieren vorhandene Aktivitäten, Transformationen und Operationen unverändert weiter.

Diese Anleitung behandelt die durchgehende Umstellung für eine einzelne Verbindung: Was in Salesforce konfiguriert werden muss, was in Studio geändert werden muss und wie das Ergebnis vor der Bereitstellung validiert wird. Die gleichen Schritte gelten für die Salesforce Service Cloud- und ServiceMax-Connector, die denselben Authentifizierungsfluss nutzen.

Verbindungen, die bereits mit OAuth 2.0 Client Credentials konfiguriert sind, benötigen keine Änderung.

Diese Anleitung behandelt fünf Schritte:

1. Bestätigen Sie Ihre Agent-Version und identifizieren Sie jede Verbindung, die geändert werden muss.
2. Erfassen Sie eine Instanz-URL, Client-ID und Client-Secret von einer Salesforce-externen Client-App oder verbundenen App.
3. Ändern Sie die Verbindung in OAuth 2.0 Client Credentials und geben Sie die neuen Anmeldedaten ein.
4. Validieren Sie die Änderung durch Bereitstellung und Ausführung der Operationen, die die Verbindung verwenden.
5. Führen Sie die Änderung in der Produktion ein.

Was ändert sich und was nicht

Der Authentifizierungstyp ist eine Eigenschaft der Verbindung, daher deckt eine einzelne Änderung jede Aktivität und jedes Skript ab, das diese Verbindung verwendet:

Vor dem Start

Agent-Version bestätigen

OAuth 2.0 Client Credentials erfordert Cloud-Agenten oder einen privaten Agenten mit mindestens folgenden Versionen:

Überprüfen Sie die Agent-Gruppe für jede betroffene Umgebung.

Zu ändernde Verbindungen identifizieren

Erstellen Sie vor dem Start ein Verzeichnis, damit jede Änderung bewusst und nicht reaktiv erfolgt. Die Seite Endpoints Usage der Management Console ist die einzige Stelle, die Salesforce-Endpunkte in jedem Projekt und jeder Umgebung Ihrer Organisation auflistet. Beginnen Sie dort:

1. Öffnen Sie die Seite Endpoints Usage und suchen Sie nach den Zeilen für den Salesforce-Connector und die Funktion SalesforceLogin. Diese Seite erfordert die Rollenberechtigung Admin role permission.

2. Klicken Sie auf einen Endpunkt, um die Endpunkt-Details-Schublade zu öffnen. Diese zeigt die Umgebung, das Projekt und den Betrieb an, in denen dieser Endpunkt verwendet wird.

3. Klicken Sie auf Go to endpoint, um die Verbindung in Studio zu öffnen, und überprüfen Sie dann den Authentifizierungstyp. Verbindungen, die auf Basic Auth eingestellt sind, müssen geändert werden.

4. Wiederholen Sie dies für jede Salesforce-Zeile, um die vollständige Liste zu erstellen.

Skripte, die auf eine Salesforce-Verbindung über Salesforce-Funktionen verweisen, müssen nicht bearbeitet werden. Beziehen Sie jedoch die Betriebe ein, die diese ausführen, wenn Sie validieren.

Erforderliche Werte aus Salesforce erfassen

OAuth 2.0 Client Credentials authentifiziert sich mit einer Instanz-URL, einer Client-ID und einem Client-Secret, die von einer externen Salesforce-Client-App oder einer verbundenen App stammen. Das vollständige Verfahren finden Sie unter 2-legged OAuth 2.0 prerequisites.

• Instanz-URL: Die Salesforce-Instanz-URL Ihrer Organisation, die von der My Domain-Einstellung abhängt. Mit aktiviertem My Domain (Standard) hat sie die Form https://exampleDomain.my.salesforce.com.

• Client-ID und Client-Secret: Der Consumer Key und das Consumer Secret Ihrer Salesforce-App.

  Important

  Ab Frühjahr 2026 hat Salesforce die Erstellung von verbundenen Apps beschränkt. Erstellen Sie eine externe Client-App, es sei denn, Sie verfügen bereits über eine vorhandene verbundene App.

Unabhängig vom verwendeten App-Typ müssen Sie diese Einstellungen in Salesforce bestätigen:

• Client Credentials Flow aktivieren ist in den OAuth-Einstellungen der App und in ihren Client Credentials Flow-Richtlinien ausgewählt.
• Unter OAuth Scopes ist Benutzerdaten über APIs verwalten (api) zusammen mit allen anderen Scopes ausgewählt, die Ihre Integration benötigt.
• Bei einer externen Client-App ist die Callback URL auf die URL für Ihre Region der Organisation eingestellt.
• Ein Salesforce-Benutzer ist als Run As-Benutzer (oder Ausführungsbenutzer) der App zugewiesen.

Verbindung zu OAuth 2.0 ändern

Nehmen Sie die Änderung zuerst in einer Nicht-Produktionsumgebung vor und befördern Sie dann das validierte Projekt.

1. Notieren Sie die vorhandenen Werte Server host, Sandbox und Username der Verbindung. Wenn Sie diese speichern, können Sie die Verbindung wiederherstellen, falls Sie vor Abschluss der Validierung ein Rollback durchführen müssen.

2. Öffnen Sie die Salesforce-Verbindung zur Bearbeitung aus der Design-Komponentenpalette, der Registerkarte „Komponenten" des Projektbereichs oder der Seite Globale Endpoints.

3. Ändern Sie Authentication type von Basic Auth zu OAuth 2.0 Client Credentials. Die Felder für Anmeldedaten ändern sich in Instance URL, Client ID und Client secret.

4. Geben Sie die Instance URL, die Client ID und das Client secret ein, die Sie von Salesforce erfasst haben. Jedes dieser Felder unterstützt Projektvariablen, was es ermöglicht, dass dasselbe Projekt in jeder Umgebung unterschiedliche Anmeldedaten verwendet.

5. Klicken Sie auf Test, um die Verbindung zu überprüfen, und klicken Sie dann auf Save.

Eine Beschreibung aller Felder auf diesem Bildschirm finden Sie unter Salesforce-Verbindung konfigurieren.

Änderung überprüfen

Ein erfolgreicher Verbindungstest bestätigt nur, dass die Anmeldedaten gültig sind. Führen Sie die Operationen aus, um zu bestätigen, dass die Berechtigungen des Run As-Benutzers ausreichend sind.

1. Führen Sie die Schritte unter Operation bereitstellen und ausführen aus, um die Operationen bereitzustellen und auszuführen, die die aktualisierte Verbindung verwenden, einschließlich aller Operationen, die Skripte ausführen, die auf die Verbindung verweisen.

2. In den Operationsprotokollen bestätigen Sie, dass jede Operation erfolgreich war, und vergleichen Sie die Datensatzanzahl mit einem Durchlauf vor der Änderung. Ein Erfolg mit weniger Datensätzen als erwartet deutet normalerweise darauf hin, dass der Run As-Benutzer keinen Lesezugriff auf einige Datensätze, Objekte oder Felder hat.

3. Öffnen Sie eine Aktivität, die die Verbindung verwendet, und klicken Sie auf Refresh, um die Liste Select Object(s) von Salesforce neu zu laden. Wenn Objekte oder Felder, die vorher vorhanden waren, jetzt fehlen, hat der Run As-Benutzer keinen Zugriff auf sie in Salesforce.

4. Überprüfen Sie die geschriebenen Datensätze in Salesforce, um zu bestätigen, dass die Feldwerte wie erwartet gefüllt wurden.

5. (Optional) Bestätigen Sie, dass nichts mehr die SOAP API login() verwendet. Salesforce bietet einen Test-Lauf, der alle login()-Aufrufe an eine Organisation blockiert und dieselbe Antwort wie die Einstellung zurückgibt. Öffnen Sie in Salesforce Setup unter Release Updates das Update SOAP API login() Retirement, wählen Sie View Update und dann Enable Test Run. Wählen Sie Disable Test Run, um login() wiederherzustellen.

   Vorsicht

   Ein Test-Lauf gilt für die gesamte Salesforce-Organisation, daher schlagen alle Integrationen fehl, die noch login() verwenden, während dieser aktiviert ist. Führen Sie ihn in einer Sandbox aus, nachdem Sie jede Verbindung geändert haben, die sich bei dieser Organisation authentifiziert.

6. (Optional, nur private Agents) Um die genaue Salesforce API-Version zu bestätigen, die eine Anfrage verwendet hat, überprüfen Sie das tomcat/logs/catalina.out-Protokoll des Agents unmittelbar nach dem Klick auf Test bei der Verbindung oder beim Ausführen einer Operation. Es protokolliert die Anfrage-URL, beispielsweise Service request URL: https://login.salesforce.com/services/Soap/u/64.0, wobei die Zahl nach /u/ die aufgerufene API-Version ist.

Änderung ausrollen

1. Nach der Validierung führen Sie die Schritte unter Projektübertragung aus, um das Projekt in Ihre Produktionsumgebung zu übertragen.

2. Falls die Produktionsumgebung separate Salesforce-App-Anmeldedaten verwendet, aktualisieren Sie die Verbindung dort mit den Werten für diese App. Mit Projektvariablen für die Client-ID und das Client-Geheimnis bleibt dies auf eine Variablenwertänderung pro Umgebung beschränkt.

3. Führen Sie die Schritte unter Operation bereitstellen und ausführen aus, um die Operationen bereitzustellen, die die aktualisierte Verbindung verwenden, und bestätigen Sie dann, dass die ersten geplanten oder ausgelösten Läufe erfolgreich abgeschlossen werden.

4. Sobald jede Umgebung validiert ist, stellen Sie das Salesforce-Konto, das zuvor für Basic Auth verwendet wurde, gemäß den Praktiken Ihrer Organisation ein.

Benötigen Sie Hilfe?

Bei Authentifizierungs- und Konfigurationsfehlern finden Sie Informationen unter Salesforce-Connector-Fehlerbehebung.

Kontaktieren Sie Jitterbit Support oder Jitterbit Professional Services für eine koordinierte Änderung oder Unterstützung bei der Planung.