免费开始 →

管理

管理工作区

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

单点登录

所有者在设置 › 访问权限 › 企业 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 密钥发起的请求只能被拒绝,不能被批准:四眼原则需要知道是谁提出的请求。
  • 四眼原则需要第二位所有者或管理员——批准连接器则需要第二位所有者:开启前请先邀请一位。规则的例外由规则负责人或所有者、管理员决定,绝不由提出请求的人决定(例外)。
  • 在 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)。解除保全需要四眼原则(诉讼保全)。

告警路由

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

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

双因素认证

每个人都在设置 › 访问权限中使用身份验证器应用(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:请求头格式错误)。每种情形都在错误代码中说明。
  • 在保持默认设置的部署上,只要工作区尚未使用人员归属——个人密钥、允许指明人员的密钥或已开启的要求——其调用就与以前完全一样地执行,其发送的 X-Azoth-On-Behalf-Of 会被忽略。