login —— 登录 CertCloud

通过 OAuth 2.0 设备授权流登录 CertCloud 账号。凭证保存在 ~/.certiman/cc/credentials（权限 0600），令牌自动滚动刷新，无需重复登录。

用法

certiman login

参数

本命令没有自有参数。以下全局 flag 对本命令有特殊语义：

flag	说明
-f / --force	已登录时强制重新授权（切换账号）

示例

# 首次登录
certiman login

# 切换账号
certiman login -f

输出

0成功

» 请在浏览器打开以下地址完成授权(已尝试自动打开):
  https://certcloud.cn/oauth/device?user_code=5G52-JS1S
  (或访问 https://certcloud.cn/oauth/device 手动输入用户码: 5G52-JS1S,10 分钟内有效)
i 批准前请核对页面显示的应用名称,谨防钓鱼
等待授权…
✔ 已登录(当前用户: user)
✔ 凭证已写入 ~/.certiman/cc/credentials(权限 0600;令牌自动滚动刷新,无需重复登录)

3授权会话超时

» 请在浏览器打开以下地址完成授权 …
等待授权…
错误: 设备授权会话已超时,运行 `certiman login` 重新发起授权
日志: ~/.certiman/logs/cc-2026-08.log

相关命令

• login status —— 查看当前登录状态
• logout —— 撤销当前凭证
• profile —— 保存账号级参数模板

login status

查看当前登录状态：所属用户、访问令牌与刷新令牌剩余有效期、当前指向的 API 端点。

用法

certiman login status

参数

本命令没有自有参数。

示例

certiman login status
certiman login status -o json

输出

0成功

项                值
当前用户          user
所属账号          Jfe6Tl3C
发布通道          release
OpenAPI 端点      https://api.certcloud.cn
认证服务端点      https://certcloud.cn
访问令牌有效期至  2026-08-07T11:41:31Z
刷新令牌有效期至  2026-09-06T10:41:31Z

3未登录

错误: 未登录;运行 `certiman login` 登录后重试
日志: ~/.certiman/logs/cc-2026-08.log

3凭证被服务端拒绝

错误: 凭证被服务端拒绝,运行 `certiman login` 重新登录
日志: ~/.certiman/logs/cc-2026-08.log

0认证服务暂时不可达（凭证本身仍可用）

⚠ 无法获取当前用户信息:xxx;凭证本身仍然可用,仅无法显示账号
项                值
所属账号          Jfe6Tl3C
发布通道          release
OpenAPI 端点      https://api.certcloud.cn
认证服务端点      https://certcloud.cn
访问令牌有效期至  2026-08-07T11:41:31Z
刷新令牌有效期至  2026-09-06T10:41:31Z

三种结果的区分

• 未登录：本机没有凭证
• 凭证被服务端拒绝：本机有凭证，但凭证已失效，需要运行 certiman login 重新登录
• 认证服务暂时不可达：本机有凭证，但暂时无法获取用户信息。本机凭证保持不变，稍后重试即可

三种情况的退出码见上方各示例的 status 标记，退出码含义见 配置 · 退出码。

相关命令

• login —— 登录 / 切换账号
• doctor —— 检查凭证文件、权限与时钟偏差