> For the complete documentation index, see [llms.txt](https://docs.dispel.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dispel.com/documentation/documentation-zh/bao-hu-yu-zhi-li/identity-providers/ping-identity.md).

# PingIdentity

将 PingIdentity 作为你的联合单点登录身份提供方，使用户通过 OAuth（OIDC）或 SAML 使用其现有企业凭据访问 Dispel。

## 概览

连接 PingIdentity——Ping 的联合身份平台——作为贵组织的身份提供商。连接后，用户可通过单点登录使用其现有企业凭据登录 Dispel。您可以通过以下方式连接 Ping： **OAuth（OIDC）** 或 **SAML**.

本页介绍 Ping 的特定设置。有关适用于所有提供商的通用行为——用户如何登录、组映射、MFA 以及断开连接——请参见 [身份提供商](/documentation/documentation-zh/bao-hu-yu-zhi-li/identity-providers.md).

{% hint style="info" %}
**在哪里找到它。** 以组织管理员身份登录并打开 **设置 → 集成** （或专门的 **设置 → 身份验证** 页面）。PingIdentity 显示在 **身份与身份验证（IdP / SSO）** 部分。点击 **连接** 卡片上的它开始。
{% endhint %}

## 开始之前

* 您将在 Ping 环境中配置 IdP 端—— **PingOne** 或 **PingFederate** ——因此您需要在那里具有管理员访问权限。
* 选择一种协议—— **OAuth（OIDC）** 或 **SAML**。请参阅 [选择协议](/documentation/documentation-zh/bao-hu-yu-zhi-li/identity-providers.md#choosing-a-protocol).
* 确保将通过 Ping 登录的用户已经 **已受邀加入您的组织** 在 Dispel 中。SSO 会验证用户身份，但不会自行创建访问权限。

{% hint style="warning" %}
**一次仅连接一个提供商。** 如果贵组织已连接到其他身份提供商，请先断开连接，再连接 PingIdentity。
{% endhint %}

## 使用 OAuth（OIDC）连接

#### 在 PingIdentity 中

1. 在您的 Ping 环境中，创建一个新的 **OIDC / Web** 面向 Dispel 的应用程序。
2. 设置 **重定向 URI** 为您的 Dispel 地址后跟 `/oauth/login-callback` ——例如 `https://app.dispel.com/oauth/login-callback`。如果不确定，请向您的 Dispel 代表确认您环境中的确切地址。
3. 生成一个 **客户端密钥** 用于该应用程序。
4. 记下该应用程序的 **客户端 ID**, **客户端密钥**以及您的 Ping OAuth/OIDC 签发端点。

#### 在 Dispel 中

1. 点击 **连接** PingIdentity 卡片上的，并 **选择身份验证协议 → OAuth**.
2. 填写以下字段：

| 字段          | 来自 PingIdentity 的值               |
| ----------- | -------------------------------- |
| **客户端 URL** | 您的 Ping OAuth/OIDC 签发端点（令牌签发位置）。 |
| **客户端 ID**  | 该应用程序的 **客户端 ID**.               |
| **客户端密钥**   | 该应用程序的 **客户端密钥**.                |
| **组织标识符**   | 您自行选择的唯一标识符；用户会在登录界面输入它。         |

3. 点击 **保存设置**.

## 使用 SAML 连接

#### 在 PingIdentity 中

1. 在您的 Ping 环境中，创建一个新的 **SAML** 面向 Dispel 的应用程序。
2. 在 SAML 配置中，粘贴 Dispel 在其 SAML 表单顶部显示的值：
   * **ACS URL / 断言消费者服务 URL** ← Dispel 的 **断言消费者服务 URL**.
   * **实体 ID / 受众** ← Dispel 的 **服务提供商（SP）实体 ID**.
3. 从 Ping 应用程序的 SAML / 连接详情中收集：
   * 该 **单点登录服务 URL** → Dispel 的 **SSO URL**.
   * 该 **IdP 实体 ID / 签发者** → Dispel 的 **身份提供商实体 ID**.
   * 该 **签名证书** → Dispel 的 **Base64 签名证书**.
4. 将该应用分配给应有访问权限的用户或组。

#### 在 Dispel 中

1. 点击 **连接** PingIdentity 卡片上的，并 **选择身份验证协议 → SAML**.
2. 复制 **服务提供商（SP）实体 ID** 和 **断言消费者服务 URL** 在表单顶部显示的（使用 **复制 ID** / **复制 URL**）如上所述复制到 Ping 中。
3. 填写以下字段：

| 字段              | 来自 PingIdentity 的值          |
| --------------- | --------------------------- |
| **SSO URL**     | 该 **单点登录服务 URL**.           |
| **身份提供商实体 ID**  | 该 **IdP 实体 ID / 签发者**.      |
| **Base64 签名证书** | Ping 的签名证书。粘贴它或使用 **上传证书**. |
| **组织标识符**       | 您自行选择的唯一标识符；用户会在登录界面输入它。    |

4. 点击 **保存设置**.
5. 点击 **测试连接**。Dispel 会将您重定向到 Ping 登录，然后显示其收到的电子邮件和姓名。如果测试失败，请确认这些值与您的 Ping 应用程序一致，并且测试用户已受邀加入您的组织。

## 连接后

* **用户登录** 在 Dispel 登录界面输入您的组织标识符并通过 Ping 进行身份验证。请参阅 [用户如何登录](/documentation/documentation-zh/bao-hu-yu-zhi-li/identity-providers.md#how-users-sign-in).
* **将 Ping 组映射到 Dispel 组** 以保持成员资格同步——请参阅 [OIDC 组映射](/documentation/documentation-zh/ji-cheng-yu-guan-li/integrations/oidc-group-mapping.md).
* **MFA** 在 Ping 中强制执行的策略会在登录时生效；Dispel 的电子邮件一次性验证码不适用于 SSO 用户。请参阅 [SSO 和多因素身份验证](/documentation/documentation-zh/bao-hu-yu-zhi-li/identity-providers.md#sso-and-multi-factor-authentication).
* **要切换协议或提供商**，请先断开连接。请参阅 [切换或断开提供商连接](/documentation/documentation-zh/bao-hu-yu-zhi-li/identity-providers.md#switching-or-disconnecting-a-provider).

## 常见问题

<details>

<summary>这是否同时适用于 PingOne 和 PingFederate？</summary>

是。无论您使用哪种 Ping 产品，都创建一个 OIDC 或 SAML 应用程序，然后将其值输入 Dispel。无论哪种方式，Dispel 端字段都相同。

</details>

<details>

<summary>我应该在 Ping 中使用哪种协议？</summary>

两种都可以。请选择与您在 Ping 中创建的应用程序相匹配的协议——OAuth 对应 OIDC 应用程序，SAML 对应 SAML 应用程序。

</details>

<details>

<summary>我的 SAML 测试连接失败了。我应该检查什么？</summary>

确认 SSO URL、IdP 实体 ID 和证书与您的 Ping 应用程序一致，确认您已将 Dispel 的 SP 实体 ID 和 ACS URL 粘贴到 Ping 的 SAML 配置中，并确认测试用户已被授予访问 Ping 应用程序的权限且已受邀加入您的 Dispel 组织。

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.dispel.com/documentation/documentation-zh/bao-hu-yu-zhi-li/identity-providers/ping-identity.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.