はじめに
Laravelのbladeでformを作成中に親の顔より見ているであろう以下のディレクティブ
<form action="・・・" method="POST">
@csrf ←コレ
たまに書き忘れて419 Page Expired(Laravel特有のCSRFトークン不一致などを示すエラー)になるやつですね
クロスサイトリクエストフォージェリ(CSRF)攻撃からアプリケーションを保護するためのものとなりますが、Laravelバージョン13においてCSRF攻撃対策にアップデートが入りました
アップデート内容
今までCSRFトークンの検証はLaravelのミドルウェア VerifyCsrfToken で行われていました
しかしながらバージョン13にてCSRF検証を担うミドルウェアは PreventRequestForgery に変わりました
もちろんただクラス名が変わっただけではなく、検証内容も変わっています
今まではbladeに記載した @csrf ディレクティブが以下のようなHTMLを生成し
<input type="hidden" name="_token" value="xxxxxxxx" autocomplete="off">
_token の値をsubmit、ミドルウェアで正規のtokenか検証していました
バージョン13からは @csrf を書かずとも Sec-Fetch-Site というリクエストヘッダーを使った検証 も できるようになっています
@csrf でのCSRF対策機能は無効化されていないため、ご安心ください
PreventRequestForgeryのソース を見てもらえればわかりますが、以下の流れで判定しています
-
Sec-Fetch-Siteヘッダーを使った検証:$this->hasValidOrigin($request)- OKなら通す
- NGならトークン検証へ
- トークン検証:
$this->tokensMatch($request)- OKなら通す
- NGなら
throw new TokenMismatchException
Sec-Fetch-Siteヘッダーで何故CSRF保護ができるのか?
そもそもCSRF攻撃は正規のWebシステムにログイン済み状態であるユーザーが罠サイトに行き、罠サイトのページ内に埋め込まれたスクリプトが、ユーザーのブラウザから正規のWebシステムに対して不正なリクエストを送ることにより、本来ログインが必要な処理をユーザーの意図しない所で実行させる攻撃です
正規のWebシステムからするとただログインしているユーザーがリクエストを送ってきているだけなので、対策しないと通常通り処理してしまいます
でもそのリクエスト内容に正しい _token の値が入っていないと、それは不正なリクエストだとみなせます
これが今までもあった @csrf の検証で、そのトークンはWebシステム側が発行します
対してSec-Fetch-Siteヘッダーはブラウザが「このリクエストはどこから発生したか」をこのヘッダーに付与します
送信元と送信先の関係性は以下の組み合わせがあります
| 値 | 送信元と送信先の関係 |
|---|---|
| cross-site | 全く別のドメイン |
| same-origin | 一緒 |
| same-site | ドメインは同じだがサブドメインやポート違いなど |
| none | 送信元無し(URL直接入力など) |
Webシステム側はブラウザが判断した Sec-Fetch-Site ヘッダーを見て、cross-siteだからブロックしようなどと判断します
リクエストヘッダーなんだからなんぼでも好きに設定できるやろ?
と、私は一瞬思いました
fetch('http://localhost/admin/delete-all-db', {
method: 'POST',
headers: {
'Content-Type': 'application/x-www-form-urlencoded',
'Sec-Fetch-Site': 'same-origin',
},
body: 'agree=1&aikotoba=ICanDoIt'
})
.then(response => {
console.log('通信が完了しました。ステータス:', response.status);
})
.catch(error => {
console.error('通信エラー:', error);
});
結果
POST http://localhost/admin/delete-all-db net::ERR_FAILED 419 (unknown status)
ちゃんと弾かれました。完璧な偽造のはずなのに…
開発者ツールのネットワークタブを開きリクエストヘッダーを見てみると、 same-origin に設定した値が cross-site に変わっていますね
sec-fetch-site: cross-site
Sec- で始まるリクエストヘッダーは「Forbidden request header」と呼ばれJavaScriptからの設定や変更が禁止されています
Forbidden request header (禁止リクエストヘッダー) - 用語集 | MDN
そのためJavaScriptで same-origin に設定してもブラウザ側で正しい cross-site が設定され、419エラーとなりました
ブラウザ側で拒否されてもcurlで叩けばsame-originし放題やろ?
と、私は一瞬思いました
curl -X POST http://localhost/admin/delete-all-db \
-H "Sec-Fetch-Site: same-origin" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "agree=1&aikotoba=ICanDoIt" \
-v
結果
HTTP/1.1 302 Found
Location http://localhost/admin/login
419エラーにはなりませんでしたが、ログイン画面に飛ばされましたね
そもそもCSRF攻撃は「正規のWebシステムにログイン済みであるブラウザ」で「罠サイトから正規のWebシステムにリクエストを飛ばして」初めて成り立つ攻撃です
なのでいくらcurlで Sec-Fetch-Site: same-origin を指定しようが、ユーザーが認証済みのCookie laravel-session の値を攻撃者側が知らないことにはログイン後の画面は攻撃できません
※laravel-session を入手したうえで行う攻撃はセッションハイジャック攻撃と呼ばれ、CSRF攻撃とはまた別のものとなります
curl -X POST http://localhost/admin/delete-all-db \
-H "Sec-Fetch-Site: cross-site" \
-H "Content-Type: application/x-www-form-urlencoded" \
-b "laravel-session=ey******************" \
-d "agree=1&aikotoba=ICanDoIt" \
-v
ログイン済みにした laravel-session の値を持ってきて Sec-Fetch-Site: cross-site でリクエストを投げてみると
HTTP/1.1 419 unknown status
しっかりと419が返ってきました
Good Bye @csrf...?
これで毎回form内に @csrf を書かずに済むわぁと思ったそこのあなた、もうちょっとゆっくりしていきましょう
Sec-Fetch-Site ヘッダーはブラウザが自動的に付与するものでしたよね
つまり、ブラウザが対応していないと付与されずに検証に失敗し、419エラー画面が表示されます
それぞれ以下のバージョンから対応したようです
| ブラウザ | 対応バージョン | リリース時期 |
|---|---|---|
| Chrome | 76 | 2019-07-30 |
| Safari(Mac) | 16.4 | 2023-03-27 |
| Chrome Android | 76 | 2019-07-30 |
| Safari on iOS | 16.4 | 2023-03-27 |
Sec-Fetch-Site ヘッダー - HTTP | MDN
2026年現在からするとSafariはわりと最近なんですね
アップデートできない端末等、システムの要件的に対応前のブラウザを含めないといけない場合、今まで同様 @csrf を含めないとPOSTする度に419エラーとなってしまい、ログインすらできないシステムが完成してしまいます
また、そもそも Sec-Fetch-Site ヘッダーは信頼できるURL( https:// だったり localhost だったり)の場合のみ付与される仕様です
Fetch Metadata Request Headers
信頼できないURLの場合はSec-Fetch-Site ヘッダーは付与されないため、今まで同様 @csrf を含めないとPOSTする度に419エラーとなってしまい、これまたログインすらできないシステムが完成してしまいます
とはいえ結果的に @csrf を消しても動くケースは多いかもしれませんが、Laravelが @csrf の廃止を推奨しているわけではないです。
多層防御の観点からも、残念ながら今まで通り @csrf は必ず記述すべきですね
おまけ
何故このCSRF対策の変更に気づいたのか、それは普段からLaravelのドキュメントを片っ端から頭に入れているからです
...という綺麗な気づき方ではなく、419エラーを起こそうとして @csrf を消したものの419エラーは発生せず
これいつの間にかCSRF対策無効化してしまっているのでは?と誤った方向で原因探求を始めてしまい、ミドルウェアも各所でwithoutしていないことを確認し万策尽きた状態で一服
そういえばLaravel13使うのは今回が初めてだと思い、アップグレードガイドを確認して発見できました
この記事でLaravel13にて419エラーを起こそうとして起きずに20分ぐらいを浪費する人が減ると幸いです
株式会社BTMではエンジニアの採用をしております。
ご興味がある方は是非こちらをご覧ください。