跳转到正文
皓量云擎文档

身份认证

当前使用登录会话 Cookie、CSRF 与固定 Origin。

当前公开管理 API 的认证方式是 服务端会话 Cookie。契约中 ClientBearer 为预留,平台不接受第三方 Bearer 凭据,也不提供 API Key 或 OIDC。

请求所需内容
获取 CSRFGET /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 小时。密码修改、用户停用、撤销会话等可使凭据失效;租户切换不授予额外权限。

写请求要求的权限以操作、目标资源真实租户和分配关系共同决定。角色名称本身不是权限令牌。

详细示例见第三方会话接入,具体认证接口见登录与会话参考。