Clear-Site-Data Header
Intro
Clear-Site-Data Header の実装が進んでいる。
このヘッダについて解説する。
Clear-Site-Data
例えばログアウト処理を実施する場合は、レスポンスヘッダで Cookie を無効にするといった形で実現されるだろう。
しかし、最近では Cookie 以外にも多くのストレージがあり、アカウント特有のデータが保存されていることが多い。
- local storage
- session storage
- indexed db
- service worker
- cache api
これらを、ログアウト処理の中で各 API を適切に呼び出し、全て確実に削除するのは簡単ではない。
また、httponly の Cookie や browser cache などは、JS からの削除もできない。
SPA のように実装されている場合は、その状態を含めて初期化しないと不整合が発生する場合もある。
こうした問題に対して策定されたのが、Clear-Site-Data Header である。
ブラウザにあるデータ削除機能が、API として出たというイメージだ。
ページを遷移しなくても、fetch() などで受信したレスポンスヘッダに含まれれば、そのコンテキストで削除が実施される。
Clear-Site-Data Header
ヘッダの値に Type を列挙するだけである。
Clear-Site-Data: "cache"
Clear-Site-Data: "cache", "cookies", "storage", "executionContexts"
Clear-Site-Data: "*"Type は現時点では以下が定義されている。
cookiescachestorageexecutionContexts*
各 Type で解説する。
httponly, secure の有無に関わらず、全ての Cookie が消える。
( また Basic Auth の Authorization Header や TLS の Channel ID 、Token Binding なども対象になっている。
ブラウザキャッシュのみであり、Cache API は storage 扱いとなる。
対象は以下
例えば service worker だけは残したい、といった細かい調節はできない。
実行コンテキストをクリアする、つまりリロードを行う。
挙動は これにより、メモリ上の値なども全てクリアされるため、アプリケーションが持つステートなどを初期化できる。
挙動がわかりにくいところがあるが、執筆時点で唯一実装している Firefox Nightly 63.0a1 では、遷移したページがこれを返すと無限にリロードしてしまう。
JS でリクエストした場合は、そうはならないので、提供方法は注意が必要だろう。
全てを消す。
しかし、将来に Type が追加された場合は、それらを全て含むことになる。
よって、ショートハンドとして安易に それを踏まえて、セーフリストを選択するべきかどうかは考慮が必要となる。
cookies
document.cookie や Cookie Store API も全て同じ Cookie を見ているため、storage ではなく cookie である)
cache
storage
executionContext
location.reload() を実行するのと同等だが 開いている他のタブも全てリロード される。
* (all)* を使うと、前方互換性が保たれない可能性がある。
User Case
一番わかりやすい例は Logout の処理だろう。
ヘッダは以下のように提供できる。
- logout ページに遷移する際のヘッダに載せる
- logout 用の API を JS からリクエストする
Type は cache, cookie, storage, executionContext を全て載せることになるだろう。
executionContext は他の Tab を含めて対応するために
他にも、脆弱性が判明した場合に、開いているタブなども含め確実に修正版を表示させるといった用途にも使える。
強制的なログアウトが可能な運用をしている場合は、そのタイミングで提供できるだろう。
JS API
現状削除されているが、もともとは JS の API も合わせて定義されていた。
navigator.storage.clear("cache")しかし、navigator.storage.clear("executionContexts") を実行した場合、開いている全てのタブにおいて location.reload() 相当が実行されるという API の設計に疑問が出た。
結果、一旦これは Drop され、ニーズがあれば再度議論することとなった。
DEMO
動作するデモを以下に用意した。