Zum Hauptinhalt springen

Voraussetzungen

Konfiguration der Voraussetzungen

Salesforce-Komponenten für die DuoKey-BYOK-Integration konfigurieren

Vorschau

Die Salesforce-Shield-Integration befindet sich in der Vorschau und ist auf Standard-Tenants von DuoKey Cockpit noch nicht aktiviert. Dieser Leitfaden beschreibt Funktionsweise und Einrichtung. Kontaktieren Sie DuoKey, um den Zugang für Ihr Projekt zu besprechen.

Gilt für:
Salesforce-SetupConnected AppSelbstsigniertes ZertifikatREST-API-Anmeldedaten

Überblick​

Zu den Voraussetzungen gehören:

  1. Erstellen einer Connected App in Salesforce
  2. Erzeugen eines selbstsignierten Zertifikats
  3. Beschaffen der REST-API-Anmeldedaten

Schritt 1: Connected App erstellen​

Eine Connected App stellt eine sichere Kommunikation zwischen DuoKey und Salesforce über die REST API her.

1

Zum App Manager navigieren

  1. Melden Sie sich bei Ihrem Salesforce-Konto an
  2. Klicken Sie auf das Zahnradsymbol Setup
  3. Suchen Sie in Quick Find nach „App Manager“
  4. Navigieren Sie zu Apps → App Manager
2

Neue Connected App erstellen

  1. Klicken Sie auf die Schaltfläche New Connected App
  2. Füllen Sie die Basisinformationen aus:
FeldWert
Connected App NameDuoKey BYOK Integration
API Name(automatisch ausgefüllt)
Contact Email[email protected]
3

OAuth-Einstellungen konfigurieren

  1. Aktivieren Sie Enable OAuth Settings
  2. Setzen Sie die Callback-URL: sfdc://oauth/restapi/success
  3. Fügen Sie unter Selected OAuth Scopes hinzu: Full access (full)
  4. Klicken Sie auf Save
Hinweis

Die Callback-URL sfdc://oauth/restapi/success ist Standard für Salesforce-REST-API-Integrationen.

4

Consumer Key und Secret abrufen

  1. Suchen Sie im App Manager Ihre neu erstellte Connected App
  2. Klicken Sie auf den Dropdown-Pfeil (▼) und wählen Sie View
  3. Klicken Sie im Abschnitt API (Enable OAuth Settings) auf Manage Consumer Details
  4. Geben Sie den an Ihre E-Mail gesendeten Bestätigungscode ein
  5. Kopieren und speichern Sie sicher:
    • Consumer Key (Client ID)
    • Consumer Secret (Client Secret)
Warnung

Bewahren Sie diese Anmeldedaten sicher auf. Sie benötigen sie bei der Konfiguration der DuoKey-Anwendung.

Schritt 2: Selbstsigniertes Zertifikat erzeugen​

Salesforce erfordert für die BYOK-Integration mit dem Cache-Only Key Service ein selbstsigniertes Zertifikat.

1

Zur Zertifikatsverwaltung navigieren

  1. Suchen Sie im Salesforce-Setup in Quick Find nach „Certificate“
  2. Navigieren Sie zu Security → Certificate and Key Management
2

Selbstsigniertes Zertifikat erstellen

  1. Klicken Sie auf Create Self-Signed Certificate
  2. Füllen Sie die Zertifikatsdetails aus:
FeldWertHinweis
LabelDuoKey BYOK CertificateAussagekräftiger Name
Unique Name(automatisch ausgefüllt)Oder manuell eingeben
Key Size4096Aus Sicherheitsgründen empfohlen
Exportable Private KeyAktiviert Ermöglicht Sicherung/Migration
Tipp

Durch die Aktivierung von „Exportable Private Key“ können Sie das Zertifikat bei Bedarf zu Sicherungs- oder Migrationszwecken exportieren.

Klicken Sie auf Save

Schritt 3: REST-API-Anmeldedaten beschaffen​

Salesforce-Benutzername und -Passwort​

Dies sind Ihre standardmäßigen Salesforce-Anmeldedaten:

  • Benutzername: Ihre Salesforce-Konto-E-Mail
  • Passwort: Ihr Salesforce-Kontopasswort

Security Token erzeugen​

1

Security Token zurücksetzen

  1. Klicken Sie oben rechts auf Ihr Profilsymbol
  2. Wählen Sie Settings
  3. Suchen Sie in Quick Find nach „Reset My Security Token“
  4. Navigieren Sie zu My Personal Information → Reset My Security Token
  5. Klicken Sie auf Reset Security Token
  6. Prüfen Sie Ihre E-Mails auf den neuen Security Token
  7. Kopieren und speichern Sie den Security Token sicher
Vorsicht
  • Der Security Token wird per E-Mail gesendet und sollte vertraulich behandelt werden
  • Wenn Sie Ihr Passwort ändern, wird Ihr Security Token automatisch zurückgesetzt
  • Sie müssen den aktuellsten Security Token für die API-Authentifizierung verwenden

Salesforce-Domain/-Instanz​

  1. Navigieren Sie zu Setup Home → Company Settings → My Domain
  2. Notieren Sie Ihren Domainnamen (z. B. yourcompany.develop.lightning.force.com)
  3. Extrahieren Sie den Instanz-Alias (z. B. yourcompany)

Zusammenfassung der Anmeldedaten​

AnmeldedatenBeschreibungBeispiel
Consumer KeyAus den OAuth-Einstellungen der Connected App3MVG9... (lange Zeichenfolge)
Consumer SecretAus den OAuth-Einstellungen der Connected App12345... (numerische Zeichenfolge)
Salesforce-BenutzernameIhre Salesforce-Anmelde-E-Mail[email protected]
Salesforce-PasswortIhr Salesforce-KontopasswortYourP@ssw0rd
Security TokenAus „Reset My Security Token“ABC123... (alphanumerisch)
Domain/InstanzIhr Salesforce-Domain-Aliasyourcompany
ZertifikatName des selbstsignierten ZertifikatsDuoKey BYOK Certificate
Tipp

Erwägen Sie die Verwendung eines sicheren Passwort-Managers, um diese Anmeldedaten sicher zu speichern.

Verifizierungs-Checkliste​

Voraussetzungen abgeschlossen

Connected AppMit aktiviertem OAuth erstellt
Consumer-AnmeldedatenKey und Secret beschafft
Zertifikat4096-Bit-Schlüssel erstellt
Security TokenPer E-Mail beschafft

Fehlerbehebung​

Nächste Schritte​

Salesforce-App erstellen

Die DuoKey-Anwendung konfigurieren

Integration testen

Überprüfen, ob die Einrichtung funktioniert

Siehe auch