halfoff.dev文档
获取密钥
账户

账户安全

用两步验证、恢复码和会话管理保护 Half Off Dev 控制台,并了解平台具体保存了哪些数据。

账户靠两样东西守护:邮箱和密码用来登录控制台,余额、密钥和日志都在里面;API 密钥则让代码可以花这笔余额。本页讲前者的保护方法,并给出保管后者的要点。除特别说明外,以下设置都在设置页面。

两步验证#

开启两步验证(2FA)后,登录时除了密码,还要输入身份验证器应用生成的 6 位验证码。任何支持基于时间的验证码(TOTP)的应用都可以,比如 Google Authenticator、1Password、Authy。

  1. 开始设置

    在设置的 两步验证 下点击 设置两步验证。

  2. 在验证器中添加 Half Off Dev

    用验证器扫描二维码,或者手动输入二维码旁边的设置密钥。

  3. 输入验证码确认

    填入应用显示的 6 位验证码,点击 验证并开启,状态会变成 开启。

  4. 保存恢复码

    系统会给你十个一次性恢复码,形如 k7mq-2xpd,每个可以代替一次验证码。它们不会再显示:点击 复制恢复码,存进密码管理器,再点 我已保存。

此后登录需要邮箱、密码和当前验证码。

没有恢复码就进不去了

验证器丢了、恢复码也用光了,就无法登录控制台。恢复码不要只存在装验证器的那部手机上。

验证码总是不对?检查手机是否开启了自动设置时间。验证码在有效窗口前后约 30 秒内都能通过。

用恢复码登录#

手机不在身边时,在输入验证码的地方改填一个恢复码。大小写和中间的短横线都无所谓。每个码只能用一次,设置页面会显示还剩几个可用。

更换恢复码#

在 生成新的恢复码 旁输入当前验证码,就会得到一组新的十个码,旧的那组立即作废。恢复码快用完,或者怀疑被别人看到时,就该换一组。

关闭两步验证#

在 关闭两步验证 旁输入验证码或恢复码,点击 关闭。设置密钥和恢复码都会被删除。之后重新开启会生成新的二维码,记得把验证器里的旧条目删掉。

两步验证管什么、不管什么#

两步验证保护的是控制台登录,也就是你的余额、账单、密钥和日志。API 请求不会要求第二重验证,有密钥就能调用。所以要像对待密码一样对待每一个密钥。

验证邮箱#

如果控制台提示你验证邮箱,打开注册时我们发给你的链接即可。链接只能用一次,48 小时内有效;提示条上的 重新发送链接 可以再发一封。验证过的邮箱用于通知你账户相关的变动。

修改密码#

在 修改密码 处输入当前密码和至少 8 位的新密码,点击 更新密码。其他所有已登录的浏览器都会被退出,当前这个保持登录。

登录会话#

每次登录在该浏览器上保持 30 天。控制台侧边栏底部的 退出登录 只结束当前浏览器的会话。

设置里的 会话 卡片会显示还有几个浏览器或设备登录着你的账户。退出其他会话 会把它们全部踢下线,只保留你当前这个。用过公共电脑,或怀疑账户被他人使用时,点它就对了。

保管好 API 密钥#

  • 每个应用、每个环境单独一个密钥,只给它需要的限制和模型。参阅 API 密钥。
  • 从环境变量或密钥管理服务读取密钥,不要提交到代码仓库,也不要放进客户端代码。
  • 定期轮换;一旦可能泄露,立即吊销,吊销从下一个请求起生效。
  • 定期翻看日志,留意不认识的调用。每条请求都标明了来自哪个密钥。

更多内容见认证。

Half Off Dev 保存哪些数据#

数据保存方式
API 密钥哈希值,加上用于显示的前几位字符。完整密钥只在创建时显示一次,之后无法找回。
密码加盐的慢哈希(PBKDF2-SHA256),从不保存密码原文。
控制台会话安全、HTTP-only Cookie 中的随机令牌,服务器只保存它的哈希。
两步验证密钥用于校验验证码,关闭 2FA 时删除。
恢复码每个未使用恢复码的哈希,用过即删。
请求日志只有元数据:模型、密钥、token 数、扣费、耗时和状态。不保存提示词和回复内容。保留 90 天。

语言#

在设置的 语言 中切换,也可以用侧边栏或文档页眉上的语言选择器。所选语言对该浏览器上的控制台和文档都生效。在你手动选择之前,Half Off Dev 跟随浏览器语言。