This content is outdated and no longer accurate.

このページは Cloud Translation API によって翻訳されました。

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

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

Chrome 95 ベータ版から、User-Agent Reduction のオリジントライアルを公開し、削減された UA 文字列の受信をサイトが今すぐオプトインできるようにします。これにより、UA の短縮が Chrome のデフォルト動作になる前に、サイトで問題を検出して修正できるようになります（短縮は 2022 年の第 2 四半期に開始される予定です）。Stable ユーザーにリリースされる前に、95 人のベータ版ユーザーでオリジントライアルをテストする場合は、Chrome 95（現在予定は 2021 年 10 月 19 日）のリリース日までにオプトインしてテストしてください。

以下に、オリジントライアルの概要と今後の見通しを示します。このトライアル全体を通して、UA Reduction GitHub リポジトリに関するフィードバックや問題をぜひお寄せください。

User-Agent とは

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 に移行するをご覧ください。

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

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

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

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

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

User-Agent Reduction のオリジントライアルに参加するにはどうすればよいですか？

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

注: トライアル用のドメインをサードパーティの埋め込みとして登録するには、別のトークンが必要です。
HTTP レスポンスヘッダーを更新します。
1. Origin-Trial: <ORIGIN TRIAL TOKEN> を HTTP レスポンスヘッダーに追加します。<ORIGIN TRIAL TOKEN> には、オリジントライアルの登録時に取得したトークンが含まれます。
2. HTTP レスポンスヘッダーに Accept-CH: Sec-CH-UA-Reduced を追加します。
3. Accept-CH を設定すると、送信元への後続のリクエストでのみ、削減されたユーザーエージェント文字列が送信されます。ユーザーエージェント文字列を削減して最初のナビゲーションリクエストを再送信するには、Accept-CH と Origin-Trial ヘッダーに加えて、HTTP レスポンスヘッダーに Critical-CH: Sec-CH-UA-Reduced を追加します。
4. 注: レスポンスヘッダーに有効な Origin-Trial トークンと Accept-CH: Sec-CH-UA-Reduced が含まれている場合、すべてのサブリソースリクエスト（画像やスタイルシートなど）とサブナビゲーション（iframe など）は、リクエストのオリジンがオリジントライアルに登録されていない場合でも、縮小された UA 文字列を送信します。
Chrome M95 以降でウェブサイトを読み込み、短縮された UA 文字列の受信を開始します。
問題やフィードバックは、UA Reduction の GitHub リポジトリまでお送りください。
オリジントライアルとソースコードの簡単なデモについては、https://uar-ot.glitch.me/ をご覧ください。

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

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

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

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

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

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

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

ユーザーエージェントヘッダーには、情報量削減後のバージョンが含まれています。削減された UA 文字列のサンプルのリストをご覧ください。Chrome のマイナーバージョン文字列に 0.0.0 が含まれているかどうかを簡単に確認できます。
Sec-CH-UA-Reduced ヘッダーが ?1 に設定されている。

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

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