多租户任务签名声明如何设计与轮换
为多租户后台任务实现租户隔离:从任务上下文传递到跨租户回归测试
异步任务的安全边界,往往在入队那一刻就已经开始松动。最常见的错误假设是:请求入口已经完成租户认证,任务进入队列后就会自动继承这份身份。但队列通常只保存序列化消息,消费者可能运行在另一个进程、节点甚至不同的服务账号下,原本可信的请求上下文在传递中会丢失。更危险的是,如果消息里携带的 tenant_id 只是普通业务参数,租户 A 提交的任务就可能通过篡改参数读取或修改租户 B 的数据。租户隔离不能等同于认证或授权,系统必须用可信的租户上下文限制资源访问范围,并且阻止任何跨租户访问路径。
设计任务签名声明的核心原则是:入队时从已认证请求上下文生成受保护的身份声明,而不是把租户标识当作普通字段写入消息。具体做法可以是为任务主体、租户标识、权限范围、发布时间和过期时间做签名,或使用不可伪造的内部令牌引用。消费者在读取任何数据前先验证签名、消息来源、任务类型和有效期,再把验证结果转换为只读的租户上下文,业务代码不能重新赋值。数据访问函数应强制要求上下文,没有上下文就拒绝执行,而不是退化为“按参数查数据”。缓存键、对象存储路径、事件主题和审计记录也都要包含可信租户上下文,避免出现主查询已隔离但导出或缓存仍未隔离的局部漏洞。
轮换策略同样重要。签名声明必须包含过期时间,消费者对有效期进行校验,过期的任务应进入失败流程并要求重新授权,不能因为重试由后台调度器发起就自动提升为全局管理员。重试消息应引用原任务的不可变身份声明,重新验证有效期和权限;若原任务已过期或权限被收紧,应让任务失败。上线更严格的校验后,队列中已存在的旧任务可能没有签名或使用旧格式,直接切换会导致存量任务全部失败。可行的做法是分阶段回退:先在测试环境和小比例消费者上启用强制校验,统计缺失上下文和签名不匹配的任务;对无法证明租户归属的存量任务标记为待人工处理或进入受控死信队列,不自动补写身份;保留旧消费者作为短期回退,但只处理经过迁移且可验证的消息。回退应恢复部署版本或消费策略,而不是关闭租户校验。
幂等键也要带租户范围。只使用全局的业务 ID 作为幂等键,可能造成不同租户之间互相覆盖状态,应使用包含租户标识的受保护组合,且租户部分由可信上下文生成,不允许调用者自行提供。死信队列本身也不能成为无保护的数据仓库,消息可能包含租户标识、资源 ID 或敏感参数,应限制读取权限、设置保留期限,人工重放前重新执行授权校验并记录操作者。
异步任务不应被视为“请求处理的延迟版本”,而应作为独立的信任边界来验证:从请求入口生成的可信租户身份,必须贯穿入队、消费、重试、数据访问、缓存、文件输出和审计全过程,任何一环断裂都可能成为跨租户数据泄露的通道。

参与讨论
异步任务确实不能默认继承请求身份
租户上下文做成只读很关键