本文へスキップ

すべてのバグ報告から、アップロード前に機密情報をマスキング

更新日

Midge は、バグ報告から機密情報を自動でマスキングします。パスワード、カード番号、トークン、Cookie は、デバイスから送信される前にブラウザ内で伏せられます。同じルールがヘッダー、URL、リクエストとレスポンスのボディ、コンソールメッセージ、インスタントリプレイ、ユーザー操作のログに適用され、取り除かれた値はすべて [REDACTED] に置き換えられます。読む人には、そこに何かがあったことがわかります。

基本方針はシンプルです。迷ったら隠す。無害な値を消してしまうのは許容できるコストですが、セッショントークンを漏らすのは許されません。このページでは、すべてのルールを平易な言葉で紹介し、そのうえでマスキングでは防げないことを説明します。要約版はセキュリティページにあります。

ルール

ヘッダー

次のヘッダーは、名前で判断して常に伏せられます。Authorization、Proxy-Authorization、Cookie、Set-Cookie、X-API-Key、X-Auth-Token、X-CSRF-Token、X-XSRF-Token。

さらに、名前に token、secret、key、session、auth、signature、password を含むヘッダーは、大文字・小文字を問わずすべて伏せられます。そのため、X-Shopify-Access-Token や X-Session-Id も、誰かが個別に登録しなくても対象になります。

URL

リクエストの URL、ページ遷移、コンソールのテキストに現れる URL では、次のパラメータの値が取り除かれます。token、access_token、refresh_token、id_token、code、key、api_key、apikey、signature、sig、password、pass、secret、session、sessionid、auth、jwt。これはクエリ文字列にも、多くの OAuth フローがトークンを置く # 以降のフラグメントにも適用されます。https://user:pass@host のように URL に書き込まれたパスワードも取り除かれます。また、値が後述のパターンのいずれかに一致するパラメータは、名前に関係なく伏せられます。

リクエストとレスポンスのボディ

Midge は JSON、URL エンコードされたフォーム、マルチパートのフォームを、ネストされたオブジェクトも含めてスキャンします。次の名前のフィールドは伏せられます。password、passwd、pwd、pass、secret、token、otp、pin、cvv、cvc、card、cardNumber、pan、iban、ssn、apiKey、privateKey、client_secret、refresh_token、access_token。照合では camelCase と snake_case の違いは無視され、newPassword や reset_token のように中心となる単語で終わる名前も一致します。

ログインリクエストは、マスキング後には次のようになります。

{
  "email": "j***@acme.com",
  "password": "[REDACTED]",
  "device": { "name": "Work laptop", "pushToken": "[REDACTED]" }
}

機密情報らしい値は、どこにあっても

形だけで機密情報だとわかるものもあります。Midge は、フィールドの名前に関係なく、ボディ、ヘッダー、URL、コンソールのテキスト、リプレイ内のページテキストから次のものを取り除きます。

  • JSON Web Token: eyJ で始まり、ドットで区切られた 3 つの base64url の部分。
  • カード番号: スペースやハイフンの有無にかかわらず、Luhn チェックサムを通る 13〜19 桁の数字。チェックを通らない注文番号はそのまま残ります。
  • 既知の形式の API キー: Stripe(sk_live_、sk_test_、rk_live_)、AWS(AKIA)、GitHub(ghp_、gho_、github_pat_)、Slack(xoxb-、xoxp-)、Google(AIza)、OpenAI や Anthropic 形式のキー(sk-、sk-ant-)。
  • Bearer トークン: Bearer の後ろの値。
  • 秘密鍵: -----BEGIN ... PRIVATE KEY----- から終了行までのブロック全体。

メールアドレスと電話番号

これらは削除ではなくマスクされるため、どのアカウントが関わっていたかはレポートからわかります。[email protected] は j***@acme.com になります。+ で始まる国際電話番号は、国番号、最初の 1 桁、最後の 2 桁が残ります。+44 7700 900123 は +44 7*** ****23 になります。

入力した内容

入力したテキストが記録されることはありません。操作ログに残るのは、ある欄に入力したという事実だけです。たとえば「Typed in input[name=email]」のようになります。クリック対象のテキストも、ほかのすべてと同じパターンのスキャンを通ります。

動画、スクリーンショット、リプレイ

  • タブ録画では、パスワード欄、カード番号欄(autocomplete="cc-...")、そして data-midge-blur が付いた要素が録画中ぼかされるため、動画に映ることはありません。
  • スクリーンショットでは、どの範囲でも手動でぼかせます。
  • インスタントリプレイでは、すべての入力値がマスクされ、ページのテキストには上記のパターンのルールが適用されます。

独自のルール

どのアプリにも、tenantKey や X-Partner-Id のような独自の機密情報があります。ワークスペースの管理者はフィールド名やヘッダー名を追加でき、拡張機能はサインイン時にそのリストを読み込みます。ルールは追加できますが、組み込みのルールを外すことはできません。オフにするスイッチも許可リストもないのは、意図的な設計です。

マスキングでは防げないこと

ルールと同じくらい、限界をはっきりさせておくことも大切です。

  • ルールベースです。 ルールに書かれたものを取り除きます。珍しい名前で、見分けのつかない形式の機密情報はすり抜ける可能性があります。見つけたら、ワークスペースのルールを追加してください。
  • ランダムに見える文字列は残ります。 Midge はエントロピーにもとづく推測はしません。そうすると、開発者がデバッグに必要とするリクエスト ID、ハッシュ、レコード ID まで消してしまうからです。
  • ウインドウや画面全体の録画はぼかされません。 欄を自動でぼかすのはタブ録画だけです。ウインドウや画面の録画を始める前に、Midge が見られたくないものを閉じるようお知らせします。
  • タブ録画の動画では、ページのテキストはスキャンされません。 ページにトークンが表示されていれば、動画にも映ります。インスタントリプレイはピクセルではなくページのテキストを扱うので、この点が異なります。

自分のファイルでルールを試す

無料の HAR サニタイザーは、拡張機能とまったく同じマスキングのコードを使っています。DevTools からエクスポートした HAR ファイルをドロップすれば、何が取り除かれるかをすべてブラウザ内で確認できます。手作業で行う場合は、「HAR ファイルから機密データを削除する方法」をお読みください。マスキングは、レポートのネットワークログとコンソールログのすべてにも適用されます。

Midge は無料で、録画数は無制限、動画は最長 15 分、透かしも入りません。

よくある質問

マスキングはどこで行われますか?
Midge がレポートを準備している間に、あなたのデバイス上のブラウザ内で行われます。Midge のサーバーが受け取るのは常にマスキング後のデータだけなので、生の値が保存されることはありません。
信頼しているサイトでは、マスキングをオフにできますか?
いいえ。オフにするスイッチも、許可リストもありません。チームはマスキング対象のフィールド名やヘッダー名を追加できますが、組み込みのルールを外すことはできません。
Midge はすべての機密情報を見つけられますか?
それを約束できるツールはありません。Midge は、テスト済みの決まったルールに従います。珍しい名前や形式の機密情報は認識されない可能性があるため、チームが独自のフィールド名やヘッダー名を追加できるようにしています。
メールアドレスを削除せずにマスクするのはなぜですか?
開発者は、どのアカウントでバグが起きたかを知る必要があることが多いからです。j***@acme.com のように一部だけマスクすれば、アドレス全体をさらさずにその手がかりを残せます。
ウインドウを録画すると、画面全体がぼかされますか?
いいえ。ウインドウや画面全体の録画では、自動のぼかしは入りません。こうした録画を始める前に Midge が注意を表示するので、見られたくないものを閉じておけます。