> For the complete documentation index, see [llms.txt](https://help.laiout.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.laiout.co/chinese/zu-zhi-she-zhi/single-sign-on.md).

# 单点登录（SSO）

单点登录可让你的团队使用公司的身份提供商（例如 Okta、Microsoft Entra 或 Google）登录 laiout，无需另外管理密码。

## 开始使用

<details>

<summary>laiout 中的单点登录是什么？</summary>

单点登录可让你的团队通过公司的身份提供商（例如 Okta、Microsoft Entra 或 Google）登录 laiout，无需单独设置密码。

</details>

<details>

<summary>设置 SSO 需要什么？</summary>

你需要拥有 laiout 组织的管理员或经理权限、身份提供商的管理员权限（或 IT 团队的协助）、访问域名 DNS 设置的权限（或负责管理 DNS 的人员的协助），以及大约 10 分钟的时间；此外，还要留出 DNS 提供商发布更改所需的时间。

</details>

<details>

<summary>在哪里可以找到 SSO 设置？</summary>

在 laiout 中打开你的组织，点击左侧边栏中的组织头像以打开组织面板，然后点击底部的用户菜单并选择 Single Sign On (SSO)。

</details>

## 在身份提供商中创建应用

<details>

<summary>如何在身份提供商中创建 laiout 应用？</summary>

在身份提供商中为 laiout 创建一个新应用，然后按照下方与你要使用的协议（SAML 或 OIDC）相对应的部分进行操作。所需的值也会显示在 laiout 的 SSO 窗口顶部。laiout 根据用户的电子邮件地址匹配用户，因此应用必须在用户登录时传递其电子邮件地址；未提供电子邮件地址的登录请求会被拒绝。创建应用后，将其分配给需要访问 laiout 的用户。

</details>

<details>

<summary>SAML 身份提供商需要填写哪些值？</summary>

使用以下值创建应用：

| 身份提供商要求填写    | 值                                   |
| ------------ | ----------------------------------- |
| ACS / 回复 URL | <https://laiout.app/api/oauth/saml> |
| 受众 / 实体 ID   | <https://saml.laiout.co>            |

然后添加一个属性，让应用发送用户的电子邮件地址。你的身份提供商可能将其称为属性声明、属性映射或声明：

| 属性名称  | 值         |
| ----- | --------- |
| email | 用户的电子邮件地址 |

如果这样更方便，也可以将应用的 Name ID 格式设置为 EmailAddress。你还可以选择添加 firstName 和 lastName 属性。

</details>

<details>

<summary>OpenID Connect (OIDC) 身份提供商需要填写哪些值？</summary>

使用以下值创建应用：

| 身份提供商要求填写 | 值                                   |
| --------- | ----------------------------------- |
| 重定向 URL   | <https://laiout.app/api/oauth/oidc> |

应用必须是机密 Web 应用，并返回标准的 email 声明。

</details>

## 验证电子邮件域名

<details>

<summary>为什么需要验证电子邮件域名？</summary>

只有在你证明拥有相应的电子邮件域名后，laiout 才会将用户重定向到你的身份提供商。你可以通过添加 DNS 记录来证明。

</details>

<details>

<summary>如何验证电子邮件域名？</summary>

1. 在 laiout 的 SSO 窗口中，在 Email domains 下输入公司的域名（例如 acme.com），然后点击 Add domain。该域名会显示为 Pending。
2. laiout 会显示该域名的 TXT 记录。点击名称或值即可复制。
   * **类型：** TXT。
   * **名称：** \_laiout-verification.acme.com.
   * **值：** laiout-verification= 后接你的代码。
3. 在 DNS 提供商处添加该记录。有些提供商会自动将你的域名附加到名称中，因此你可能只需输入 \_laiout-verification。
4. 返回 laiout 并点击 Verify。域名显示为 Verified 后，验证即告完成。

验证后，请保留 TXT 记录。

</details>

<details>

<summary>点击 Verify 后提示未找到匹配记录。怎么办？</summary>

更改可能尚未在互联网上生效。等待几分钟后再试。

</details>

<details>

<summary>团队使用的每个域名都需要验证吗？</summary>

是。对团队使用的每个域名重复这些步骤，例如也要验证 acme.co.uk。eu.acme.com 这样的子域名需要单独添加记录。

</details>

<details>

<summary>我无法编辑 DNS。laiout 可以帮我验证域名吗？</summary>

可以。点击域名旁边的 Can't edit DNS? Ask laiout to verify it，laiout 团队会手动检查。

</details>

## 在 laiout 中连接 SSO

<details>

<summary>创建应用并验证域名后，如何连接 SSO？</summary>

返回 laiout 的 SSO 窗口，选择协议：SAML 或 OIDC。对于 SAML，请粘贴刚创建的应用所提供的完整元数据 XML。对于 OIDC，请输入应用中的 Issuer URL、Client ID 和 Client Secret。最后，点击 Enable SSO。启用后，所有使用已验证域名邮箱的用户都可以立即使用 SSO。

</details>

<details>

<summary>我的 SAML 元数据被拒绝了，是什么原因？</summary>

请粘贴完整的元数据文件，并确保第一行是 XML 声明。缺少声明的元数据会被拒绝。

</details>

<details>

<summary>如何测试 SSO 是否正常运行？</summary>

前往 laiout 登录页面，点击 Single Sign On，输入工作邮箱，然后点击 Proceed。系统会将你带到公司的登录页面；完成登录后，你会返回 laiout。

</details>

## 管理 SSO

<details>

<summary>我可以要求团队使用 SSO 登录吗？</summary>

可以。SSO 正常运行后，你可以在同一窗口中启用 Require SSO on Login。此后，团队成员必须通过 SSO 而不是密码登录。组织管理员和经理仍可使用密码登录作为备用方式。

</details>

<details>

<summary>SSO 会让用户获得我所在组织的访问权限吗？</summary>

不会。SSO 负责登录，而非访问权限。团队成员仍需先受邀加入你的 laiout 组织，才能登录。

</details>

<details>

<summary>尚未验证域名的用户会怎样？</summary>

只有已验证的域名才会被发送到你的身份提供商。使用待验证域名的用户仍按常规方式登录。

</details>

<details>

<summary>移除域名后会怎样？</summary>

移除域名后，该域名用户将立即不再被发送到你的身份提供商。

</details>

<details>

<summary>一个组织可以配置多个 SSO 连接吗？</summary>

不可以。每个组织只能有一个 SSO 连接；再次保存会替换之前的配置。

</details>

<details>

<summary>如何编辑 SSO 配置，而不必重新输入所有内容？</summary>

你的客户端密钥和元数据会安全存储，且之后不会再次显示。编辑时，请将这些字段留空，以保留当前值。

</details>

<details>

<summary>移除 SSO 连接后会怎样？</summary>

移除连接会立即关闭 SSO，密码登录仍可正常使用。

</details>

<details>

<summary>设置 SSO 时需要帮助，我应该联系谁？</summary>

请通过 <support@laiout.co> 联系 laiout 团队，我们很乐意协助你完成设置。

</details>
