为你的账户启用两步验证

两步验证（2FA）用身份验证器 App 里不断轮换的六位数字码保护你的咏唱引擎账户。下面讲怎么启用、启用后怎么登录，以及如何管理活跃会话。

启用 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

管理活跃会话