M365Con 2027 – 無料オンラインカンファレンス · 11–22 Jan 2027 · 120 sessions→ m365con.net

ブログ · Mirko Peters

自動ブラウザー テストにおけるテスト用の資格情報とシークレットの扱い方

By · · Updated

自動ブラウザー テストのシークレットは、コード、トレース、動画、ログを通じて漏えいします。パスワードをリポジトリの外に置く方法、テスト アカウントの範囲を絞る方法、成果物を整理する方法を学びましょう。

Automatically translated with AI from the original post. Read the English original

自動ブラウザー テストにおけるシークレットとは、テストがサインインするために必要とするパスワード、トークン、API キー、セッション Cookie のことです。これらは多くのチームが想定しているより多くの場所から漏えいします。適切に扱うことは、テスト自動化、ひいてはブラウザー自動化全般における基本です。このガイドは、実際のシステムにサインインする エンドツーエンド テストのブラウザー テストを作成または保守するテスト自動化エンジニア向けです。シークレットが漏えいする場所、コードやリポジトリから除外する方法、アクセスを制限したテスト アカウントの設定方法、サインイン状態を安全に再利用する方法、多要素認証への対処方法を解説します。架空の数値を使った実例では、簡単な監査の流れを示します。

重要なポイント

  • ブラウザー テストのシークレットは、テスト コードの外でも漏えいします。トレース、スクリーンショット、動画、コンソール ログ、HAR ファイル、保存されたサインイン状態には、いずれもトークンやパスワードが含まれる可能性があります。
  • テスト ファイルにパスワードを直接書き込まないでください。ローカルでは環境変数から読み込み、パイプラインでは CI プラットフォームの シークレット ストア'から読み込みます。
  • 保存されたブラウザー状態ファイルには、有効なセッション Cookie が含まれている場合があります。これを使えばテスト アカウントになりすまされるおそれがあるため、すべてのリポジトリから除外してください。
  • テスト アカウントは専用のものを使用してください。ロールごとに 1 つ用意し、共有データを変更する並列実行では、ワーカーごとに 1 つ用意します。各アカウントには、そのテストに必要なアクセス許可だけを与えてください。
  • 成果物はランナーの外に出る前に整理し、レポートを読めるユーザーを制限してください。テスト専用のログイン ショートカットは、本番環境に残さないようにします。

自動ブラウザー テストでシークレットが漏えいする場所

最も分かりやすい漏えいは、テスト スクリプトに直接入力されたパスワードです。それよりも気付きにくいのは、テストの実行によって生成されるファイルです。Currents の記事 Playwright でのデータ漏えいの回避では、そのリスクが挙げられています。同様の方法で実行内容を記録する他のツールにも、同じリスクが当てはまります。

  • トレース。 トレースには、生の承認ヘッダー、ベアラー トークン、Cookie の値、ページのスナップショット、ネットワーク トラフィックに含まれる個人データが含まれる可能性があります。この記事では、トレースを最も重大なリスクとして評価しています。
  • スクリーンショット。 テストが値を入力している最中の値が表示されることがあります。また、通知にトークンが表示される場合もあります。
  • 動画。 動画はテスト全体にわたって画面全体を記録します。そのため、自動入力されたパスワードや、管理ページに表示されたトークンも記録されます。
  • コンソール ログと添付ファイル。 コンソールの出力は再試行のたびに繰り返し記録されます。また、添付された API 応答にはトークンや個人データが含まれる場合があります。
  • レポーターとステップの出力。 ステップ名に環境の値が含まれていると、その値は CI ログと HTML レポートに表示されます。
  • HAR ファイル。 これらのネットワーク記録には、要求と応答のヘッダーおよび本文が含まれます。そのため、資格情報が含まれる場合があります。
  • 保存されたサインイン状態。 状態ファイルには有効なセッション Cookie とトークンが含まれます。誰も無視設定をしていなければ、Git に入ってしまう可能性があります。

この記事では、CI のシークレット マスキングはログ出力しか対象にしないことも指摘しています。エンコードされた値、途中で切り詰められた値、他のテキストと結合された値は、マスキングの対象から漏れます。マスキングは安全網であり、対策そのものではありません。

パスワードをコードとリポジトリの外に置く

TestDinoのPlaywright 認証に関するガイドは明快です。テストファイルにパスワードを直接書き込んではいけません。CIでの実行に関する助言は、他のフレームワークで一般的に行われている方法とも一致しています:

  1. 環境変数を使用します。 ローカルでは、バージョン管理の対象外にした環境ファイルにパスワードを保存します。CIでは、利用しているプロバイダーのシークレット管理機能を使い、プロセス環境から値を読み込みます。
  2. ファイルを無視します。 最初のコミットの前に、環境ファイルのパターンを無視リストに追加し、変数名だけを記載したプレースホルダーファイルのみをコミットします。
  3. パイプラインの値を優先させます。 Currentsは、ローカルファイルの値よりもCIから注入された値が優先されるように、環境ローダーを設定することを勧めています。
  4. 大規模なチームではシークレットマネージャーを使用します。 これらのセキュリティのベストプラクティスは、規模が大きくなっても適用しやすい方法です。Currentsは、CIネイティブのシークレット機能に加え、Vault、AWS Secrets Manager、Google Cloud Secret Managerといった外部のマネージャーを挙げています。また、ワークロードIDを通じた短期間有効なトークンの使用と、実行に必要なシークレットのパスだけにスコープを絞ったランナーの権限設定も推奨しています。
  5. ステップ名は固定します。 シークレットをステップのタイトルに書き込まないでください。固定のラベルを使用します。

シークレットがすでにコミットされている場合は、漏えいしたものとして扱ってください。値を変更してから、履歴をクリーンアップします。後のコミットでファイルを削除しても、履歴からは消えません。

最小特権の専用テストアカウントを使用する

テスト用アカウントも実在のアカウントであり、他のアカウントと同じように慎重に扱う必要があります。サインインを自動化するということは、実際のシステムへのアクセスも自動化することになります。そのため、各テスト環境で、各アカウントがどこまで到達できるかを検証してください。最小特権の原則が適用されます。各アカウントには、テストに必要なアクセス権だけを付与し、それ以上は与えないようにします。

  • 個人アカウントは使用しないでください。 専用のログインであれば、個人のアクセス権に影響を与えることなく、無効化、ローテーション、監査を行えます。
  • ロールごとに1つのアカウントを用意します。 管理者と一般ユーザーに何が見えるかをテストする場合、ロールごとに専用のアカウントが必要です。TestDinoは、複数ロールのテストに対してこれを要件として挙げています。
  • テストが共有データを変更する場合は、並列ワーカーごとに1つのアカウントを用意します。 サインインに関するPlaywrightのドキュメントでも、この点が説明されています。単一の共有アカウントが機能するのは、テスト同士が互いに影響を与えずに同時実行できる場合だけです。そうでない場合は、並列ワーカーごとに専用のアカウントが必要です。TestDinoは、ワーカーのインデックスに基づいてアカウントを選択する方法を説明しています。
  • 本番環境へのアクセスは最小限に抑えます。 テストがライブシステムに接触する場合は、そのログインを分離し、請求データや顧客データに到達できないようにしてください。
  • 所有者と有効期限を設定します。 各アカウントの所有者と、パスワードの見直し時期を記録してください。これは当社独自の助言であり、出典にある内容ではありません。

所有者のいないログインは、それが作成された目的のテストが終わった後も残り続け、長期間有効なままになります。

サインイン状態を、露出させずに再利用する

テストデータとサインイン状態は別のものですが、どちらも保護が必要です。テストのたびに画面からサインインすると時間がかかり、すべての自動テストがサインインの手順に依存することになります。認証に関するPlaywrightのドキュメントでは、一般的なパターンが説明されています。セットアップのステップで一度だけサインインし、ブラウザーの状態をファイルに書き出します。その後、テストはその状態から開始します。ドキュメントには、安全に関するルールも記載されています:

  • 状態ファイル用のフォルダーを作成し、無視ファイルに追加してください。ドキュメントでも、まさにそうすることが推奨されています。
  • このファイルは認証情報として扱ってください。危険に関する注意書きでは、このファイルに機密性の高いCookieやヘッダーが含まれている可能性があり、それらを使われると、本人やテスト用アカウントになりすまされるおそれがあると記載されています。ドキュメントでは、このようなファイルをプライベートまたはパブリックのリポジトリにチェックインしないよう、強く勧めています。
  • 有効期限が切れた保存済みの状態は削除してください。実行をまたいで保持する必要がない場合は、出力フォルダーに書き出してください。
  • アプリケーションがAPI経由のサインインに対応している場合は、画面を操作するより簡単で高速なことがあります。得られた状態も同じ方法で保存します。

Currentsは、クリーンアップのステップを追加することも勧めています。サインイン用フィクスチャのティアダウンでCookieを消去し、CIの成果物を読み取れるユーザーを制限してください。

多要素認証とテスト専用の近道

多要素認証は自動化を難しくしますが、それこそがその目的です。TestDinoは、テストアカウントに対する選択肢を提案しています。認証アプリのコードについては、セットアップスクリプトでライブラリを使ってコードを生成します。SMSやメールのコードについては、ステージング環境のテストアカウントで多要素サインインを無効にするか、テスト専用のルートを使用します。

テスト専用のバイパスルートは現実的なリスクです。TestDinoは、環境変数のチェックで保護し、本番環境には決してデプロイしないよう述べています。サインインを回避するあらゆるショートカットは、独自のレビューが必要なセキュリティ機能として扱ってください。

実際のサインインが必要なテストシナリオを選ぶ

すべてのテストケースで実際のログインが必要なわけではありません。テスト戦略の一環として、実際のブラウザーで実際のサインインページを操作するエンドツーエンドのテストシナリオを1つか2つ残し、それ以外の機能テストは、保存済みの状態から開始するか、APIテストと同様にAPI経由のサインインから開始することをお勧めします。これにより、シークレットを入力する回数を抑え、テストの実行を速めつつ、サインインの流れも確実にカバーできます。

サインイン手順は、ページオブジェクトモデルのクラスや共有フィクスチャなど、1か所にまとめてください。そうすれば、ログインページの変更やシークレットの読み取り方法の変更が、1つの自動化スクリプトだけに影響します。ログイン手順をすべてのテストにコピーして貼り付けると、情報漏えいの一般的な原因になるうえ、ページが変わったときに不安定なテストが生じやすくなります。

サインイン画面の手動テストや探索的テストは、自動化で使用しないアカウントで行ってください。共有ログインは、アカウントのロックアウトや監査証跡の不明確さを招くためです。同じ並列実行の中に、小さなセキュリティテストのチェックも加えてください。例えば、レポート内にトークンが含まれていないかを検索するといったものです。どの自動化ツールを選んでも、シークレットに関するルールは変わりません。

例:30分の監査

数値はあくまで仮定です。

あるチームは、回帰テストの一環として90件のブラウザーテストを実行しており、テストリポジトリ内のシークレットを確認しています。監査には30分かかり、次の5つの問題が見つかりました。

  1. テストヘルパーファイルに、パスワードが2つ直接書かれていました。
  2. 無視リストに含まれていない、保存済みサインイン状態ファイルのフォルダーがありました。
  3. すべてのテストを記録するトレース設定があり、全社員が開けるレポートの成果物がありました。
  4. 8つの並列ワーカーすべてが同じアカウントを使用しており、その結果、2件のテストがランダムに失敗していました。
  5. 以前テスターを務めていた人の個人アカウントが、いまも1件のテストで使われていました。

修正には1日かかりました。パスワードはCIのシークレットストアに移し、古い値は変更しました。状態フォルダーは無視対象に設定し、履歴からも削除しました。トレースは失敗したテストに限定して保存し、レポートへのアクセスはQAグループに絞りました。並列ワーカーごとに専用アカウントを割り当てたことで、ランダムな失敗はなくなりました。個人アカウントは、担当者が明確な専用アカウントに置き換えました。チームは同じ監査を四半期ごとに実施するよう予定に組み込みました。

よくある間違い

  • 「とりあえず」でパスワードをハードコードする。 それは履歴に永久に残ります。
  • 保存済みのサインイン状態をコミットする。 そのファイルはアカウントのパスワードと同じように機能します。
  • CIのログのマスキングを信頼する。 エンコードされた値や一部の値は見逃され、トレースや動画には効果がありません。
  • すべてを記録する。 動画、完全なトレース、公開されたレポートによって、シークレットがより多くの人に広がります。
  • 並列ワーカー間で1つのログインを共有する。 ランダムな失敗と監査証跡の不明確さの両方を引き起こします。
  • 本番環境にテスト専用のバイパスルートを残したままにする。 環境変数で制御し、定期的にレビューしてください。

ソフトウェアが役立つ場面

まずは、CIプラットフォームのシークレットストアと、利用可能であればリポジトリのシークレットスキャン機能から始めましょう。シークレットマネージャーは保存された値を暗号化することもでき、複数のチームでログインを共有する場合に、アクセス制御、ローテーション、ログ記録を1か所で管理できるため役立ちます。テストフレームワークの設定で記録対象を制御し、小さなスクリプトで成果物から機密性の高いヘッダーを取り除くこともできます。CI環境に合った自動テストツールを選び、クリーンアップを頼りにする前に、サンプル実行で動作を確認してください。同じルールは、Selenium、Cypress、Playwright、Pythonのテストスイートにも当てはまり、Webアプリケーションを呼び出すAPIテストだけでなくUIテストにも適用されます。

次のステップ

今日中にテストリポジトリを開き、パスワード、トークン、保存済みの状態ファイルを検索してください。見つかったシークレットはすべて、CIのシークレットストアに移します。そのうえで、テストがトレースや動画をどのように記録しているかを見直し、ブラウザーの自動テストに含まれるシークレットがレポート全体に広がらないようにしてください。

Entities in this article

End-to-end testing Least privilege Regression testing

Related articles

RSS