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

# 用户

> 如何在知行之桥中创建和管理用户及其访问权限。

第一次启动 知行之桥 时，系统会提示你设置用户名和密码来创建第一个应用程序用户。第一个用户默认为[管理员角色](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/settings/user-roles.md#管理员角色)。

要创建和管理其他用户，请导航至[系统设置页面](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/settings/settings-page.md)的**用户**选项卡。该选项卡列出所有用户，以及用户角色、用户类型、状态、是否为临时用户、[双因素身份验证（2FA）](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/2fa.md)状态等信息。

![用户表](https://mintcdn.com/qiao/V5zXPPmcRAz2rNUe/26.4/images/users_table_264.png?fit=max\&auto=format\&n=V5zXPPmcRAz2rNUe\&q=85\&s=eae77e166430b80990361e33ecc58708)

管理员角色的成员可以在此选项卡上创建、删除和修改用户。管理员是唯一有权管理其他用户的角色。

## 添加或编辑用户

要添加用户，请点击**添加用户**。要编辑现有用户，请将鼠标悬停在表格中对应的行上，点击省略号，然后选择**编辑**。

请填写以下字段：

| 字段 | 描述 |
| - | - |
| **用户类型** | 选择用户账号的类型：**标准**、**单点登录**、**Active Directory**、**LDAP** 或**服务**。所选类型决定表单中显示哪些其他字段。可用的类型取决于你的许可证级别。有关详细信息，请参阅[用户类型](#用户类型)。 |
| **用户名** | 输入用户名。保存用户后，此字段无法更改。对于 **Active Directory** 账号，请使用 `domain\username` 格式。 |
| **临时帐户** | 如果用户只应获得临时访问权限，请勾选此项并提供**到期日期**。 |
| **电子邮件地址** | 最佳做法是为每个用户提供电子邮件地址，以便在必要时[重置密码](#密码重置)。 |
| **角色** | 选择要分配给用户的[用户角色](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/settings/user-roles.md)。 |
| **密码** | 输入符合[登录设置](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/settings/sign-in-settings.md)要求的密码。**密码**字段仅对标准账号和具有管理员角色的单点登录账号显示。勾选**下次登录时需要重置密码**可强制用户在登录时更改密码。具有管理员角色的单点登录账号会保留本地密码，因此也可以使用此复选框。 |
| **状态** | 指示用户处于活动还是非活动状态。 |
| **联合 ID（Federation Id）** | 对于**单点登录**账号，输入身份提供商（IdP）中用于将 SSO 身份声明映射到此 知行之桥 用户账号的值。无论是否已全局启用 SSO，单点登录账号始终显示此字段。有关详细信息，请参阅[单点登录](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/settings/single-sign-on.md)。 |

要授予新用户[系统 API](#系统-api-访问)或 OAuth 访问权限，请点击 **API 访问**选项卡。

![提供系统 API 或 OAuth 访问权限](https://mintcdn.com/qiao/4hcVjuRd69QHuQ3V/26.4/images/add_user_api_access.png?fit=max\&auto=format\&n=4hcVjuRd69QHuQ3V\&q=85\&s=6d0db8be38ab81e60d8967e8a9207062)

| 字段 | 描述 |
| - | - |
| **API 访问** | 勾选**启用 Authtoken 访问**，授予用户可用于访问系统 API 的 Authtoken。启用后会显示本表中的其余字段。 |
| **令牌到期日（天）** | 令牌到期前的天数。如不希望令牌过期，请勾选**无到期日**。 |
| **Authtoken** | 系统生成的 Authtoken。保存用户前请将其复制到安全位置，因为之后不会再次显示。 |
| **每小时最大请求数** | 取消选中**无限请求数**可限制该用户每小时的最大请求数。 |
| **最大并发请求数** | 取消选中**无限请求数**可限制同时发送的最大请求数。 |
| **启用 OAuth 访问** | 勾选后，授予用户可用于保护[系统 API](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/settings/admin-api-settings.md)公共 API 端点的凭据。OAuth 2.0 适用于需要管理令牌生命周期或与外部应用程序集成的客户端。 |
| **授权类型** | 决定客户端应用程序如何获取访问令牌的 OAuth 2.0 授权类型。目前仅支持**客户端凭据**。 |
| **客户端 ID** | 系统生成的客户端 ID。 |
| **客户端密钥** | 系统生成的客户端密钥。保存用户前请将其复制到安全位置。 |
| **访问 URL** | 客户端应用程序使用配置的凭据请求访问令牌的端点 URL。 |

要添加特定于该用户的受信任或禁止 IP 范围，请使用**受信任 IP 范围**或**禁止 IP 范围**选项卡。可以提供单个 IP 地址、简单范围（如 `203.0.113.*` 或 `203.0.113.1-255`）或 CIDR 范围。这些选项卡还显示在**系统设置 > 安全**页面的[网络访问](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/settings/network-access.md)部分定义的全局范围。

## 用户类型

知行之桥 支持以下用户类型：

* **标准**账号供用户通过用户名和密码交互式登录 知行之桥 控制台。
* **单点登录**账号供通过外部身份提供商（IdP）进行身份验证的用户使用。不具有管理员角色的单点登录账号不显示**密码**字段。具有管理员角色的单点登录账号会保留本地密码，以便在 SSO 不可用时作为备用登录方式。单点登录账号始终显示\*\*联合 ID（Federation Id）\*\*字段，该字段用于将 IdP 的身份声明映射到此 知行之桥 用户账号。由于身份验证在 IdP 端进行，知行之桥 的双因素身份验证（2FA）不适用于单点登录账号，因此不显示 2FA 控件。有关配置 SSO 的详细信息，请参阅[单点登录](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/settings/single-sign-on.md)。
* **Active Directory** 账号供使用 Windows 域账号进行身份验证的用户使用。用户名必须采用 `domain\username` 格式。Active Directory 仅在 [.NET 版](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/installation/windows-edition.md)中可用。
* **LDAP** 账号供使用 LDAP 目录服务进行身份验证的用户使用。LDAP 仅在[跨平台版](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/installation/cross-platform-edition.md)中可用。
* **服务**账号用于自动化的机器间访问，例如调用 [Flow API](https://docs.kasoftware.com/26.4/self-hosted/zh/flows/flow-api.md) 端点或[系统 API](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/settings/admin-api-settings.md)。服务账号不能交互式登录，因此不显示**密码**字段和 2FA 控件，只能使用 **API 访问**选项卡中配置的 Authtoken 或 OAuth 客户端凭据进行身份验证。服务账号要求在 **API 访问**选项卡中至少配置一种身份验证方式（**启用 Authtoken 访问**或**启用 OAuth 访问**）。如果两者均未启用，表单会显示警告并阻止保存。例如，可以将服务账号与仅授予 Flow API [**Invoke** 权限](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/settings/user-roles.md#flow-api-配置)的角色配对，使其能够调用指定端点，但无法访问或查看 知行之桥 UI。

> [!NOTE]
>
> 全局启用 SSO 后，标准账号也会显示\*\*联合 ID（Federation Id）\*\*字段。这适用于已有联合 ID 但尚未迁移为单点登录类型的标准账号，例如保留本地密码作为备用登录方式的管理员账号。

可用的用户类型取决于你的许可证级别：

| 许可证级别 | 可用的用户类型 |
| - | - |
| 企业版 | 标准、单点登录、Active Directory、LDAP、服务 |
| 专业版 | 标准、服务 |
| 标准版 | 标准 |

## 单点登录

知行之桥 支持通过实现 OpenID 标准的身份提供商进行单点登录（SSO）。有关详细信息和 Azure AD 的具体指南，请参阅[单点登录](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/settings/single-sign-on.md)。

## 系统 API 访问

每个用户都可以获得用于访问[系统 API](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/settings/admin-api-settings.md)的 Authtoken。有关身份验证的更多信息，请参阅[系统 API 身份验证](https://docs.kasoftware.com/26.4/self-hosted/zh/admin-api/admin-api-authentication.md)。

用户可通过系统 API 执行的操作与其在 UI 中可执行的操作一致。例如，不能在 UI 中删除连接器的用户也不能通过系统 API 删除连接器。要执行任意系统 API 操作，请使用管理员用户的 Authtoken。

## 密码重置

每个用户都可以将电子邮件地址与其帐户关联。需要重置密码时，用户可点击**忘记密码**链接接收重置邮件。每次发送密码重置邮件都会在[应用程序日志](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/activity.md#应用程序日志)中添加一行。

没有关联电子邮件地址的用户必须联系管理员重置密码，因此管理员最好为每个用户帐户设置电子邮件地址。

如果所有管理员均无法登录 知行之桥，各版本的嵌入式 Web 服务器允许重置密码。此操作需要安装目录的管理权限，并且只应在没有其他可用用户时使用。

在[跨平台版](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/installation/cross-platform-edition.md)中：

```text theme={null}
java -jar arc.jar -ResetPassword -User <user> -Password <password> -AppDirectory <appDirectory>
```

在 [.NET 版](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/installation/windows-edition.md)中：

```text theme={null}
CData.Arc.exe -ResetPassword -User <user> -Password <password> -AppDirectory <appDirectory>
```


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