スクリプトを壊さない本格的な二要素認証
通知履歴は、システムが何をしたか、いつ壊れたかの記録です。それは 1 つのパスワードよりも価値があります。
どの認証アプリでも使える
標準の TOTP に対応しています。普段お使いの認証アプリで QR コードを読み取り、コードを 1 つ入力して有効化を確定します。
ウェブとモバイルの両方に対応
プライマリのログイン後に、ウェブダッシュボードとモバイルアプリの両方で適用されます。そのため、裏口のような抜け道はありません。
信頼できるリカバリーコード
設定時に一度だけ使えるリカバリーコードを発行し、アトミックに消費します。そのため、同時に行われた 2 つのログインが同じコードを使うことはできません。
自動化には影響なし
API キーには追加の確認が求められません。二要素認証を有効にする前日と同じように、自動化は動作し続けます。
安心して再登録できる
新しい登録は、確認されるまで保留スロットに置かれます。そのため、設定が途中で中断されても、自分のアカウントからロックアウトされることはありません。
総当たり攻撃への防御
コードを 5 回間違えるとアカウントは 15 分間ロックされます。二要素認証のオンとオフが切り替わるたびにメールで通知されます。
2 分で設定完了
コードを読み取る
アカウント → セキュリティを開き、認証アプリで QR コードを読み取ります。
一度だけ確認する
6 桁のコードを 1 つ入力して確定します。正しいコードを入力して初めて二要素認証が有効になります。
バックアップを保管する
リカバリーコードは、認証アプリを入れたスマホとは別の場所に保存してください。
有効化の方法
アカウント → セキュリティを開き、設定を開始します。任意の TOTP 認証アプリで読み取れる QR コードとシークレットが表示されるので、6 桁のコードを 1 つ入力して確定してください。正しいコードを入力して初めて二要素認証が有効になり、そのあとでリカバリーコードが表示されます。認証アプリを入れたスマホとは別の場所に保存してください。
ログイン時の変化
ダッシュボードとアプリでは、正しいパスワードを入力すると、すぐにアカウントへ入るのではなく、コードの入力画面が表示されるようになります。内部的には、ログインエンドポイントがトークンの代わりに有効期限の短いチャレンジを返します。2 回目のリクエストで、そのチャレンジとコードを送信すると、本物のセッションが発行されます。チャレンジの有効期限は 5 分です。
コード欄には 6 桁の TOTP コードか、リカバリーコードのいずれかを入力できます。そのため、スマホを紛失しても、締め出されるのではなく、少し手間がかかるだけで済みます。
変わらないもの
API キーはこの仕組みの対象外です。Token ヘッダーで認証され、追加の確認を求められることはありません。そのため、お使いのすべてのスクリプト、cron ジョブ、CI パイプラインは、これまでと同じようにアラートを送信し続けます。また、サービスごとに別々の API キーを発行することをおすすめする理由もここにあります。1 つのキーを失効させても、ほかには影響しません。
よくある質問
Google Authenticator、1Password、Authy、Bitwarden など、QR コードを読み取って 6 桁のコードを生成できる一般的な TOTP アプリであれば利用できます。
いいえ。二要素認証は、ダッシュボードとスマホアプリでの対話型ログインに適用されます。API キーは Token ヘッダーで認証され、追加の確認を求められることはありません。そのため、cron ジョブ、CI パイプライン、監視フックは今まで通りアラートを送信し続けます。
6 桁のコードの代わりに、リカバリーコードのいずれかを入力してください。各コードは 1 回だけ使えます。アカウント → セキュリティから、いつでも新しいセットを発行できます。その際、古いコードは無効になります。
既存の二要素認証には影響しません。新しいシークレットは保留スロットに保存され、コードを確認して初めて現在のものと置き換わります。そのため、設定の途中でタブを閉じても、ログインできなくなることはありません。
ログインではトークンの代わりに、有効期限の短いチャレンジが返されます。そのチャレンジとコードを送信すると、本物の JWT を受け取れます。チャレンジの有効期間は 5 分です。コード欄には TOTP コードかリカバリーコードのどちらも入力できます。
コードを 5 回連続で間違えるとアカウントは 15 分間ロックされ、それ以降の試行は 429 を返します。さらに、二要素認証が有効化または無効化されるたびにメールが届きます。心当たりがないメールが届いた場合は、すぐにパスワードを変更してください。