Loading
Identifizieren der Benutzer und Verwalten des Zugriffs
Konfigurieren einer externen Client-Anwendung zum Ausstellen von JWT-basierten Zugriffstoken

Sie befinden sich hier:

  1. Salesforce-Hilfe
  2. Dokumente
  3. Identifizieren der Benutzer und Verwalten des Zugriffs

Konfigurieren einer externen Client-Anwendung zum Ausstellen von JWT-basierten Zugriffstoken

Aktivieren Sie JWT-basierte Zugriffstoken für eine vorhandene externe Client-Anwendung, die Sie als Entwickler erstellt oder als Administrator aus einem verwalteten Paket installiert haben. Verwenden Sie den Manager für externe Client-Anwendungen unter "Setup". Alternativ können Sie Ihre externe Client-Anwendung über die Metadaten-API konfigurieren.

Erforderliche Editionen

Verfügbarkeit: Lightning Experience
Verfügbarkeit: Group, Essentials, Professional, Enterprise, Performance, Unlimited und Developer Edition
Erforderliche Benutzerberechtigungen
Konfigurieren von Einstellungen und Richtlinien als Entwickler einer externen Client-Anwendung: Erstellen, Bearbeiten und Löschen von externen Client-Anwendungen
Verwalten von Richtlinien für externe Client-Anwendungen als Administrator der externen Client-Anwendung: Alle externen Client-Anwendungen und deren Einstellungen anzeigen und die zugehörigen Richtlinien bearbeiten
Hinweis
Hinweis Die Erstellung verbundener Anwendungen ist ab der Version Spring '26 eingeschränkt. Sie können vorhandene verbundene Anwendungen während und nach der Version Spring '26 weiterhin verwenden. Es wird jedoch empfohlen, stattdessen externe Client-Anwendungen zu verwenden. Wenn Sie weiterhin verbundene Anwendungen erstellen müssen, wenden Sie sich an den Salesforce-Support.

Weitere Details finden Sie unter Neue verbundene Anwendungen können in der Version Spring '26 nicht mehr erstellt werden.

Wenn Sie ein JWT-basiertes Zugriffstoken für die Sitzungsauthentifizierung verwenden, können Sie weder $Api.Session_ID noch GETSESSIONID() verwenden, um die Sitzungs-ID des Benutzers zurückzugeben.

Verwenden des Managers für externe Client-Anwendungen

Aktivieren Sie unter "Setup" im Manager für externe Client-Anwendungen, dass eine Anwendung JWT-basierte Zugriffstoken anstelle von opaken Zugriffstoken ausstellt.

Hinweis
Hinweis Die Erstellung verbundener Anwendungen ist ab der Version Spring '26 eingeschränkt. Sie können vorhandene verbundene Anwendungen während und nach der Version Spring '26 weiterhin verwenden. Es wird jedoch empfohlen, stattdessen externe Client-Anwendungen zu verwenden. Wenn Sie weiterhin verbundene Anwendungen erstellen müssen, wenden Sie sich an den Salesforce-Support.

Weitere Details finden Sie unter Neue verbundene Anwendungen können in der Version Spring '26 nicht mehr erstellt werden.

Die externe Client-Anwendung muss OAuth-fähig sein.

  1. Aktivieren Sie als Entwickler JWT-basierte Zugriffstoken in den Einstellungen der externen Client-Anwendung. Wenn Sie Abonnentenadministrator sind, aktiviert Ihr Entwickler diese Einstellung für Sie, sodass Sie diesen Schritt überspringen können.
    1. Geben Sie unter "Setup" im Feld "Schnellsuche" den Text Externe Client-Anwendungen ein und wählen Sie dann Manager für externe Client-Anwendungen aus. Klicken Sie neben Ihrer Anwendung auf Dropdown-Pfeil und wählen Sie Einstellungen bearbeiten aus.
    2. Wählen Sie unter "OAuth-Einstellungen" im Abschnitt "Sicherheit" die Option JSON-Webtoken (JWT)-basierte Zugriffstoken für benannte Benutzer aus.
    3. Speichern Sie die Änderung.
    Die Anwendung stellt nun JWT-basierte Zugriffstoken anstelle von opaken Zugriffstoken aus. Wenn Sie diese Einstellung für installierte Anwendungen aktivieren, stellen Sie eine Richtlinie zum Festlegen der Token-Zeitüberschreitung bereit.
  2. Legen Sie in den Richtlinien der externen Client-Anwendung die Token-Zeitüberschreitung für benannte Benutzer fest. Als Abonnentenadministrator steuern Sie diesen Wert für installierte Anwendungen.
    1. Geben Sie unter "Setup" im Feld "Schnellsuche" den Text Externe Client-Anwendungen ein und wählen Sie dann Manager für externe Client-Anwendungen aus. Wenn Sie sich bereits auf der Registerkarte "Einstellungen" befinden, klicken Sie alternativ auf Richtlinien.
    2. Klicken Sie im Manager für externe Client-Anwendungen neben Ihrer Anwendung auf Dropdown-Pfeil und wählen Sie Richtlinien bearbeiten aus. Wenn Sie sich bereits auf der Seite "Richtlinien" für die Anwendung befinden, klicken Sie auf Richtlinien bearbeiten.
    3. Wählen Sie im Abschnitt "Anwendungsautorisierung" unter "JWT-basierte Zugriffstokeneinstellungen für benannte Benutzer" eine Option für die Token-Zeitüberschreitung aus. Dieser Wert definiert die Dauer, bis die Sitzung eines Benutzers abläuft. Die Zeitüberschreitung für ein JWT-basiertes Zugriffstoken ist fest definiert und ändert sich nicht anhand des Zeitpunkts, zu dem das Token zuletzt aktiv war.
    • Standard-Sitzungs-Timeout des Benutzers verwenden: Bei dieser Option verwendet Salesforce die in den Profilsitzungseinstellungen des Benutzers im Feld "Zeitüberschreitung nach Sitzung" definierte Zeitüberschreitung. Wenn für den Benutzer keine Zeitüberschreitung für die Profilsitzung vorhanden ist, verwendet Salesforce den Wert aus dem Feld "Zeitüberschreitungswert" aus Ihren Organisationssitzungseinstellungen. Wenn beide definiert sind, wird von Salesforce standardmäßig die Zeitüberschreitung für die Profilsitzung verwendet.
    • Anwendungsspezifische Token-Zeitüberschreitung festlegen: Wählen Sie mit dieser Option einen Zeitüberschreitungswert aus, der nur für diese Anwendung gilt.
  3. Wenn Sie die Anwendung für den Headless-Gastbenutzer-Flow verwenden, legen Sie einen Token-Timeout-Wert für Gastbenutzer fest. Wenn Sie die Anwendung nur für Flows für benannte Benutzer verwenden, überspringen Sie diesen Schritt.
    1. Suchen Sie auf der Richtlinienseite für externe Client-Anwendungen nach OAuth-Flows und Verbesserungen an externen Client-Anwendungen.
    2. Wählen Sie für "JWT-basierte Zugriffstoken-Zeitüberschreitung für Gastbenutzer" eine Option für die Token-Zeitüberschreitung aus.
    • Experience Cloud-Gastbenutzer-Timeout verwenden: Mit dieser Option verwendet Salesforce die in den Profilsitzungseinstellungen des Gastbenutzers im Feld "Zeitüberschreitung nach Sitzung" definierte Timeout. Wenn für den Benutzer keine Zeitüberschreitung für die Profilsitzung vorhanden ist, verwendet Salesforce den Wert aus dem Feld "Zeitüberschreitungswert" aus Ihren Organisationssitzungseinstellungen. Wenn beide definiert sind, wird von Salesforce standardmäßig die Zeitüberschreitung für die Profilsitzung verwendet.
    • Anwendungsspezifische Token-Zeitüberschreitung festlegen: Wählen Sie mit dieser Option einen Zeitüberschreitungswert aus, der nur für diese Anwendung gilt.
  4. Speichern Sie Ihre Änderungen.
    Wenn Ihre Anwendung nun einen OAuth-Flow erfolgreich abschließt, stellt sie JWT-basierte Zugriffstoken mit den von Ihnen konfigurierten Token-Timeout-Werten aus.

Verwenden der Metadaten-API

Verwenden Sie die Metadaten-API, damit eine externe Client-Anwendung JWT-basierte Zugriffstoken ausstellen kann.

Hinweis
Hinweis Die Erstellung verbundener Anwendungen ist ab der Version Spring '26 eingeschränkt. Sie können vorhandene verbundene Anwendungen während und nach der Version Spring '26 weiterhin verwenden. Es wird jedoch empfohlen, stattdessen externe Client-Anwendungen zu verwenden. Wenn Sie weiterhin verbundene Anwendungen erstellen müssen, wenden Sie sich an den Salesforce-Support.

Weitere Details finden Sie unter Neue verbundene Anwendungen können in der Version Spring '26 nicht mehr erstellt werden.

Zum Verwenden von JWT-basierten Zugriffstoken muss das OAuth-Plugin für Ihre externe Client-Anwendung aktiviert sein. Weitere Informationen finden Sie in den folgenden Ressourcen.

  1. (Nur Entwickler) Bearbeiten Sie die JWT-basierten Zugriffstoken in der Datei mit den globalen OAuth-Einstellungen der externen Client-Anwendung.
    Entsprechende Informationen finden Sie unter Konfigurieren der globalen OAuth-Einstellungen der externen Client-Anwendung.
    1. Legen Sie das Feld isNamedUserJwtEnabled auf true fest.
    2. Stellen Sie Ihre Änderungen bereit.
  2. (Entwickler und Abonnenten) Legen Sie den Token-Timeout-Wert für benannte Benutzer in den konfigurierbaren OAuth-Richtlinien fest. Dieser Wert definiert die Dauer, bis die Sitzung des Benutzers abläuft. Die Zeitüberschreitung für ein JWT-basiertes Zugriffstoken ist fest definiert und ändert sich nicht anhand des Zeitpunkts, zu dem das Token zuletzt aktiv war. Es gibt zwei Möglichkeiten, die Token-Zeitüberschreitung zu konfigurieren.
    Token-Timeout-Option für benannten Benutzer Konfiguration
    Verwenden Sie die standardmäßige Sitzungszeitüberschreitung des Benutzers. Bei dieser Option verwendet Salesforce die Zeitüberschreitung, die in den Profilsitzungseinstellungen des Benutzers im Feld "Zeitüberschreitung nach Sitzung" definiert ist. Wenn für den Benutzer keine Zeitüberschreitung für die Profilsitzung vorhanden ist, verwendet Salesforce den Wert aus dem Feld "Zeitüberschreitungswert" aus Ihren Organisationssitzungseinstellungen. Wenn beide definiert sind, wird von Salesforce standardmäßig die Zeitüberschreitung für die Profilsitzung verwendet. Legen Sie das Feld namedUserJwtSessionTimeoutType auf UserSession fest.
    Legen Sie einen Zeitüberschreitungswert fest, der nur für diese Anwendung gilt.
    • Legen Sie das Feld namedUserJwtSessionTimeoutType auf Custom fest.
    • Legen Sie für das Feld namedUserJwtTimeout einen Zeitüberschreitungswert in Minuten fest. Eine Liste der gültigen Werte finden Sie unter ExtlClntAppOauthConfigurablePolicies im Metadata API Developer Guide.
  3. Wenn Sie die Anwendung für den Headless-Gastbenutzer-Flow verwenden, legen Sie einen Token-Timeout-Wert für Gastbenutzer fest. Wenn Sie die Anwendung nur für Flows für benannte Benutzer verwenden, überspringen Sie diesen Schritt.
    Token-Timeout-Option für Gastbenutzer Konfiguration
    Experience Cloud-Gastbenutzer-Timeout verwenden: Mit dieser Option verwendet Salesforce die in den Profilsitzungseinstellungen des Gastbenutzers im Feld "Zeitüberschreitung nach Sitzung" definierte Timeout. Wenn für den Benutzer keine Zeitüberschreitung für die Profilsitzung vorhanden ist, verwendet Salesforce den Wert aus dem Feld "Zeitüberschreitungswert" aus Ihren Organisationssitzungseinstellungen. Wenn beide definiert sind, wird von Salesforce standardmäßig die Zeitüberschreitung für die Profilsitzung verwendet. Legen Sie das Feld guestJwtSessionTimeoutType auf UserSession fest.
    Legen Sie einen Zeitüberschreitungswert fest, der nur für diese Anwendung gilt.
    • Legen Sie das Feld guestJwtSessionTimeoutType auf Custom fest.
    • Legen Sie für das Feld guestJwtTimeout einen Zeitüberschreitungswert in Minuten fest. Eine Liste der gültigen Werte finden Sie unter ExtlClntAppOauthConfigurablePolicies im Metadata API Developer Guide.
  4. Stellen Sie Ihre Änderungen bereit.
 
Laden
Salesforce Help | Article