Salesforce / OpenID Connect-Sicherheitsanbieter in Jitterbit App Builder

Der Salesforce / OpenID Connect (SF/OIDC)-Sicherheitsanbieter ist eine herstellerspezifische Implementierung des OpenID Connect-Sicherheitsanbieters. Die Salesforce-Implementierung ermöglicht es App Builder, Salesforce-Benutzer zu authentifizieren. Es kann auch verwendet werden, um Anfragen an die folgenden Datenserver zu autorisieren:

• Salesforce ADO.NET
• REST

Einschränkungen

• Der SF/OIDC-Sicherheitsanbieter kann nicht mit Salesforce1 Platform-Datenservern verwendet werden
• Der SF/OIDC-Sicherheitsanbieter unterstützt den Parameter ReplaceIssuerTenantId nicht

Konfiguration in Salesforce

Um zu beginnen, müssen Sie sich in Ihrem Salesforce-Konto anmelden und eine verbundene App erstellen.

Über den Bildschirm Verbundene Apps verwalten in Salesforce:

1. Geben Sie den Wert Callback URL an. Dies ist die URL, die nach der OAuth-Autorisierung für die Consumer-verbundene App aufgerufen wird. Dies ist das App Builder-Stammverzeichnis/signin-[Scheme des Sicherheitsanbieters].
   Beispiel: https://example.com/Vinyl/signin-Salesforce

2. Fügen Sie die folgenden Verfügbaren OAuth-Bereiche zur Liste Ausgewählte OAuth-Bereiche hinzu:

   • Zugriff auf den Identitäts-URL-Dienst (id, profile, email, address, phone)
   • Zugriff auf eindeutige Benutzerbezeichner (openid)
   • Vollzugriff (full)
   • Benutzerdaten über APIs verwalten (api)
   • Anfragen jederzeit ausführen (refresh_token, offline_access)

3. Stellen Sie sicher, dass die folgenden Optionen aktiviert sind:

   • Proof Key for Code Exchange (PKCE)-Erweiterung für unterstützte Autorisierungsflows erforderlich
   • Geheimnis für Web Server Flow erforderlich
   • Geheimnis für Refresh Token Flow erforderlich
   • Client Credentials Flow aktivieren

Der Consumer Key und das Consumer Secret für die Salesforce-verbundene App sind für die App Builder-Konfiguration erforderlich. Stellen Sie sicher, dass Sie diese Werte zur Hand haben.

So beschaffen Sie die Salesforce-Anmeldedaten für verbundene Apps:

1. Melden Sie sich in Ihrem Salesforce-Konto an
2. Navigieren Sie zu Apps > Connected Apps > Manage Connected Apps
3. Klicken Sie auf die Schaltfläche Manage Consumer Details für Consumer Key and Secret
4. Kopieren Sie die Werte Consumer Key und Consumer Secret

Salesforce als Sicherheitsanbieter in App Builder konfigurieren

Der SF/OIDC-Sicherheitsanbieter erfordert:

• Client-Anmeldedaten (Consumer Key und Consumer Secret)

So konfigurieren Sie den Salesforce-Sicherheitsanbieter:

1. Melden Sie sich als Administrator bei der App Builder-Instanz an
2. Navigieren Sie zur IDE
3. Klicken Sie im Menü Connect auf Security Providers
4. Klicken Sie auf + Security Provider

5. Geben Sie Folgendes an:

   • Name: Salesforce
   • Type: Salesforce / OpenID Connect

6. Aktivieren Sie das Feld Enabled

7. Wählen Sie User als Wert für Owner der Tokens
8. Klicken Sie auf die Schaltfläche Save
9. Im Panel Endpoints stellt App Builder Standard-Endpunkte bereit und es ist keine zusätzliche Konfiguration erforderlich, es sei denn, Sie möchten die Standards außer Kraft setzen. Der Standardwert für OpenID Connect Issuer ist https://login.salesforce.com.

10. Klicken Sie im Panel Credentials auf die Schaltfläche + Credential, um die folgende Anmeldeinformation hinzuzufügen:

    • Type: Client
    • User Name: Geben Sie den Salesforce Consumer Key an
    • Password: Geben Sie das Salesforce Consumer Secret an

11. Klicken Sie auf Save und beenden Sie den Bildschirm Credential

12. Klicken Sie im Panel Properties auf die Schaltfläche +Property, um die folgenden Eigenschaften hinzuzufügen:

    • Parameter: Scopes
    • Value: openid profile offline_access api

13. Klicken Sie auf Speichern und beenden Sie den Bildschirm Eigenschaften

14. Klicken Sie auf + Anspruch im Panel Ansprüche und fügen Sie folgendes hinzu:

    • Identifizierungsmerkmal: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name
    • Verwendung: Name

15. Klicken Sie auf Speichern und fügen Sie einen weiteren Datensatz für Ansprüche hinzu:

    • Identifizierungsmerkmal: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier
    • Verwendung: Name ID

16. Klicken Sie auf Speichern

Salesforce als Datenbankserver registrieren

So registrieren Sie Salesforce als Datenbankserver:

1. Melden Sie sich als Administrator bei der App Builder-Instanz an
2. Navigieren Sie zur IDE
3. Klicken Sie auf die Schaltfläche Datenbankserver im Menü Verbinden
4. Klicken Sie auf + Server, um einen neuen Server zu registrieren

5. Geben Sie folgendes an:

   • Servername: Ein eindeutiger Name. Beispiel: Salesforce Connected App
   • Typ: Salesforce ADO.NET

6. Klicken Sie auf die Schaltfläche Erweiterte Einstellungen

7. Geben Sie die OAuth-Serverinformationen im Feld Erweitert ein:

   https://<your instance>.salesforce.com/services/Soap/c/56.0/<your organization ID>
   Um Ihre Instanz zu finden, melden Sie sich bei Salesforce an. Die URL beginnt mit der richtigen Instanz.
   Die Organisations-ID finden Sie in folgendem Salesforce-Artikel: Ihre Salesforce-Organisations-ID finden

8. Klicken Sie auf Speichern und kehren Sie zum Bildschirm Server-Einstellungen zurück

9. Erweitern Sie Sicherheitseinstellungen und wählen Sie Salesforce als Sicherheitsanbieter
10. Klicken Sie auf Speichern

11. Erweitern Sie Tests und klicken Sie auf die Schaltfläche Verbindung testen

    • Klicken Sie auf die Schaltfläche Fortfahren, um zu bestätigen. Wenn alle Informationen korrekt konfiguriert sind, erhalten Sie die Meldung „Der Verbindungstest war erfolgreich."