Referer

Penggunaan

Header Referer dikirim oleh klien (browser, pustaka HTTP) untuk menunjukkan URL halaman atau sumber daya yang menautkan ke sumber daya yang diminta. Ketika pengguna mengeklik sebuah tautan di https://example.re/page, browser mengirimkan alamat halaman penaut tersebut pada header Referer bersama permintaan berikutnya.

Catatan

Nama header “Referer” adalah salah eja historis dari kata bahasa Inggris “referrer”. Spesifikasi HTTP yang asli memperkenalkan salah ketik ini, dan memperbaiki ejaannya sekarang akan merusak implementasi yang sudah ada. Bentuk yang salah eja itu tetap menjadi nama resmi header tersebut.

Header ini memiliki beberapa tujuan. Sistem analitik mengandalkan perujuk untuk melacak sumber lalu lintas. Server menggunakan nilainya untuk pencatatan log dan kontrol akses. Mesin pencari secara historis memanfaatkan data perujuk untuk memahami hubungan tautan antarhalaman.

Header respons Referrer-Policy mengontrol seberapa banyak informasi yang disertakan header Referer. Kebijakannya berkisar dari mengirim URL lengkap (unsafe-url), mengirim hanya origin (origin), sampai menghilangkan header tersebut sepenuhnya (no-referrer). Sebagian besar browser menggunakan strict-origin-when-cross-origin secara bawaan, yang mengirim URL lengkap untuk permintaan same-origin dan hanya origin untuk permintaan lintas asal.

Header Referer tidak dikirim pada permintaan dari halaman HTTPS ke halaman HTTP (sebuah downgrade) di bawah kebijakan bawaan. Pengenal fragmen dan kredensial tidak pernah disertakan dalam nilainya.

URL absolut

URL lengkap termasuk skema, host, path, dan string kueri. Permintaan same-origin umumnya menyertakan URL lengkapnya.

Referer: https://example.re/articles/http-headers?page=2

Hanya origin

Skema dan host tanpa path atau string kueri. Dikirim untuk permintaan lintas asal di bawah kebijakan bawaan browser.

Referer: https://example.re/

Kosong atau tidak ada

Header dihilangkan sepenuhnya ketika Referrer-Policy disetel ke no-referrer, ketika permintaan berasal dari URL yang ditandai sebagai bookmark, ketika URL diketikkan langsung ke bilah alamat, atau saat terjadi downgrade dari HTTPS ke HTTP di bawah kebijakan bawaan.

Contoh

Browser yang mengikuti sebuah tautan dari halaman hasil pencarian mengirimkan URL pencarian sebagai perujuk. Server yang menerima permintaan tersebut melihat dari mana pengunjung berasal.

Referer: https://search.example.re/results?q=http+headers

Permintaan lintas asal dari halaman yang aman hanya mengirimkan bagian origin di bawah kebijakan bawaan strict-origin-when-cross-origin.

Referer: https://example.re/

Sumber daya yang dimuat pada origin yang sama menyertakan path dan string kueri lengkap di dalam nilai perujuk.

Referer: https://example.re/docs/guide?section=headers