为你的账户启用两步验证

两步验证（2FA）通过身份验证器 App 中不断轮换的六位数字码保护你的咏唱引擎账户。本指南涵盖启用 2FA、之后的登录方式，以及管理活跃会话。

启用 2FA

开始设置

curl -X POST https://ariacompute.cn/api/auth/2fa/setup \
  -H "Authorization: Bearer eyJhbGciOi..."

响应包含 TOTP secret 以及一个可在控制台渲染的 qr_code_url。

将账户添加到身份验证器 App

扫描二维码（或粘贴密钥）到 Google Authenticator、1Password、Authy 或任意兼容 TOTP 的 App。

确认验证码

curl -X POST https://ariacompute.cn/api/auth/2fa/enable \
  -H "Authorization: Bearer eyJhbGciOi..." \
  -H "Content-Type: application/json" \
  -d '{"code": "123456"}'

调用成功即在该账户上激活 2FA。

使用 2FA 登录

启用 2FA 后，POST /api/auth/login 会返回一个挑战而非完整会话。验证验证码以完成登录：

curl -X POST https://ariacompute.cn/api/auth/2fa/verify \
  -H "Content-Type: application/json" \
  -d '{"challenge": "chg_01H...", "code": "123456"}'

成功响应的结构与普通登录相同：一个 token 加上一个 user 对象。

停用 2FA

curl -X POST https://ariacompute.cn/api/auth/2fa/disable \
  -H "Authorization: Bearer eyJhbGciOi..." \
  -H "Content-Type: application/json" \
  -d '{"code": "123456"}'

停用 2FA 会削弱账户安全性。仅当你计划在之后立即于新设备上重新登记时才这样做。

管理活跃会话

每次登录都会创建一个会话。查看并吊销它们：

curl -H "Authorization: Bearer eyJhbGciOi..." \
  https://ariacompute.cn/api/auth/sessions

curl -X DELETE \
  -H "Authorization: Bearer eyJhbGciOi..." \
  https://ariacompute.cn/api/auth/sessions/sess_01H...

curl -X POST \
  -H "Authorization: Bearer eyJhbGciOi..." \
  https://ariacompute.cn/api/auth/sessions/revoke-others

curl -X POST \
  -H "Authorization: Bearer eyJhbGciOi..." \
  https://ariacompute.cn/api/auth/logout

快速开始

核心概念

指南

SDK

资源

为你的账户启用两步验证

启用 2FA

使用 2FA 登录

停用 2FA

管理活跃会话

​启用 2FA

​使用 2FA 登录

​停用 2FA

​管理活跃会话

启用 2FA

使用 2FA 登录

停用 2FA

管理活跃会话