【ITニュース解説】Validate Telegram Login Widget Hashes in Yii2 to Prevent Account Impersonation

Webサイトにユーザーを登録させたり、ログインさせたりする際、多くのサービスではメールアドレスとパスワードによる認証が一般的だ。しかし、この方法だとユーザーは新規登録フォームに情報を入力し、メールアドレスの確認作業まで行う必要があり、手間がかかる。そこで登場するのが、Telegramログインウィジェットのような外部サービスと連携する認証方法だ。これは、ユーザーが普段使い慣れているTelegramアカウントを使って、手軽にあなたのWebサイトにログインできるようにする便利な仕組みである。ユーザーはボタンをクリックするだけでTelegramの認証画面に飛び、許可を与えればすぐにサイトに戻り、ログインが完了する。メールアドレスの入力やパスワードの設定といった面倒な手間がなく、ユーザーにとっては非常にスムーズな体験となる。

しかし、この手軽さの裏には、セキュリティ上の重大な課題が潜んでいる。Telegramログインウィジェットを使った認証は、一度Telegram側でユーザーが本人であると確認された後、その情報（ユーザーID、名前、認証日時など）がWebサイトのブラウザ（クライアントサイド）に送られ、そこからあなたのWebサーバーに転送される仕組みになっている。もし、サーバー側で送られてきた情報をそのまま鵜呑みにしてしまうと、悪意のある攻撃者はブラウザから送られてくる情報を簡単に改ざんし、他人のTelegramユーザーIDを使ってログインできてしまう可能性がある。例えば、URLのクエリパラメータを書き換えるだけで、簡単に他人のアカウントを乗っ取ることが可能になるのだ。このような「アカウント乗っ取り」を防ぐためには、サーバー側で送られてきた認証情報が本当にTelegramから送られた正当なものであるかを厳しくチェックする仕組みが必要となる。

このチェックにおいて最も重要なのが、「ハッシュ」と呼ばれる暗号学的な署名の検証だ。Telegramは認証情報と一緒に、その情報が改ざんされていないことを保証するための特別な文字列（ハッシュ）も一緒に送ってくる。サーバー側では、このハッシュを使って、送られてきた情報が本当にTelegramからのものであり、途中で誰かに改ざんされていないかを検証する。このハッシュの検証方法は、Telegramの他の機能（例えばMini Appのデータ検証）とは少し異なるため、混同すると正しく検証できないことに注意が必要だ。

Telegramログインウィジェットのハッシュ検証手順は次のようになる。まず、Telegramから送られてきた全てのキーと値のペア（id、first_name、auth_dateなど）を、ハッシュ値そのもの（hashフィールド）を除いて集める。次に、これらのキーと値のペアをキーのアルファベット順にソートし、「キー=値」という形式で、各ペアを改行文字（\n）で区切って一つの長い文字列にする。これが「データチェック文字列」となる。一方、ハッシュを計算するための「シークレットキー」は、あなたのボットトークン（TelegramのBot APIを利用するために発行される秘密の文字列）をSHA-256という暗号化アルゴリズムでハッシュ化し、その結果をバイナリ形式で取得して生成する。最後に、このデータチェック文字列とバイナリ形式のシークレットキーを使って、HMAC-SHA256というアルゴリズムで新たなハッシュ値を計算する。この計算されたハッシュ値と、Telegramが送ってきたハッシュ値が完全に一致すれば、その認証情報は正当であると判断できる。

ハッシュ検証に加えて、認証日時（auth_date）のチェックも非常に重要だ。たとえ正当な認証情報であっても、攻撃者が一度取得したURLを繰り返し利用する「リプレイ攻撃」を防ぐ必要がある。もし認証日時が古すぎる場合、例えば24時間以上前の認証であれば、システムはそのリクエストを拒否するように設定すべきだ。これにより、一度有効だった認証情報がいつまでも悪用されるのを防ぐことができる。

具体的な実装例として、Yii2フレームワークを使ったPHPでの方法を見ていこう。まず、ハッシュ検証と認証日時チェックのロジックを、再利用可能なコンポーネントとして切り出すのが良いプラクティスだ。TelegramAuthValidatorという名前のクラスを作成し、ボットトークンと最大認証期間を設定できるようにする。このクラスのvalidatePayloadメソッドの中で、上記で説明したデータチェック文字列の生成、シークレットキーの作成、HMAC-SHA256によるハッシュ計算、そして認証日時と計算されたハッシュ値の比較を行う。特に、ハッシュ値の比較にはPHP標準のhash_equals()関数を使うことが推奨される。これは、通常の文字列比較演算子（===）が、一致しない文字を見つけた時点で比較を中断し、処理時間に差が出ることで攻撃者にハッシュ値を推測される可能性（タイミング攻撃）があるのを防ぐためだ。hash_equals()は必ず文字列全体を比較するため、安全性が高い。このコンポーネントは、Yii2アプリケーションの設定ファイルに登録し、ボットトークンは環境変数から読み込むようにすれば、安全かつ柔軟に管理できる。

次に、ユーザー情報を保存するデータベースの準備も必要となる。TelegramのユーザーIDは非常に大きな数値（64ビット整数）であり、一般的なデータベースの「INTEGER」型では保存しきれない場合がある。PostgreSQLやMySQLなどのデータベースで32ビット整数のカラムに保存しようとすると、数値がオーバーフローしてしまい、エラーになったり、意図しない値が保存されたりする可能性がある。そのため、ユーザーテーブルにtelegram_idというカラムを追加する際は、BIGINT型（64ビット整数を扱える型）を指定し、さらに同じTelegram IDが複数のユーザーに紐付けられないよう、「ユニークインデックス」を設定する必要がある。これにより、データの整合性を保ちながら、将来のTelegram IDの増加にも対応できる。Yii2のマイグレーション機能を使えば、安全かつ効率的にデータベーススキーマを変更できる。

最後に、Webサイトのコントローラーで実際の認証ロジックを実装する。Telegramからの認証リクエストを受け取るactionTelegramCallbackのようなメソッドを作成し、その中で以下の二つのシナリオに対応する。一つは、既にあなたのWebサイトにログインしているユーザーが、自分のアカウントにTelegramアカウントを紐付けたい場合だ。この場合、まずTelegramAuthValidatorを使って認証ペイロードを検証する。検証が成功したら、現在のユーザーのtelegram_idカラムに取得したTelegram IDを保存する。この際、もしそのTelegram IDが既に他のWebサイトアカウントに紐付けられていないかを確認することも重要だ。二つ目は、まだあなたのWebサイトにログインしていないゲストユーザーが、Telegramを使ってログインまたは新規登録する場合だ。この場合も同様にペイロードを検証した後、データベースでそのTelegram IDを持つユーザーが存在するかを検索する。もし見つかれば、そのユーザーをログインさせる。見つからなければ、新しいユーザーアカウントを作成し、取得したTelegram IDを紐付けてからログインさせる。新規ユーザー作成時には、ランダムな認証キーの生成など、アプリケーションのポリシーに応じた初期設定を行うことが望ましい。

本番環境での運用においては、他にもいくつかのセキュリティ上の注意点がある。前述のhash_equals()の使用はタイミング攻撃対策として必須だ。また、Telegramからの認証情報がURLのクエリパラメータとして渡される場合、その情報がブラウザの履歴やサーバーのアクセスログに残ってしまう可能性がある。機密性の高い認証情報を外部に漏らさないためにも、JavaScriptで認証情報を受け取り、POSTリクエストを使ってサーバーに送信する方がより安全だ。さらに、Telegramから送られてくるユーザー名（first_name、usernameなど）をそのままWebページに表示するのは危険である。攻撃者がユーザー名に悪意のあるスクリプトを埋め込む「XSS攻撃」を仕掛ける可能性があるため、必ずHTMLエスケープ処理を施してから表示するように心がけよう。もし、複数のユーザーが同時に同じTelegram IDを自分のアカウントに紐付けようとするような競合状態が発生した場合、データベースのユニーク制約によってエラーが発生することがあるため、例外処理を適切に実装し、ユーザーに分かりやすいエラーメッセージを表示する工夫も必要となる。

Telegramログインウィジェットは、ユーザーにとって便利な認証手段だが、その裏側では堅牢なセキュリティ対策が求められる。暗号学的検証、認証期間の制限、データベース設計の考慮、そして本番環境での細かなセキュリティ対策を怠らずに実装することで、ユーザーに安全で快適なログイン体験を提供できるだろう。