身份认证
当前使用登录会话 Cookie、CSRF 与固定 Origin。
当前公开管理 API 的认证方式是 服务端会话 Cookie。契约中 ClientBearer 为预留,平台不接受第三方 Bearer 凭据,也不提供 API Key 或 OIDC。
| 请求 | 所需内容 |
|---|---|
| 获取 CSRF | GET /api/auth/v1/csrf,保存响应 Cookie 与 data.csrf_token |
| 登录 | 预认证 Cookie、用户名/密码、Origin、X-CSRF-Token |
| 认证读取 | 当前会话 Cookie 和资源权限 |
| 会话写入 | 当前 Cookie、Origin、与该会话绑定的 X-CSRF-Token、资源权限 |
Origin 必须匹配平台配置的公开入口。登录后会轮换 Cookie,写请求应重新获取 CSRF。不要硬编码 virt_dev_session 开发 Cookie 名称,生产使用 Secure、HttpOnly 会话 Cookie。
会话默认空闲 30 分钟、绝对期限 12 小时。密码修改、用户停用、撤销会话等可使凭据失效;租户切换不授予额外权限。
写请求要求的权限以操作、目标资源真实租户和分配关系共同决定。角色名称本身不是权限令牌。
