# アラートの履歴には、 パスワード以上の守りを 。

> TOTP による二要素認証と使い切りのリカバリーコードで、Pocket Alert のアカウントを保護できます。Web とモバイルアプリのログインで必須になり、API キーやスクリプトはこれまでどおり使えます。

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

最終更新日:2026-08-11

ダッシュボードとアプリで適用される、一度だけ使えるリカバリーコード付きの TOTP 二要素認証です。API キーとスクリプトは影響を受けず、そのまま動作し続けます。

ドキュメント:https://info.pocketalert.app/features/two-factor-auth.html

## 2 分で設定完了

1. **コードを読み取る** — アカウント → セキュリティを開き、認証アプリで QR コードを読み取ります。
2. **一度だけ確認する** — 6 桁のコードを 1 つ入力して確定します。正しいコードを入力して初めて二要素認証が有効になります。
3. **バックアップを保管する** — リカバリーコードは、認証アプリを入れたスマホとは別の場所に保存してください。

## スクリプトを壊さない本格的な二要素認証

通知履歴は、システムが何をしたか、いつ壊れたかの記録です。それは 1 つのパスワードよりも価値があります。

- **どの認証アプリでも使える** — 標準の TOTP に対応しています。普段お使いの認証アプリで QR コードを読み取り、コードを 1 つ入力して有効化を確定します。
- **ウェブとモバイルの両方に対応** — プライマリのログイン後に、ウェブダッシュボードとモバイルアプリの両方で適用されます。そのため、裏口のような抜け道はありません。
- **信頼できるリカバリーコード** — 設定時に一度だけ使えるリカバリーコードを発行し、アトミックに消費します。そのため、同時に行われた 2 つのログインが同じコードを使うことはできません。
- **自動化には影響なし** — API キーには追加の確認が求められません。二要素認証を有効にする前日と同じように、自動化は動作し続けます。
- **安心して再登録できる** — 新しい登録は、確認されるまで保留スロットに置かれます。そのため、設定が途中で中断されても、自分のアカウントからロックアウトされることはありません。
- **総当たり攻撃への防御** — コードを 5 回間違えるとアカウントは 15 分間ロックされます。二要素認証のオンとオフが切り替わるたびにメールで通知されます。

## 有効化の方法

    
アカウント → セキュリティを開き、設定を開始します。任意の TOTP 認証アプリで読み取れる QR コードとシークレットが表示されるので、6 桁のコードを 1 つ入力して確定してください。正しいコードを入力して初めて二要素認証が有効になり、そのあとでリカバリーコードが表示されます。認証アプリを入れたスマホとは別の場所に保存してください。

    
## ログイン時の変化

    
ダッシュボードとアプリでは、正しいパスワードを入力すると、すぐにアカウントへ入るのではなく、コードの入力画面が表示されるようになります。内部的には、ログインエンドポイントがトークンの代わりに有効期限の短いチャレンジを返します。2 回目のリクエストで、そのチャレンジとコードを送信すると、本物のセッションが発行されます。チャレンジの有効期限は 5 分です。

    
コード欄には 6 桁の TOTP コードか、リカバリーコードのいずれかを入力できます。そのため、スマホを紛失しても、締め出されるのではなく、少し手間がかかるだけで済みます。

    
## 変わらないもの

    
API キーはこの仕組みの対象外です。`Token` ヘッダーで認証され、追加の確認を求められることはありません。そのため、お使いのすべてのスクリプト、cron ジョブ、CI パイプラインは、これまでと同じようにアラートを送信し続けます。また、サービスごとに別々の API キーを発行することをおすすめする理由もここにあります。1 つのキーを失効させても、ほかには影響しません。

## よくある質問

### どの認証アプリが使えますか？

Google Authenticator、1Password、Authy、Bitwarden など、QR コードを読み取って 6 桁のコードを生成できる一般的な TOTP アプリであれば利用できます。

### 二要素認証で、スクリプトや API キーが動かなくなりませんか？

いいえ。二要素認証は、ダッシュボードとスマホアプリでの対話型ログインに適用されます。API キーは Token ヘッダーで認証され、追加の確認を求められることはありません。そのため、cron ジョブ、CI パイプライン、監視フックは今まで通りアラートを送信し続けます。

### スマホを紛失した場合はどうすればよいですか？

6 桁のコードの代わりに、リカバリーコードのいずれかを入力してください。各コードは 1 回だけ使えます。アカウント → セキュリティから、いつでも新しいセットを発行できます。その際、古いコードは無効になります。

### 設定を始めて途中で中断した場合はどうなりますか？

既存の二要素認証には影響しません。新しいシークレットは保留スロットに保存され、コードを確認して初めて現在のものと置き換わります。そのため、設定の途中でタブを閉じても、ログインできなくなることはありません。

### 二要素認証は API ログインをどう変えますか？

ログインではトークンの代わりに、有効期限の短いチャレンジが返されます。そのチャレンジとコードを送信すると、本物の JWT を受け取れます。チャレンジの有効期間は 5 分です。コード欄には TOTP コードかリカバリーコードのどちらも入力できます。

### コードを推測されないようにする仕組みはありますか？

コードを 5 回連続で間違えるとアカウントは 15 分間ロックされ、それ以降の試行は 429 を返します。さらに、二要素認証が有効化または無効化されるたびにメールが届きます。心当たりがないメールが届いた場合は、すぐにパスワードを変更してください。
