用 Okta 管理联盟

Okta 只是您可以在 CXone 中使用的受支持的外部身份提供程序 (IdP) 之一。本页将逐步指导您使用 Okta 为 CXone 系统设置身份验证。

如果您正在进行 CXone 系统的初始实现，则需考虑其他步骤。我们建议阅读下面的联机帮助页面，其中包括以下注意事项：

按照给定的顺序完成以下每一个任务。

在开始之前，请确保您可以访问 Okta。您将需要创建一个应用程序。

使用 SAML 2.0 创建和配置 Okta 应用程序

  1. 登录到 Okta 管理帐户。
  2. 单击应用程序菜单 > 创建应用程序集成。
  3. 选择 SAML 2.0 作为方法，然后单击下一步。
  4. 输入要用于标识此集成的名称，然后单击下一步。
  5. 配置 SAML：
    1. 在单点登录 URL 字段中，输入占位符 URL，例如 https://cxone.niceincontact.com/need_to_change。您将使用稍后收到的 URL 更改此值。
    2. 在受众 URI 字段中，输入占位符 URL，例如 https://cxone.niceincontact.com/need_to_change。您将使用稍后收到的 URI 更改此值。
    3. 将与您希望如何识别用户相对应的姓名 ID 格式和应用程序用户名指定为 CXone。
    4. 单击显示高级设置。
    5. 将断言签名更改为未签名。将响应保留为已签名。
    6. 确保断言加密为未加密。
  6. 单击下一步，完成反馈，然后单击“反馈”选项卡上的完成。
  7. 单击查看 SAML 设置说明以打开新选项卡，然后：
    1. 单击下载证书以下载签名证书。为您的 CXone 配置保存此文件。
    2. 复制身份提供程序单点登录 URL。为您的 CXone 配置保存此 URL。
    3. 关闭“SAML 设置说明”选项卡。让“配置 SAML”选项卡保持打开状态。您将根据接下来获得的 CXone 设置更改您的配置。

设置位置

所需权限：位置管理创建

如果您想要求用户从特定 IP 地址登录，请使用您想要允许的 IP 地址、IP 地址范围或 IP 地址子网创建一个位置。当对于某个用户您需要一个已配置的位置时，该用户必须拥有正确的凭据和 IP 地址才能登录。否则，他们的登录尝试将失败并收到错误。您一次最多可以有 20 个位置，每个位置最多有 10 条规则。

  1. 单击应用程序选择器 并选择Admin。
  2. 转到位置 > 位置定义。
  3. 单击新位置。
  4. 为此位置提供描述性名称。如果您想添加有关该位置的更多详情，请输入描述。
  5. 您可以选择设置为默认位置或远程位置来指示位置类型。您只能有一个默认位置。这些字段目前不会影响任何功能，选择它们仅供您自己参考。

  6. 使用其余字段添加您想要的任何其他信息，包括实际地址、国家/地区、GPS 坐标、时区或已分配的组。这些字段目前不会影响任何内容，其中输入的信息仅供您参考。

    如果将组添加到已分配的组字段，属于这些组的用户将显示在“已分配的用户”选项卡上。但是，位置设置将不适用于它们。如果您为登录身份验证程序分配位置，则该位置适用于分配给该登录身份验证程序的用户，并根据其 IP 地址限制他们的登录能力。但是，这些用户不会出现在“已分配的用户”选项卡上。

  7. 单击保存。

  8. 返回“位置定义”页面，单击您刚刚创建的位置将其打开。

  9. 单击“自动检测规则”选项卡。

  10. 创建一条新规则。为此：

    1. 单击新规则。

    2. 为规则提供描述性名称。

    3. 从以下选项中选择规则类型：

      • 列表：允许用于此位置的特定 IP 地址的列表。例如，100.0.1.100、100.0.1.101 和 100.0.1.102。

      • 范围：允许用于此位置的 IP 地址范围。例如，100.0.1.100-100.0.1.125。

      • 子网：允许用于此位置的子网。例如，100.0.0.1/32。

    4. 将 IP 版本指定为以下之一：

      • IPV4：32 位 IP 地址

      • IPV6：128 位十六进制地址。

    5. 按照先前步骤中示例的格式，在规则定义字段中输入实际 IP 地址、范围或子网。如果您选择了列表，则最多可以输入 100 个 IP 地址。如果您选择了范围或子网，则只能输入一个值。

    6. 单击确认。

  11. 根据需要添加更多规则。最多可以有 10 条。

  12. 单击保存。

使用 SAML 2.0 设置 CXone 登录身份验证程序

所需权限：登录身份验证程序创建

  1. 单击应用程序选择器 并选择管理员。
  2. 单击安全 > 登录身份验证程序。
  3. 单击新登录身份验证程序。
  4. 输入登录身份验证程序的名称和描述。
  5. 选择 SAML 作为身份验证类型。

  6. 如果您想要求用户从某个 IP 地址登录，请选择您在上一部分中设置的位置。

  7. 输入您从 Okta 收到的身份提供程序单点登录 URL 作为端点 URL。有关更多详细信息，请参阅上述任务的最后一步。
  8. 单击选择文件，然后选择您在上一个任务中从 Okta 下载的公共签名证书。该证书必须为 PEM 文件。它将是一个文本文件，第一行将包含 BEGIN CERTIFICATE 和一些额外文本。

  9. 选择已分配的用户选项卡。选择要分配给正在创建的登录身份验证程序的用户。您还可以将用户直接分配给他们的员工配置文件中的登录身份验证程序。

  10. 单击保存并激活。
  11. 打开登录身份验证程序。

  12. 您会注意到显示的两个额外只读字段，即实体 ID 和 ACS URL。记录这些值。您将在“将 CXone 值添加到 Okta” 任务中需要它们。

使用 OpenID 连接 配置 Okta 应用程序

  1. 登录到 Okta 管理帐户。
  2. 单击应用程序菜单 > 创建应用程序集成。
  3. 选择 OIDC -OpenID 连接 作为登录方法。
  4. 选择 Web 应用程序作为应用程序类型，然后单击下一步。
  5. 在应用程序集成名称字段中，输入要用于标识此集成的名称。
  6. 您需要提供一个此时不知道的登录重定向 URI。使用 https://cxone.niceincontact.com/need_to_change 作为占位符。您将使用稍后收到的 URI 更改此值。
  7. 您可能需要提供一个此时不知道的注销重定向 URI。使用 https://cxone.niceincontact.com/need_to_change 作为占位符。您将使用稍后收到的 URI 更改此值。
  8. 在受控访问下拉列表中，选择暂时跳过组分配。
  9. 单击保存。
  10. 在常规选项卡上的客户端凭据下，选择客户端身份验证。
  11. 选择以下身份验证方法之一：
    1. client_secret_basic：客户端凭据在身份验证期间在基本标题中进行传递。选择此方法后，配置以下内容：
      1. 选择客户端身份验证作为客户端密钥。
      2. 复制客户端 ID 和客户端密钥，然后将其粘贴到设备上的安全位置。当您在 CXone 中配置登录身份验证程序时，您将需要使用它们。
    2. client_secret_post：客户端凭据在身份验证期间在正文中进行传递。选择此方法后，配置以下内容：
      1. 选择客户端身份验证作为客户端密钥。
      2. 复制客户端 ID 和客户端密钥，然后将其粘贴到设备上的安全位置。当您在 CXone 中配置登录身份验证程序时，您将需要使用它们。
    3. client_secret_jwt：使用 JWT 持有者令牌进行客户端身份验证。选择此方法后，配置以下内容：
      1. 选择客户端身份验证作为客户端密钥。
      2. 复制客户端 ID 和客户端密钥，然后将其粘贴到设备上的安全位置。当您在 CXone 中配置登录身份验证程序时，您将需要使用它们。
    4. private_key_jwt：使用 JWT 持有者令牌进行客户端身份验证。您将在后续步骤中提供的客户端私钥对 JWT 进行签名。选择此方法后，配置以下内容：
      1. 选择客户端身份验证作为公钥/私钥。
      2. 在添加公钥字段中，输入占位符公钥。配置登录身份验证程序时，您需要将占位符替换为 CXone 提供的密钥。
  12. 在“分配”选项卡上，单击分配，然后单击分配给人员。
  13. 将用户分配给该应用程序。

使用 CXone 中的 OpenID 连接 设置登录身份验证程序

  1. 单击应用程序选择器 并选择Admin

  2. 转至安全设置 > 登录身份验证程序。

  3. 单击新登录身份验证程序或选择您要编辑的登录身份验证程序。
  4. 输入登录身份验证程序的名称和描述。
  5. 选择 OIDC 作为身份验证类型。

  6. 如果您想要求用户从某个 IP 地址登录，请选择您在上一部分中设置的位置。

  7. 如果您有来自 Okta 的发现端点，请单击发现设置。输入您的发现端点，然后单击发现。系统会为您填充其余字段。发现设置不可与 Salesforce 发现端点共同使用。
  8. 输入客户端标识符和客户端密码。在客户端确认密码字段中再次键入该密码。客户端标识符是 Okta 分配给您帐户的登录 ID。

  9. 如果您没有来自 Okta 的发现端点，请输入您 Okta 提供的发行者、Json Web 密钥设置端点、授权端点、令牌端点、用户信息端点和撤销端点。

    字段

    详细信息
    发行者

    Okta 的 URL，不带任何参数。
    JsonWebKeySet 端点 Okta 的 JWK 集的 URL。
    授权端点 Okta 的 OAuth 2.0 授权端点的 URL。
    令牌端点 Okta 的 OAuth 2.0 令牌端点的 URL。
    UserInfo 端点 Okta 的 UserInfo 端点的 URL。
    撤销端点 Okta 的撤销端点的 URL。
  10. 选择客户端身份验证方法。您选择的方法必须与您在上一个任务中设置的方法相匹配。它必须是 Okta 支持的身份验证方法。如果您选择 private_key_jwt，则必须输入您的客户端私钥。
  11. 您可以选择启用 FICAM 配置文件来打开美国政府特定设置。此步骤仅适用于 FedRAMP 用户。

  12. 选择已分配的用户选项卡。选择要分配给正在创建的登录身份验证程序的用户。您还可以将用户直接分配给他们的员工配置文件中的登录身份验证程序。

  13. 单击保存和激活，以验证提供的信息并将您的 CXone 帐户链接到您的 Okta 帐户。
  14. 打开登录身份验证程序。

  15. 记下登录重定向 URI 和注销重定向 URI。您将需要它们来更新您的 Okta 设置。

  16. 更新您的 Okta 设置，将上一个任务中使用的占位符替换为您刚刚记下的值。

  17. 确保将每个使用登录身份验证程序的用户的 CXone 外部身份设置为正确的值。可以在员工配置文件的安全部分访问此字段。

    Okta 确定必须使用的值。它可以在 Okta 中的用户配置文件中找到。该值必须与您在 CXone 中的外部身份字段中输入的值完全匹配。此字段的值必须采用以下格式：claim(email):{您 IdP 配置的电子邮件}。例如，如果 IdP 中用户的电子邮件为 nick.carraway@classics.com，您将输入 claim(email):nickcarraway@classics.com。

  18. 让用户登录到 CXone。他们必须使用最新的登录 URL。如有需要，在输入用户名后会将他们引导至 Okta。

  19. 当 Okta 要求您使用自己的帐户进行身份验证时，请以您希望与您当前所登录的 CXone 帐户相关联的用户身份进行身份验证。
  20. 如果您在 CXone 中的 OpenID 连接 设置没有显示为已验证，请使用 Okta 日志诊断问题。

将 CXone 值添加到 Okta

  1. 返回到 Okta 应用程序并转至“常规”选项卡。
  2. 单击“SAML 设置”窗口上的编辑，然后单击下一步。
  3. 对于单点登录 URL，输入来自 CXone 登录身份验证程序的 ACS URL 值。
  4. 对于受众 URI（SP 实体 ID），输入来自 CXone 登录身份验证程序的实体 ID 值。
  5. 单击下一步，然后单击完成以完成更改。

使用 Okta 单点登录验证用户访问

  1. 确保将每个使用登录身份验证程序的员工的外部身份设置为正确的值。该值必须与 CXone 中的外部身份完全匹配。外部身份字段区分大小写。

  2. 让一位或多位测试用户使用最新的登录 URL https://cxone.niceincontact.com 登录。对于 FedRAMP，请使用 https://cxone-gov.niceincontact.com。如有需要，在输入用户名后会将他们引导至 Okta。

  3. 准备就绪后，向所有员工推出 Okta 单点登录。