> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/account-administration/account-settings/invite-and-manage-users/enable-saml-single-sign-on.md).

# 启用 SAML 单点登录

账户管理员可以启用 [SAML 单点登录（SSO）](https://en.wikipedia.org/wiki/Security_Assertion_Markup_Language) 供账户用户通过受支持的身份提供商（IDP）或通过唯一登录链接访问您品牌的 impact.com 账户。请选择您偏好的方法。

SAML SSO 使用 impact.com 与您的身份提供商之间的连接。impact.com 目前支持以下提供商：

* AD FS
* Okta
* OneLogin
* Microsoft Entra ID

#### 启用 SAML SSO

{% hint style="warning" %}
**警告：** 如果您已启用 SAML SSO 并想切换提供商，您需要我们的技术服务团队协助。在您 [提交工单](https://impact.atlassian.net/servicedesk/customer/portal/6/group/1088)之前，请确保将现有的 IDP 元数据文件保存到您的本地设备，并准备一份需要迁移的用户名列表。
{% endhint %}

{% stepper %}
{% step %}

#### **步骤 1：上传 IDP 元数据文件**

开始前，请确保您已准备好 **IDP 元数据文件** 的 .XML 格式文件——此文件需要上传到 impact.com。

1. 从顶部导航栏中，选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[用户资料] → 设置**.
2. 在左侧栏中，位于 *常规，* 选择 **账户用户身份验证**.
3. 在……旁边的 *身份验证类型* 条目，选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b5e1740618ed6571d97b8fed7c25a7678f85d375%2F299632fb6f4f91fbf9847471754cc6180e4284a65b4960af4c4ea472a159f552.svg?alt=media) **\[复选框] SAML** 并使用 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-df93ac0f80fc5cece7983980a5ce3fbcf19aabce%2F3ef9d737089bc07dbb7e4fd41a97edfbaec261e4f55ab3a1666f3daf957f69c3.svg?alt=media) **\[下拉菜单]** 以选择您的身份提供商。
4. 使用文件选择器查找并 **上传您的 .XML 元数据文件**.
5. 在界面底部，选择 **保存**.

<div data-with-frame="true"><figure><img src="https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FxmP4vAfVX0qeE1RNgLUv%2FScreenshot%202026-04-16%20at%2010.52.21.png?alt=media&amp;token=cb6aa481-a1cd-4d11-8d00-30ca4d1dc5d7" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### **步骤 2：为账户用户启用 SAML SSO**

以下说明需要为将使用 SAML SSO 的每位个人用户完成：

1. 从顶部导航栏中，选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[用户资料] → 设置**.
2. 在左侧栏中，转到 *常规* 并选择 **账户用户**.
3. 将光标悬停在某个用户上，然后选择 **\[更多] → 编辑访问权限**
4. 在……中 *用户注册方式* 部分下，选择 **SAML**.
5. 在滑出面板底部，选择 **保存**.

<div data-with-frame="true"><figure><img src="https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FsnYUet3HzxHTSStNVDx9%2FScreenshot%202026-04-16%20at%2011.03.26.png?alt=media&amp;token=087a8479-7021-4f86-94ca-037090e216b0" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### **步骤 3：通过 SAML SSO 配置用户登录**

用户可通过两种方式使用 SAML SSO 访问 impact.com：

* **通过您的身份提供商（IDP）** — 在您的 IDP 中配置连接/连接器，并使用它来为用户登录。
* **通过您品牌的唯一登录链接** — 适用于不通过 IDP 连接登录的用户。

**选项 A：身份提供商登录**

* **OneLogin** — 在 OneLogin 中，找到 *Impact Partnership Cloud* 连接，在 *OneLogin 应用目录* 并按照屏幕上的说明启用并配置该应用。
* **ADFS、Okta 和 Microsoft Entra ID** — 使用以下准确值创建新的自定义连接：

  | 字段                          | 要输入的值                             |
  | --------------------------- | --------------------------------- |
  | 单点登录 URL / 回复 URL / ACS URL | <https://app.impact.com/saml/SSO> |
  | 接收方 URL                     | <https://app.impact.com/saml/SSO> |
  | 目标 URL                      | <https://app.impact.com/saml/SSO> |
  | 受众限制                        | <https://app.impact.com>          |
  | Name ID 格式                  | EmailAddress                      |
  | 响应                          | 已签名                               |
  | 断言签名                        | 已签名                               |
  | 签名算法                        | RSA\_SHA1                         |
  | 摘要签名                        | SHA1                              |
  | 断言加密                        | 未加密                               |
  | SAML 单点登出                   | 已禁用                               |
  | AuthnContextClassRef        | PasswordProtectedTransport        |
* **Microsoft Entra ID** — 使用以下准确值创建新的自定义连接：

  | 字段                             | 要输入的值                             |
  | ------------------------------ | --------------------------------- |
  | 回复 URL（断言消费者服务 URL）            | <https://app.impact.com/saml/SSO> |
  | 回复 URL（隐式）                     | <https://app.impact.com/saml/SSO> |
  | 标识符（实体 ID）                     | <https://app.impact.com>          |
  | 名称标识符格式（高级设置 → “名称标识符格式”）      | EmailAddress                      |
  | 响应签名选项（签名 SAML 响应）             | 已签名                               |
  | 对 SAML 断言签名（选项）                | 已签名                               |
  | 签名算法                           | RSA\_SHA1                         |
  | 摘要算法                           | SHA1                              |
  | 加密证书（可选）                       | 未加密                               |
  | 单点登出 URL                       | 已禁用                               |
  | 默认 AuthnContextClassRef（不直接显示） | PasswordProtectedTransport        |

您输入的值必须与上面提供的值完全一致。例如，不要在 *单点登录 URL / 回复 URL / ACS URL* 字段末尾添加斜杠，如下所示： `https://app.impact.com/saml/SSO`**`/`**，也不要输入多个 URL 值。另请确保您 IDP 中该用户的电子邮件地址与 impact.com 中该用户的电子邮件地址完全一致。

**选项 B：品牌链接登录**

如果用户不是通过您的 IDP 登录，他们可以使用唯一的品牌登录链接访问您的 impact.com 账户。要获取此登录链接：

1. 从顶部导航栏中，选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[用户资料] → 设置**.
2. 在左侧栏中，位于 *品牌设置*，选择 **广告主登录品牌设置**.
   * 您的品牌链接将类似于这样： `https://app.impact.com/abe/Stark-Industries12345678912345/login.user?preview=t`
3. 在 *登录链接* 字段，复制并保存 *登录链接* ，以分发给您的 impact.com 账户成员。

{% hint style="warning" %}
**重要：** 此品牌登录链接唯一的用途是让用户在不使用您的 IDP 时直接登录 impact.com。请勿将此链接输入到您 IDP 的 *单点登录 URL / 回复 URL / ACS URL* 字段中。
{% endhint %}
{% endstep %}
{% endstepper %}


---

# 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://help.impact.com/brand/zh/what-would-you-like-to-learn-about/account-administration/account-settings/invite-and-manage-users/enable-saml-single-sign-on.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.
