用途:管理 ACL 所作用的主体对象。acl-security 讲规则,本技能讲规则作用的对象,避免代理在“把 Sam 加入变更团队”时误写背景脚本,导致静默产生重复成员行。
涉及的四个表:sys_user(人员)、sys_user_group(组)、sys_user_grmember(每个用户-组成员关系一行)、sys_user_has_role(每个用户-角色授权一行,含直接与继承)。组上没有成员列表,用户上也没有角色列表,二者都是连接表,工作就发生在这些表里。
操作顺序:先建组、再建成员关系;先有角色、再授权。示例:先用 snow_role_group_manage 的 create_group 建组,再用 snow_manage_group_membership 的 add 加入成员(接受 sys_id、用户名或邮箱),最后用 assign_role 把角色赋给组。snow_manage_group_membership 插入前会检查既有成员关系,而手写 GlideRecord.insert() 不会;重复的 sys_user_grmember 行不会破坏访问,但会破坏移除操作。
继承与直接角色:直接授权产生 inherited=false 的行,平台在用户加入带该角色的组、或所持角色包含其他角色时产生 inherited=true 的行。snow_get_user_roles 返回该用户 sys_user_has_role 的全部行及显示值,判断前先看 inherited 标志。移除角色不一定移除访问:撤销直接授权后,若用户所在组也授予该角色,继承行仍在。因此撤销前应查看该角色的所有行,若有 inherited=true,应从组成员关系入手;不要手工删除 inherited=true 的行。角色包含关系会叠加,例如 itil_admin 包含 itil。
assign_role 的注意点:snow_role_group_manage 的 assign_role 把行写入 sys_user_has_role,而标准实例上组到角色的连接表是 sys_group_has_role,需用 snow_query_table 核实结果;若为空,改在 UI 的组角色相关列表中授予,工具只用于用户授权。
停用而非删除:snow_user_manage 的 deactivate 将 active 置为 false,是唯一移除方式。sys_user 记录被所有任务、日志、审批引用,删除会留下悬空引用;停用可阻止登录、移出分配查找并保留引用。停用不会移除组成员关系或角色,如需明确清除访问,需显式移除成员关系后再停用。组同理,应停用而非删除。
读先于写:可用成员 list 查看组内所有人,或用 snow_query_table 查询某用户所属的所有组。相关主题包括 acl-security、instance-security 与 domain-separation(域分离实例上跨域成员关系行为不同)。