User-Agent Reduction オリジン トライアル

ユーザー エージェントの情報量削減は、User-Agent（UA）文字列に含まれる情報を、ブラウザのブランドとメジャー バージョン、パソコンまたはモバイルの区別、実行されているプラットフォームのみに削減することで、パッシブ フィンガープリント サーフェスを減らす取り組みです。現在、UA 文字列はすべての HTTP リクエストで共有され、ブラウザによって読み込まれるすべてのリソースに JavaScript で公開されます。これには、ブラウザ、実行されているプラットフォーム、その機能に関する重要な情報が含まれています。User-Agent Client Hints（UA-CH）は、完全な UA 文字列と同じ情報を提供できますが、サイトは必要な UA 情報のみをリクエストできます。

Chrome 95 ベータ版より、ユーザー エージェントの情報量削減のオリジン トライアルが開始されます。これにより、サイトは削減された UA 文字列の受信をオプトインできるようになります。これにより、UA の削減が Chrome のデフォルト動作になる前に、サイトが問題を見つけて修正できるようになります（削減は 2022 年第 2 四半期に開始される予定です）。安定版ユーザーへのリリース前に 95 ベータ版ユーザーでオリジン トライアルをテストする場合は、Chrome 95 のリリース日（現在は 2021 年 10 月 19 日に予定されています）までにオプトインしてテストしてください。

以下に、オリジン トライアルの概要と想定される内容を示します。このトライアル期間中は、UA 削減の GitHub リポジトリでフィードバックや問題をお寄せください。

User-Agent とは何ですか？

ユーザー エージェント（UA）文字列はすべての HTTP リクエストで共有され、ブラウザによって読み込まれるすべてのリソースに JavaScript で公開されます。現在、ブラウザとその実行プラットフォームに関する重要な情報が含まれています。

User-Agent が削減されるのはなぜですか？

ユーザー エージェントの情報量削減は、2020 年 1 月に初めて発表された、Chrome ブラウザのパッシブ フィンガープリント サーフェスを削減するための取り組みです。UA 文字列の情報量を、ブラウザのブランドとメジャー バージョン、パソコンまたはモバイルの区別、実行プラットフォームのみに削減することで、個々のユーザーを特定することがより困難になります。

ウェブ デベロッパーへの影響

サイトは、削減された UA 文字列の受信に備え、オリジン トライアルへの参加を検討する必要があります（詳しくは下記を参照）。削減されたユーザー エージェントの値は、次の場所に表示されます。

  • User-Agent HTTP リクエスト ヘッダー
  • navigator.userAgent JavaScript ゲッター
  • navigator.platform JavaScript ゲッター
  • navigator.appVersion JavaScript ゲッター

削減された User-Agent によって共有される情報よりも多くのクライアント情報を受け取るには、サイトは新しい User-Agent Client Hints API に移行する必要があります。移行戦略の詳細については、User-Agent Client Hints に移行するをご覧ください。

現時点では、User-Agent の削減計画に iOS と WebView は含まれていないため、これらのプラットフォームでは引き続き完全なユーザー エージェント文字列が取得されます。主な理由は、これらのプラットフォームに User-Agent Client Hints がまだ実装されていないことです。

このオリジン トライアルの仕組み

このオリジン トライアルは、標準のオリジン トライアルとは少し異なります。標準オリジン トライアルでは、レスポンスの動作のみを制御できます（レスポンスの JavaScript で API へのアクセスを制御するなど）。このトライアルでは、JavaScript API で提供される UA 文字列を変更するだけでなく、HTTP リクエストで送信される User-Agent ヘッダーも変更することを目標としています。

これを実現するため、Sec-CH-UA-Reduced という名前の一時的なクライアント ヒントを定義します。このヒントがリクエストに存在すると、User-Agent ヘッダー値に削減された UA 文字列が含まれていることが示されます。Sec-CH-UA-Reduced クライアント ヒントは、オリジン トライアル トークンが有効な場合にのみ（削減された UA 文字列とともに）送信されます。オリジン トライアルが期限切れになると、Sec-CH-UA-Reduced クライアント ヒントは機能しなくなります。Critical-CH header を設定しない限り、最初のナビゲーション リクエストには引き続き、圧縮されていない User-Agent 文字列が送信されます。

同じオリジンへのサブリソース リクエストでは、送信されたトップレベル リクエストと同じ User-Agent 文字列が自動的に送信されます。サードパーティのオリジンへのサブリソース リクエストでも、トップレベル リクエストと同じユーザー エージェント文字列が送信されます。これには、オリジン トライアル トークンが有効な場合の削減された UA 文字列も含まれます（権限ポリシーで許可されている場合）。

ユーザー エージェント文字列削減のオリジン トライアルに参加するにはどうすればよいですか？

  1. オリジン トライアルに登録してドメインのトークンを取得するには、ユーザー エージェントの削減に関するトライアルのページをご覧ください。

  2. HTTP レスポンス ヘッダーを更新します。

    1. HTTP レスポンス ヘッダーに Origin-Trial: <ORIGIN TRIAL TOKEN> を追加します。ここで、<ORIGIN TRIAL TOKEN> には、オリジン トライアルの登録時に取得したトークンを含めます。
    2. HTTP レスポンス ヘッダーに Accept-CH: Sec-CH-UA-Reduced を追加します。
    3. Accept-CH を設定すると、送信元への後続のリクエストでのみ、削減された User-Agent 文字列が送信されます。削減された User-Agent 文字列を使用して最初のナビゲーション リクエストを再送信するには、Accept-CH ヘッダーと Origin-Trial ヘッダーに加えて、HTTP レスポンス ヘッダーに Critical-CH: Sec-CH-UA-Reduced を追加します。
    4. 注: レスポンス ヘッダーに有効な Origin-Trial トークンと Accept-CH: Sec-CH-UA-Reduced が含まれている場合、リクエストの送信元が送信元トライアルに登録されていなくても、すべてのサブリソース リクエスト（画像やスタイルシートなど）とサブナビゲーション（iframe など）は、削減された UA 文字列を送信します。

  3. Chrome M95（以降）でウェブサイトを読み込み、削減された UA 文字列の受信を開始します。

  4. 問題やフィードバックは、UA の削減に関する GitHub リポジトリに送信してください。

  5. オリジン トライアルの簡単なデモ（ソースコードを含む）については、https://uar-ot.glitch.me/ をご覧ください。

サードパーティ埋め込みとしてオリジン トライアルに参加するにはどうすればよいですか？

Chrome 96 以降では、サードパーティの埋め込み（別のサイト内の iframe など）が、トップレベル サイトを登録しなくてもオリジン トライアルに参加できるようになります。

サードパーティ埋め込みとして登録するには:

  1. User-Agent の削減トライアルにアクセスし、[登録] をクリックします。
  2. トークンを作成する際は、Third-party matching チェックボックスをオンにしてください。
  3. サードパーティの埋め込みから削減されたユーザー エージェント ヘッダーを受け取るには、HTTP レスポンス ヘッダーを更新します。
  4. JavaScript API で削減されたユーザー エージェント文字列を受け取るには、トライアル トークンを JavaScript 経由で挿入する必要があります。

サードパーティ埋め込みでオリジン トライアルを実施する際の重要なポイントは次のとおりです。 + サードパーティ埋め込みには Critical-CH を指定できないため、最初のナビゲーションでは削減された UA 文字列が送信されませんが、サードパーティ埋め込みのサブリソース リクエストでは削減された UA 文字列が送信されます。+ サードパーティの埋め込みのオリジンに対してオリジン トライアルが検証された場合、最上位のナビゲーション内の同じオリジンに対する後続のリクエストでは、削減された UA 文字列が送信されます。このため、トップレベル リクエストと埋め込みリクエストの両方でオリジン トライアルへの参加を段階的に増やすことをおすすめします。+ ユーザー エージェントでサードパーティ Cookie が無効になっている場合、サードパーティ埋め込みリクエストの User-Agent ヘッダーではオリジン トライアルは機能しませんが、Javascript API は引き続き削減された UA 文字列を取得します。

オリジン トライアルが機能していることを確認するにはどうすればよいですか？

オリジン トライアルが機能していることを確認するには、リクエスト ヘッダーを調べて、次の点を確認します。

  1. User-Agent ヘッダーには、削減されたバージョンが含まれます。削減された UA 文字列のサンプル リストを参照してください。簡単に確認する方法は、Chrome マイナー バージョンの文字列に 0.0.0 が含まれているかどうかです。
  2. Sec-CH-UA-Reduced ヘッダーは ?1 に設定されています。

オリジン トライアル トークンを含む最初のレスポンスのヘッダーは次のようになります。

オリジン トライアル トークンを含む最初のレスポンスのヘッダー。

削減された UA 文字列を含む後続のリクエスト ヘッダーは次のようになります。

削減された UA 文字列を含む後続のリクエスト ヘッダー。

ユーザー エージェントの情報量削減のオリジン トライアルへの参加を停止するにはどうすればよいですか？

トライアル期間中はいつでも参加を停止して、完全なユーザー エージェント文字列を受け取ることができます。参加を停止するには:

  1. HTTP レスポンスで Accept-CH ヘッダーを送信し、Sec-CH-UA-Reduced を含めないでください。注: サイトが他のクライアント ヒントをリクエストしない場合、空の値の Accept-CH は、この目的を達成するための有効な方法です。
  2. HTTP レスポンスから、ユーザー エージェント文字列削減トライアルの Origin-Trial ヘッダーを削除します。
  3. 設定されている場合は、HTTP レスポンスの Critical-CH ヘッダーから Sec-CH-UA-Reduced を削除します。

オリジン トライアルの期間はどのくらいですか？

ユーザー エージェント（UA）の情報量削減オリジン トライアルは、少なくとも 6 か月間（Chrome マイルストーンに換算すると約 6 回）実施されます。オリジン トライアルは M95 で開始され、M101 で終了します。この時点で、Chrome はオリジン トライアルからのフィードバックを評価し、ロールアウト計画に従って削減された User-Agent 文字列を段階的に送信します。サイトにさらに時間が必要な場合は、その後の非推奨のオリジン トライアルにオプトインできます。これにより、少なくとも 6 か月間、完全な UA 文字列にアクセスできます。サポート終了トライアルの詳細については、準備ができ次第公開する予定です。

ユーザー エージェント文字列削減のオリジン トライアルについてフィードバックを送信するにはどうすればよいですか？

問題やフィードバックは、UA の削減に関する GitHub リポジトリに送信してください。