跳转到正文
皓量云擎文档

会话认证接入

用 Cookie 和 CSRF 建立真实会话,正确处理过期与注销。

调用顺序

  1. GET /api/auth/v1/csrf,保留响应设置的预认证 Cookie,读取 data.csrf_token。
  2. POST /api/auth/v1/login,发送用户名和密码、预认证 Cookie、Origin、X-CSRF-Token。
  3. 登录会轮换会话。后续写请求重新读取 CSRF,再随当前 Cookie 提交。
  4. GET /api/auth/v1/me 确认身份、平台权限、租户成员关系和当前工作区。
  5. 会话失效时停止未授权调用,重新登录;注销后丢弃 Cookie 与令牌。

Origin 必须等于平台配置的公开入口,含协议和非默认端口。HTTPS 部署由客户端 CookieJar 处理 Secure Cookie,不手写开发模式 Cookie 名称。

Python 示例

下载可运行的会话示例。设置 CMP_ORIGIN、CMP_USERNAME、CMP_PASSWORD 环境变量后运行;示例只登录并读取身份,不创建资源。

# 环境变量由服务端运行配置或凭据管理器提供,不写死在代码中。
from session_client import Client

client = Client()
client.call("POST", "/api/auth/v1/login", {
    "username": client.username,
    "password": client.password,
})
identity = client.call("GET", "/api/auth/v1/me")

第三方 Authorization: Bearer ... 当前不会获得认证,携带该头也不会退回 Cookie。即使契约列有 Bearer 安全方案,也不能将其用作当前版本的登录方式。

本页目录