Einrichten der Salesforce Connected-Anwendung

Das Ziel dieser Anleitung ist es, amberSearch den Zugriff auf die Salesforce-Umgebung zu ermöglichen. Zu diesem Zweck sollte der Administrator von Salesforce eine sogenannte „Connected App” in seiner Umgebung erstellen. Die Connected App dient als Client, der bestimmte API-Berechtigungen gewährt, die es amberSearch ermöglichen, auf die Inhalte von Salesforce zuzugreifen und diese zu indexieren.

Schritt 1: Erstellen Sie die verbundene App

  • Navigieren Sie zu Einstellungen

  • Suchen Sie im Suchfeld „Schnellsuche“ nach „App-Manager“ und navigieren Sie zum App-Manager.

  • Drücken Sie auf „Neue verbundene App“ und geben Sie die folgenden grundlegenden Daten ein

    • Name der verbundenen App: amberSearch Connected App

    • Kontakt Email: it@ambersearch.de

      • Oder verwenden Sie Ihre eigene E-Mail-Adresse. Manchmal erhalten Sie Bestätigungscodes.

  • Aktivieren Sie die OAuth-Einstellungen

    • Callback-URL festlegen: https://login.salesforce.com/services/oauth2/success

    • Wählen Sie „Benutzerdaten über APIs verwalten (API)” aus den ausgewählten OAuth-Bereichen aus.

    • Stellen Sie außerdem die folgenden Prüfungen ein:

      • Erfordert die Erweiterung „Proof Key for Code Exchange“ (PKCE) für unterstützte Autorisierungsabläufe

      • Geheimnis für Webserver-Ablauf erforderlich

      • Geheimnis für Aktualisierungstoken-Ablauf erforderlich

      • Client-Anmeldeinformationen aktivieren

  • Speichern

Schritt 2: Neuen Benutzer erstellen

Je nach den Modulen und Inhalten, die in amberSearch integriert werden sollen, muss der neue Benutzer, der angelegt werden soll, Zugriff auf diese Inhalte haben. Wenn beispielsweise Service Cloud das relevante Modul von Salesforce ist, sollte der Benutzer Zugriff auf die Fälle haben.

  • Navigieren Sie zu den Einstellungen

  • Suchen Sie im Suchfeld „Schnellsuche“ nach Benutzern und navigieren Sie zu „Benutzer“.

  • Neuer Benutzer anlegen

  • Stellen Sie sicher, dass Sie dem Benutzer die erforderliche Lizenz/das erforderliche Profil zuweisen.

Schritt 3: Weitere Konfiguration der verbundenen App

  • Navigieren Sie zu Einstellungen, suchen Sie im Suchfeld Schnellsuche nach verbundenen Apps und navigieren Sie zu Verbundene Apps verwalten.

  • Klicken Sie auf Bearbeiten für die in Schritt 1 verbundene Anwendung.

  • OAuth-Richtlinien -> Zugelassene Benutzer -> Alle Benutzer auswählen dürfen sich selbst autorisieren

  • Client Credentials Flow -> Ausführen als -> Legen Sie den Benutzer aus Schritt 2 fest.

Schritt 4: Abrufen der Verbraucherdaten

In diesem Schritt rufen wir die Verbraucherdaten (Client-ID und Secret) ab, die in der Salesforce-Terminologie als Verbraucherschlüssel und Verbrauchergeheimnis bezeichnet werden.

  • Navigieren Sie zu Einstellungen, suchen Sie im Suchfeld Schnellsuche nach App-Manager und navigieren Sie zu App-Manager.

  • Zeigen Sie die in Schritt 1 verbundene App an.

  • Klicken Sie auf „Verbraucherdaten verwalten” (im Abschnitt „API (OAuth-Einstellungen aktivieren)”).

  • Geben Sie den Consumer Key und den Consumer Secret an das amberSearch-Team weiter.

Die Englische Version für das Set Up der Salseforce Connected Application ist hier zu finden.