授权、审批与审计
授权决定一个 Agent 能碰哪些资源,审批决定哪些操作要有人点头,审计记下发生过什么。这三件事都在 Nexus Core 里统一处理,模块在执行时照着做。
授权给谁
授权的对象有四类:单位、岗位角色、人员和 Agent。在控制台的「接入中心 › 授权管理」里,先看到所有已有授权的对象,点进去就是这个对象的授权;还没有任何授权的对象,在上方的「授权对象」里选。
一个 Agent 的实际权限,是它自己的授权,加上所属人员、岗位角色和单位的授权合并的结果。同一个资源有多条授权时,以最近的一级为准:
- Agent 自身;
- Agent 所属的人员(个人 Agent);
- 人员担任的岗位角色;
- 人员所属和兼任的单位,由近到远。上级单位的授权需要勾选「含下级单位」才会覆盖下级。
例如单位层授予了某个动作,同时在某个人身上单独授一条不含这个动作的授权,这个人就没有这个动作。同一层级内的授权约束互相矛盾时,该资源会被拒绝,控制台会标出来,需要统一约束,或者在更近的一级单独授权。
Agent 详情页的「有效权限」会列出合并后的结果和每一项的来源。授权改动后,受影响的 Agent 在下一次调用时生效。
添加授权时可以一次选多个资源,同一组能力逐个资源添加,每条都经模块校验,分别写入审计。已经有授权的资源会被跳过。数据范围,比如表的可见字段和行条件,属于单个资源,只在选了一个资源时可以编辑。
能授权到多细
粒度由各模块的资源决定,控制台把模块的动作和约束用中文列出来。
| 模块 | 授权的资源 | 可以细分的内容 |
|---|---|---|
| 数脉 | 数据源里的表,以及业务说明文档 | 动作分「查看结构」「执行查询」「读取业务文档」。表上可以选可见字段,把字段设为只允许聚合,设行条件(字段等于以下任一值),设固定条件和按关联表过滤,限定每次查询最多返回的行数 |
| 知汇 | 文档和文件夹 | 动作是「检索」。可以限定每次检索最多返回的结果数 |
| 运枢 | 运维资源 | 按动作逐项授予:查看资源、状态、日志、告警、巡检,发起巡检,查看、停止、核对任务,以及制定和提交变更、重启、扩缩容、回滚、重载计划。提交的计划要经审批页放行 |
| 联枢 | 接口或工具,以及工作流 | 动作分「查看目录」「调用接口」「运行工作流」「查看调用日志」。写操作是否需要审批,由工具或工作流自己的档位决定(见下一节) |
| 研枢 | 研发项目 | 动作分「读研发数据」「发起任务与采纳」 |
按调用者动态限定范围
行条件和固定值可以引用调用者变量,让同一条授权对不同的人展开成不同的范围:本人工号,所属和兼任单位的编码,这些单位及全部下级单位的编码,名下全部在职下属(含各级)的工号,以及本人或所属单位在某个外部系统里的编码。变量按组织目录解析,目录变了,下次调用就按新结果执行。
变量展开后超过 1000 个值时,这条授权不会下发给模块,也不会被截断成更宽的范围。控制台在有效权限里标出「未生效」,建议拆成多份分批授予,比如按下级单位分别授权。
三档调用
每个需要人放行的操作都有一个档位,档位由平台管理员在联枢的工具和工作流、运枢的资源上配置。
| 档位 | 谁放行 | 适合 |
|---|---|---|
| 授权后直接调用 | 不需要人,授权和参数检查通过就执行 | 只读操作,或者低风险、可撤回的写操作 |
| 本人确认 | 发起这个操作的 Agent 所属的那个人,本人确认 | 防止 Agent 理解错,比如替本人提交一张单据 |
| 他人审批 | 持有审批权的其他人员,不能是发起人本人,还可以收窄到发起人的单位链上 | 涉及资金、他人数据或生产环境的写操作 |
- Agent 不能批准。审批动作只能授予人员、岗位角色和单位,不能授予 Agent。属于某个单位的 Agent 即使继承到了带审批的授权,也只得到其余动作。模型在对话里回答的「同意」不算审批。
- 平台管理员不能放行。管理员可以配置档位、授予和收回审批权、查看待批项,但不能批准或确认任何待批项,包括自己发起的。管理员能做的是叫停:撤销待批项、终止运行、撤销已批准但还没执行的计划。撤销会记录是谁、为什么,并在审批页显示为「已由管理员撤销」,与业务上的拒绝区分开。
- 没有人能放行时立即拒绝,不会让待批项一直挂着。例如除发起人外没有任何人持有审批权,或者要求本人确认但这个 Agent 没有归属人员。控制台在配置他人审批时会显示当前可审批的人数,为 0 时给出警告。
- 不能自批自授。管理员账号关联了某个人员时,不能直接给这个人员授予审批类权限,需要另一位管理员来做。通过岗位角色或单位继承得到的不拦截,但会在审计里标记。
- 期限。本人确认默认 15 分钟,他人审批默认 24 小时,工具和工作流可以单独配置,上限 7 天。期限内配置变了,要重新规划,不能沿用旧的批准。
运枢没有「授权后直接调用」这一档:变更至少要本人确认,新资源默认是他人审批。联枢的工作流计划取所有步骤所用工具中最高的一档。
审批人怎么登录和审批
Nexus 不给审批人建账号,也不保存审批人的密码。登录调用客户自己的身份系统,由平台管理员在控制台配置。
| 登录方式 | 说明 |
|---|---|
| OIDC | 授权码加 PKCE。Nexus 校验 ID Token 的签名、签发方、受众和有效期 |
| 票据 | 浏览器跳到客户的登录页,登录后带一次性票据回到 Nexus,Nexus 再调用客户的校验接口确认身份。同一票据只能用一次 |
| 钉钉、企业微信、飞书 | 扫码登录,按各平台公开文档的网页授权流程实现 |
| 代收密码校验 | 只在原系统既没有 OIDC,也没有登录页加票据校验时使用。启用前必须确认风险:用户名和密码会经过 Nexus 转交校验接口 |
登录后,身份要对应上组织目录里的在职人员,并且满足下面任一条才能进入审批页:
- 持有至少一个只有人才能执行的动作,比如审批;
- 名下有至少一个在用的 Agent。这类人员没有审批授权,登录后只能确认自己的 Agent 发起的、要求本人确认的操作。
对应不上人员、人员已离职,或两条都不满足的,登录一律被拒绝,浏览器看到的结果都一样,具体原因只记在审计里。审批页的会话有效 8 小时,空闲 30 分钟失效,人员离职后立即失效。这个会话只能访问审批相关的接口,进不了控制台。
审批页有四栏:「待我确认」「待我审批」「我发起的」「审批记录」。审批人看到的是冻结的内容:已完成步骤的结果(已脱敏)、要执行的下一步和参数,工具登记的关键参数按原值展示。批准或拒绝时提交的是当时看到内容的指纹,内容变了就拒绝;同一个请求只有第一个决定生效。
审批提醒
平台管理员在「系统设置 › 审批提醒」里配置一个 HTTPS 的 Webhook 地址和签名密钥。审批请求创建时、等待一段时间后、临近截止时,Nexus 把提醒以签名的 JSON 推送过去,由客户自己的机器人网关或消息中台转发给对应的人。
- 提醒只含标题、发起人、截止时间和审批页链接,不含审批内容和任何参数,参数只有登录审批页后才能看到。
- 请求带
X-Nexus-Signature,是对时间戳和请求正文的 HMAC-SHA256 签名。网关应校验签名,拒收时间戳相差超过 5 分钟的请求。 - 投递失败按 1、2、4、8、16 分钟的间隔重试,最多尝试 6 次。每次尝试都写入审计,审计里不含提醒内容。
- Nexus 不直接调用钉钉、企业微信、飞书或邮件服务。启用前已经在等待的请求不会补发。
不配置任何渠道也能看到待办:审批页的「待我确认」「待我审批」两个标签上显示待办数量。
审计
核心的审计是一条只追加的哈希链。控制台操作、模块注册、Agent 调用、审批和授权变更都写入其中。数据库触发器禁止修改、删除和清空,核心也没有删除审计的接口或命令,没有任何自动删除。
按条件查询
在「系统设置 › 审计日志」里按条件查询,条件同时满足:
- 时间范围、类别、事件类型(可以写前缀,如
grant.*); - 主体(Agent 或账号)、人员、单位(默认包含下级单位);
- 目标对象、模块、结果(成功、拒绝、失败)。
结果按序号稳定翻页,条件、每页条数和位置都写在地址里,把链接发给同事能回到同一页。人员和单位按记录写入时的归属匹配,之后调动或调整不会改变过去的记录。
导出归档并离线校验
在「保留与归档」里填起止序号导出归档,一个归档最多 50,000 条,超过会被拒绝,不会截断。导出本身也写一条审计,记录导出人、范围和文件的 SHA-256。归档可以脱离在线系统,用核心镜像里的管理命令校验,不需要连接数据库:
node dist/admin.js verify-audit --archive nexus-audit-core-1-50000.json
校验会重算每条记录的哈希,检查记录的前后链接、序号是否连续、分段摘要和链头。不通过时给出原因和出错的序号。
核心每天至少对链头签名一次,每追加 10 万条记录再签一次,称为锚点,用来发现整条链被重写。锚点可以推送到客户自己的日志平台或对象锁存储,数据库被整体替换时,外部副本仍可比对。
内审、外审的只读查看
内审和外审人员不需要 Nexus 账号。他们经客户的身份系统登录 /approvals/audit,按授权只读查看。
- 授权在「授权管理」里给人员、岗位角色或单位,模块选「Nexus 核心」,资源类型选「审计」,动作是「审计查看」和「审计导出」,两者互不包含。只能授予人,不能授予 Agent。
- 审计页有「审计记录」「审批记录」「有效权限」三个标签。可以查询、查看哈希链校验结果、查看任一人员或 Agent 的有效权限,持有导出权的还可以按条件导出证据包。
- 审计员不能修改任何配置、授权、Key 或模块,也不能审批。访问审计以外的接口一律被拒绝并写审计。授权收回后,已登录的审计员下一次请求就被拒绝。
- 审计员的每次查询和导出都写审计,平台管理员的查询不写审计,导出写。
证据包按条件导出,包含符合条件的原始记录、相关的审批记录、哈希链校验信息,以及各模块的结果留存和敏感字段访问记录,一个证据包最多 50,000 条。审计员还可以对数脉的一条留存结果发起复现,系统重新执行并只回答「一致」「不一致」或「不能复现」,不返回结果行。
局限:审计的访问范围不能细分,持有审计权的人能看全部模块、全部期间的记录。证据包里的记录一般不连续,不能单独证明没有遗漏,需要时导出覆盖同一序号范围的归档。同一个人可以同时持有审计权和审批权,如果需要职责分离,授权时请避免这样分配。
出站控制
出站控制要回答两件事:发给模型的数据里有没有不该出去的,以及查询结果会不会进入一个外部模型的上下文。
模型连接的部署位置
每个模型连接都标明部署在「企业内部部署」还是「外部」。预设的服务商固定是外部,自定义地址必须明确选一个。数脉在组装发给模型的内容时,按本次请求所用连接的部署位置处理:发给外部模型的内容里,级别为 personal、sensitive 的字段只提供名称、类型和说明,不提供样例值。
在数脉面板里,数据源的设置有一个「出域控制」标签,可以按数据源再收紧:
- 模型:设为只向企业内部部署的模型提供结构、说明和样例后,该数据源的这些内容只发给内部模型。用途绑定的是外部模型时,提交就会被拒绝并说明原因。
- 结果:设为只对内部 Agent 返回明细后,客户端模型不是企业内部部署的 Agent,在对话里拿到的 personal、sensitive 字段明细为空,只能通过聚合查询得到。确实需要明细时,改用结果交付,结果作为文件交给 Agent 所属人员下载,不进入对话。
Agent 声明客户端使用的模型
平台管理员在「接入中心 › Agent 与密钥」的 Agent 详情里,用「客户端模型」声明这个 Agent 的客户端用的是什么模型:未声明(默认)、企业内部部署或外部模型,可以附一个名称,比如 qwen-72b-内网。每次实际变化都写审计,记录修改人和前后取值,修改后各模块在下一次调用时按新声明执行。
出站网络
Nexus Core 和各模块访问模型、客户数据库、研发系统、上游接口、通知和目录的地址,默认拒绝回环、私网、链路本地和云元数据等网段。要接入客户自己的内网地址,由部署人员在部署配置里明确放行。放行范围再宽,Nexus 部署自己的内部网络也始终拒绝,模块不能经出站路径直连数据库或其他模块。
组织与人员从哪来
授权、审批人、审计员和 Agent 归属都依赖组织目录。目录是空的时候,没有人能登录审批页。目录有三种来源,在「组织 › 导入与同步」里配置:
- CSV 批量导入:用来初始化组织目录,日常的单位和人员维护在「组织架构」里做。
- HR 系统推送:客户的 HR 系统或导出脚本把组织和人员推送给 Nexus。全量快照用
POST /v1/org-sync/snapshots,加?dry_run=true只预检不写入;单人的离职或调动用POST /v1/org-sync/events,立即生效。认证用在控制台生成的同步凭据(Authorization: Nexus-Sync <凭据>),凭据只显示一次。一个部署有一个同步来源。 - 从钉钉、企业微信、飞书通讯录拉取:由 Nexus 直接读取通讯录,不需要写导出脚本,可以手动拉取,也可以每小时、每 4 小时或每天定时拉取。读到的内容走与推送同一套计划,预检、保护阈值和写入规则都相同。
几条同步规则:
- 整份原子写入。只要有一条记录有错,整份快照一条都不写入,错误清单保留给管理员查看。
- 批量离职有保护阈值。一次办理离职的人数超过「人数」与「在职人数 × 百分比」两者中较大的一个(默认 5 人或 2%)时,这次同步不写入,等待管理员核对后选择确认写入或丢弃。有被拦下的同步,控制台首页会告警。
- 离职立即生效。人员办理离职后,这个人的个人 Agent 和全部 Key 立即停用。
- 来源维护的字段在控制台只读。同步写入的单位和人员,名称、上级、所属和兼任单位、在职状态等在控制台里不能改,只能调整岗位角色和来源不维护的外部编码。