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

# B2B 组织管理：成员、角色与企业 SSO | Didit

> 在 Didit Authentication 中将企业客户建模为组织，支持成员、角色、邀请、已验证域名自动加入及各组织独立的 SSO。

Didit Authentication 的组织功能让 B2B 应用可以按用户所任职的企业对其进行分组。
每个组织都有自己的成员和角色，可以验证其邮箱域名，让同事自动加入；还可以让其成员通过组织自己的 SAML 或 OIDC 身份提供商登录。
您的应用从用户的 token 和会话中读取其所属的组织和角色，并决定每个角色可以执行哪些操作。

> [!NOTE]
>
> 此处的组织是**您的一个**客户，位于您的应用内部。
> 它与您在 Business Console 中的 Didit 组织相互独立，后者包含您自己的团队。

## 开启组织功能

新应用默认未开启组织功能。
在控制台中打开 **Authentication > Organizations**，然后在其 **Settings** 卡片中：

* 开启 **Organizations**。
* 选择 **Default role for new members**（新成员的默认角色）。这是人员通过已验证域名或单点登录加入时获得的角色（默认为 `member`）。
* 保持 **Require MFA for organization admins** 开启。这是默认的 MFA 策略（见[下文](#组织管理员的-mfa)）。

之后，您可以在控制台中管理组织。点击 **New organization** 即可创建组织，并填写名称和 slug。slug 在应用内必须唯一。
组织由您的团队创建，用户目前无法通过您的应用自行创建组织。
列表会显示每个组织的成员、已验证域名、单点登录状态、MFA 规则和创建日期。列表上方的关键指标会统计组织数、成员数、SSO 连接数和已验证域名数。

![Didit Business Console 中的组织页面，显示关键指标以及组织列表，包括各组织的成员、已验证域名和单点登录状态](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-organizations.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=95f8ab54f499735fe3f8593c565c0daa)

Authentication > Organizations。

## 成员与角色

一个人可以同时属于应用中的多个组织，并在每个组织中担任一个角色。

| 角色 | 适用对象 |
| - | - |
| `admin` | 在您的应用中管理组织的人员。 |
| `member` | 其他所有人员。默认角色。 |
| `billing` | 在您的应用中处理组织计费事务的人员。 |

在 Scale 和 Enterprise 套餐中，以及每个沙盒应用中，您还可以定义**自定义角色**，每个角色包含一个键以及您的应用检查的权限，例如 `payouts.approve`。
成员除自身角色外，还可以再持有一个自定义角色。

打开组织即可查看其单点登录、已验证域名、成员、角色和邀请。

![在 Didit Business Console 中打开的组织，显示其 SAML 单点登录（附设置链接）、带自动加入功能的已验证域名，以及其成员和角色](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-organization-detail.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=c3c60f877bbd96f53cb7d6ca2095d3d1)

组织的单点登录、已验证域名、成员和角色。

## 邀请

在组织中选择 **Invite member**，输入最多 20 个电子邮件地址以及每位成员获得的角色（`admin`、`member` 或 `billing`），Didit 会向每个人发送一封邀请邮件。
邀请有效期为 7 天。邀请会打开您登录源上的托管 `/invite` 页面，受邀者可以在该页面登录或创建账户并加入组织。
组织的 **Invitations** 列表会显示每个邀请的到期时间，并提供 **Resend** 和 **Revoke** 操作。

## 验证域名与自动加入

组织可以证明其拥有某个邮箱域名：

1. 将该域名添加到组织。
2. 在您的 DNS 服务商处，为 `_didit-auth.<domain>` 添加 Didit 显示的 TXT 记录，记录内容为验证 token。
3. 检查该域名。找到记录后，状态会显示为 **Verified**。

对已验证的域名启用 **Auto-join** 后，使用该域名下已验证邮箱地址登录的用户，会自动以您的默认角色加入该组织。
一个域名在您的应用中只能自动加入一个组织。

## 企业单点登录

组织可以通过自有的身份提供商，使用 SAML 或 OIDC 让其成员登录。

* **设置链接。** 在组织的 **Single sign-on** 卡片中选择 **Copy setup link**，并安全地分享给该组织的 IT 管理员。该链接有效期为七天，会引导他们完成连接。设置链接需要 Scale 或 Enterprise 套餐；沙盒应用在任何套餐下都可以使用设置链接。
* **SAML。** 您的服务提供商元数据发布在 `{origin}/sso/saml/metadata/`。
* **查找连接。** 托管登录页面会根据用户已验证的电子邮件域名，通过 **Use single sign-on**，或通过登录 URL 中的 `organization=<slug>` 找到该组织的连接。
* **状态。** 组织列表会显示每个连接是已启用、未设置，还是正在等待已发送的设置链接。

通过组织的身份提供商登录的用户，会以您的默认角色加入该组织。各协议的配置字段见[登录方式](https://docs.didit.me/zh/authentication/sign-in-methods.md#组织-sso)。

## 组织管理员的 MFA

默认的 MFA 策略 `organization_admins` 要求应用中任意组织里持有 `admin` 角色的每个人都提供第二重身份验证因素。
成为管理员的人必须注册一种验证因素。`GET /session/` 将不再接受其会话，直到其会话再次满足策略为止。
您可以在 **Authentication > Security and sessions** 中修改此策略，也可以在[应用设置](https://docs.didit.me/zh/authentication/overview.md#应用设置)中通过 `mfa_policy` 修改。

## 在应用中读取组织

开启组织功能后，用户的令牌和会话会告诉您的应用其所属的组织：

| 位置 | 包含内容 |
| - | - |
| 访问令牌和 ID 令牌中的 `org` 声明 | 用户最早的组织成员身份对应的 `{"id", "role"}`，若没有则为 `null`。 |
| `GET /session/` 中的 `organizations` | 所有成员身份，包含 `organization_id`、`organization__name`、`role` 和 `custom_role`（`key` 和 `permissions`，或 `null`）。 |
| SDK 会话中的 `organizations` | 相同的列表，例如 JavaScript 中的 `session.organizations`，React 中的 `user.organizations`。 |

```json theme={null}
{
  "organizations": [
    {
      "organization_id": "3e9a1f0b-5c2d-4e7f-8a6b-9c0d1e2f3a4b",
      "organization__name": "Northwind",
      "role": "admin",
      "custom_role": {"key": "approver", "permissions": ["payouts.approve"]}
    }
  ]
}
```

在每次执行依赖角色和权限的操作之前，请先在后端根据已验证的令牌或 `GET /session/` 检查角色和权限。
当组织功能关闭时，`org` 为 `null`，列表为空。

## 导入现有组织

从其他平台[导入用户](https://docs.didit.me/zh/authentication/migration.md)时，您可以一并导入他们的组织成员关系。
另请参阅[社交链接、身份验证器和组织](https://docs.didit.me/zh/authentication/migration.md#社交账号关联、验证器应用和组织)。


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