# 你的告警历史值得拥有 不止是一个密码 。

> 使用 TOTP 双重身份验证和一次性恢复码保护你的 Pocket Alert 账号。网页端和移动端均强制启用，API 密钥和脚本不受影响，照常使用。

<!-- source: https://pocketalert.app/zh/features/two-factor-auth -->

最后更新：2026-08-11

基于 TOTP 的双重身份验证，配合一次性恢复码，在控制台和应用中强制执行。你的 API 密钥和脚本保持不变，继续正常运行。

文档：https://info.pocketalert.app/features/two-factor-auth.html

## 两分钟完成设置

1. **扫描二维码** — 打开“账户 → 安全”，用你的验证器应用扫描二维码。
2. **确认一次** — 输入一个六位数验证码进行确认。只有输入正确的验证码后，双重身份验证才会开启。
3. **保存备份** — 请将恢复码保存在非验证器所在手机的其他地方。

## 真正的双重身份验证，不破坏你的脚本

你的推送通知历史记录了系统做了什么、何时出了故障。它的价值远不止一个密码。

- **兼容任意验证器** — 标准 TOTP。用你已经在用的任意验证器扫描二维码，输入一个验证码即可开启。
- **覆盖网页与手机端** — 在网页控制台和手机应用中，主登录之后都会强制执行，不存在任何薄弱的后门。
- **可靠的恢复码** — 设置时会颁发一次性恢复码，且使用时具有原子性，因此两个并行登录无法同时消耗同一个恢复码。
- **自动化不受影响** — API 密钥永远不会触发验证。你的自动化流程将与开启双重身份验证前的一天完全一样地运行。
- **可安全地重新注册** — 新的注册信息会先保存在待定位置，直到你确认后才生效，因此中断的设置不会把你锁在自己的账户之外。
- **防暴力破解保护** — 连续五次输入错误验证码，账户将被锁定十五分钟；每次开启或关闭双重身份验证时，你都会收到一封邮件。

## 开启方法

    
打开“账户 → 安全”并开始设置。你会获得一个二维码和一个密钥，可用任意 TOTP 验证器扫描，然后输入一个六位数验证码进行确认。只有输入正确的验证码后，双重身份验证才会真正开启，此时才会显示你的恢复码。请将恢复码保存在非验证器所在手机的其他地方。

    
## 登录时有哪些变化

    
在控制台和应用中，输入正确密码后，将先进入验证码输入页面，而不是直接登录你的账户。在底层，登录接口会返回一个短期有效的挑战令牌而非访问令牌，随后再发起一次请求，将该挑战令牌与你的验证码交换为真正的会话。挑战令牌五分钟后过期。

    
验证码字段既可以输入六位数 TOTP 验证码，也可以输入你的任一恢复码，因此即使丢了手机，也只是有些不便，而不会被锁在外面。

    
## 哪些内容不会改变

    
API 密钥不在此范围内。它们通过 `Token` 请求头进行身份验证，且永远不会触发验证，这意味着你所有的脚本、cron 任务和 CI 流水线都会像以前一样继续发送告警。这也是为每个服务单独颁发密钥的理由：撤销其中一个，不会影响其他密钥。

## 常见问题

### 哪些验证器应用可以使用？

任何标准 TOTP 应用都可以，例如 Google Authenticator、1Password、Authy、Bitwarden，以及其他能扫描二维码并生成六位数验证码的应用。

### 开启双重身份验证会影响我的脚本和 API 密钥吗？

不会。双重身份验证仅适用于在控制台和手机应用中的交互式登录。API 密钥通过 Token 请求头进行身份验证，不会触发验证，因此你的 cron 任务、CI 流水线和监控 Webhook 会继续正常发送告警，不受影响。

### 如果我丢了手机怎么办？

用一个恢复码代替六位数验证码即可。每个恢复码只能使用一次。你可以随时前往“账户 → 安全”生成一组新的恢复码，旧的恢复码会随之失效。

### 如果我开始设置后中途放弃，会发生什么？

这不会影响你已经开启的双重身份验证。新密钥会先保存在待定位置，只有在你确认验证码后才会替换当前生效的密钥，因此即使中途关闭页面，也不会把你锁在外面。

### 双重身份验证如何改变 API 登录？

登录时会返回一个短期有效的挑战令牌，而不是访问令牌。你需要将该挑战令牌与验证码一起提交，才能换取真正的 JWT。挑战令牌有效期为五分钟。验证码字段可接受 TOTP 验证码或恢复码。

### 如何防止他人猜测我的验证码？

连续五次输入错误验证码，账户将被锁定十五分钟，之后的尝试会返回 429。每当开启或关闭双重身份验证时，你还会收到一封邮件。如果收到邮件而操作并非你本人所为，请立即修改密码。
