> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ahaslides.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 设置 SSO 和 SCIM 配置

> 将您的身份提供商连接到 AhaSlides 以实现单点登录，要求您的邮箱域名使用 SSO，并通过 SCIM 2.0 自动配置团队成员。

单点登录（SSO）让您的团队通过贵组织的身份提供商登录 AhaSlides，而无需使用 AhaSlides 密码；SCIM 配置则通过同一个提供商创建和停用他们的账户。当您的 IT 团队需要在一个地方控制谁可以访问 AhaSlides 时，请同时使用两者。

## 开始设置 SSO 和 SCIM 之前

SSO 和 SCIM 并非在所有套餐中都可用。如需为您的团队添加它们，请通过 [Enterprise 表单](https://ahaslides.com/enterprise/)或 [hi@ahaslides.com](mailto:hi@ahaslides.com) 联系我们。

您的团队设置中没有 SSO 或 SCIM 界面。您只需设置身份提供商，AhaSlides 一侧由我们的团队为您完成：

| 步骤 | 您 | AhaSlides |
| - | - | - |
| 连接身份提供商 | 在身份提供商中创建 AhaSlides 应用，并把其详细信息发送给我们 | 发送您的提供商名称，并为您的团队开启 SSO |
| 关联邮箱域名 | 告诉我们您的团队使用哪些域名登录 | 将它们关联到您的团队 |
| 要求仅限 SSO 登录 | 请我们开启 | 为您已关联的域名开启或关闭 |
| SCIM 配置 | 在身份提供商中输入 SCIM URL 和令牌 | 生成您的 SCIM 令牌 |

您需要拥有身份提供商的管理员权限，以及一个供成员加入的 AhaSlides [团队](/cn/teams-and-enterprise/managing-your-team-members)。

## 连接您的身份提供商

AhaSlides 适用于任何 SAML 2.0 身份提供商（例如 Okta）以及 Microsoft Entra ID。

<Steps>
  <Step title="请我们开启 SSO">
    请联系我们，并告知您的团队名称和所使用的邮箱域名。我们会回复您的 **provider name**，这是代表您组织的简短标识符，会出现在您的 SSO 地址中。
  </Step>

  <Step title="在身份提供商中创建 AhaSlides 应用">
    对于 SAML 2.0 提供商，请使用以下值创建一个 SAML 应用：

    | 字段 | 值 |
    | - | - |
    | 单点登录 URL（ACS URL） | `https://presenter.ahaslides.com/p/saml/your-provider-name/login/callback` |
    | Audience URI（SP entity ID） | 我们随提供商名称一起发送给您的值 |
    | Name ID | 用户的电子邮箱地址 |

    您也可以从 `https://presenter.ahaslides.com/p/saml/your-provider-name/metadata` 下载我们的服务提供商元数据。

    对于 Microsoft Entra ID，请改为注册一个应用程序。我们会把要添加到其中的重定向 URI 发送给您。
  </Step>

  <Step title="把身份提供商的详细信息发送给我们">
    对于 SAML，请发送身份提供商的登录 URL、颁发者和 X.509 签名证书，或包含这些信息的元数据文件。如果您希望自动填写名和姓，请告诉我们哪些属性包含它们。

    对于 Microsoft Entra ID，请发送租户 ID、客户端 ID 和客户端密钥。
  </Step>

  <Step title="分配人员并测试">
    把应用分配给应该使用 AhaSlides 的人员。待我们确认连接已生效后，按照使用 SSO 登录中的步骤进行测试。
  </Step>
</Steps>

## 将您的邮箱域名关联到团队

SSO 仅适用于已关联到您团队的域名下的电子邮箱地址，这些域名由我们为您关联。请把您的成员用于登录的每个域名都发送给我们。

* 一个域名只能关联到一个团队。
* 电子邮箱所在域名未被关联的人，无法通过您的 SSO 登录。

## 使用 SSO 登录

<Steps>
  <Step title="打开 SSO 页面">
    在 [AhaSlides 登录页面](https://presenter.ahaslides.com/pages/login)上，点击**使用 SSO 登录** (Log in with SSO)。
  </Step>

  <Step title="输入您的工作邮箱">
    输入您的电子邮箱地址并点击**登录** (Log in)。AhaSlides 会将您带到贵组织的登录页面。
  </Step>

  <Step title="通过您的组织登录">
    在那里登录后，您就会进入 AhaSlides。
  </Step>
</Steps>

某人首次使用 SSO 登录时，如果还没有账户，AhaSlides 会为其创建账户，并以**成员** (Member) 角色将其添加到您的团队。他们无需设置 AhaSlides 密码。

## 为您的域名要求使用 SSO

默认情况下，设置 SSO 只是增加一种登录方式，并不会移除其他方式。已经拥有 AhaSlides 密码的人仍然可以使用它。如果贵组织需要将 SSO 作为唯一的登录途径，请让我们为您已关联的域名开启仅限 SSO 登录。这需要先有可用的 SSO 连接。

开启后，使用已关联域名下电子邮箱地址的任何人都会看到以下内容：

| 位置 | 他们看到的内容 |
| - | - |
| 登录、注册和忘记密码页面 | 输入电子邮箱后，会出现标题为**您的组织要求使用单点登录 (SSO)** (Your organisation requires single sign-on) 的窗口。**继续使用 SSO** (Continue with SSO) 会带他们前往 SSO 页面；**使用其他电子邮箱** (Use a different email) 会清空该栏。 |
| SSO 页面 | 提示信息“Your organisation requires single sign-on. Please continue below to sign in.”，并已填入他们的电子邮箱 |
| 账户设置 | 没有**密码** (Password) 部分，且他们的电子邮箱地址无法编辑 |

这适用于已关联域名下的每个地址，包括尚未加入您团队的人。

## 设置 SCIM 用户配置

SCIM 让您的身份提供商为您创建、更新和停用 AhaSlides 账户。AhaSlides 支持针对用户的 SCIM 2.0。

<Steps>
  <Step title="向我们索取 SCIM 令牌">
    我们会生成令牌并发送给您。请将其保存在安全的地方：我们只保留它的哈希值，因此无法再次向您显示。如果您丢失了它，或它可能已泄露，请向我们索取新的令牌。
  </Step>

  <Step title="在身份提供商中输入连接详细信息">
    | 设置 | 值 |
    | - | - |
    | SCIM 基础 URL | `https://presenter.ahaslides.com/api/scim/v2` |
    | 身份验证 | Bearer 令牌，以 `Authorization: Bearer your-token` 发送 |
    | 唯一标识符 | `userName` |
  </Step>

  <Step title="映射用户属性">
    映射“支持的 SCIM 属性”下列出的属性，然后开启创建、更新和停用用户。保持密码同步关闭。
  </Step>

  <Step title="分配用户">
    将人员或群组分配给 AhaSlides 应用。随后您的身份提供商会创建他们的账户。
  </Step>
</Steps>

### 支持的 SCIM 属性

| SCIM 属性 | 用途 |
| - | - |
| `userName` | 成员的电子邮箱地址。它用于标识用户，并以小写形式存储。 |
| `name.givenName`, `name.familyName` | 名和姓 |
| `displayName` | 仅在未发送 `name` 时用于姓名：第一个词作为名，其余部分作为姓 |
| `active` | `true` 保持账户有效；`false` 停用账户并让该成员退出登录 |
| `externalId` | 原样返回在响应中 |

### 支持的 SCIM 操作

| 方法 | 端点 | 作用 |
| - | - | - |
| `GET` | `/Users` | 列出您团队的用户。接受 `filter=userName eq "name@example.com"`、`startIndex` 和 `count`（默认为 10）。 |
| `GET` | `/Users/{id}` | 返回一个用户 |
| `POST` | `/Users` | 创建用户 |
| `PATCH` | `/Users/{id}` | 更新部分属性，例如 `active` |
| `PUT` | `/Users/{id}` | 替换用户的属性 |

不支持群组和 `DELETE`。要收回某人的访问权限，请将 `active` 设置为 `false`，这也是大多数身份提供商在您取消分配用户时发送的值。

通过 SCIM 创建的用户会以**成员** (Member) 角色加入您的团队。如果该电子邮箱已属于一个不在任何团队中的 AhaSlides 账户，则会把该账户添加到您的团队，而不是创建新账户。

### 您的团队页面会发生什么变化

SCIM 开启期间，管理成员资格应在您的身份提供商中进行。在团队页面上，**邀请** (Invite) 按钮不再显示，成员也无法在账户设置中编辑自己的电子邮箱地址。

## SSO 和 SCIM 故障排除

### SCIM 连接测试返回 401

令牌缺失、输入有误或已失效。请检查是否以 Bearer 令牌的形式发送，且前后没有多余内容。如果仍然失败，请向我们索取新的令牌。

### 已配置成员的姓名错误或为空

请发送 `name.givenName` 和 `name.familyName`。如果只发送了 `displayName`，AhaSlides 会在第一个空格处拆分它，这会让由两个以上部分组成的姓名出现错位。

### 成员无法使用 SSO 登录

请检查该成员是否已在您的身份提供商中被分配到 AhaSlides 应用，以及其电子邮箱域名是否是您请我们关联的域名。如果您添加了新的域名，请告诉我们，以便我们关联。

## 常见问题

<AccordionGroup>
  <Accordion title="一个邮箱域名可以关联到两个团队吗？">
    不可以。每个域名只属于一个团队，因此该域名下的所有人都登录到同一个团队。
  </Accordion>

  <Accordion title="SCIM 会删除 AhaSlides 账户吗？">
    不会。SCIM 只会停用账户并让该成员退出登录。他们的演示文稿仍保留在账户中。
  </Accordion>

  <Accordion title="我使用 SSO 但忘记了密码，该怎么办？">
    您没有需要重置的 AhaSlides 密码。请使用**使用 SSO 登录** (Log in with SSO) 登录，并参阅[更改或重置密码](/cn/account-management/change-or-reset-your-password)，了解密码重置如何处理 SSO 账户。
  </Accordion>
</AccordionGroup>

**有疑问？**

请联系我们的支持团队：如果您已登录，请使用控制面板右下角的聊天图标；如果尚未登录，请[在此联系我们](https://ahaslides.com/contact-us/)，或发送邮件至 [hi@ahaslides.com](mailto:hi@ahaslides.com)。

想与其他用户交流？欢迎加入 [AhaSlides 社区](https://community.ahaslides.com/)，分享使用技巧、提出功能建议，了解其他人如何与观众互动。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.