Sie befinden sich hier:
Definieren von Anmeldeinformationen mit Namen der alten Art
Sie können Anmeldeinformationen mit Namen der alten Art erstellen, um den URL eines Callout-Endpunkts und die zugehörigen erforderlichen Authentifizierungsparameter in einer Definition anzugeben. Anschließend können Sie diese Anmeldeinformationen mit Namen der alten Art als einen Callout-Endpunkt angeben, damit Salesforce die gesamte Authentifizierung verarbeitet. Für die in den Anmeldeinformationen mit Namen der alten Art definierte Site können Sie auch die Einstellungen für Remote-Standorte auslassen, die andernfalls für Callouts an externe Sites erforderlich sind.
Erforderliche Editionen
| Verfügbarkeit: Salesforce Classic und Lightning Experience |
| Verfügbarkeit: Alle Editionen |
| Erforderliche Benutzerberechtigungen | |
|---|---|
| Anzeigen von Anmeldeinformationen mit Namen der alten Art: | Setup und Konfiguration anzeigen |
| Erstellen, Bearbeiten oder Löschen von Anmeldeinformationen mit Namen der alten Art: | "Anmeldeinformationen mit Namen verwalten" oder "Anwendung anpassen" |
Anmeldeinformationen mit Namen der alten Art werden in diesen Callout-Definitionstypen unterstützt:
- Apex-Callouts
- Externe Datenquellen dieser Typen:
- Salesforce Connect: OData 2.0
- Salesforce Connect: OData 4.0
- Salesforce Connect: Benutzerdefiniert (mit dem Apex Connector Framework entwickelt)
- Salesforce Connect: Amazon DynamoDB
- Externe Services
Einrichten von Anmeldeinformationen mit Namen der alten Art:
- Geben Sie unter "Setup" im Feld "Schnellsuche" den Text Anmeldeinformationen mit Namen ein und wählen Sie Anmeldeinformationen mit Namen aus.
- Klicken Sie zum Erstellen von Anmeldeinformationen mit Namen der alten Art im Dropdown-Menü auf Neu (alte Art). Bearbeiten Sie vorhandene alte Anmeldeinformationen, indem Sie auf den zugehörigen Link und dann auf Bearbeiten klicken.
-
Geben Sie Informationen in die Felder ein.
-
Wählen Sie das Authentifizierungsprotokoll aus.
- Wenn Sie Kennwortauthentifizierung auswählen, geben Sie den Benutzernamen und das Kennwort für den Zugriff auf das externe System ein.
- Wenn Sie OAuth 2.0 auswählen, füllen Sie folgende Felder aus.
Feld Beschreibung Authentifizierungsanbieter Wählen Sie den Anbieter aus. Siehe Authentifizierungsanbieter. Umfang Gibt den Umfang der angeforderten Berechtigungen für das Zugriffstoken an. Ihr Authentifizierungsanbieter ermittelt die zulässigen Werte. Siehe Verwenden des Umfangsparameters.
- Der von Ihnen eingegebene Wert ersetzt den Wert Standardumfänge, der im angegebenen Authentifizierungsanbieter definiert ist.
- Die Tatsache, ob Umfänge definiert sind, kann sich darauf auswirken, ob jeder OAuth-Flow den Benutzer mit einem Einwilligungsbildschirm zu einer Interaktion auffordert.
- Sie sollten ein Aktualisierungstoken oder den Offlinezugriff anfordern. Ansonsten kann nach dem Ablauf des Tokens der Zugriff auf das externe System verlorengehen.
Authentifizierungs-Flow bei Auswahl von "Speichern" starten Aktivieren Sie dieses Kontrollkästchen, um sich am externen System zu authentifizieren und um ein OAuth-Token abzurufen. Dieser Authentifizierungsprozess wird als OAuth-Flow bezeichnet.
Beim Klicken auf Speichern werden Sie vom externen System aufgefordert, sich anzumelden. Nach der erfolgreichen Anmeldung gewährt Ihnen das externe System ein OAuth-Token für den Zugriff auf die entsprechenden Daten über diese Organisation.
Wiederholen Sie den OAuth-Flow, wenn Sie ein neues Token benötigen (beispielsweise bei Ablauf des Tokens) oder wenn Sie das Feld Umfang oder Authentifizierungsanbieter bearbeiten. Wenn das Token abläuft, wird vom externen System der HTTP-Fehlerstatus 401 zurückgegeben.
- Füllen Sie bei Auswahl von JWT oder JWT-Tokenaustausch die folgenden Felder aus.
Feld Beschreibung Aussteller Geben Sie den Aussteller des JWT durch eine Zeichenfolge mit Berücksichtigung der Groß- und Kleinschreibung an. Umfang Nur JWT-Tokenaustausch. Bestimmt die Berechtigungen, die den Token zugeordnet sind, die von Ihnen angefordert werden. Token-Endpunkt-URL Nur JWT-Tokenaustausch. Der URL des Autorisierungsanbieters. JSON-Webtoken-Anforderungen werden im Austausch gegen Zugriffstoken an den Anbieter gesendet. Subjekt pro Benutzer Nur Identitätstyp "Pro Benutzer". Formelzeichenfolge, in der das Subjekt von JWT berechnet wird. Setzen Sie API-Namen und konstante Zeichenfolgen in Anführungszeichen. Erlaubt ein dynamisches Subjekt, das für den Benutzer, der das Token anfordert, eindeutig ist. Beispielsweise 'User='+$User.Id. Benanntes Prinzipal-Subjekt Nur Identitätstyp "Benannter Prinzipal". Geben Sie statischen Text ohne Anführungszeichen ein, der das JWT-Subjekt angibt. Zielgruppen Externer Service oder andere zulässige Empfänger für das JWT. Speichern Sie jede Zielgruppe als Zeichenfolge mit Berücksichtigung der Groß- und Kleinschreibung in einer neuen Zeile. Token gültig für Die Gültigkeitsdauer des Tokens für die Authentifizierung des Benutzers beim externen System. JWT-Signaturzertifikat Das Zertifikat, das die Echtheit des JWTs bei externen Systemen verifiziert. - Füllen Sie bei Auswahl von AWS Signature Version 4 die folgenden Felder aus.
Feld Beschreibung AWS Access Key ID (AWS-Zugriffsschlüssel-ID) Der erste Teil des Zugriffsschlüssels, der zum Signieren der an AWS gesendeten programmatischen Anforderungen verwendet wird. Geheimer AWS-Zugriffsschlüssel Der zweite Teil des Zugriffsschlüssels, der zum Signieren der an AWS gesendeten programmatischen Anforderungen verwendet wird. AWS-Region Der Name der AWS-Region für den Endpunkt von Anmeldeinformationen mit Namen der alten Art. Beispielsweise us-east-1. AWS-Service Das AWS-Dienstprogramm, auf das zugegriffen werden soll.
-
Wenn Sie benutzerdefinierte Kopfzeilen oder Texte in den Callouts verwenden möchten, sollten Sie die relevanten Optionen aktivieren.
Feld Beschreibung Autorisierungskopfzeile generieren Salesforce generiert standardmäßig eine Autorisierungskopfzeile und wendet sie auf jedes Callout an, das auf die Anmeldeinformationen mit Namen der alten Art verweist.
Deaktivieren Sie diese Option nur dann, wenn eine der folgenden Aussagen zutrifft.
- Der Remote-Endpunkt unterstützt keine Autorisierungskopfzeilen.
- Die Autorisierungskopfzeilen werden auf andere Weise bereitgestellt. In Apex-Callouts kann der Entwickler über den Code beispielsweise eine benutzerdefinierte Autorisierungskopfzeile für jedes Callout erstellen lassen.
Diese Option ist erforderlich, wenn Sie über eine externe Datenquelle auf die Anmeldeinformationen mit Namen der alten Art verweisen.
Briefvorlagenfelder in HTTP-Kopfzeile zulassen
Briefvorlagenfelder im HTTP-Text zulassen
In jedem Apex-Callout gibt der Code an, wie die HTTP-Kopfzeile und der Anforderungstext erstellt werden. So kann über den Apex-Code z. B. der Wert eines Cookies in einer Autorisierungskopfzeile festgelegt werden.
Dank dieser Optionen kann der Apex-Code Briefvorlagenfelder verwenden, um bei der Erstellung des Callouts Organisationsdaten in die HTTP-Kopfzeile und in den Anforderungstext einzufügen.
Diese Optionen sind nicht verfügbar, wenn Sie über eine externe Datenquelle auf die Anmeldeinformationen mit Namen der alten Art verweisen.
Verwenden Sie den URL für die Anmeldeinformationen mit Namen der alten Art, um über eine Callout-Definition auf diese Anmeldeinformationen mit Namen zu verweisen. Ein URL für die Anmeldeinformationen mit Namen der alten Art enthält das Schema callout:, den Namen dieser Anmeldeinformationen mit Namen und einen optionalen Pfad. Beispiel: callout:My_Named_Credential/some_path.
Sie können eine Abfragezeichenfolge an einen URL für die Anmeldeinformationen mit Namen der alten Art anhängen. Verwenden Sie ein Fragezeichen (?) als Trennzeichen zwischen dem URL für die Anmeldeinformationen mit Namen der alten Art und der Abfragezeichenfolge. Beispiel: callout:My_Named_Credential/some_path?format=json.
Siehe auch:
- Grundlegendes zu Anmeldeinformationen mit Namen der alten Art
- Authentifizierungsprotokolle für Anmeldeinformationen mit Namen
- Erteilen von Zugriff auf Authentifizierungseinstellungen für Anmeldeinformationen mit Namen der alten Art
- Apex-Entwicklerhandbuch: Invoking Callouts Using Apex (Aufrufen von Callouts mithilfe von Apex)
- Erstellen von Anmeldeinformationen mit Namen und externen Anmeldeinformationen

