TOTP生成器の仕組み|6桁コードの計算方法

Google OTPやAuthyのようなアプリに表示される6桁の数字は、サーバーがリアルタイムで送ってくる値ではありません。自分の端末がシークレット1つと現在時刻だけから計算し出した結果です。だから機内モードでも番号は表示されますし、逆に端末の時計がずれていれば番号は合いません。
この記事では、その6桁がどんな順序で作られるのか、QRコードには何が入っているのかを、標準(RFC)どおりに解き明かします。どの認証方式を使うべきかという判断ではなく、動作の仕組みを検証できる事実として確かめたい方に向けた記事です。
まとめ ① Base32シークレットが番号を生み出す唯一の秘密の材料であり、発行元やアカウントはアプリの一覧に出るラベルにすぎず、6桁の計算には入りません。 ② 6桁は「シークレット(鍵)+現在のUTC時刻を30で割ったカウンター(メッセージ)」をHMAC-SHA1で混ぜ、その結果を切り出して1,000,000で割った余りです。 ③ 番号が合わない原因のほとんどは、端末の時計がずれているか、Base32に存在しない文字(0・1・8・9など)をシークレットに入れてしまったケースです。
番号が合わない理由が分からないとき
新しいスマホに買い替えて認証アプリを移す場面を考えてみます。QRコードを出し直せないため「設定キーを直接入力」画面に進むと、アプリはシークレット・発行元・アカウント名の3つの欄を尋ねてきます。
このとき何をどこに入れるべきか、3つのうちどれが実際に番号を変えるのかを知らないと、勘で埋めてしまいがちです。登録を終えたのに「コードが正しくありません」と表示されると、シークレットが違うのか時計がずれているのか、区別がつきません。
問題は、6桁が作られる過程がアプリの中に隠れていることです。仕組みを一度自分の目で確かめておけば、どの段階で間違えたのかを自分で突き止められます。
ツールなしで6桁を自分で計算する標準手順
TOTPは公開された標準です。番号を作る規則がRFCの文書にそのまま書かれているので、必要なら手計算やコマンドでも同じ値を再現できます。
3つの入力値はそれぞれ何を意味するのか
まず、アプリが尋ねてくる3つの欄の役割を区別しておきましょう。
- Base32シークレット(Secret): サーバーと自分の端末が分け合っている元の材料です。番号の計算に入る唯一の秘密の値です。
- 発行元(Issuer): 「Google」「GitHub」のように、アプリの一覧に表示されるサービス名です。
- アカウント(Account): 同じサービスに複数のアカウントがあるときに見分けるためのメールアドレスやIDです。
要点は、後ろの2つの値は番号の計算にまったく関与しないことです。ラベルをいくら変えても6桁はそのままです。
6桁を導き出す5つのステップ
RFC 4226(HOTP)とRFC 6238(TOTP)が定めた順序です。
- Base32デコード: シークレットをバイト列に戻します。Base32(RFC 4648)はA〜Zと2〜7の32文字だけを使い、5ビットずつ区切られているので、8ビット単位に組み直します。
- 時刻をカウンターに: UTC基準で1970年1月1日から経過した秒(Unix時刻)を30で割った商がカウンターです。RFC 6238の既定の間隔が30秒です。この値を8バイトで表します。
- HMAC-SHA1: シークレットを鍵、8バイトのカウンターをメッセージとしてHMAC-SHA1を計算すると、20バイトのハッシュが出ます。
- 動的切り出し(dynamic truncation): 20バイトのうち最後のバイトの下位4ビットで開始位置(0〜15)を決め、そこから4バイトを取り出して最上位ビットを捨て、31ビットの整数にします。
- 6桁に切り出す: その整数を1,000,000で割った余りが6桁です。先頭が空く場合は0で埋めます。
同じシークレットと同じ30秒の区間なら、世界のどこで計算しても結果は同じです。サーバーと自分のアプリの番号が一致する理由はここにあります。
QRコードには何が入っているのか
QRコードは画像ではなく、1行のURIを格納したものです。形式は次のとおりです。
otpauth://totp/発行元:アカウント?secret=シークレット&issuer=発行元
ここで番号を作る値はsecretの1つだけです。先頭の発行元:アカウントとissuerは、アプリが一覧に名前を表示するときに使うラベルです。そのため、QRをスキャンするのとシークレットを直接入力するのは結果が同じになります。
コマンドで検証する
自分で再現してみたいなら、オープンソースのコマンドラインツールoathtool(oath-toolkit)なら1行で済みます。
oathtool --totp -b JBSWY3DPEHPK3PXP
-bはシークレットがBase32であることを示し、出力値がその瞬間の6桁です。30秒後に再実行すると値が変わります。Pythonの標準ライブラリhmac・hashlibでも、同じ5つのステップを数行で書けます。
無料ツール「TOTP/ワンタイムパスワード(2段階認証)テスター」で実際に確かめてみましょう。
会員登録なしで、ブラウザ上でBase32シークレットの生成・QRコードの表示と、30秒周期の6桁トークンの計算をすぐに確認できます

よくつまずくポイント
「発行元やアカウントを変えれば番号も変わるはず。」 そうではありません。ここまで見てきたとおり、6桁はシークレットと時刻だけで決まります。3つの入力値の役割を整理すると次のとおりです。
| 入力値 | 役割 | 6桁への影響 |
|---|---|---|
| Base32シークレット | 計算の唯一の秘密の材料(鍵) | あり |
| 発行元(Issuer) | アプリの一覧に出るサービス名のラベル | なし |
| アカウント(Account) | どのアカウントかを示すラベル | なし |
「番号がずっと合いません。」 最も多い原因は時刻のずれです。カウンターは端末のUTC時刻を30で割って作りますが、スマホの時計がサーバーと数十秒以上ずれていると、別のカウンターになり別の番号が出ます。検証サーバーが前後の区間を多少許容することもありますが、差が大きければ結局は合いません。
「シークレットを入れたらエラーが出ます。」 Base32にない文字を入れたケースです。Base32はA〜Zと2〜7しか使わないため、0・1・8・9や記号が混ざるとデコードの段階で止まります。大文字・小文字の違いや空白はたいてい自動で処理されますが、存在しない文字は元に戻せません。
| 区分 | 文字 |
|---|---|
| Base32で使う文字 | A〜Z、2〜7 |
| 使わない文字(入れるとエラー) | 0、1、8、9および記号 |
「なぜ30秒ごとに変わるのですか。」 カウンターが「時刻÷30の商」だからです。30秒の区間をまたぐ瞬間に商が1増え、カウンターが変わるので、HMACの結果も6桁もまったく別になります。画面のゲージバーは、今の区間が終わるまでの残り秒数を示しています。
まとめ
- 6桁はサーバーが送ってくるのではなく、計算される値です。 材料はシークレットと現在のUTC時刻の2つだけです。
- 標準の手順は5つのステップです。 Base32デコード → 時刻を30秒カウンターに → HMAC-SHA1 → 動的切り出し → 1,000,000で割った余り。
- 番号を変えるのはシークレットと時刻だけです。 発行元・アカウントはラベルであり、計算には入りません。
- QRコードは
otpauth://URIの1行で、その中で実際に使われる値はsecretです。 - 合わない原因はたいてい2つです。 端末の時計のずれ、またはBase32にない文字。
下のツールはこの5つのステップをブラウザ上でリアルタイムに実行し、シークレットを入れた瞬間にQRコードと6桁、残り時間をまとめて表示します。
会員登録なしで、ブラウザ上でBase32シークレットの生成・QRコードの表示と、30秒周期の6桁トークンの計算をすぐに確認できます
よくある質問
アプリに登録せずに6桁だけ確認できますか?
はい。正しいBase32シークレットさえあれば、ブラウザがその場でHMAC-SHA1の計算を行い、30秒周期の6桁を表示します。シークレットをサーバーに送らず、画面の中だけで計算します。
別の端末やサーバーと番号がぴったり一致するのはなぜですか?
TOTPが固定のシークレットと、世界中で共通の協定世界時(UTC)だけを材料にしているからです。同じ鍵と同じ30秒の区間なら計算結果は同じになります。そのため端末間で時刻の同期がずれると番号もずれます。
シークレットに小文字や空白が入っていても大丈夫ですか?
たいていは問題ありません。標準の処理では小文字を大文字に変換し、空白を取り除いてからデコードするためです。ただし0・1・8・9のようにBase32に存在しない文字が入っていると、その段階でエラーになります。
30秒が経つ直前に表示された番号を入力してもいいですか?
区間をまたぐとカウンターが変わり、番号も変わります。ただ多くの検証サーバーは、直前の区間の番号も一時的に受け付けるように設計されているため、入力中に区間が切り替わっても通ることがあります。許容される幅はサーバーごとに異なります。
この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む