TOTPジェネレーター

アルゴリズムをやさしい言葉で

TOTPはHOTP（HMACベースのワンタイムパスワード、RFC 4226）のカウンターを、現在のUnix時間をタイムステップ（通常30秒）で割った値に置き換えたものです。

counter = floor(unix_time / 30)
hash = HMAC-SHA1(secret, counter_as_8_byte_big_endian)
offset = last byte of hash AND 0x0F
truncated = 4 bytes from offset, with the top bit zeroed
code = truncated mod 10^digits

デバイスとサーバーが同じシークレットと同じ時計で同じ計算をするため、コード自体をどこにも送らずに両者が同じコードにたどり着きます。6桁のコードは、切り詰めたHMACを10^6で割った余りにすぎません。魔法ではなく、ただのハッシュ計算です。

一般的なパラメーター

サービスにコードを拒否されたら、まず桁数と期間、次にアルゴリズムを確認してください。また、一部の認証アプリは標準外のパラメーターを黙って無視します（Google 認証システムは歴史的にすべてをSHA-1・6桁・30秒として扱っていました）。必ず、利用者が実際に使うアプリそのもので試してください。

シークレットを安全に保管する

• 2FAシークレットをメールやメッセージで送らない。 受信トレイに入った瞬間から、プロバイダーのログとバックアップに残り続けます。
• 登録はQRコードのスキャンで行う。 QRコードには、シークレット・アルゴリズム・桁数・期間を一つの明確なパッケージにまとめたotpauth://totp/... URIが入っています。
• 登録した時点でバックアップする。 復元コード、またはシークレットそのものをパスワードマネージャーに保管してください。それが無いままスマートフォンを失うと、締め出されます。
• サービスごとにシークレットは一つ。 どのサービスも設定時に固有のシークレットを発行します。漏えいしたら、そのサービスで2FAを登録し直して古いシークレットを無効にしてください。

時刻のずれ

TOTPは双方の時計が一致している間だけ機能します。このページはサーバーの時計でコードを計算するため、ここのコードがスマートフォンの認証アプリと違う場合、最初に疑うべきはデバイスの時計です。ほとんどの検証システムは前後1ウィンドウ（30～60秒）のずれを許容します。それを超えるなら、シークレットを疑う前にデバイスの時刻をNTPで同期してください。

ここではテスト用シークレットを使う

このツールはコードを当社のサーバーで計算します。入力したシークレットは更新のたびにHTTPSで送信され、ツールのステップを移動するとページのURLにも現れます。使い捨てのシークレットでの開発・デモ・デバッグにはそれで十分です。しかし、メールや銀行口座を守っている本物のシークレットを入れる場所ではありません。それはスマートフォンの専用認証アプリに置くべきものです。もし本物のシークレットを認証アプリの外に貼り付けてしまったなら、そのサービスで2FAを登録し直してシークレットを更新してください。