OKTA / 调度 SAML 设置说明

Last updated: June 19, 2026

Okta 是一家第3方身份验证服务,为企业提供 SAML 集成。L2L 调度可以轻松添加到 Okta 作为应用程序,为拥有 Okta 账户的调度用户提供 SSO 功能。启用调度的 SAML 身份验证后,调度登录页面将显示一个按钮,用户可以使用该按钮发起 SSO 身份验证;或者,用户也可以使用其 Okta 主页访问已配置的应用程序。

本文档介绍如何配置调度和 Okta,以使用 SAML 进行身份验证。在示例中,调度服务器将为 acme.leading2lean.com,而 Acme-L2L-Dispatch 将是我们创建的 Okta 应用程序的名称。

您必须拥有调度和 Okta 账户的管理员访问权限,才能完成这些步骤。您的用户必须已经在 Okta 中拥有账户,并且您需要将这个新应用程序分配给他们。

第 1 步:创建调度 SAML 配置

我们首先创建一个新的 SAML 配置,用于定义调度与 Okta 应用程序之间的 SAML 信任关系。登录 acme.leading2lean.com,然后导航至设置 -> IT 设置 -> SAML SSO 配置,网址为 https://acme.leading2lean.com/setup/samlconfig/。点击“添加新建”链接。

在 添加新 SAML 配置 页面中,我们将输入以下信息:

  • 代码:这必须是所有调度 SAML 配置中唯一的代码,并用于调度 SAML URL。在此示例中,我们将使用代码 acme-okta-sso。
  • 显示名称:这是调度登录页面上用户可见的文本——在此示例中,我们将使用 调度 ACME Okta SSO。
  • IdP 用户命名属性:您需要选择用户登录调度的方式。选择 email 要求调度用户账户的电子邮件地址与用户 Okta 账户中设置的电子邮件地址相同,而选择 username 则要求调度用户名与 Okta 用户名匹配。

暂时将所有其他字段留空并点击保存。现在再次点击新的 SAML 配置,并复制 SP 实体 ID 和 SP 发起 URL,因为我们将在下一步中使用这两个 URL。

步骤 2:创建 Okta 应用程序

现在我们在 Okta 账户中创建一个新的应用程序。按照以下步骤创建新的应用程序:

  • 以管理员身份登录 Okta
  • 点击 应用程序 标题链接
  • 点击 添加应用程序 按钮
  • 点击 创建新应用 链接
  • 在 创建新的应用程序集成 对话框中,将 平台 设置为 Web,并选择 SAML 2.0 作为 登录方式,然后点击 创建 按钮。
  • 选择一个应用名称——在此示例中我们将使用 Acme-L2L-Dispatch,然后点击下一步。

现在在配置 SAML 步骤中,先决定您希望用户使用 Okta 用户名还是邮箱地址登录调度,然后设置以下选项:

  • 单点登录 URL – 将其设置为调度 SAML 配置的 SP SSO URL
    • 将此用于收件人 URL 和目标 URL - 已选中
  • 受众 URI – 将其设置为调度 SAML 配置的 SP Entity ID
  • 名称 ID 格式 – 如果您使用邮箱地址,则设置为 邮箱地址,否则保留为未指定
  • 应用用户名 – 如果您使用邮箱地址,则设置为 邮箱,或选择用户名选项之一。

所有其他字段都可以留空或保留默认值。现在点击下一步。在第 3 步中,选择您是添加内部应用的客户,无需设置其他字段。点击完成以保存应用,然后点击查看设置说明链接。这个新页面包含我们需要存储在调度 SAML 配置中的信息。

第 3 步:更新调度 SAML 配置

现在在您的调度 Web 会话中,查看我们之前创建的 acme-okta-sso SAML 配置。现在我们将填写以下字段:

  • 将 IdP Entity Id 字段设置为 Okta 应用程序的 Identity Provider Issuer 值。
  • 将 IdP SSO URL 设置为 Okta 应用程序的 Identity Provider Single Sign-On URL。
  • 复制 Okta 应用程序的 X.509 证书字符串,并将其存储在调度 SAML 配置的 IdP Certificate Information  字段中,格式为 PEM 格式的 x509 公钥证书。

现在点击调度 SAML 配置的保存按钮。您的 SAML 配置现已准备就绪,可以使用。

第 4 步:迁移调度账户以使用 SAML 身份验证

如果您需要将大多数或全部调度账户迁移为使用 SAML 身份验证,调度提供了相关工具来简化此过程。每个调度 SAML 配置都有一个 迁移账户 按钮,可用于批量迁移用户以使用 SAML 配置。只需点击该按钮并按照说明操作,即可启用您的用户账户通过 SAML 进行身份验证。