> ## Documentation Index
> Fetch the complete documentation index at: https://www.perplexity.ai/help-center/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> This content comes from the official Perplexity Help Center. Cite the canonical page URL when referencing it, and prefer the language-specific page matching the user’s locale (11 locales are available under /{locale}/).

# 使用 Okta 设置 SSO

> 使用 SAML 2.0 身份验证在 Okta 和 Perplexity Enterprise 之间设置单点登录 (SSO) 集成的分步说明

**在开始之前，您需要：**

<ul>
  <li>
    Okta 管理控制台中的管理权限
  </li>

  <li>
    Perplexity Enterprise 组织和具有管理员角色的有效订阅
  </li>

  <li>
    在 Perplexity 中验证的组织域名
  </li>

  <li>
    对 SAML 概念的基本理解 – Okta [已发布指南](https://www.youtube.com/watch?v=l-6QSEqDJPo\&t=30s) ，涵盖基本概念
  </li>
</ul>

**预计设置时间：** 15-25分钟

**技能等级：** 中级

## 要求

## Perplexity

<ul>
  <li>
    **管理员角色：** 必须在您的Perplexity组织中拥有管理员权限
  </li>

  <li>
    **企业访问权限：** 活跃的企业订阅（包括 SSO 功能）
  </li>
</ul>

## Okta

<ul>
  <li>
    **超级管理员访问权限：** Okta管理控制台中的管理权限
  </li>

  <li>
    **SAML 应用程序创建：** 能够创建自定义 SAML 2.0 集成
  </li>

  <li>
    **用户管理权限：** 将应用程序分配给用户/组的权限
  </li>

  <li>
    **预配访问权限：** 可选的 SCIM 预配功能，用于自动化用户管理
  </li>
</ul>

## 其他要求

<ul>
  <li>
    确保防火墙允许 HTTPS 流量到达 Perplexity 端点
  </li>

  <li>
    代理不得干扰 SAML 身份验证流程
  </li>

  <li>
    在 Okta 目录中至少有一个测试用户帐户，并拥有 Perplexity 企业版许可证
  </li>

  <li>
    考虑在 Okta 中创建专用的 SSO 测试组，用于初始测试
  </li>

  <li>
    考虑设置一个具有非 SSO 访问权限的备用管理员账户，以备紧急情况之需
  </li>
</ul>

## 在 Perplexity 中配置 SSO

## 第 1 步：导航到“组织设置”

**Step 1**

使用管理员账户登录 Perplexity Enterprise

**Step 2**

点击左下角的组织

**Step 3**

在“组织设置”中，导航至 **[身份](https://www.perplexity.ai/account/org/identity)**。

[![](https://mintcdn.com/perplexity-help-center/Qv3d0vQE9qMlZrQx/help-center/assets/img/3e65a67504_Screenshot_2025-10-30_at_11_47_24.png?fit=max\&auto=format\&n=Qv3d0vQE9qMlZrQx\&q=85\&s=9853e1e3b6b759760b1698bf7370cad5)](https://www.perplexity.ai/help-center/help-center/assets/img/3e65a67504_Screenshot_2025-10-30_at_11_47_24.png)

**Step 4**

点击 **SSO 和 SCIM**中的 **开始设置**

## 第 2 步：添加并验证组织域名

**Step 1**

点击 **域名** 选项旁边的 **添加**

**Step 2**

输入您所在组织的域名（例如 `yourcompany.com`），然后点击“继续”

**Step 3**

复制提供的 DNS TXT 记录

**Step 4**

将 TXT 记录添加到域名的 DNS 配置中

[![](https://mintcdn.com/perplexity-help-center/Qv3d0vQE9qMlZrQx/help-center/assets/img/05c9fe7763_image__2833_29.png?fit=max\&auto=format\&n=Qv3d0vQE9qMlZrQx\&q=85\&s=9e90ce75209492d60a5cec15bff8ac45)](https://www.perplexity.ai/help-center/help-center/assets/img/05c9fe7763_image__2833_29.png)

一旦我们检测到您已添加上述记录，您的域名将自动完成验证。 通常，添加新记录时，验证时间不到一分钟，但如果您要更新现有 TXT 记录，则可能需要更长时间。 如果是这种情况，您可以将 TTL 设置为 60 秒。

## 第 3 步：选择身份提供商

**Step 1**

在“组织设置”中，导航到 **身份提供商** 部分

**Step 2**

点击 **连接** 开始设置

**Step 3**

从可用的身份提供商选项中选择 **Okta**

[![](https://mintcdn.com/perplexity-help-center/kBGsQkSG8SPEk_Ye/help-center/assets/img/d88ada0a7d_Screenshot_2025-10-30_at_11_51_37.png?fit=max\&auto=format\&n=kBGsQkSG8SPEk_Ye\&q=85\&s=00079860f214c2a7a305c046ea31126c)](https://www.perplexity.ai/help-center/help-center/assets/img/d88ada0a7d_Screenshot_2025-10-30_at_11_51_37.png)

## 第 4 步：记录集成参数

Perplexity 将显示以下配置 Okta 所需的参数：

<ul>
  <li>
    **IdP SSO URL** - Okta 发布 SAML 响应的端点
  </li>

  <li>
    **实体 ID（受众 URI）** - Perplexity 服务的唯一标识符
  </li>

  <li>
    **必需属性：**

    <ul>
      <li>
        电子邮件地址（主标识符）
      </li>

      <li>
        全名（名字 + 姓氏）
      </li>

      <li>
        组织名称（可选）
      </li>
    </ul>
  </li>
</ul>

## 第 5 步：准备 IdP 配置

在单独的选项卡中打开Perplexity配置页面，因为您需要在Okta设置期间引用这些值。 记下确切值，以便轻松复制粘贴到 Okta。

## 1. 访问 Okta 管理控制台：

[![](https://mintcdn.com/perplexity-help-center/Qv3d0vQE9qMlZrQx/help-center/assets/img/45a19e3020_Screenshot_2025-10-30_at_12_05_16.png?fit=max\&auto=format\&n=Qv3d0vQE9qMlZrQx\&q=85\&s=4ee924a8aa44a4875f0d7d173e989795)](https://www.perplexity.ai/help-center/help-center/assets/img/45a19e3020_Screenshot_2025-10-30_at_12_05_16.png)

**Step 1**

前往您的 Okta 管理控制台（通常为 `https://yourcompany.okta.com/admin`）

**Step 2**

使用您的 Okta 超级管理员账户凭据登录

**Step 3**

在 **管理控制台** 主页，导航到 **应用程序** > **应用程序**

## 2. 创建 SAML 集成

我们将为您提供分步文档，说明如何在 Okta 中为 Perplexity 创建 SAML 集成。 请仔细阅读并遵循每个步骤。

**Step 1**

点击 **创建应用集成** 按钮

**Step 2**

选择 **SAML 2.0** 作为登录方式

**Step 3**

点击 **下一步** ，继续进行应用配置

## 3. 配置常规设置

[![](https://mintcdn.com/perplexity-help-center/Qv3d0vQE9qMlZrQx/help-center/assets/img/1e6f9aac5d_Screenshot_2025-10-30_at_12_07_07.png?fit=max\&auto=format\&n=Qv3d0vQE9qMlZrQx\&q=85\&s=b228e7c9728e4da11155f36b7a6d3c8a)](https://www.perplexity.ai/help-center/help-center/assets/img/1e6f9aac5d_Screenshot_2025-10-30_at_12_07_07.png)

**Step 1**

**应用名称：** 输入“Perplexity Enterprise”或其他描述性名称

**Step 2**

**应用徽标：** 上传 Perplexity 徽标（可选，但建议用于用户识别）

**Step 3**

**应用可见性：** 如果您更喜欢无图标体验，请勾选 **“不向用户显示应用程序图标”**

**Step 4**

点击 **下一步** 继续进行SAML配置

## 4. 配置 SAML 设置

[![](https://mintcdn.com/perplexity-help-center/VSbT8XXdqBYCrHHo/help-center/assets/img/662add8424_Screenshot_2025-10-30_at_12_10_21.png?fit=max\&auto=format\&n=VSbT8XXdqBYCrHHo\&q=85\&s=bc389b537147164e8b078d040bc5960f)](https://www.perplexity.ai/help-center/help-center/assets/img/662add8424_Screenshot_2025-10-30_at_12_10_21.png)

输入您之前记录的 Perplexity 参数：

**单点登录 URL 配置：**

<ul>
  <li>
    **单点登录 URL：** 从 Perplexity 配置页面输入 **ACS URL/IdP SSO URL**
  </li>

  <li>
    **将此用于收件人 URL 和目标 URL：** 选中此框
  </li>
</ul>

**受众 URI 配置：**

<ul>
  <li>
    **受众 URI (SP 实体 ID):** 从 Perplexity 配置页面输入 **实体 ID** 。 确保此值与 Perplexity 中的值完全匹配
  </li>
</ul>

**其他 SAML 配置**

<ul>
  <li>
    **默认中继状态：** 除非 Perplexity 支持人员指定，否则留空
  </li>

  <li>
    **Name ID 格式：** 选择 **EmailAddress**
  </li>

  <li>
    **应用程序用户名：** 选择 **Email**
  </li>

  <li>
    **更新应用程序用户名：** 选择 **创建并更新**
  </li>
</ul>

## 5. 配置属性语句

[![](https://mintcdn.com/perplexity-help-center/VSbT8XXdqBYCrHHo/help-center/assets/img/6e11695690_Screenshot_2025-10-30_at_12_11_38.png?fit=max\&auto=format\&n=VSbT8XXdqBYCrHHo\&q=85\&s=4d762f3c4d588105aac0f254b1eee8e4)](https://www.perplexity.ai/help-center/help-center/assets/img/6e11695690_Screenshot_2025-10-30_at_12_11_38.png)

将以下 Okta 属性映射到 Perplexity 要求：

<table>
  <tbody>
    <tr>
      <td>
        **属性名称**
      </td>

      <td>
        **名称格式**
      </td>

      <td>
        **值**
      </td>
    </tr>

    <tr>
      <td>
        email
      </td>

      <td>
        Basic
      </td>

      <td>
        user.email
      </td>
    </tr>

    <tr>
      <td>
        firstName
      </td>

      <td>
        Basic
      </td>

      <td>
        user.firstName
      </td>
    </tr>

    <tr>
      <td>
        lastName
      </td>

      <td>
        Basic
      </td>

      <td>
        user.lastName
      </td>
    </tr>

    <tr>
      <td>
        organization
      </td>

      <td>
        Basic
      </td>

      <td>
        user.organization（或 user.department）
      </td>
    </tr>
  </tbody>
</table>

<ul>
  <li>
    在 **属性语句** 部分，点击 **添加另一个**
  </li>

  <li>
    输入 **email** 作为名称，将名称格式保留为 **Basic**，输入 **user.email** 作为值
  </li>

  <li>
    添加 **firstName** 属性，值为 **user.firstName**
  </li>

  <li>
    添加值为 **user.lastName** 的 **lastName** 属性
  </li>

  <li>
    添加 **organization** 属性，值为 **user.organization** 或 **user.department**
  </li>
</ul>

## 6：配置组属性语句（可选）

[![](https://mintcdn.com/perplexity-help-center/Qv3d0vQE9qMlZrQx/help-center/assets/img/341b39dfc7_Screenshot_2025-10-30_at_12_13_28.png?fit=max\&auto=format\&n=Qv3d0vQE9qMlZrQx\&q=85\&s=78b0c4c8d4d3b911a812caa3d84f7ec4)](https://www.perplexity.ai/help-center/help-center/assets/img/341b39dfc7_Screenshot_2025-10-30_at_12_13_28.png)

对于基于组的高级访问控制，请填写 **组属性语句** 部分：

<ul>
  <li>
    **Name:** groups
  </li>

  <li>
    **Name format:** Basic
  </li>

  <li>
    **筛选条件：** 选择相关筛选条件（例如，“以...开头”，然后输入“Perplexity\_”）
  </li>
</ul>

## 7. 可选：预览 SAML 断言

[![](https://mintcdn.com/perplexity-help-center/Qv3d0vQE9qMlZrQx/help-center/assets/img/10a0a95b4f_Screenshot_2025-10-30_at_12_14_06.png?fit=max\&auto=format\&n=Qv3d0vQE9qMlZrQx\&q=85\&s=22eff98bf95a153369f4917b07644230)](https://www.perplexity.ai/help-center/help-center/assets/img/10a0a95b4f_Screenshot_2025-10-30_at_12_14_06.png)

点击 **预览 SAML 断言** ，查看将用于断言的 XML，并验证您输入的信息。

[![](https://mintcdn.com/perplexity-help-center/VSbT8XXdqBYCrHHo/help-center/assets/img/a36eaa2493_Screenshot_2025-10-30_at_12_14_33.png?fit=max\&auto=format\&n=VSbT8XXdqBYCrHHo\&q=85\&s=6f5b6f87d41809006b4cbed9af77fb43)](https://www.perplexity.ai/help-center/help-center/assets/img/a36eaa2493_Screenshot_2025-10-30_at_12_14_33.png)

## 8. 反馈和完成

您可以向 Okta 提供有关 SAML 应用的更多信息。 此部分为可选。

## 9. 分配用户和组

创建 Perplexity 应用程序后，就可以为其分配用户和/或组。

[![](https://mintcdn.com/perplexity-help-center/VSbT8XXdqBYCrHHo/help-center/assets/img/9b8d4bb536_Screenshot_2025-10-30_at_12_17_14.png?fit=max\&auto=format\&n=VSbT8XXdqBYCrHHo\&q=85\&s=6d24596043992b5cb2222594bb172a5b)](https://www.perplexity.ai/help-center/help-center/assets/img/9b8d4bb536_Screenshot_2025-10-30_at_12_17_14.png)

**Step 1**

在新创建的 Perplexity 应用中，导航到 **分配** 选项卡

**Step 2**

点击 **分配** > **分配给人员** ，以便分配给个人用户

**Step 3**

或者点击 **分配** > **分配给群组** 以进行基于群组的分配

*建议在此步骤之前创建两个组（例如 PPLX\_Admin 和 PPLX\_Members），并将用户添加到这些组中。 然后，您可以在 Okta 的 Perplexity 应用程序中为这些组分配访问权限。*\
​

[![](https://mintcdn.com/perplexity-help-center/Qv3d0vQE9qMlZrQx/help-center/assets/img/3299b143ce_Screenshot_2025-10-30_at_12_17_30.png?fit=max\&auto=format\&n=Qv3d0vQE9qMlZrQx\&q=85\&s=7f11fc290b01b23719d52322fcc48a56)](https://www.perplexity.ai/help-center/help-center/assets/img/3299b143ce_Screenshot_2025-10-30_at_12_17_30.png)

**Step 4**

对于初始测试，您可以只分配测试用户或测试组。

**Step 5**

分配完成后，点击 **保存并返回**

[![](https://mintcdn.com/perplexity-help-center/VSbT8XXdqBYCrHHo/help-center/assets/img/90d9ea87c6_Screenshot_2025-10-30_at_12_17_57.png?fit=max\&auto=format\&n=VSbT8XXdqBYCrHHo\&q=85\&s=ece42cb2525de2c6f53481be5d7101ed)](https://www.perplexity.ai/help-center/help-center/assets/img/90d9ea87c6_Screenshot_2025-10-30_at_12_17_57.png)

\
​

## 10. 可选：配置自动预配 (SCIM)

用于自动化用户预配和取消预配：

**Step 1**

导航到 **Provisioning** 选项卡

**Step 2**

点击 **配置 API 集成**

**Step 3**

选中 **启用 API 集成**

**Step 4**

按照 [这篇文章](https://www.perplexity.ai/help-center/help-center/zh-CN/articles/11652604-基于-scim-的用户账户管理.md)中的步骤操作，并根据需要配置预配功能。

## 第 5 步：测试和验证

**Step 1**

**完全退出** 当前的 Perplexity 会话

**Step 2**

**清除浏览器缓存和 Cookie** ，以确保测试环境干净，或使用浏览器的无痕模式窗口

**Step 3**

**关闭所有与 Perplexity 相关的浏览器选项卡**

**Step 4**

导航到 Perplexity 登录页面，然后 **输入电子邮件地址** ，该地址应来自已验证的域名（例如 `testuser@yourcompany.com`）

**Step 5**

**验证您是否被重定向** 到带有贵组织品牌标识的 Okta 身份验证页面

**Step 6**

**使用测试账户凭据和任何所需的 MFA 完成 Okta 身份验证**

**Step 7**

**确认您已成功重定向** 回到 Perplexity 企业版仪表板

目前，Perplexity 不支持身份提供商 (IdP) 启动的会话。

不过，有一种解决方法：组织可以通过将其 IdP 的 Perplexity 图块的 URL 目标设置为启动 SSO 流的组织特定 URL，来模拟 IdP 启动的会话。 如果您需要此组织专用 URL，请联系我们。

## 常见问题排查

## SAML 身份验证失败

<ul>
  <li>
    **症状：** 用户在 Okta 身份验证后被重定向到错误页面
  </li>

  <li>
    **解决方案：**

    <ul>
      <li>
        验证 ACS URL 和实体 ID 是否已正确输入到 Okta SAML 设置中
      </li>

      <li>
        检查属性映射是否包含必填的电子邮箱、名字和姓氏字段
      </li>

      <li>
        确保在 Okta 中将名称 ID 格式设置为“EmailAddress”
      </li>

      <li>
        验证 Okta 证书尚未过期
      </li>

      <li>
        在浏览器开发者工具中查看 SAML 响应，了解具体错误
      </li>
    </ul>
  </li>
</ul>

## 属性映射错误

<ul>
  <li>
    **症状：** 用户信息在Perplexity中未正确显示
  </li>

  <li>
    **解决方案：**

    <ul>
      <li>
        查看 Okta 属性语句配置
      </li>

      <li>
        确保所有必需属性（email、firstName、lastName）都已正确映射
      </li>

      <li>
        验证测试用户在 Okta 配置文件中填充了必要信息
      </li>

      <li>
        检查 Okta 和 Perplexity 要求的属性名称是否完全匹配
      </li>
    </ul>
  </li>
</ul>

## 无效域名错误

<ul>
  <li>
    **症状：** 登录时出现“域名未验证”消息
  </li>

  <li>
    **解决方案：**

    <ul>
      <li>
        确认在域名 DNS 设置中正确配置了 DNS TXT 记录
      </li>

      <li>
        允许 24-48 小时在全球范围内进行 DNS 传播
      </li>

      <li>
        使用 DNS 查找工具从多个位置验证 TXT 记录可见性
      </li>

      <li>
        如果 DNS 更改受到限制，请联系域名管理员
      </li>
    </ul>
  </li>
</ul>

## 用户分配问题

<ul>
  <li>
    **症状：** 尽管配置了 SSO，但用户仍无法访问 Perplexity 应用程序
  </li>

  <li>
    **解决方案：**

    <ul>
      <li>
        验证用户是否已在 Okta 中分配到 Perplexity 应用程序
      </li>

      <li>
        如果使用基于组的分配，请检查组成员身份
      </li>

      <li>
        确保用户拥有适当的 Perplexity Enterprise Pro 许可证
      </li>

      <li>
        查看 Okta 应用程序分配策略和规则
      </li>
    </ul>
  </li>
</ul>

## 其他资源

## Perplexity 企业支持

<ul>
  <li>
    **支持：** 请通过 Help 菜单中的[“联系支持团队”](https://www.perplexity.ai/?support=true#settings/account)联系我们
  </li>

  <li>
    **LinkedIn：** 关注 [@perplexityai](https://linkedin.com/company/perplexityai) ，获取产品公告和更新
  </li>
</ul>

## Perplexity 文档和资源

<ul>
  <li>
    **帮助中心：** [perplexity.ai/collections/11312901-perplexity-enterprise](https://www.perplexity.ai/help-center/help-center/zh-CN/collections/11312901-perplexity-企业版)
  </li>

  <li>
    **信任中心：** [trust.perplexity.ai](https://trust.perplexity.ai/) - 安全与合规信息
  </li>

  <li>
    **API 文档：** [docs.perplexity.ai](https://docs.perplexity.ai/home) 面向开发人员
  </li>
</ul>

## Okta 资源

<ul>
  <li>
    **Okta管理员文档：** [help.okta.com](https://help.okta.com/) 完整的Okta配置指南
  </li>

  <li>
    **SAML 配置指南：** Okta 的官方 SAML 2.0 设置文档
  </li>

  <li>
    **Okta 社区：** developer.okta.com/community 可获取同行支持和最佳实践
  </li>

  <li>
    **Okta 状态：** [status.okta.com](https://status.okta.com/) 用于查看服务状态和事件通知
  </li>
</ul>


## Related topics

- [企业版管理员中心](https://www.perplexity.ai/help-center/help-center/zh-CN/enterprise.md)
- [Perplexity 企业版](https://www.perplexity.ai/help-center/help-center/zh-CN/collections/11312901-perplexity-企业版.md)
- [SSO 集成：入门](https://www.perplexity.ai/help-center/help-center/zh-CN/articles/11200832-sso-集成-入门.md)
- [单点登录 (SSO) 故障排除](https://www.perplexity.ai/help-center/help-center/zh-CN/articles/11199936-单点登录-sso-故障排除.md)