接口权限与审计声明
账号类型、操作权限与数据范围共同决定接口访问；写入审计要记录安全目标和真实结果。
文档导航
本页目录
接口声明包含哪些层次？
单体版存在账号类型声明、权限目录和业务审计声明；检查授权需同时核对请求方法、主体权限与业务数据范围。
AllowedAccounts表达允许的账号类别，权限目录组织业务能力，AuditAction表达写入审计。存在这些声明不代表所有记录都可读；控制器、可信主体和core用例仍需检查商城及对象归属。
会话与CSRF怎样处理？
单体版管理会话使用会话 Cookie 与 X-CSRF-TOKEN；公开 storefront 只读链路与管理链路分别配置。
管理修改链路使用当前会话和CSRF，不把凭证写入浏览器持久存储或普通日志。会话撤销、权限变化和账号停用后要核对后继请求，不能只验证初次登录。
审计记录哪些内容？
记录固定安全操作、对象类型、结果、时间及可追踪身份，避免请求体、Cookie、明文密码和完整联系方式。操作成功、业务拒绝和外部状态未知不能统一写成成功。具体字段由当前审计实现与契约确认。
怎样设计拒绝样本？
- 有权身份读取本范围对象。
- 同类身份读取其他商城对象应被拒绝。
- 缺少对应操作权限，修改不生效。
- 过期修订不会覆盖新值。
- 撤权后重发旧请求仍被当前权限拒绝。
前端按钮状态与后端拒绝分别验证。接口测试成功后仍需检查审计结果和数据库未发生越范围变更。