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

公開ツールTOTP/ワンタイムパスワード(2段階認証)テスター

目次
  1. 番号が合わない理由が分からないとき
  2. ツールなしで6桁を自分で計算する標準手順
  3. よくつまずくポイント
  4. まとめ
  5. よくある質問

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)が定めた順序です。

  1. Base32デコード: シークレットをバイト列に戻します。Base32(RFC 4648)はA〜Zと2〜7の32文字だけを使い、5ビットずつ区切られているので、8ビット単位に組み直します。
  2. 時刻をカウンターに: UTC基準で1970年1月1日から経過した秒(Unix時刻)を30で割った商がカウンターです。RFC 6238の既定の間隔が30秒です。この値を8バイトで表します。
  3. HMAC-SHA1: シークレットを鍵、8バイトのカウンターをメッセージとしてHMAC-SHA1を計算すると、20バイトのハッシュが出ます。
  4. 動的切り出し(dynamic truncation): 20バイトのうち最後のバイトの下位4ビットで開始位置(0〜15)を決め、そこから4バイトを取り出して最上位ビットを捨て、31ビットの整数にします。
  5. 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段階認証)テスター」で実際に確かめてみましょう。

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桁、残り時間をまとめて表示します。

TOTP/ワンタイムパスワード(2段階認証)テスター

会員登録なしで、ブラウザ上でBase32シークレットの生成・QRコードの表示と、30秒周期の6桁トークンの計算をすぐに確認できます

よくある質問

アプリに登録せずに6桁だけ確認できますか?

はい。正しいBase32シークレットさえあれば、ブラウザがその場でHMAC-SHA1の計算を行い、30秒周期の6桁を表示します。シークレットをサーバーに送らず、画面の中だけで計算します。

別の端末やサーバーと番号がぴったり一致するのはなぜですか?

TOTPが固定のシークレットと、世界中で共通の協定世界時(UTC)だけを材料にしているからです。同じ鍵と同じ30秒の区間なら計算結果は同じになります。そのため端末間で時刻の同期がずれると番号もずれます。

シークレットに小文字や空白が入っていても大丈夫ですか?

たいていは問題ありません。標準の処理では小文字を大文字に変換し、空白を取り除いてからデコードするためです。ただし0・1・8・9のようにBase32に存在しない文字が入っていると、その段階でエラーになります。

30秒が経つ直前に表示された番号を入力してもいいですか?

区間をまたぐとカウンターが変わり、番号も変わります。ただ多くの検証サーバーは、直前の区間の番号も一時的に受け付けるように設計されているため、入力中に区間が切り替わっても通ることがあります。許容される幅はサーバーごとに異なります。

この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む

関連記事

  1. Unicodeエスケープ変換と復元、6つの形式の違いを整理\uXXXX・U+コードポイント・HTMLエンティティの相互変換と復元の方法を例で整理しました。各形式の意味と違い、絵文字が2つに分かれる理由、ASCIIが変わらない理由まで解説します。
  2. URL正規化とは?utm・追跡パラメータを削除して標準リンクにutm_やfbclid・gclid・refなどの追跡パラメータを消し、ホストの小文字化や既定ポートの削除、末尾スラッシュやパラメータ整列まで、URL正規化の規則と「適用された変更」の読み方をまとめました。
  3. URLエンコードで空白が%20になる理由と仕組みURLエンコードで空白が%20、韓国語の「가」が%EA%B0%80になる仕組みをUTF-8バイトから説明します。全体URLと構成要素の2モードの違い、二重エンコードなどの失敗例も確認できます。
  4. URLパスセグメントを抽出してルートに変換URLをプロトコル・ホスト・パスセグメント・クエリに分ける仕組みと、数字だけのセグメントや9文字以上のセグメントがExpressの:変数、Next.jsの[変数]に置き換わる条件を例で解説します。
  5. URLエンコードとは?パーセントエンコーディングと文字化けの仕組みURLにスペースや日本語をそのまま使えない理由と、パーセントエンコーディングの規則、encodeURIとencodeURIComponentが予約文字を扱う違いで結果が変わる仕組みを解説します。
  6. User-Agentヘッダーの構造とモバイル・ボット判定を解説HTTPリクエストのUser-Agentヘッダーを構成する要素と、ブラウザ・端末・クローラーを見分ける正規表現の書き方、Client Hintsの標準仕様を解説します。

関連ツール