← ブログに戻る

CHIPS は埋め込み状態のための仕組みであり、サイト横断の ID のためではない

CHIPS は、コンポーネントを埋め込むトップレベルサイトごとに別の Cookie jar を作ります。適した用途と、サードパーティ間で共有 ID を提供できない理由を解説します。

パーティション化 Cookie は、あるサイトに埋め込まれた widget のログイン状態を維持できますが、その widget を埋め込むすべてのサイトで共通の ID を与えることはできません。この違いは、チャット、決済、ドキュメント、アカウントプロバイダーの埋め込み機能の設計に影響します。

CHIPS は埋め込み元ごとに別のセッションを作る

CHIPS(Cookies Having Independent Partitioned State)を使うと、クロスサイトの埋め込みコンポーネントは Partitioned 属性を指定して、Cookie をパーティション化ストレージに保存できます。ブラウザーは Cookie を設定したサイトとトップレベルサイトの両方を基準に Cookie を分けます。同じプロバイダーが関係のない2つのサイトに埋め込まれても、プロバイダー共通の1つの jar ではなく、別々の Cookie jar を受け取ります。

たとえば、shop.example に埋め込まれた support.example は、その埋め込みコンテキスト専用のセッション Cookie を設定できます。

Set-Cookie: __Host-widget_session=opaque-value; Secure; Path=/; SameSite=None; Partitioned

これらの保証はブラウザーの対応状況に依存する。未対応の Partitioned 属性が無視され、ブラウザーが許可していれば、分割されていないサードパーティ Cookie が残る場合がある。対象ブラウザーごとにテストし、属性だけで分離されると決めつけないこと。

widget が shop.example 上で読み込まれるとブラウザーはこの Cookie を送信しますが、同じ widget が docs.example 上で読み込まれても送信しません。ユーザーが support.example を直接訪問しても、パーティション化 Cookie が汎用 Cookie になるわけではありません。トップレベルサイトごとにコンテキストが異なるため、別の埋め込み元から初めて訪問すると、以前のサイトの widget セッションはありません。

これは、埋め込みコンポーネントが1つのサイトに限定された状態を必要とする場合に有効です。たとえば、そのサイトに紐づくサポートの会話、サイトごとの設定、1つのストア専用のカートなどです。関係のないサイトにも存在することを、共有 ID として扱わずに状態を保持できます。

必要な状態に合わせて Cookie を選ぶ

埋め込み元ごとに独立したセッションでも機能するなら、CHIPS を選びます。サーバーは新しいトップレベルサイトで Cookie が存在しない場合を想定し、別サイトの状態と暗黙に結合したり、ユーザーが全体からログアウトしたと判断したりするのではなく、embed 専用の新しいセッションを作成します。

関係のないサードパーティサイト間でユーザーを識別する必要があるサービスのアカウント Cookie として、パーティション化 Cookie を使ってはいけません。ブラウザーが強制するのは正反対の動作です。同じサードパーティ origin でも、トップレベルコンテキストが異なれば、別々のパーティション状態を受け取ります。共通のアカウントを必要とする widget は、別の明示的なフローで ID を取得する必要があります。

この分離は設計上の選択であり、Cookie 名を変えたり値をローテーションしたりして回避する不具合ではありません。embed の主要機能が同じ ID をどこでも利用できることに依存するなら、CHIPS だけでは要件を満たせません。embed 自体の状態を維持したいだけなら、サイト横断のサードパーティ Cookie に依存するよりパーティション化が適しています。

Storage Access は別の契約

embed がパーティション化されていないファーストパーティ状態を本当に必要とする場合、たとえばユーザーがプロバイダー自身のサイトでログイン済みのアカウントを表示する場合には、**Storage Access API(SAA)**という別のリクエスト方法があります。埋め込みドキュメントは document.hasStorageAccess() を確認し、必要なら document.requestStorageAccess() を呼び出せます。許可されるのはその埋め込みコンテキストからのアクセスであり、CHIPS Cookie が共有 Cookie jar に変わるわけではありません。

このリクエストは、プロダクトフローの条件分岐として扱います。ブラウザーによってはユーザー操作、トップレベルでの事前訪問、その他の条件を要求し、リクエストが拒否されることもあります。たとえば WebKit の実装ガイドでは、ユーザー操作を契機にリクエストし、事前にファーストパーティとして操作されたことを求めています。ブラウザーごとにポリシーは異なるため、あるエンジンで成功しても、すべてのユーザーの embed がアクセスできるとは限りません。

loginButton.addEventListener("click", async () => {
  try {
    await document.requestStorageAccess();
    await loadAccount();
  } catch {
    showSignedOutExperience();
  }
});

フォールバックは例外的なエラー画面ではなく、機能の一部です。アクセスできない場合も、embed の公開機能やローカル状態を使い続けられるようにし、アカウント固有のデータが必要なときは明確なログイン操作を提示します。また、埋め込みドキュメントのストレージにアクセスできても、その ID が別 origin の API に送るリクエストへ自動的に付与されるわけではありません。

成功パターンだけでなく境界をテストする

同じ embed を異なる2つのトップレベルサイトでテストし、それぞれが独立した状態で始まることを確認します。次に、プロバイダーをトップレベルで開いた場合、SAA リクエストが拒否された場合、embed が別 origin の API に送るリクエストをテストします。ブラウザーの開発者ツールでパーティションキーを確認し、各 endpoint に実際に届く Cookie を検証します。

このテストで、埋め込みアプリケーションを壊しがちな思い込みが明らかになります。サードパーティコンポーネントは複数の場所に存在できますが、どこでも同じログインユーザーを表すとは限りません。1つの埋め込み元に属する状態には CHIPS を使い、プロダクトが本当に共通アカウントを必要とする場合は、ユーザーが関与する明示的な ID フローを使います。

参考資料

Comments

Loading comments…