> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # Okta SAML SSO Okta SAML SSO 支持工作区成员通过 Okta SAML 2.0 应用集成登录 ElevenLabs。 > **Info** > > SSO 仅适用于企业版工作区。只有工作区管理员可以配置 SSO 设置。 > **Warning** > > ElevenLabs 支持由服务提供商（SP）发起的 SAML SSO。要开始登录，请使用 > `https://elevenlabs.io/app/sign-in?use_sso=true`。你可以添加 `email=user@example.com` 作为查询 > 参数，预填邮箱字段。 ## 前提条件 * 一个企业版 ElevenLabs 工作区。 * ElevenLabs 中的工作区管理员权限。 * Okta 中的管理员权限。 * 将通过 Okta 登录的用户，需在 ElevenLabs 中拥有已验证的邮箱域名。 ## 设置 Okta SAML SSO #### 在 ElevenLabs 中打开 SSO 设置 前往 **工作区设置** > **安全与 SSO**。 ![ElevenLabs 工作区设置中的安全与 SSO 标签页](/docs/_fern-img/3bc083c160206a93cce639948b66d9aefdacfc7ed238d60548d1bde2ae365479.webp) #### 选择 SAML 作为 SSO 提供商 在 **SSO 提供商** 中选择 **SAML**。复制 **服务提供商实体 ID** 和 **重定向 URL** 值。你将在 Okta 中使用这些值。 ![ElevenLabs SAML 提供商设置](/docs/_fern-img/299948b19e628c531333c21ced70086b975d926f834b0f8a55e13edbd5898303.webp) #### 创建 Okta 应用集成 在 Okta 管理控制台中，前往 **Applications** > **Applications**，然后点击 \*\*Create App Integration \*\*。 ![带有 Create App Integration 的 Okta Applications 页面](/docs/_fern-img/ed1e7575d777d053d3749efc7f0a31ebfdf19a5f37de5f266ea147b26e4a2487.webp) 选择 **SAML 2.0**，然后点击 **Next**。 ![已选择 SAML 2.0 的 Okta Create a new app integration 对话框](/docs/_fern-img/89e194f26b79f20c6e34af660802266901dd96464987be2f38ea41c7d338704b.webp) #### 添加应用名称 在 **General Settings** 中，将 **App name** 设置为 `ElevenLabs`，然后点击 **Next**。 ![Okta Create SAML Integration 常规设置](/docs/_fern-img/56ed422543674b8b81608e27e585faf71fdca05d28ceb1493aef5d5d3c256722.webp) #### 在 Okta 中配置 SAML 设置 在 **SAML Settings** 中，使用 ElevenLabs 的值配置应用： * 将 **Single sign-on URL** 设置为 ElevenLabs 的 **Redirect URL**。 * 选择 **Use this for Recipient URL and Destination URL**。 * 将 **Audience URI (SP Entity ID)** 设置为 ElevenLabs 的 **Service Provider Entity Id**。 * 将 **Name ID format** 设置为 **EmailAddress**。 * 将 **Application username** 设置为 **Email**。 ![ElevenLabs 的 Okta SAML 设置](/docs/_fern-img/45c4621749048612f9dcaa96123b07b60e661f3a84c03c654a0e229dce385ad6.webp) #### 分配用户或群组 打开 Okta 应用的 **Assignments** 标签页，分配应能够登录 ElevenLabs 的用户或群组。 ![Okta 应用的 Assignments 标签页](/docs/_fern-img/3cf08aff22d992d143bfb1c655f3a807c5b2b6b5cafba4ee2aff6e18bd997676.webp) #### 将 Okta 证书添加到 ElevenLabs 在 Okta 中，打开 **SAML Signing Certificates**，然后针对有效证书使用 **Actions** > **Download certificate**。 ![Okta SAML Signing Certificates 中的下载证书操作](/docs/_fern-img/334a3a8fb4355a170254e0dd132b141fd9f6a86dd58374d054ae1a708a8778f9.webp) 打开证书文件并复制完整的 PEM 证书，包括 `-----BEGIN CERTIFICATE-----` 和 `-----END CERTIFICATE-----`。 ![PEM 格式的 Okta 证书文件](/docs/_fern-img/d62e28cf4ff1d3240d190cc9405345e193177e533b185acd64b19ab7f77596c5.webp) 在 ElevenLabs 中，点击 **Add Certificate**，粘贴 Okta 证书，然后点击 **Add**。 ![ElevenLabs Add X509 Certificate 对话框](/docs/_fern-img/910152284bd98c1ebdae064a7424d7d1ac185fe716abdda751607bad9b4cc147.webp) #### 将 Okta 元数据值复制到 ElevenLabs 在 Okta 中，打开 IdP 元数据 XML。将元数据值复制到 ElevenLabs： * 将 `entityID` 用于 **身份提供商实体 ID**。 * 将以 `/sso/saml` 结尾的 `SingleSignOnService Location` URL 用于 \*\*身份提供商 登录 URL \*\*。 ![显示 entityID 和 SingleSignOnService Location 的 Okta IdP 元数据 XML](/docs/_fern-img/96f8ad35da0fbeafc265310e0ca761c69163cb53c76baf8d35c97e9a992d4ee8.webp) #### 添加允许的邮箱域名 在 ElevenLabs 中，点击 **Add Domain**，然后选择与 Okta 用户邮箱 域名匹配的已验证域名。 ![ElevenLabs Add allowed email domains 对话框](/docs/_fern-img/bd532d18051c43e9db7c3b33e54b5910a2050ec16e04e85c9b7541fda20f7b6f.webp) #### 保存 SSO 提供商 检查配置，选择 \*\*I acknowledge this change will log out users currently using SSO \*\*，然后点击 \*\*Update SSO \*\*。 ## 字段映射 使用此表将 Okta SAML 设置映射到 ElevenLabs SSO 字段。 | Okta 字段或位置 | ElevenLabs 字段 | 要使用的值 | | --------------------------------------------------- | --------------- | ----------------------------------------------------------- | | **登录方式** | **SSO 提供商** | `SAML` | | **Audience URI (SP Entity ID)** | **服务提供商实体 ID** | 使用 ElevenLabs 的值，例如 `https://elevenlabs.io` | | **Single sign-on URL** | **重定向 URL** | 使用 ElevenLabs 的值，例如 `https://elevenlabs.io/__/auth/handler` | | **Recipient URL** | **重定向 URL** | 与 **Single sign-on URL** 相同 | | **Destination URL** | **重定向 URL** | 与 **Single sign-on URL** 相同 | | **SAML Issuer ID** 或元数据 `entityID` | **身份提供商实体 ID** | Okta 颁发者，例如 `http://www.okta.com/exk...` | | **Sign On URL** 或元数据 `SingleSignOnService Location` | **身份提供商登录 URL** | 以 `/sso/saml` 结尾的 Okta SAML URL | | **X.509 Certificate** 或元数据 `ds:X509Certificate` | **证书** | 有效 PEM 格式的 Okta 签名证书 | | **Application username** | 无需手动配置 | 设置为 **Email** | | **Name ID format** | 无需手动配置 | 设置为 **EmailAddress** | | Okta 中的用户或应用邮箱域名 | **域名** | 必须与已验证的 ElevenLabs 域名匹配，例如 `company.com` | ## 故障排除 #### Okta 显示登录成功，但 ElevenLabs 显示无法登录 检查浏览器网络响应中的 `accounts:signInWithIdp`。例如 `User single sign on to app SUCCESS` 的 Okta 系统日志条目仅确认 Okta 已验证该用户。若断言值与 SSO 配置不匹配，ElevenLabs 仍可能拒绝 SAML 响应。 #### INVALID_IDP_RESPONSE: 解析证书时出错 浏览器网络响应可能显示 `INVALID_IDP_RESPONSE: Error when parsing certificate`。 从 ElevenLabs 中移除证书，然后以有效 PEM 格式重新添加 Okta X.509 证书。请勿使用 LLM 格式化证书。务必原样复制证书，包括 `-----BEGIN CERTIFICATE-----` 和 `-----END CERTIFICATE-----`。 #### 用户或认证不匹配错误 确保 Okta 将用户邮箱地址作为 `NameID` 发送。在 Okta 中，将 **Name ID format** 设置为 **EmailAddress**，并将 **Application username** 设置为 **Email**。 #### 应使用哪些 Okta 元数据值？ 将元数据 `entityID` 用于 **身份提供商实体 ID**，将 `SingleSignOnService Location` 用于 **身份提供商登录 URL**，将 `ds:X509Certificate` 用于 **证书**。