# 管理工作区

所有者或管理员为工作区设置的内容：谁以何种方式登录、谁可以做什么、数据保留多久、告警发往何处，以及网关治理的严格程度。

## 单点登录

所有者在**设置 › 访问权限 › 企业 SSO**中将工作区连接到公司的身份提供商。OIDC 从 Growth 套餐起提供；SAML 2.0 面向只支持该协议的身份提供商，随 Enterprise 套餐提供。

- 只有所有者可以保存身份提供商、开启或关闭仅限 SSO 模式，或将其删除：身份提供商决定谁能以该域名的任意地址登录。每次更改在写入前都会记入审计日志。
- 证明该邮件域名属于您：将屏幕显示的 TXT 记录添加到其 DNS，然后点击**验证域名**。在此之前不会有任何请求被引导到您的身份提供商；DNS 更改最多可能需要一小时才会生效。
- 先在登录页测试**使用公司 SSO 登录**，再开启仅限 SSO 模式：此后该域名的所有地址都无法再使用密码、Google 或邮件链接登录。
- 保存另一个身份提供商——另一个颁发者或客户端 ID、另一个 SAML entity ID 或签名证书、另一种协议——会撤销该域名的证明并关闭仅限 SSO 模式：请重新验证域名。保存同一个提供商（新的客户端密钥或相同的元数据）则两者都会保留。
- 通过 SSO 登录不会授予任何成员资格：加入工作区需要邀请或通过 SCIM。

### SAML 2.0 协议

- “SAML 设置”区域给出需要在身份提供商处登记的 entity ID 和 ACS URL。将提供商的元数据交给 Azoth：可以是其 URL，也可以粘贴其 XML——位于您自有网络中的身份提供商应使用其 XML 进行配置。保存提供商后，`/api/sso/metadata?workspaceId=<id>` 会提供服务提供商的元数据，大多数身份提供商可一步导入。
- Name ID 必须是持久的，并且对同一个人保持不变：新的 Name ID 就是一个新账户。
- 由身份提供商发起的注销会被执行：将您 Azoth 地址上的 `/api/sso/logout` 登记为注销 URL。一个经过签名的注销请求（HTTP-Redirect 或 HTTP-POST 绑定）会结束其所指人员在 Azoth 的全部会话。使用 SHA-1 签名的请求会被拒绝：请使用 SHA-256 或更强的算法。在 Azoth 云中，返回给身份提供商的应答不带签名。
- 身份提供商的签名证书变更时，请在同一屏幕保存其新的元数据。

### OIDC

- 填写域名、颁发者 URL、客户端 ID 和客户端密钥，并在身份提供商处登记屏幕显示的重定向 URI，作用域为 `openid email profile`。Azoth 在保存前会读取发现文档。客户端密钥加密存储，之后不再显示：留空即可保留原密钥。
- Azoth 自行完成登录，并在任何会话存在之前进行检查：颁发者只属于一个组织，ID token 的签名（RS256、PS256 或 ES256）和声明有效，且邮件地址正好属于已验证的域名，并由您的身份提供商声明已验证。
- Microsoft Entra ID：使用单租户颁发者（`https://login.microsoftonline.com/<tenant-id>/v2.0`，绝不能是 `common`、`organizations` 或 `consumers`），并在 ID token 中加入可选声明 `xms_edov`。Google Workspace：使用您 Workspace 内部的 OAuth 客户端，以便 Google 发送域名（`hd`）。
- OIDC 没有单点注销：会话在过期时结束——默认在该人员登录八小时后。

## SCIM 用户配置

SCIM 2.0 让您的身份提供商——Microsoft Entra ID、Okta、PingOne、JumpCloud 等——添加和移除工作区成员。从“设置 › 访问权限 › 企业 SSO”打开**用户预配 (SCIM)**。SCIM 与 SAML 一样随 Enterprise 套餐提供：其他套餐无法创建令牌，身份提供商的调用会被拒绝。

- 租户 URL：`https://www.azothos.ai/api/scim/v2`，自托管时为您自己的主机。工作区由令牌决定，而不是由 URL 决定。
- 所有者或管理员创建身份提供商所发送的 bearer 令牌。它只显示一次，仅以带密钥的哈希形式存储，并可在同一屏幕撤销：此后身份提供商的下一次调用即被拒绝。
- 用户可被创建、读取、更新（PATCH，包括 `active`）和删除；列表可按 `userName eq` 和 `externalId eq` 筛选。将 `userName` 映射为该人员的邮件地址，将 `externalId` 映射为其在目录中的稳定 ID。不支持批量操作。
- 以这种方式配置的人员以成员身份加入。其角色来自所属的组（见下文）：请在身份提供商处开启组配置。
- 取消配置——将 `active` 设为 false 或删除用户——会立即移除成员资格：该人员负责的授权被暂停，其个人密钥被撤销。由本工作区 SCIM 创建且没有其他关联的账户会被停用，绝不会被删除。工作区所有者不能通过 SCIM 取消配置：请先在 Azoth 中转移所有权。

只有使用以下显示名称之一的组才会授予角色——不区分大小写，忽略首尾空格以及分隔符 `_` 或 `-`：

- `Azoth Owners` — 管理员——SCIM 从不授予所有者角色
- `Azoth Admins` — 管理员
- `Azoth Finance` — 财务
- `Azoth Security Officers` — 安全官
- `Azoth Analysts` — 分析师
- `Azoth Members` — 成员

- 其他名称不授予任何角色：例如名为 Finance team 的团队组不授予任何权限。您的身份提供商也可以改用属性 `urn:ietf:params:scim:schemas:azoth:2.0:Group:mappedRole` 指定角色，该属性始终优先。
- 属于多个组的人员获得其中权限最高的角色：管理员，其次是安全官和财务（两者之间安全官优先），然后是分析师，最后是成员。从最后一个授予其角色的组中移除后，该人员即离开工作区。
- 名称不授予角色的组绝不会降低或移除任何人的角色。组授予或收回的每个角色在生效前都会记入审计日志。

## 角色

每位成员在一个工作区中只有一个角色。**设置 › 访问权限 › 团队**可以以所有者、管理员、成员或分析师的身份邀请和修改成员；财务和安全官角色来自 SCIM 组。

- **所有者** — 管理员能做的一切，外加付款方式、单点登录、双因素认证的强制要求、需要四眼原则的操作、诉讼保全以及删除工作区。工作区始终保留一位所有者，且只有所有者可以授予所有者角色。
- **管理员** — 配置工作区，管理成员、角色和 API 密钥，处理审批。不能删除工作区，也不能更改付款方式或身份提供商。
- **财务** — 账单——发票和付款方式——以及用量，审计日志只读。不能配置，也不能管理成员。
- **安全官** — 审计日志、其导出及向您的 SIEM 的转发；可查看单点登录设置、API 密钥和告警路由。不涉及账单、成员和模型调用。
- **成员** — 通过 Azoth 调用模型并查看自己的用量；可查看规则和设置。
- **分析师** — 只读：用量和审计日志，不能调用模型。

> 角色高于成员的邀请会授予该角色：当角色变更需要四眼原则时，邀请要等待第二位所有者或管理员，在此之前不会发送任何内容。移除所有者或管理员同样如此：批准前其访问权限保持不变。每次角色变更在生效前都会记入审计日志。

## 四眼原则

有些操作只有在第二个人批准后才会生效。提出请求的人永远不能批准自己的请求：Azoth 会检查，数据库也会再次检查。

- 所有者在**规则 › 更多 › 审批**中选择以下哪些操作需要第二位所有者或管理员：更改成员角色、发布或修改生效中的规则、更改数据保留期。批准连接器也可以要求四眼原则；只有所有者可以批准连接器，因此第二个人须是另一位所有者。
- 以下操作始终需要：运行被规则挂起待批的调用、需要人员批准的智能体操作或 MCP 工具调用、被依据检查挂起的回答、红队测试豁免、对法律的解读（以其他方式适用的规则、优先的区域）、解除诉讼保全。
- 请求会在**规则 › 更多 › 审批**和主页中等待，并在 72 小时后过期。获批后，操作以批准人作为执行者运行；每项决定都会记入审计日志并被密封。
- 无法读取该设置时，操作会等待第二个人，而不是由一个人执行。由无法确定其人员的 API 密钥发起的请求只能被拒绝，不能被批准：四眼原则需要知道是谁提出的请求。
- 四眼原则需要第二位所有者或管理员——批准连接器则需要第二位所有者：开启前请先邀请一位。规则的例外由规则负责人或所有者、管理员决定，绝不由提出请求的人决定（[例外](https://www.azothos.ai/zh/docs/rules#exceptions)）。
- 在 Slack 或 Teams 中，以 MFA 关联账户的所有者和管理员可以处理被挂起的调用、智能体与 MCP 操作、被挂起的回答和规则发布；以 MFA 关联账户的所有者还可以处理连接器。角色变更、保留期变更、红队测试豁免、对法律的解读和解除保全始终在 Azoth 中打开处理。

## 访问审查

所有者或管理员在**设置 › 访问权限 › 访问权限审查**中审查谁拥有哪些权限。

- 审查列出：成员及其角色、上次登录、双因素认证和登录方式；待处理的邀请；API 密钥及其角色、作用域、到期时间和上次使用；SCIM 令牌；是否强制双因素认证；以及哪些操作需要四眼原则。
- 它会指出需要关注的情况：没有双因素认证的所有者或管理员、90 天未登录、没有到期时间的 API 密钥、90 天未使用、仍使用旧哈希或没有作用域限制的密钥。
- 可下载为 JSON，或将成员下载为 CSV；纠正不应存在的内容后，将其标记为完成。准备审查和完成审查都会密封进工作区的日志——只有其指纹和计数，绝不包含邮件地址。建议每季度进行一次。
- Azoth 员工在您工作区上的操作同样会密封进其日志（`staff_access`）。在 Azoth 云中，他们只能通过所有者同意的支持访问接触其数据，最长 4 小时。

## 保留期

所有者或管理员在**设置 › 模块与保留 › 数据保留**中设置工作区对每类记录的保留时长：

- **用量追踪** — 30 至 365 天
- **路由决策** — 30 至 365 天
- **循环事件** — 7 至 180 天
- **复用的响应（缓存）** — 7 至 90 天
- **审计日志** — 365 至 730 天

- 每晚的清理会同时应用这些时长和数据策略自身的保留期：以较短者为准。当保留期变更需要四眼原则时，变更要等待第二位所有者或管理员——缩短追踪记录保留时间的数据策略也是如此。未设定保留期的新数据策略沿用当前生效的时长。复用的响应最多提供 7 天，过期后即被删除，无论其时长设置如何。
- 适用于您的法律可以设定下限：屏幕会显示该下限并拒绝更短的时长，清理也绝不会低于它。
- 已密封的决策日志的保留时长以您的套餐或合同为准，且绝不少于该下限。一旦应用，其最早的条目会在每晚于一个已密封的检查点之后被移除，因此链条从新的起点开始仍可验证；屏幕会显示是否已应用。
- 无论时长如何，诉讼保全都会保留其指定的内容。所有者将其设置在选定的决策上；在其有效期间，清理会保留这些决策的追踪，擦除会保留其信封，工作区既不能被删除，也不能随其所有者一起被擦除（`legal_hold_active`）。解除保全需要四眼原则（[诉讼保全](https://www.azothos.ai/zh/docs/dossiers#hold)）。

## 告警路由

工作区的每条告警都发送到**设置 › 集成与告警 › 告警**中的路由，这是设置告警目的地的唯一位置。

- 路由指定一个渠道——PagerDuty、Slack 或 Teams 频道 webhook，或一个邮件地址——以及最低严重级别（`info`、`low`、`medium`、`high` 或 `critical`）：它接收该级别及以上的告警。设置延迟后只在延迟结束后发送，以便只在无人处理时呼叫值班人员。
- 告警包括：等待决定的审批和例外；治理告警（被拒绝的调用、数据驻留、证明缺口、无授权的用途）；登录异常（重复失败、快速的角色变更）；提供商故障；模型版本变更和回归；被 Azoth 停止的智能体循环；接近或达到上限的已密封决策配额。
- 所有者和管理员可以修改路由，并向 Slack 或 PagerDuty 路由发送测试；安全官可以查看路由。
- 预算阈值发送到每个预算各自设置的目的地。治理事件也可以推送到您自己的端点（[治理 webhook](https://www.azothos.ai/zh/docs/webhooks#governance)）。
- 在**设置 › 组织**中指定一位安全联系人：除所有者和管理员外，工作区数据发生个人数据泄露时也会通知此人。

## 双因素认证

每个人都在**设置 › 访问权限**中使用身份验证器应用（TOTP）开启双因素认证；此后每次登录都会要求输入 6 位验证码。

- 所有者可以要求工作区所有成员都使用它。所有者自己的会话必须先通过它，以免有人把工作区锁死；之后，没有开启它的成员会被拒绝（`mfa_required_by_workspace`），直到其开启并重新登录。访问审查会显示是否已强制要求。
- 在 Slack 或 Teams 中处理审批需要以 MFA 关联的账户。
- Azoth 员工始终使用它：平台管理页面会拒绝未通过它的会话。
- API 密钥不会登录，因此双因素认证不适用于它：请为密钥设置作用域和到期时间，并定期审查。

## 治理模式

所有者或管理员在**设置 › 组织 › 治理模式**中选择网关治理该工作区的严格程度：

- **观察** — 没有已批准授权的调用照常执行，并在日志中标记：不会新增任何拦截。
- **治理** — 与上面相同，并就每一次此类调用向管理员发出告警。
- **强制** — 没有已批准授权的调用会被阻止，每次阻止都会被密封。

- 模式决定如何处理未关联到已批准授权的调用、无人负责或已到期的授权，以及适用法律。在所有模式下，规则、预算、紧急停止和禁止的做法（《人工智能法》第 5 条）都会拦截调用。
- 实际生效的模式是部署模式与工作区模式中较严格的那个：工作区只能收紧，绝不能放宽。屏幕会将比部署模式更宽松的选项置灰。
- 每次更改在写入前记入审计日志，随后被密封。每项决策都会密封其所处的模式，因此档案可以显示 Azoth 当时是在观察还是在强制。
- 无法读取工作区的选择时，任何规则都不会放宽：最后读取的值最多保留 10 分钟，之后调用按“强制”模式治理。
- 被归类为禁止的系统在所有模式下都会被拒绝，无论其状态如何：任何模式、例外或豁免都不会为其提供服务。
- 选择“强制”之前，请检查**授权 › 系统与智能体**：届时所有未关联到已批准授权的调用都会被拒绝。
- 智能体有自己的策略，位于**设置 › 访问权限 › 智能体 Guard 策略**：“观察”会根据授权检查每次工具调用并加以密封；“强制”会阻止授权范围之外的调用，并将不可逆操作挂起等待人员处理。它同样只能比部署的策略更严格。

## 人员归属

一项决策可以指明调用是为谁发起的——以假名密封，绝不使用姓名——以便档案能够说明是谁发起了它。在**设置 › 访问权限 › 每次调用由谁发起**中设置。

- **个人密钥** — 每次调用都属于其持有人：即为自己创建该密钥的所有者或管理员。它永远不能指明其他人；当持有人离开工作区或被擦除时，该密钥即被撤销。
- **可指明人员的服务密钥** — 在创建密钥时允许。应用发送 `X-Azoth-On-Behalf-Of`，附带该人员的 SCIM ID 或邮件地址，调用即归属到该成员。
- **服务密钥** — 不指明任何人，与以前相同。

- 密钥的类型在创建时即固定：如需更改，请创建另一把密钥。
- 应用发送的标识符会与某位成员匹配，然后被丢弃：绝不存储、记录或密封。决策密封的是该成员的假名（每个工作区各不相同）以及识别该人员的方式。擦除该人员会删除假名的关联，链条仍可验证。
- 请求头未指明任何成员的调用照常执行，并记录为未解析。`X-Azoth-End-User` 是另一回事：它表示公开系统的匿名访客。
- 所有者或管理员可以开启**要求每次调用都指明其人员**：此后未指明任何成员的调用会被拒绝，且拒绝会被密封。这一更改会记入审计日志并被密封。
- 拒绝情形：`on_behalf_of_not_allowed`（403：不能指明人员的密钥发送了该请求头）、`human_identity_required`（400：工作区要求指明人员，而调用未指明）、`identity_unavailable`（503：无法读取密钥或该要求，调用被拒绝而不是在未经检查的情况下执行）、`invalid_on_behalf_of`（400：请求头格式错误）。每种情形都在[错误代码](https://www.azothos.ai/zh/docs/errors)中说明。
- 在保持默认设置的部署上，只要工作区尚未使用人员归属——个人密钥、允许指明人员的密钥或已开启的要求——其调用就与以前完全一样地执行，其发送的 `X-Azoth-On-Behalf-Of` 会被忽略。
