Django 5.2.8 ドキュメント

Home | Table of contents | Index | Modules

« previous | up | next »

クリックジャッキング対策

The clickjacking middleware and decorators provide easy-to-use protection against clickjacking. This type of attack occurs when a malicious site tricks a user into clicking on a concealed element of another site which they have loaded in a hidden frame or iframe.

クリックジャッキングの例

オンラインストアに、ログイン中のユーザーが商品を購入できる「今すぐ購入」ボタンのあるページがあるとします。ユーザーは利便性のために常にストアにログインしたままにしています。攻撃者は、自分のウェブサイトのページに「私はポニーが好き」という投票ボタンを作成した上で、ストアのページを透明な iframe として読み込ませ、「今すぐ購入」ボタンをその「私はポニーが好き」ボタンの位置に不可視のまま重ね合わせます。もしユーザーが攻撃者のサイトを訪れ、「私はポニーが好き」をクリックすると、意図せず「今すぐ購入」ボタンがクリックされ、ユーザーが知らないうちに商品を購入してしまいます。

クリックジャッキングを防止する

モダンブラウザでは、frame や iframe の中にあるリソースをロードして良いかどうかを示す X-Frame-Options HTTP ヘッダの指定を尊重します。もしサーバからのレスポンスに SAMEORIGIN という値を指定した X-Frame-Options ヘッダが含まれていた場合、ブラウザは frame 中のリソースが同一サイトに由来する場合に限り、そのリソースをロードします。もしヘッダが DENY に設定されていた場合、どのサイトがリクエスト元であろうとブラウザは frame 中のリソースのロードを問答無用でブロックします。

Django はこのヘッダをレスポンスに含めるための方法をいくつか提供します:

1. すべてのレスポンスにこのヘッダを設定するミドルウェア

2. そのミドルウェアの動作をオーバーライドする、または単純に特定のビューにだけこのヘッダを設定するデコレータのセット

X-Frame-Options HTTP ヘッダは、まだそれがレスポンス中に存在しない場合に、ミドルウェアまたはビューのデコレータでのみ設定されます。

使用方法

X-Frame-Options をすべてのレスポンスに設定する

サイト内のすべてのレスポンスに対して同じ X-Frame-Options 値を設定するには、'django.middleware.clickjacking.XFrameOptionsMiddleware' を MIDDLEWARE に追加します:

MIDDLEWARE = [
    ...,
    "django.middleware.clickjacking.XFrameOptionsMiddleware",
    ...,
]

このミドルウェアは、startproject が生成する設定ファイルでは最初から有効化されています。

デフォルトでは、このミドルウェアはすべての HttpResponse の X-Frame-Options ヘッダを DENY に設定します。もし他の値にしたい場合は X_FRAME_OPTIONS を次のように設定します:

X_FRAME_OPTIONS = "SAMEORIGIN"

このミドルウェアを使うにあたって、いくつかのビューでは X-Frame-Options ヘッダを 設定したくない かもしれません。そのような場合にはヘッダを設定しないよう、ビューデコレータでミドルウェアに指示できます:

from django.http import HttpResponse
from django.views.decorators.clickjacking import xframe_options_exempt


@xframe_options_exempt
def ok_to_load_in_a_frame(request):
    return HttpResponse("This page is safe to load in a frame on any site.")

注釈

フレームやiframe内でフォームを送信したり、セッションクッキーにアクセスしたい場合は、 CSRF_COOKIE_SAMESITE や SESSION_COOKIE_SAMESITE の設定を変更する必要があるかもしれません。

Setting X-Frame-Options をビューごとに設定する

X-Frame-Options ヘッダをビューごとに設定するために、Django は次のようなデコレータを提供しています:

from django.http import HttpResponse
from django.views.decorators.clickjacking import xframe_options_deny
from django.views.decorators.clickjacking import xframe_options_sameorigin


@xframe_options_deny
def view_one(request):
    return HttpResponse("I won't display in any frame!")


@xframe_options_sameorigin
def view_two(request):
    return HttpResponse("Display in a frame if it's from the same origin as me.")

なお、これらのデコレータはミドルウェアとともに使うことができます。 デコレータの指定は、ミドルウェアの指定よりも優先されます。

制限事項

X-Frame-Options ヘッダーは、モダンブラウザ においてのみクリックジャッキングに対する保護を提供します。

Last update:

12月 03, 2025

« previous | up | next »