
CSRFとは?Djangoでの守り方と、開発中に出る「CSRF検証に失敗」画面の意味
Django で作ったサイトのログイン画面などから送信したとき、「Forbidden (403)」「CSRF verification failed. Request aborted.」という画面が出ることがあります(日本語の設定では「CSRF検証に失敗したため、リクエストは中断されました。」)。これは故障ではなく、CSRFという攻撃を防ぐための Django の仕組みが、送信を止めた結果です。開発中は、攻撃を受けていなくても、テンプレートの書き忘れや設定の不足で、この画面が出ることがあります。
この記事では、CSRF(クロスサイト・リクエスト・フォージェリ)とはどのような攻撃か、なぜ危ないのか、Django がどのように防いでいるのかを、Django 6.1.3 で実際に動かした結果とあわせて説明します。後半では、開発中にこの画面が出たときに、何を意味しているのか、どこを直せばよいのかも扱います。本文の[1]のような番号は、押すと出典のページが開きます。
Django の仕組みは、以前の記事「DjangoのORMとマイグレーションの仕組み」と「Nginx・Gunicorn・Djangoの関係を整理する」でも扱いました。あわせてご覧ください。
まず用語をそろえる
CSRF の話に入る前に、よく出てくる言葉を整理します。
リクエスト:ブラウザーがサーバーに送る「このページを見せてほしい」「この内容を登録してほしい」という依頼のことです。
GET と POST:リクエストの種類です。GET はページを見るとき、POST はフォームの内容を送って登録・変更するときに使います。
Cookie(クッキー):サーバーがブラウザーに預ける小さな文字列です。ブラウザーは、同じサイトにリクエストを送るたびに、預かった Cookie を自動で付けて送ります。
セッション:ログインしている状態を保つ仕組みです。Django は、ログインに成功した利用者のブラウザーに sessionid という Cookie を預け、次のリクエストからはその値で「誰がログインしているか」を見分けます。
オリジン:「https」などの方式、「example.com」などのホスト名、ポート番号の3つの組み合わせです。3つがすべて同じページどうしを、同じオリジンと呼びます[1]。
403:サーバーがリクエストを受け取ったうえで、処理を拒んだことを示す番号です。

この「Cookie を自動で付けて送る」という性質が、あとで説明する CSRF の原因になります。
CSRF:ログイン中の利用者に、別のサイトから送信させる
CSRF(クロスサイト・リクエスト・フォージェリ)は、攻撃者が用意したサイトに置いたリンクやフォーム、スクリプトを使い、ログイン中の利用者の権限で、本来のサイトの操作をさせる攻撃です[2]。IPA は、ログインした利用者からの送信について、本人が意図した送信かどうかを見分ける仕組みを持たないサイトは、外部のサイトを経由した悪意のある送信を受け入れてしまう場合がある、と説明しています[3]。
起こりうる被害として、IPA は不正な送金、意図しない商品の購入や退会処理、ログインした利用者だけが編集できる情報の書き換えなどを挙げています[3]。
なぜ別のサイトから送信できるのか
攻撃の流れは次のとおりです。ここでは、会員サイトの「登録メールアドレスの変更」を例にします。
利用者が会員サイトにログインしている。ブラウザーには sessionid の Cookie がある
利用者が、攻撃者の用意したページを開く
そのページに隠されたフォームが、会員サイトのメールアドレス変更の画面へ、自動で送信される
ブラウザーは、送信先が会員サイトなので、会員サイトの Cookie を付けて送る
会員サイトは、ログイン中の本人からの送信と区別できず、メールアドレスを攻撃者のものに書き換える
メールアドレスが攻撃者のものに変われば、パスワードの再設定のメールも攻撃者に届くことになります。OWASP(ウェブのセキュリティの国際的な団体)も、ブラウザーのリクエストにはセッションの Cookie を含むすべての Cookie が自動で付くため、対策のないサイトは正規の送信と偽の送信を見分けられない、と説明しています[4]。

ここで大事なのは、ブラウザーの「書き込みはできるが、読み込みはできない」という決まりです。
MDN(ウェブ技術の解説文書)によると、異なるオリジンへの書き込み、たとえばリンクやフォームの送信は概して許可されますが、異なるオリジンからの読み込みは一般に許可されません[1]。この決まりを同一オリジンポリシーと呼びます。攻撃者のページは、会員サイトへ送信することはできますが、会員サイトのページの中身や Cookie を読むことはできません。

実際のブラウザーで試した結果
本当に別のサイトから書き換えられるのかを、実際に試しました。記事用に、会員サイト(localhost:8000)と、攻撃役のページ(127.0.0.1:8001)を用意しました。ホスト名(localhost と 127.0.0.1)が違うため、ブラウザーは2つを別のサイトとして扱います。
手順は、①会員サイトにログインする、②同じブラウザーで攻撃役のページを開く、③会員サイトの登録メールアドレスが書き換わったかを確かめる、の3つです。攻撃役のページは画面に「当選しました!」とだけ表示し、裏で会員サイトへ送信します。ブラウザーは Chromium(Google Chrome のもとになっているブラウザー)を使いました。
比べた3つの作り方
攻撃が成功するかどうかは、会員サイトの作り手が「メールアドレスの変更」をどう作ったかで変わります。そこで、会員サイトの側を次の3通りに作り分けました。
作り方A:URL を開くだけで変更される作り。/email-get/?email=新しいアドレス という URL を開くと、?email= の後ろに書いたアドレスに変わります。ページを見るときと同じ GET のリクエストで、変更まで行ってしまう作りです。攻撃役のページは、この URL へ移動するだけで攻撃できます
作り方B:フォームで送信する作り。ただし CSRF の検証を外している。変更は POST で受け付けますが、@csrf_exempt という指定で Django の CSRF の検証を外しています。攻撃役のページは、隠したフォームを自動で送信します
作り方C:フォームで送信し、Django の CSRF の検証を通す作り。Django の初期設定のままです。攻撃役のページは、作り方B と同じように、隠したフォームを自動で送信します

Cookie の SameSite という設定も変えた
もう1つ変えたのが、sessionid の Cookie の SameSite という設定です。SameSite は、別のサイトから始まったリクエストに、その Cookie を付けてよいかをブラウザーに伝える指定です。
Lax(Django の初期値):別のサイトのリンクなどから移動してページを開くとき(GET)は、Cookie を付けます。別のサイトから POST で送信するときは、付けません[5]
None:別のサイトからのリクエストにも、いつも Cookie を付けます
Cookie が付かなければ、会員サイトはログインしていない人からの送信として扱うため、書き換えは起きません。
結果
作り方A:Lax でも None でも、書き換えられた。URL への移動は GET なので、Lax でも Cookie が付いた
作り方B:Lax では Cookie が付かず、ログイン画面に移されて書き換えられなかった。None では書き換えられた
作り方C:Lax でも None でも、403 で止まった

この結果から分かることは2つあります。1つは、作り方A のようにGET で変更する作りは、SameSite が Lax でも防げないことです。OWASP は、状態を変える操作に GET で届くなら SameSite=Lax では防げず、これが SameSite に頼る対策が実際に破られる最も多い形だと説明しています[4]。
Django の公式文書も、CSRF への最初の守りは、GET などの「安全な」メソッドで副作用を起こさないことだとしています[2]。ページを見るための GET では何も変更せず、変更は POST で受け付けるのが基本です。
もう1つは、作り方B が Lax で助かったのは、ブラウザーが Cookie を付けなかったおかげにすぎないことです。SameSite を None にすれば、作り方B は書き換えられました。どちらの設定でも止めたのは、Django の CSRF の検証を通した作り方C だけです。
SameSite と Django の対策の移り変わり
SameSite による守りは、ここ数年で広がりました。
2018年8月:Django 2.1 で、セッションと CSRF の Cookie に SameSite=Lax が初期設定で付くようになった[6]
2020年2月:Chrome 80 で、SameSite の指定がない Cookie を Lax として扱う仕組みを、段階的に始めた[7]。2020年4月に一時中断し、2020年7月の Chrome 84 の公開にあわせて再開した[8]
2021年12月:Django 4.0 で、CSRF の検証が Origin ヘッダー(送信元のオリジン)も照合するようになった[9]
2026年8月:Django 6.1 が公開された[10]。この記事の動作は、Django 6.1.3 で確かめた

それでも、SameSite だけに頼ることは勧められていません。OWASP は、SameSite は多層の守りの1つとしては有用だが、多くの場合、本来の CSRF 対策の代わりにはならないとしています[4]。指定のない Cookie を Lax として扱うのは Chromium 系のブラウザーで、Firefox と Safari はそうしていない、とも書いています[4]。
Django は「トークン」で、自分のページから送られたかを見分ける
Django の CSRF 対策は、トークンという推測できない文字列を使います。公式文書の説明をもとに、仕組みを順に見ます[2]。
CSRF の Cookie:ランダムな秘密の値を、csrftoken という Cookie で利用者のブラウザーに預けます。ほかのサイトは、この値を読めません
フォームの隠し項目:POST のフォームには、csrfmiddlewaretoken という隠し項目が入ります。テンプレートに {% csrf_token %} と書くと作られます
照合:フォームの送信のような、ページを見るだけではないリクエスト(POST など)が届くと、CSRF の Cookie があり、隠し項目の値が正しいことを確かめます。そうでなければ 403 を返します
実際にログイン画面を開くと、Cookie には32文字、隠し項目には64文字の値が入っていました。

前の節で見たとおり、攻撃者のページは、会員サイトへ送信することはできても、ページの中の隠し項目や Cookie の値を読めません。そのため、正しいトークンを付けた送信を作れず、Django はそれを 403 で止めます。トークンが、同一オリジンポリシーの「読めない」ことを利用した仕組みであることが分かります。
なお、この仕組みは、サイトのページに攻撃者のスクリプトを入り込ませる XSS(クロスサイト・スクリプティング)という別の脆弱性がないことを前提にしています。Django の公式文書は、XSS の脆弱性があれば、攻撃者は CSRF でできることをすべて行えるうえ、さらに悪いこともできると明記しています[2]。
隠し項目の値は、表示のたびに変わる
同じ画面を2回開くと、Cookie の値は同じなのに、隠し項目の値は毎回違っていました。公式文書によると、隠し項目の値は秘密そのものではなく、BREACH という攻撃への対策として、表示のたびにランダムな「マスク」で変えてあります。照合するときは、マスクを外した秘密だけを Cookie と比べます[2]。

送信元のサイトも確かめる(Origin と Referer)
ブラウザーは、フォームを送信するとき、「どのサイトのページから送ったか」を Origin という欄(ヘッダー)に書いて付けます。Django は、トークンに加えて、この Origin が自分のサイトか、CSRF_TRUSTED_ORIGINS という設定に書いた信頼するサイトと一致するかを確かめます[2]。
Origin が付いていない送信もあります。HTTPS のサイトでは、そのときは代わりに Referer(送信元のページの URL)を見て、同じサイトから送られたかを厳しく確かめます[2]。
先ほどの実験の作り方C で 403 になったときの理由は、「Origin checking failed - http://127.0.0.1:8001 does not match any trusted origins.」でした。攻撃役のページのオリジンが、信頼するオリジンに入っていないため、トークンを確かめる前に止まっています。
ここまでをまとめると、Django は、届いたリクエストを次の順に確かめます。

使う側が書くのは、ほとんど1行
Django で新しくプロジェクトを作ると、設定の MIDDLEWARE に CsrfViewMiddleware が初めから入っています。公式文書の手順でも、CSRF のミドルウェアは初期設定で有効で、POST のフォームを使うテンプレートには、<form> の中に {% csrf_token %} を書くこととされています[11]。
<form method="post">
{% csrf_token %}
...
</form>外部のサイトへ送るフォームには、このタグを書いてはいけません。トークンが外部に漏れ、脆弱性につながるためです[11]。
ログイン画面でも、なぜ CSRF を確かめるのか
ログインする前の利用者には、まだ守るべきセッションがないように見えます。それでも Django は、ログイン画面の送信も CSRF の検証の対象にしています。公式文書は、攻撃者のサイトが利用者のブラウザーに、別人のアカウントでログインさせる「ログインCSRF」も防ぐと明記しています[2]。
OWASP は、ログインCSRF の例として、買い物サイトで利用者を攻撃者のアカウントにログインさせ、利用者がそのままクレジットカードの情報を入力すると、攻撃者がその情報で買い物できるおそれがある、と説明しています[4]。利用者は自分のアカウントだと思って入力するため、気づきにくい攻撃です。

ログインで 403 が出る、よくある原因
ここからは、Django を使っていて 403 に出会ったときの見方です。DEBUG = True の開発中は、403 の画面に「Reason given for failure(失敗の理由)」として、原因の短い文が表示されます。本番の設定(DEBUG = False)では理由は表示されず、ログに記録されます[11]。

Django 6.1.3 で試したところ、理由の文は次のように出ました。
CSRF token missing.:隠し項目もヘッダーもない。テンプレートに {% csrf_token %} を書き忘れているときに出ます。JavaScript の fetch で送るときは、csrftoken の Cookie の値を X-CSRFToken というヘッダーに付けて送ります[11]
CSRF cookie not set.:CSRF の Cookie がない。ブラウザーが Cookie を受け付けていないときなどに出ます
CSRF token from POST incorrect.:トークンが Cookie の秘密と合わない。別のタブでログインしたあとや、ログインしたあとに戻るボタンで前のフォームから送ったときに出ます
Origin checking failed - … does not match any trusted origins.:送信元のオリジンが信頼するオリジンと合わない。別のサイトからの送信のほか、次に説明する HTTPS の設定でも出ます

別のタブでログインすると、前のフォームは使えなくなる
公式文書のよくある質問によると、CSRF のトークンは、安全のため、ログインのたびに取り替えられます。ログインより前に作られたフォームは古いトークンを持っているため、ページを読み込み直す必要があります。戻るボタンを使ったときや、別のタブでログインしたときに起こります[2]。
実際に、2つのタブでログイン画面を開き、片方でログインしてから、もう片方で送信すると、「CSRF token from POST incorrect.」で 403 になりました。ログインの前と後で、Cookie の値が替わっていました。ページを読み込み直してから送信すると、ログインできました。

Nginx の後ろで HTTPS を使うと、Origin が合わないことがある
以前の記事で扱ったように、Django は Nginx などのサーバーの後ろで動かすことが多く、HTTPS の暗号化は Nginx が受け持つ構成がよくあります。HTTPS そのものの仕組みは、記事「ドメイン・DNS・HTTPSのつながりを図で整理する」で扱いました。
この場合、Nginx から Django へは HTTP で渡るため、Django は「HTTP で来た」と認識します。ブラウザーの Origin は「https://〜」なのに、Django が考える自分のオリジンは「http://〜」になり、照合が合わずに 403 になります。
実際に、HTTPS の Origin を付けて送信すると、何も設定しない状態では「Origin checking failed - https://localhost does not match any trusted origins.」になりました。次のどちらかを設定すると、ログインできました。
SECURE_PROXY_SSL_HEADER:Nginx の設定で付ける X-Forwarded-Proto ヘッダーを見て、元の接続が HTTPS かを Django に判断させる設定です。公式文書は、Nginx などがこのヘッダーを正しく付け替えることを確かめたうえでのみ設定するよう、強く注意しています[5]
CSRF_TRUSTED_ORIGINS:信頼するオリジンを書き足す設定です。Django 4.0 からは、「https://」のような方式まで含めて書く必要があります[9]

403 を避けるために @csrf_exempt で検証を外すことは、実験の作り方B(SameSite が None のとき)のとおり、攻撃を通す作りにつながります。公式文書も、どうしても必要な場合を除き、csrf_exempt を付けるときは十分に注意するよう求めています[12]。原因の文を読み、設定やテンプレートを直すのが基本です。
まとめ
CSRF は、ログイン中の利用者のブラウザーに、別のサイトから本人の意図しない送信をさせる攻撃。ブラウザーが Cookie を自動で付けることが原因
別のサイトのページは、送信はできても、ページの中身や Cookie を読めない(同一オリジンポリシー)
Django は、攻撃者のページが読めないトークンと、Origin・Referer の照合で、自分のページからの送信かを見分ける。使う側は、POST のフォームに {% csrf_token %} を書く
SameSite=Lax は守りを厚くするが、GET で変更する作りは防げない。状態を変える操作は POST にする
ログイン画面も、ログインCSRF を防ぐために検証の対象になる
ログインで 403 が出たら、画面やログの理由の文を読む。タグの書き忘れ、別のタブでのログイン、HTTPS の構成と Origin の不一致がよくある原因

CSRF の対策は、「ブラウザーから届いた送信を、そのまま本人の操作とは信じない」という考え方にもとづいています。Django は初期設定のままでこの対策が働くように作られていますが、csrf_exempt のように守りを外す書き方もあります。403 の画面は、その守りが働いている合図として読むことができます。
免責事項
この記事は、筆者が個人として調べたことや経験をもとに、執筆時点の内容をまとめたものです。分かりやすさを優先し、細かい条件や例外を省いている場合があります。
動作は Django 6.1.3 と Chromium で確かめたもので、バージョンや設定、ブラウザーによって変わることがあります。実際の開発では、公式の文書で最新の内容を確認し、本番の前に検証してください。この記事は、攻撃の手順を示すものではなく、自分の管理するサイトを守るための説明です。
製品の仕様などは変わることがあります。この記事の内容を利用して生じた損害については、責任を負いかねます。
NDシステムズについて
NDシステムズは、福岡県久留米市を拠点に、ホームページの制作、業務に合わせた事務のシステムの開発、AI・DX支援を行っています。まずはお気軽に無料相談でご相談ください。
参考文献
Cross Site Request Forgery protection(Django documentation、Django 6.1)(英語)
安全なウェブサイトの作り方 - 1.6 CSRF(クロスサイト・リクエスト・フォージェリ)(IPA 独立行政法人 情報処理推進機構)
Cross-Site Request Forgery Prevention Cheat Sheet(OWASP Cheat Sheet Series)(英語)
SameSite Cookie Changes in February 2020: What You Need to Know(Chromium Blog)(英語)
How to use Django's CSRF protection(Django documentation、Django 6.1)(英語)