Salesforce 3-beinige OAuth 2.0 API-Sicherheitsprofil im Jitterbit API-Manager

Einführung

Innerhalb eines Sicherheitsprofils können Sie Salesforce als OAuth 2.0-Identitätsanbieter konfigurieren, um API-Nutzern den Zugriff auf eine API mit Salesforce-Authentifizierung zu ermöglichen.

Diese Seite zeigt, wie Sie die Salesforce-Authentifizierung mit einer Jitterbit benutzerdefinierten, OData- oder Proxy-API konfigurieren und verwenden, indem Sie die folgenden Schritte ausführen:

1. Salesforce als Identitätsanbieter aktivieren
   Konfigurieren Sie die Salesforce-Instanz als Identitätsanbieter.
2. Erstellen Sie eine verbundene App in Salesforce
   Konfigurieren Sie eine verbundene App in Salesforce und erhalten Sie den Salesforce Consumer Key (Client-ID) und das Salesforce Consumer Secret (Client-Geheimnis), die Sie als Eingabe für die Konfiguration eines Sicherheitsprofils im API-Manager benötigen.
3. Konfigurieren Sie ein Sicherheitsprofil im API-Manager
   Konfigurieren und testen Sie Salesforce als Identitätsanbieter im API-Manager. Sie müssen die im vorherigen Schritt erhaltene Client-ID und das Client-Geheimnis verwenden.
4. Weisen Sie ein Sicherheitsprofil im API-Manager zu
   Weisen Sie das Sicherheitsprofil einer oder mehreren Jitterbit benutzerdefinierten, OData- oder Proxy-APIs zu.
5. Zugriff auf eine API mit Salesforce-Authentifizierung
   API-Nutzer können die Salesforce-Authentifizierung verwenden, um Jitterbit benutzerdefinierte, OData- oder Proxy-APIs zu konsumieren, denen das Sicherheitsprofil zugewiesen ist.

Für weitere Informationen siehe die Salesforce-Dokumentation Salesforce als Identitätsanbieter aktivieren und Apps mit OAuth autorisieren.

1. Aktivieren Sie Salesforce als Identitätsanbieter

Befolgen Sie diese Schritte, um Salesforce als Identitätsanbieter in der Salesforce Classic-Benutzeroberfläche zu aktivieren:

1. Melden Sie sich als Salesforce-Administrator bei der Salesforce-Instanz an.

2. Navigieren Sie in der Salesforce Classic-Benutzeroberfläche zu Setup > Administer > Security Controls > Identity Provider.

3. Überprüfen Sie im Abschnitt Identity Provider Setup, ob Sie einen Domänennamen konfiguriert haben und ob Salesforce als Identitätsanbieter aktiviert ist:

   • Wenn Sie keine Domäne konfiguriert haben, klicken Sie auf den Link Configure a Domain Name und folgen Sie den Schritten, um eine Domäne einzurichten und sie für Benutzer bereitzustellen. Dadurch wird Salesforce automatisch als Identitätsanbieter aktiviert.

   • Wenn Sie eine Domäne konfiguriert, aber als Identitätsanbieter deaktiviert haben, klicken Sie auf die Schaltfläche Enable Identity Provider.

   

   Tipp

   Nach Änderungen im Identity Provider Setup müssen Sie möglicherweise die Seite aktualisieren.

2. Erstellen Sie eine verbundene App in Salesforce

Befolgen Sie diese Schritte, um eine verbundene App in Salesforce zu konfigurieren und den Salesforce Consumer Key (Client-ID) sowie das Salesforce Consumer Secret (Client Secret) zu erhalten:

1. Wenn Sie von Salesforce als Identitätsanbieter aktivieren fortfahren, klicken Sie auf demselben Bildschirm im Abschnitt Service Providers auf den Link, um über verbundene Apps zu erstellen. Andernfalls navigieren Sie zu Setup > Build > Create > Apps und klicken Sie auf New im Abschnitt Connected Apps.

2. Geben Sie unter Basic Information einen Connected App Name (zum Beispiel Jitterbit API Manager APIs) ein und füllen Sie die anderen erforderlichen Felder aus.

3. Unter API (OAuth-Einstellungen aktivieren) wählen Sie OAuth-Einstellungen aktivieren. Dadurch werden die zusätzlichen Felder Callback-URL und Ausgewählte OAuth-Bereiche aktiviert:

   

   • Callback-URL: Geben Sie die für Ihre Harmony-Organisation und Region geeigneten URLs ein:

     1. Geben Sie die beiden URL-Werte ein, die Sie von der Sicherheitsprofil-Konfigurationsseite kopiert haben:

        

        

     2. Geben Sie den für Ihre Region geeigneten URL-Wert ein (siehe Meine Region finden):

        • NA: https://apps.na-east.jitterbit.com/api-manager/swagger-ui/oauthredirect
        • EMEA: https://apps.emea-west.jitterbit.com/api-manager/swagger-ui/oauthredirect
        • APAC: https://apps.apac-southeast.jitterbit.com/api-manager/swagger-ui/oauthredirect
        • Ausgewählte OAuth-Bereiche: Wählen Sie diese OAuth-Bereiche aus, indem Sie sie zu Ausgewählte OAuth-Bereiche verschieben:
     3. Vollzugriff (full)
        
     4. Führen Sie jederzeit Anfragen in Ihrem Namen aus (refresh_token, offline_access)
        

4. Nach dem Klicken auf Speichern werden der Consumer Key (entspricht der Client-ID im API Manager) und das Consumer Secret (entspricht dem Client-Geheimnis im API Manager) unter API (OAuth-Einstellungen aktivieren) angezeigt. Bewahren Sie diese für die spätere Verwendung auf, da sie bei der Konfiguration des Sicherheitsprofils benötigt werden.

3. Konfigurieren Sie ein Sicherheitsprofil im API Manager

Konfigurieren Sie diese Felder für ein Sicherheitsprofil:

• Auth-Typ: Wählen Sie OAuth 2.0.

• OAuth-Anbieter: Wählen Sie Salesforce.

• Autorisierte Domains: Lassen Sie dieses Feld leer.

• OAuth-Client-ID: Geben Sie den Salesforce Consumer Key ein, der in Schritt 2 erhalten wurde.

• OAuth-Client-Geheimnis: Geben Sie das Salesforce Consumer Secret ein, das in Schritt 2 für Tests erhalten wurde.

• Testverbindung: Klicken Sie, um das Authentifizierungstoken zu validieren.

4. Weisen Sie ein Sicherheitsprofil im API-Manager zu

Um das Sicherheitsprofil mit einer API zu verwenden, folgen Sie den Anweisungen zur Konfiguration einer benutzerdefinierten API, OData-Dienst oder Proxy-API und wählen Sie das mit Salesforce OAuth 2.0-Authentifizierung konfigurierte Sicherheitsprofil aus.

5. Greifen Sie mit Salesforce-Authentifizierung auf eine API zu

Sobald Sie eine benutzerdefinierte API, OData-Dienst oder Proxy-API gespeichert und veröffentlicht haben, ist die API über die URL in der Anwendung, die die API mit der konfigurierten Authentifizierungsmethode aufruft, zugänglich.

Um die API zu konsumieren, verwenden Sie den Link zu URL kopieren und verwenden Sie ihn innerhalb der aufrufenden Anwendung:

Wenn die API GET unterstützt, können Sie die URL auch in einen Webbrowser einfügen, um die API manuell zu konsumieren.

Der Browser leitet Sie zur nativen Anmeldeschnittstelle von Salesforce weiter. Geben Sie Ihre Anmeldeinformationen ein, um sich bei Salesforce zu authentifizieren.

Wenn die Authentifizierung erfolgreich ist, wird die erwartete Nutzlast im Webbrowser angezeigt.