Einrichten der Authentifizierung für Lightning Out 2.0

Abrufen eines Frontdoor-URLs vom Lightning Out 2.0-Endpunkt

Das Lightning Out 2.0-Servlet erweitert die Benutzeroberflächen-Bridge-API, indem es CORS-Unterstützung bietet, und schränkt den Zugriff auf Salesforce-Ressourcen nur auf Lightning Out 2.0-Anwendungen ein.

Anstelle des standardmäßigen UI Bridge-API-Endpunkt-services/oauth2/singleaccess verwendet das Lightning Out 2.0-Servlet den speziellen Endpunkt-services/oauth2/lightningoutsingleaccess. Dieser Endpunkt wird zu einer Lightning Web Runtime-Anwendung weitergeleitet, die eine gültige Salesforce-Sitzungs-ID (SID) als Cookie festlegt. Die SID wird mit allen künftigen Anforderungen an die Organisation gesendet, sodass sich der Benutzer bei Verwendung der Lightning Out 2.0-Anwendung nicht erneut authentifizieren muss.

Wichtig Stellen Sie vor dem Senden einer Anforderung an den API-Endpunkt der Lightning Out 2.0-Benutzeroberflächenbrücke sicher, dass Ihre Lightning Out 2.0-Anwendung im Lightning Out 2.0-Anwendungs-Manager aktiviert ist. Entsprechende Informationen finden Sie unter Build a Lightning Out 2.0 App.

Senden Sie zum Generieren eines Haustür-URLs über Ihre externe Anwendung eine POST-Anforderung an den https://MyDomainName.my.salesforce.com/services/oauth2/lightningoutsingleaccess-Endpunkt. Fügen Sie Ihre Lightning Out 2.0-Anwendungs-ID und das OAuth 2.0-Zugriffstoken als Anforderungstextparameter hinzu.

Im Folgenden finden Sie eine POST-Beispielanforderung, die cURL verwendet.

curl -X POST \
  'https://MyDomainName.my.salesforce.com/services/oauth2/lightningoutsingleaccess' \
--form 'access_token="access-token-value"' \
--form 'lightning_out_app_id="app-id"'

Im Folgenden finden Sie eine weitere POST-Beispielanforderung, die JavaScript verwendet. Stellen Sie sicher, dass die Content-Type als application/x-www-form-urlencoded deklariert ist.

fetch(
    "https://MyDomainName.my.salesforce.com/services/oauth2/lightningoutsingleaccess", 
    {
        method: "POST",
        headers: {
            "Content-Type": "application/x-www-form-urlencoded"
        },
        body: "access_token=access-token-value&lightning_out_app_id=app-id"
    }
)
    .then((response) => {
        console.log("Status:", response.status);
        return response.json();
    })
    .then((data) => {
        console.log("Success:", data);
    })
    .catch((error) => {
        console.error("Error:", error);
    });

Bei Erfolg gibt die Benutzeroberflächen-Brücken-API eine JSON-Antwort mit dem Haustür-URL zurück.

HTTP/1.1 200 OK

Content-Type: application/json
Cache-Control: no-cache,must-revalidate,max-age=0,no-store,private
....

{"frontdoor_uri":"https://MyDomainName.my.salesforce.com/secur/frontdoor.jsp?otp=otp_value"}

Wenn dies nicht der Fall ist, gibt die API eine Fehlermeldung zurück. Beschreibungen zu Fehlermeldungen finden Sie unter Generieren eines Frontdoor-URLs zum Herstellen einer Brücke in Benutzeroberflächensitzungen.

Wenn der Haustür-URL zurückgegeben wird, legen Sie das Attribut frontdoor-url für die lightning-out-application-Komponente auf den Wert frontdoor_uri fest. Stellen Sie sicher, dass der frontdoor-url-Attributwert nur eine Zeichenfolge des URLs und nicht die gesamte JSON-Antwort ist.

Tipp Informationen dazu, aus welchen HTML-Elementen eine Lightning Out 2.0-Anwendung besteht, einschließlich der lightning-out-application-Komponentendefinition, finden Sie unter Grundlegendes zur Lightning Out 2.0-Architektur.

Nachdem das Attribut frontdoor-url festgelegt wurde, wird eine Lightning Web Runtime-Anwendung geladen und eine gültige Salesforce-Sitzungs-ID festgelegt. Ihre Lightning Out 2.0-Anwendung wird nun auf der externen Hostseite geladen.

Abrufen eines Frontdoor-URLs vom API-Endpunkt der Standard-Benutzeroberflächen-Brücke

Statt den API-Endpunkt der Lightning Out 2.0-Benutzeroberflächenbrücke zu verwenden, können Sie einen URL für die Eingangstür über den standardmäßigen API-Endpunkt der Benutzeroberflächenbrücke abrufenservices/oauth2/singleaccess. Bei dieser Methode müssen Sie Ihren eigenen serverseitigen Autorisierungs-Flow für Ihre externe Anwendung konfigurieren. Diese Methode ermöglicht jedoch eine genauere Kontrolle, wenn Ihr Unternehmen bestimmte Sicherheitsanforderungen erfüllt.

Hinweis Im Gegensatz zum Lightning Out 2.0-Endpunkt unterstützt der standardmäßige API-Endpunkt für die Benutzeroberfläche die im Salesforce-Setup konfigurierten CORS-Einstellungen nicht.

Anweisungen finden Sie unter Generieren eines Frontdoor-URLs zum Herstellen einer Brücke in Benutzeroberflächensitzungen. Fügen Sie den Parameter redirect_uri nicht in Ihre Anforderung ein. Benutzern werden die Lightning Out 2.0-Anwendungskomponenten nicht auf die Salesforce-Startseite geleitet, sondern auf der externen Hostseite.

Wenn der Haustür-URL zurückgegeben wird, legen Sie das Attribut frontdoor-url für die lightning-out-application auf den Wert frontdoor_uri fest. Stellen Sie sicher, dass der frontdoor-url-Attributwert nur eine Zeichenfolge des URLs und nicht die gesamte JSON-Antwort ist.

Nachdem das Attribut frontdoor-url festgelegt wurde, wird eine Lightning Web Runtime-Anwendung geladen und eine gültige Salesforce-Sitzungs-ID festgelegt. Ihre Lightning Out 2.0-Anwendung wird nun auf der externen Hostseite geladen.