ForHosting KIT · 開発者向けツール

TOTP時間ウィンドウの残り秒数とインデックスを計算

Unix時刻1700000000、周期30秒なら、ウィンドウ番号は56666666で、カウンターが進むまで残り10秒です。周期と時刻を入力すれば、早く期限切れになるように見えるコードを、秘密鍵なしで調べられます。ブラウザで無料で使えます。

  • 無料
  • ブラウザで動作
  • 登録不要
  • データは端末の外に出ません
ご利用方法 ウェブAPIメールTelegramアプリ 近日
入力した場合
周期
30
現在時刻
1,700,000,000
結果
残り秒数
10
ウィンドウ番号
56,666,666

このTOTP時間ウィンドウ計算ツールは、期間の長さとUnixタイムスタンプを、現在のウィンドウのインデックスと次のウィンドウが始まるまでの残り秒数に変換します。コードが予想より早く失効する場合など、時間ベースのワンタイムパスワードシステムの開発、テスト、診断に役立ちます。計算は決定論的で、秘密鍵を使用せず、パスワードも生成せず、端末の時計も読み取りません。そのため、同じ入力からは常に同じ結果が得られます。

TOTP時間ウィンドウが表す内容をご確認ください

TOTPシステムでは、Unix時刻を同じ長さの連続したウィンドウに分割します。一般的な期間は30秒ですが、任意の正の整数秒で計算できます。ウィンドウインデックスは、Unixタイムスタンプを期間で割り、小数点以下を切り捨てた値です。

同じ商になるすべてのタイムスタンプは同一のウィンドウに属するため、認証アプリとサーバーはそれぞれ独立して同じ可変カウンターを選択できます。このツールは、共有シークレットを要求したり認証コードを生成したりせず、そのカウンターを直接表示します。また、カウンターが進むまでに残っている整数秒も示します。

ウィンドウが始まった正確な秒では期間全体が残り、最後の秒では1秒が残ります。この境界の扱いにより、現在のウィンドウが有効な間にゼロを表示せず、実用的なカウントダウンを作成できます。タイムスタンプはミリ秒ではなくUnix秒で明示的に入力してください。

入力を選び、結果をご確認ください

periodには、TOTPの1ステップとして設定された長さを正の整数秒で指定してください。インデックスはUnixエポックをゼロとして始まり、現在のタイムスタンプでは通常、大きな整数になります。これは認証コードではないため、認証アプリに表示される数字とは比較しないでください。

2つのコンポーネントが同じ時刻を認識しているか確認する場合はウィンドウインデックスを比較し、テストを次の境界まで待機させる場合は残り値をご利用ください。この関数は、時計ずれの許容、隣接ウィンドウの受け入れ、うるう秒の補正、ネットワーク遅延を適用しません。これらは検証側で定める方針です。

結果は、指定されたタイムスタンプと期間に対して数学的に有効なウィンドウのみを表すため、自動テストの予測可能性を保ち、差異を特定しやすくします。

テストと運用で安全にご利用ください

TOTPシードを公開せずに時間情報が必要な場合に、この機能をご利用ください。統合テストでは固定タイムスタンプを使用することで、このツール内に隠れたシステム時計を模擬せず、境界の直前、境界上、直後の動作を確認できます。ウィンドウが一致しても、送信されたワンタイムパスワードが有効である証明にはなりません。

検証には、共有シークレット、合意されたハッシュ方式と桁数、再利用防止、明示的な許容方針が引き続き必要です。時間診断と一緒にシークレットを記録しないでください。期間、タイムスタンプ、インデックス、カウントダウンがあれば、ほとんどの同期問題を調査できます。

認証アプリの時計の一致を診断します

クライアントとサーバーに記録されたタイムスタンプの計算済みインデックスを比較し、TOTPシードを共有せずに時計や期間のずれを特定します。

切り替わりまでのカウントダウンを作成します

現在のTOTPカウンターが進み、新しく生成されたコードが次のウィンドウに属するまでの残り整数秒を表示します。

正確なウィンドウ境界をテストします

境界の直前と境界上の固定Unixタイムスタンプを使い、認証の時間テストを決定論的かつ再現可能にします。

この機能の料金はいくらですか?

ブラウザー版では、同じ決定論的な計算をローカルで実行できます。

TOTPコードを生成または検証しますか?

いいえ。 時間に関するメタデータだけを計算し、共有シークレットやワンタイムパスワードは受け取りません。

正確な境界で期間全体が返されるのはなぜですか?

新しいウィンドウが始まった直後で、整数秒がまだ経過していないため、期間全体が残っています。

時刻は秒とミリ秒のどちらで入力しますか?

Unix時刻の秒(整数)で入力し、ミリ秒は使いません。ミリ秒の値では、はるか未来のウィンドウを指してしまいます。時刻を明示して入力すれば、テストや記録、障害報告で同じ結果を再現できます。

2つのシステムのウィンドウが一致すれば、コードは有効ですか?

そうとは限りません。ウィンドウの一致は、双方の時刻がそろっていることを示すだけです。コードの確認には、共有の秘密鍵、取り決めた設定、再利用の防止、時計のずれに対する明確な許容範囲が別途必要です。

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

POSThttps://api.kit.forhosting.com/security/otp-time-window-calc

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

curl -X POST https://api.kit.forhosting.com/security/otp-time-window-calc \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"period":30,"current_time":1700000000}'
{
  "period": 30,
  "current_time": 1700000000
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "security.otp_time_window_calc",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

HTTPコード意味
401unauthorizedAPIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
402insufficient_balance残高が不足しています。チャージ後に再度お試しください。
404unknown_type指定されたタスクタイプは存在しません。タイプ名を確認してください。
429rate_limitedリクエストが多すぎます。しばらく待ってから再度お試しください。

TOTP時間ウィンドウが表す内容をご確認ください

ブラウザーやAPI実行環境の時計に依存せず、ログ、テスト、障害記録で結果を再現できます。

入力を選び、結果をご確認ください

次にcurrent_timeへ、負ではないUnixタイムスタンプを整数秒で入力します。応答にはseconds_remainingとwindow_indexが含まれます。たとえば30秒の期間で、現在のウィンドウ内ですでに10秒が経過している場合、seconds_remainingは20です。

テストと運用で安全にご利用ください

監視ジョブでは記録済みのタイムスタンプから現在のインデックスを計算でき、画面ではseconds_remainingを使ってコードの切り替わりが近いことを通知できます。API呼び出しは1回あたり$0.002で、ブラウザー版はローカルで実行できます。このアルゴリズムは一定量の算術処理だけを行い、ネットワーク、乱数源、時計へアクセスしないため、同じ入力の呼び出しは同じJSONを返し、基準テストや監査記録に適しています。

current_timeは秒とミリ秒のどちらで指定しますか?

整数のUnix秒をご使用ください。ミリ秒のタイムスタンプは、送信前に秒へ変換してください。

期間がゼロまたは負の場合はどうなりますか?

TOTP時間ウィンドウには正の長さが必要なため、リクエストはinvalid_inputエラーになります。

KITの完全なドキュメントを見る →