CaelLabID

CaelLabID 是虚舟实验室（CaelLab）推出的统一身份认证系统，基于 OAuth 2.0 标准协议构建，为第三方应用提供安全的用户身份验证与授权服务。该系统允许应用接入 CaelLabID 的用户体系，用户可通过 CaelLabID 账户登录第三方应用，无需为每个应用单独注册。

概述

CaelLabID 是虚舟实验室的统一身份认证系统，遵循 OAuth 2.0 标准协议中的 Authorization Code Grant（授权码模式）流程。该系统旨在为开发者提供标准化的身份认证接入方案，使第三方应用能够安全地接入 CaelLabID 用户体系，获取用户授权并调用用户基本信息。

系统在服务端不存储用户明文密码，而是采用 SHA-256 哈希算法进行存储，以增强安全性。

核心功能

CaelLabID 提供以下核心功能：

• OAuth 2.0 授权码流程：标准化的授权码模式，支持第三方应用通过用户授权获取访问令牌。
• 跨应用隐私保护：为每个应用分配独立的用户标识符（sub），防止第三方应用通过用户 ID 进行跨应用关联追踪。
• Refresh Token 轮换：每次刷新令牌时签发新的 Refresh Token，旧的令牌自动失效，提升会话安全性。
• Token 撤销：支持主动撤销 Access Token 和 Refresh Token。

技术规格

支持的 Scope

CaelLabID 当前仅开放 `openid` scope，用于获取用户的基本身份标识。 `profile`（用户名、显示名、头像、简介）和 `email`（邮箱地址及验证状态） scope 计划在后续版本中逐步开放。

令牌有效期

系统对各类型令牌设定了以下有效期：

• 授权码（Authorization Code）：10 分钟
• Access Token：1 小时

OAuth 2.0 接入流程

CaelLabID 的 OAuth 2.0 接入遵循标准的授权码模式，整体流程如下：

1. 引导用户授权：第三方应用将用户浏览器重定向至 CaelLabID 的授权端点（`/oauth/authorize`），用户登录并确认授权。
2. 处理回调：用户授权后，CaelLabID 通过 302 重定向将授权码（code）返回至应用指定的回调地址。
3. 换取令牌：应用服务端使用授权码，通过向 `/oauth/token` 端点发起 POST 请求，换取 Access Token 和 Refresh Token。

授权端点

授权 URL 构造方式如下：

https://id.caellab.com/oauth/authorize?response_type=code&client_id=YOUR_CLIENT_ID&redirect_uri=YOUR_CALLBACK_URL&scope=openid&state=RANDOM_STRING

主要请求参数包括：

• `response_type`：固定值 `code`
• `client_id`：应用注册时获得的 Client ID
• `redirect_uri`：回调地址，须与注册时填写的一致
• `scope`：权限范围，当前仅支持 `openid`
• `state`：推荐使用的随机字符串，用于防止 CSRF 攻击

令牌端点

换取 Access Token 需向 `/oauth/token` 端点发起 POST 请求，支持以下两种认证方式：

• POST body 传参：在请求体中传递 `client_id` 和 `client_secret`
• HTTP Basic Auth：在 Authorization 头中使用 Base64 编码的 `client_id:client_secret`

成功响应返回 JSON 格式数据，包含 `access_token`、`token_type`、`expires_in`、`refresh_token` 等字段。