会话认证接入
用 Cookie 和 CSRF 建立真实会话,正确处理过期与注销。
调用顺序
GET /api/auth/v1/csrf,保留响应设置的预认证 Cookie,读取data.csrf_token。POST /api/auth/v1/login,发送用户名和密码、预认证 Cookie、Origin、X-CSRF-Token。- 登录会轮换会话。后续写请求重新读取 CSRF,再随当前 Cookie 提交。
GET /api/auth/v1/me确认身份、平台权限、租户成员关系和当前工作区。- 会话失效时停止未授权调用,重新登录;注销后丢弃 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 安全方案,也不能将其用作当前版本的登录方式。
