代理登录
代理登录让具有特权的用户能够以另一位用户的身份操作,用来重现对方看到的内容,或代其完成某项工作。代理登录期间发出的每个请求都归属于被代理的用户,每个代理登录会话也都会被记录。发起代理登录需要管理员(或超级管理员)角色。
谁可以代理登录谁
| 操作者 \ 目标 | 持有超级管理员角色 | 持有管理员角色 | 其他任何用户 |
|---|---|---|---|
| 超级管理员 | ❌ | ✅ 整个平台 | ✅ 整个平台 |
| 管理员 | ❌ | ❌ | ✅ 仅限自己的租户 |
| 其他任何角色 | ❌ | ❌ | ❌ 根本不提供此操作 |
这张表要说明的正是一点:代理登录永远不能用来获得操作者本来没有的权限。普通管理员无法代理登录另一位管理员;超级管理员代理登录管理员也得不到任何好处,因为管理员能通过的门禁,超级管理员本来就都能绕过。
目标按其有效角色判定,因此从用户组继承的管理员角色,与直接授予的管理员角色一样保护其持有者;否则,用户组就成了绕过上表的途径。
另有四类目标无论角色如何都会被拒绝:您自己、预置的系统用户、已停用的用户,以及已软删除的用户。此外,对管理员而言,其他租户中的目标会返回 HTTP 404,而不是 403:跨租户引用永远无法证实该用户存在。
开始和停止
在用户列表中通过代理登录操作开始;确认后会进入欢迎页,并以该用户的身份操作。代理登录生效期间,页眉中的胶囊会显示“正在以 <user> 身份操作”,并带有停止代理登录按钮。
同一时间只能有一个代理登录处于打开状态:开始新的代理登录会关闭之前打开的那个。停止操作随时都可以安全调用,即使当前没有任何代理登录处于打开状态。
有效身份
代理登录是请求标头的覆盖,而不是会话的替换。真实的会话 Cookie 不会改变;浏览器只是在每个请求上附加所选用户的 ID,后端再据此解析出有效身份。由此产生两个结果:
- 真实操作者自己的会话一直在底层保持有效,因此停止代理登录时无需重新登录。
- 请求涉及的一切,包括读取、写入以及审计字段
createdBy/updatedBy,都归属于被代理的用户,就像对方亲自登录一样。角色检查同样按被代理用户的有效角色进行,因此以请求者身份操作的超级管理员要受请求者门禁的约束,看到的也是请求者看到的 UI。
开始和停止的端点是有意设置的例外:它们按真实操作者的角色而不是有效身份的角色进行门禁检查。否则,正在代理登录一位特意没有任何权限的用户的管理员,会在自己的“停止”调用上无法通过角色检查,从而被困在其中。
代理登录何时失效
资格会在每个请求上重新检查,而不只是在开始代理登录时检查,因为上表取决于角色,而角色会变化。如果代理登录不再成立,请求并不会失败,而是静默回退到真实操作者,并关闭这条过时的记录。这涵盖以下情况:目标被停用或删除;目标被提升权限(包括被加入授予管理员角色的用户组);操作者失去管理员角色(无论是被直接撤销,还是离开了授予该角色的用户组)或超级管理员角色;操作者不再与目标同属一个租户;代理登录已在其他地方被停止。
若让请求失败,后果只会更糟:所选用户保存在浏览器的本地存储中,一旦报错,一个过时的值就会把合法的管理员锁在整个应用之外。
审计跟踪
每个代理登录会话都会记录在持久的审计跟踪中(谁、代理了谁、何时),保存在 impersonation_events 表中(请参阅配置参考)。由于写入 createdBy / updatedBy 的是被代理的用户,这条跟踪记录是回答“那次写入的背后究竟是谁?”的唯一依据,这也正是它不可省略的原因。
管理员可以在审计日志的代理登录选项卡上查看这条跟踪记录,其中列出涉及其租户账户的每个会话,包括超级管理员发起的会话。