# dokumentasi Django 2.2.9.dev20191202104323

# Perlindungan clickjacking

Middleware clickjacking dan penghias menyediakan perlindungan mudah-digunakan terhadap clickjacking. Serangan jenis ini muncul ketika sebuah situs berbahaya memperdaya pengguna mengklik pada unsur tersembunyi dari situ selain yang mereka telah muat di kerangka tersembunyi atau iframe.

## Sebuah contoh dari clickjacking

Andaikan sebuah toko daring mempunyai sebuah halaman dimana pengguna masuk dapat mengklik "Buy Now" untuk membeli sebuah barang. Seorang pengguna telah memilih untuk tetap masuk kedalam toko sepanjang waktu untuk kenyamanan. Seorang penyerang situs mungkin membuat sebuah tombol "I Like Ponies" pada satu dari halaman mereka sendiri, dan memuat halaman toko di iframe transparan sehingga tombol "Buy Now" tidak terlihat melapisi pada tombol "I Like Ponies". Jika pengguna mengunjungi situ spenyerang, mengklik "I Like Ponies" akan menyebabkan klik tidak sengaja pada tombol "Buy Now" dan pembelian tidak diketahui dari barang.

## Mencegah clickjacking

Permban modern menghargai kepala HTTP X-Frame-Options yang menunjukkan apakah atau tidak sumber daya diizinkan memuat dalam sebuah kerangka atau iframe. Jika tanggapan mengandung kepala dengan sebuah nilai dari `SAMEORIGIN` kemudian peramban akan hanya memuat sumber daya di sebuah ekrangka jika permintaan berasal dari situ sama. Jika kepala disetel menjadi `DENY` kemudian peramban akan memblok sumber daya dari memuat dalam sebuah kerangka tidak peduli situs mana membuat permintaan.

Django menyediakan sedikit cara mudah untuk menyertakan kepala ini dalam tanggapan dari situs anda:

1. Sebuah middleware sederhana yang menyetel kepala di semua tanggapan.
2. Sekumpulan dari penghias tampilan yang dapat digunakan untuk menimpa middleware atau untuk hanya menyetel kepala untuk tampilan tertentu.

Kepala HTTP `X-Frame-Options` akan hanya disetel dengan middleware atau penghias tampilan jika itu belum hadir di tanggapan.

## Bagaimana menggunakannya

### Megnatur `X-Frame-Options` untuk semua tanggapan

Untuk menyetel nilai `X-Frame-Options` untuk semua tanggapan di situs anda, taruh `'django.middleware.clickjacking.XFrameOptionsMiddleware'` pada `MIDDLEWARE`:

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

Middleware diadakan di berkas pengaturan dibangkitkan oleh `startproject`.

Secara awalan, middleware akan menyetel kepala `X-Frame-Options` ke `SAMEORIGIN` untuk setiap keluaran `HttpResponse`. Jika anda ingin `DENY` sebagai gantinya, setel pengaturan `X_FRAME_OPTIONS`:

    X_FRAME_OPTIONS = 'DENY'

Ketika menggunakan middleware ada mungkin beberapa tampilan dimana dan tidak ingin menyetel kepala `X-Frame-Options`. Untuk kasus-kasus tersebut, anda dapat menggunakan sebuah tampilan penghias yang memeribtahu middleware tidak menyetel kepala:

    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.")

Catatan

Jika anda ingin mengajukan sebuah formulir atau mengakses sebuah kue sesi dalam sebuah kerangka atau iframe, anda mungkin butuh merubah pengaturan `CSRF_COOKIE_SAMESITE` or `SESSION_COOKIE_SAMESITE`.

### Mengatur `X-Frame-Options` per tampilan

Untuk menyetel kepala `X-Frame-Options` pada dasar pertampilan, Django menyediakan penghias ini:

    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.")

Catat bahwa anda dapat menggunakan penghias di penghubungan dengan middleware. Gunakan penghias menimpa middleware.

## Batasan

Kepala `X-Frame-Options` akan hanya melindungi terhadap clickjacking di peramban modern. Peramban terlama akan secara diam mengabaikan kepala dan butuh other clickjacking prevention techniques.

### Peramban yang mendukung `X-Frame-Options`

- Internet Explorer 8+
- Firefox 3.6.9+
- Opera 10.5+
- Safari 4+
- Chrome 4.1+

### Lihat juga

Sebuah complete list dari peramban mendukung `X-Frame-Options`