为 Lightning Out 2.0 设置身份验证

从 Lightning Out 2.0 端点获取 Frontdoor URL

Lightning Out 2.0 servlet 通过提供 CORS 支持来扩展 UI 桥 API，并将 Salesforce 资源访问权限限制为仅 Lightning Out 2.0 应用程序。

Lightning Out 2.0 servlet 使用特殊的端点services/oauth2/lightningoutsingleaccess，而不是标准的 UI 桥 API 端点services/oauth2/singleaccess。该端点指向将有效 Salesforce 会话 ID (SID) 设置为 Cookie 的 Lightning Web Runtime 应用程序。SID 会随所有未来请求一起发送到组织，因此用户在使用 Lightning Out 2.0 应用程序时无需重新进行身份验证。

重要 在请求 Lightning Out 2.0 UI 桥 API 端点之前，请确保从 Lightning Out 2.0 应用程序管理器中启用 Lightning Out 2.0 应用程序。见构建 Lightning Out 2.0 应用程序。

要从外部应用程序生成前门 URL，请向https://MyDomainName.my.salesforce.com/services/oauth2/lightningoutsingleaccess端点发送 POST 请求。包含 Lightning Out 2.0 应用程序 ID 和 OAuth 2.0 访问令牌作为请求正文参数。

以下是使用 cURL 的 POST 请求示例。

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

以下是另一个使用 JavaScript 的 POST 请求示例。确保将 Content-Type 标题声明为 application/x-www-form-urlencoded。

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);
    });

如果成功，UI 桥 API 会返回带有前门 URL 的 JSON 响应。

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"}

如果不成功，API 会返回错误消息。有关错误消息描述，请查看生成前门 URL 以桥接到 UI 会话。

返回前门 URL 时，将lightning-out-application组件上的 frontdoor-url 属性设置为 frontdoor_uri 值。确保 frontdoor-url 属性值是仅 URL 的字符串，而不是整个 JSON 响应。

提示 要审查哪些 HTML 元素构成 Lighting Out 2.0 应用程序，包括lightning-out-application组件定义，请参阅了解 Lightning Out 2.0 架构。

在设置frontdoor-url属性后，Lightning Web Runtime 应用程序会加载并设置有效的 Salesforce 会话 ID。Lightning Out 2.0 应用程序现在加载到外部主机页面上。

从标准 UI 桥 API 端点获取前门 URL

您可以从标准 UI 桥 API 端点services/oauth2/singleaccess获得前门 URL，而不是使用 Lightning Out 2.0 UI 桥 API 端点。此方法需要您为外部应用程序配置自己的服务器端授权流。但是，如果贵公司有特定的安全要求，这种方法允许更细粒度的控制。

备注 与 Lightning Out 2.0 端点不同，标准 UI 桥 API 端点不支持在 Salesforce 设置中配置的 CORS 设置。

有关说明，请查看生成前门 URL 以桥接到 UI 会话。在您的请求中，请勿包含 redirect_uri 参数。用户不会被带到 Salesforce 主页，而是会在外部主机页面上看到 Lightning Out 2.0 应用程序组件。

返回前门 URL 时，将lightning-out-application组件上的 frontdoor-url 属性设置为 frontdoor_uri 值。确保 frontdoor-url 属性值是仅 URL 的字符串，而不是整个 JSON 响应。

在设置frontdoor-url属性后，Lightning Web Runtime 应用程序会加载并设置有效的 Salesforce 会话 ID。Lightning Out 2.0 应用程序现在加载到外部主机页面上。