Sie befinden sich hier:
Erstellen oder Bearbeiten von Anmeldeinformationen mit Namen
Konfigurieren Sie Anmeldeinformationen mit Namen, um den URL eines Callout-Endpunkts anzugeben. Verbinden Sie die Anmeldeinformationen mit Namen mit externen Anmeldeinformationen, um die erforderlichen Authentifizierungsparameter für den Callout anzugeben.
Erforderliche Editionen
| Verfügbarkeit: Salesforce Classic (nicht in allen Organisationen verfügbar) und Lightning Experience |
| Verfügbarkeit: alle Editionen |
| Erforderliche Benutzerberechtigungen | |
|---|---|
| Anzeigen von Anmeldeinformationen mit Namen: | Setup und Konfiguration anzeigen |
| Erstellen, Bearbeiten oder Löschen von Anmeldeinformationen mit Namen: | "Anmeldeinformationen mit Namen verwalten" oder "Anwendung anpassen" |
Erstellen Sie vor dem Erstellen von Anmeldeinformationen mit Namen externe Anmeldeinformationen, mit denen sie verknüpft werden sollen. Entsprechende Informationen finden Sie unter Erstellen oder Bearbeiten von externen Anmeldeinformationen. Eine Übersicht über die zum Konfigurieren von Anmeldeinformationen mit Namen erforderlichen Schritte finden Sie unter Erstellen von Anmeldeinformationen mit Namen und externen Anmeldeinformationen.
- Verwenden Sie unter "Setup" das Feld "Schnellsuche", um Anmeldeinformationen mit Namen zu suchen und auszuwählen.
- Klicken Sie auf Anmeldeinformationen mit Namen.
-
Klicken Sie zum Erstellen neuer Anmeldeinformationen mit Namen auf Neu. Um bestehende Anmeldeinformationen mit Namen zu bearbeiten, klicken Sie auf den zugehörigen Link in der Liste der Anmeldeinformationen mit Namen und dann auf Bearbeiten.
Hinweis Wenn Sie Anmeldeinformationen mit Namen der alten Art erstellen möchten, wählen Sie stattdessen im Dropdown-Menü den Eintrag Neu (alte Art) aus und befolgen Sie die Anweisungen unter Definieren von Anmeldeinformationen mit Namen der alten Art. Anmeldeinformationen mit Namen der alten Art werden nicht mehr aktualisiert oder erweitert. -
Füllen Sie die Felder aus.
Feld Beschreibung Bezeichnung Ein benutzerfreundlicher Name für die Anmeldeinformation mit Name, der in der Salesforce-Benutzeroberfläche, beispielsweise in Listenansichten, angezeigt wird. Name Eine eindeutige Kennung, die verwendet wird, um über Callout-Definitionen und durch die API auf diese Anmeldeinformation mit Name zu verweisen.
Der Name darf nur Unterstriche und alphanumerische Zeichen enthalten. Der Name muss eindeutig sein, muss mit einem Buchstaben beginnen, darf keine Leerzeichen enthalten und nicht mit einem Unterstrich enden oder zwei aufeinanderfolgende Unterstriche enthalten.
URL Der URL oder Stamm-URL des Callout-Endpunkts. Muss mit
https://beginnen. Kann einen Pfad, aber keine Abfragezeichenfolge aufweisen. Beispiel:https://my_endpoint.example.com/secure/payrollSie können jedoch eine Abfragezeichenfolge und einen spezifischen Pfad im Verweis auf die Anmeldeinformation mit Name der Callout-Definition anhängen.
So könnte ein Apex-Callout die Anmeldeinformation mit Name "My_Payroll_System" beispielsweise wie folgt referenzieren.
HttpRequest req = new HttpRequest(); req.setEndpoint('callout:My_Payroll_System/paystubs?format=json');Für Callouts aktiviert Standardmäßig ist die Möglichkeit, Callouts mit den Anmeldeinformationen mit Namen zu erstellen, aktiviert. Es gibt zwei Ausnahmen, in denen dieses Feld deaktiviert ist: Wenn die Anmeldeinformation mit Namen aus einer Apex-Anwendung erstellt wird oder wenn ein Endpunkt der Anmeldeinformation mit Namen oder der zugehörigen externen Anmeldeinformationen oder des Authentifizierungsidentitätsanbieters aus einer Apex-Anwendung aktualisiert wird. Beachten Sie beim Aktivieren von Callouts für Anmeldeinformationen mit Namen, die aus Apex stammen oder von Apex aktualisiert werden, Sicherheitsaspekte. Authentifizierung Externe Anmeldeinformation Der Name von bestimmten externen Anmeldeinformationen. Entsprechende Informationen finden Sie unter Erstellen oder Bearbeiten von externen Anmeldeinformationen. Client-Zertifikat Optional. Wenn Sie ein Zertifikat angeben, stellt Ihre Salesforce-Organisation es bereit, wenn jede bidirektionale SSL-Verbindung mit dem externen System hergestellt wird. Das Zertifikat wird für digitale Signaturen verwendet, die nachweisen, dass Anforderungen von Ihrer Salesforce-Organisation stammen. Callout-Optionen Autorisierungskopfzeile generieren Salesforce generiert standardmäßig eine Autorisierungskopfzeile und wendet sie auf jedes Callout an, das auf die Anmeldeinformation mit Namen verweist.
Deaktivieren Sie diese Option nur dann, wenn eine der folgenden Aussagen zutrifft.
- Der Remote-Endpunkt unterstützt keine Autorisierungskopfzeilen.
- Sie generieren eine Autorisierungskopfzeile, indem Sie eine benutzerdefinierte Kopfzeile erstellen und sie "Autorisierung" nennen. Erstellen Sie beispielsweise eine benutzerdefinierte Autorisierungskopfzeile, wenn Sie die grundlegende HTTP-Autorisierung verwenden. In Apex-Callouts können Sie über den Code entsprechend eine benutzerdefinierte Autorisierungskopfzeile für jedes Callout erstellen.
Diese Option ist erforderlich, wenn Sie über eine externe Datenquelle auf die Anmeldeinformation mit Name verweisen. Entsprechende Informationen finden Sie unter Custom Headers and Bodies of Apex Callouts That Use Named Credentials.
Formeln in HTTP-Kopfzeile zulassen Verwenden Sie Felder mit Anmeldeinformationen als Formelfelder in benutzerdefinierten Kopfzeilen mit Anmeldeinformation mit Namen, in benutzerdefinierten Kopfzeilen mit externer Anmeldeinformation und in Apex-HTTP-Kopfzeilen. Beispiel:
Client-ID: {!$Credential.MyExtCred.MyClientId}Der Standardwert lautet "falsch". Entsprechende Informationen finden Sie unter Custom Headers and Bodies of Apex Callouts That Use Named Credentials.
Formeln im HTTP-Text zulassen Lassen Sie zu, dass Apex den HTTP-Text des Callouts mit den als Formelfeldern verfügbaren Anmeldeinformationen erstellt. Der Standardwert lautet "falsch". Entsprechende Informationen finden Sie unter Custom Headers and Bodies of Apex Callouts That Use Named Credentials. Ausgehende Netzwerkverbindung Verwenden Sie eine private Verbindung, die das öffentliche Internet umgeht. Geben Sie den Namen einer vorhandenen ausgehenden Netzwerkverbindung ein. Entsprechende Informationen finden Sie unter Schützen cloudübergreifender Integrationen mit Private Connect.
Bei Auswahl dieser Option weisen Ihre neuen Anmeldeinformationen mit Namen den Typ PrivateEndpoint auf. Andernfalls weisen die Anmeldeinformationen mit Namen den Typ SecuredEndpoint auf.
Zulässige Namespaces für Callouts Optionale Liste von Namespaces, in der die verwalteten Pakete angegeben werden, die mit diesen Anmeldeinformationen mit Namen Aufrufe senden dürfen.
- Bei verwalteten Paketen muss der Abonnent den Namespace des Pakets zur Liste der zulässigen Namespaces einer Anmeldeinformation mit Namen hinzufügen, um Callouts zu aktivieren. Diese Aktion ist nicht erforderlich, wenn die Anmeldeinformationen mit Namen im Rahmen desselben Pakets installiert sind.
- Wenn Sie mehrere Organisationen besitzen, können Sie eine Anmeldeinformation mit demselben Namen, jedoch mit einem anderen Endpunkt-URL in jeder Organisation erstellen. Anschließend können Sie – für alle Organisationen – ein Paket der Callout-Definition, die auf den freigegebenen Namen dieser Anmeldeinformationen mit Name verweist, erstellen und bereitstellen. Die Anmeldeinformation mit Name kann beispielsweise in jeder Organisation einen anderen Endpunkt-URL aufweisen, um den Unterschieden zwischen Entwicklungs- und Produktionsumgebungen Rechnung zu tragen. Wenn der freigegebene Name dieser Anmeldeinformationen mit Namen durch ein Apex-Callout angegeben wird, kann ein Paket der Apex-Klasse, durch die das Callout definiert wird, erstellt und in allen betreffenden Organisationen bereitgestellt werden, ohne die Umgebung programmatisch zu überprüfen.
Anmeldeinformationen mit Name werden nicht automatisch zu Paketen hinzugefügt. Wenn Sie eine externe Datenquelle oder Apex-Code, die bzw. der eine Anmeldeinformation mit Name als Callout-Endpunkt angibt, zu einem Paket hinzufügen, fügen Sie auch die Anmeldeinformation mit Name zu diesem Paket hinzu. Stellen Sie alternativ sicher, dass die Abonnentenorganisation über eine gültige Anmeldeinformation mit Name mit demselben Namen verfügt.
- Klicken Sie auf Speichern. Sie gelangen zum Bildschirm "Anmeldeinformationen mit Namen".
- Optional können Sie eine benutzerdefinierte Kopfzeile für diese Anmeldeinformationen mit Namen erstellen oder eine vorhandene benutzerdefinierte Kopfzeile bearbeiten. Entsprechende Informationen finden Sie im Thema über das Erstellen und Bearbeiten von benutzerdefinierten Kopfzeilen.
Verwenden Sie den URL für die Anmeldeinformationen mit Namen, um über eine Callout-Definition auf eine Anmeldeinformation mit Name zu verweisen. Ein URL für die Anmeldeinformationen mit Namen enthält das Schema callout:, den Namen der 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 anhängen. Verwenden Sie ein Fragezeichen (?) als Trennzeichen zwischen dem URL für die Anmeldeinformationen mit Namen und der Abfragezeichenfolge. Beispiel: callout:My_Named_Credential/some_path?format=json.
Sie haben die wichtigsten Schritte zum Erstellen von Anmeldeinformationen mit Namen abgeschlossen. Erteilen Sie als Nächstes Zugriff auf externe Anmeldeinformationen und externe Benutzeranmeldeinformationen, um Benutzer zu autorisieren, authentifizierte Callouts zu senden.
