Pengertian
Content Security Policy (CSP) adalah mekanisme keamanan browser yang membatasi sumber daya mana yang boleh dimuat dan dijalankan oleh sebuah halaman. CSP dikirim sebagai header HTTP, misalnya Content-Security-Policy: default-src 'self', lalu browser menolak skrip, gaya, gambar, atau font yang tidak masuk dalam daftar yang diizinkan.
Untuk website statis, CSP terasa sedikit aneh: tidak ada server aplikasi yang bisa diproteksi langsung. Namun justru di situlah CSP berguna. Halaman statis sering menyisipkan skrip analitik, font dari CDN, tombol media sosial, atau kode pihak ketiga lainnya. Tanpa CSP, semua skrip itu berjalan dengan hak yang sama dengan skrip Anda sendiri. Jika salah satu pihak ketiga disusupi, browser akan menjalankan kode jahat itu seolah-olah berasal dari situs Anda.
CSP juga membantu menekan risiko cross-site scripting (XSS). Walaupun konten utama berupa Markdown yang sudah di-render menjadi HTML, ada kalanya komentar, formulir, atau parameter URL tercetak kembali ke halaman. CSP bukan pengganti sanitasi, tetapi lapisan pertahanan tambahan yang efektif.
Kelebihan
- Mengurangi dampak XSS: skrip injeksi tidak jalan meskipun berhasil masuk ke halaman.
- Kontrol pihak ketiga: Anda menentukan domain mana yang boleh memasok skrip, font, dan gambar.
- Cocok untuk static hosting: cukup menambahkan header di
vercel.json,netlify.toml, atau konfigurasi Nginx tanpa mengubah aplikasi. - Terlihat jelas saat ada pelanggaran: DevTools mencatat setiap sumber yang ditolak beserta direktif yang melanggar.
- Meningkatkan skor keamanan: pemeriksa header seperti Security Headers atau Mozilla Observatory memberi penilaian langsung.
Kekurangan
- Bisa memecah halaman jika terlalu ketat: satu skrip CDN yang terlupa akan diblokir.
- Butuh penyesuaian untuk inline script: setiap blok
<script>harus diberi hash atau nonce. - Tidak semua direktif didukung meta tag:
frame-ancestorsdanreport-urihanya bisa lewat header HTTP. - Perlu perawatan: menambah layanan baru berarti memperbarui daftar sumber yang diizinkan.
- Tidak menggantikan sanitasi input: CSP memperkecil dampak, bukan menghapus sumber masalah.
Catatan penting: Mulailah dengan Content-Security-Policy-Report-Only, bukan langsung memberlakukan kebijakan. Mode ini hanya mencatat pelanggaran ke konsol sehingga Anda bisa melengkapi daftar sumber sebelum beralih ke mode enforce.
Direktif yang Paling Sering Dipakai
| Direktif | Fungsi | Contoh nilai |
|---|---|---|
default-src | Fallback untuk semua jenis sumber | 'self' |
script-src | Sumber skrip yang boleh dijalankan | 'self' https://cdn.jsdelivr.net |
style-src | Sumber CSS dan gaya inline | 'self' 'unsafe-inline' |
font-src | Sumber berkas font | https://fonts.gstatic.com |
img-src | Sumber gambar | 'self' data: https: |
connect-src | Tujuan fetch, XHR, WebSocket | 'self' https://api.example.com |
object-src | Plugin seperti Flash atau PDF lama | 'none' |
base-uri | Mencegah tag <base> disisipkan penyerang | 'self' |
form-action | Tujuan pengiriman formulir | 'self' |
frame-ancestors | Mencegah halaman dibingkai pihak lain | 'none' |
upgrade-insecure-requests | Mengubah HTTP menjadi HTTPS | tanpa nilai |
Kata kunci 'self' berarti origin yang sama dengan halaman. 'none' melarang semua sumber. Sementara 'unsafe-inline' mengizinkan atribut gaya dan skrip langsung di HTML. Hindari 'unsafe-inline' pada script-src jika memungkinkan, karena itu justru melemahkan perlindungan XSS.
Contoh Kebijakan Awal
Misalkan website statis hanya memuat CSS, JavaScript, dan font dari domain sendiri, ditambah font dari jsDelivr. Kebijakan yang masuk akal:
Content-Security-Policy: default-src 'self'; base-uri 'self'; object-src 'none'; frame-ancestors 'none'; form-action 'self'; script-src 'self'; style-src 'self' 'unsafe-inline' https://cdn.jsdelivr.net; font-src 'self' https://cdn.jsdelivr.net https://fonts.gstatic.com; img-src 'self' data: https:; connect-src 'self'Baris di atas sengaja dibuat satu baris karena nilai header HTTP tidak boleh mengandung baris baru. Agar lebih mudah dirawat, simpan sebagai satu string di konfigurasi deploy. Di Vercel, tambahkan entri header baru pada vercel.json:
{
"headers": [
{
"source": "/(.*)",
"headers": [
{
"key": "Content-Security-Policy-Report-Only",
"value": "default-src 'self'; base-uri 'self'; object-src 'none'; frame-ancestors 'none'; form-action 'self'; script-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline' https://cdn.jsdelivr.net; font-src 'self' https://cdn.jsdelivr.net https://fonts.gstatic.com; img-src 'self' data: https:; connect-src 'self'"
}
]
}
]
}Perhatikan bahwa aturan cache untuk aset tetap bisa hidup berdampingan dengan aturan CSP. Vercel menggabungkan semua header yang cocok dengan suatu URL. Setelah yakin tidak ada pelanggaran, ganti nama Content-Security-Policy-Report-Only menjadi Content-Security-Policy dan hapus 'unsafe-inline' dari script-src bila semua skrip sudah bisa ditandatangani.
Untuk Nginx, versinya lebih singkat:
add_header Content-Security-Policy "default-src 'self'; object-src 'none'; base-uri 'self'; frame-ancestors 'none'" always;Kata always memastikan header tetap dikirim pada respons error seperti 404 dan 500.
Menangani Inline Script dengan Hash
Banyak halaman statis menyimpan kecil potongan JavaScript langsung di HTML, misalnya untuk inisialisasi tema atau menu. CSP memblokirnya kecuali Anda memberi izin. Cara paling aman adalah memasukkan hash SHA-256 dari isi skrip ke dalam script-src.
Hitung hash dengan perintah berikut:
printf %s 'console.log("halo")' | openssl dgst -sha256 -binary | openssl base64Hasilnya berupa string panjang yang dimasukkan seperti ini:
Content-Security-Policy: script-src 'self' 'sha256-HASIL_DARI_PERINTAH_DI_ATAS'Hash harus dihitung dari isi tag skrip persis apa adanya, termasuk spasi dan baris baru. Jadi jika editor mengubah indentasi, hash berubah dan skrip kembali diblokir. Untuk proyek dengan banyak inline script yang dihasilkan saat build, hash sebaiknya dihitung otomatis oleh script build dan disisipkan ke header.
Alternatif lain adalah nonce, yaitu nilai acak yang dibuat ulang untuk setiap respons. Namun pada website statis yang sepenuhnya di-cache, nonce sulit dipakai karena nilainya harus berbeda setiap permintaan. Karena itu, hash lebih cocok untuk kasus ini.
Jika Anda memakai skrip pihak ketiga yang memuat skrip lain secara dinamis, direktif 'strict-dynamic' bisa membantu:
Content-Security-Policy: script-src 'nonce-NILAI_ACAK' 'strict-dynamic' https: 'unsafe-inline'; object-src 'none'; base-uri 'none'Pada browser modern, keberadaan nonce atau hash membuat daftar host diabaikan, sehingga hanya skrip yang diberi tanda atau turunannya yang boleh jalan. 'unsafe-inline' tetap ditulis hanya sebagai cadangan untuk browser lama.
Meta Tag atau Header?
CSP bisa ditulis di dalam HTML:
<meta http-equiv="Content-Security-Policy" content="default-src 'self'; object-src 'none'">Cara ini berguna jika Anda tidak menguasai konfigurasi hosting. Keterbatasannya: tidak bisa memakai frame-ancestors, report-uri, atau report-to, tidak bisa beberapa kebijakan sekaligus, dan tidak berlaku untuk unduhan atau dokumen non-HTML. Untuk situs yang deploy di Vercel atau server sendiri, header HTTP tetap lebih baik.
Cara Uji dan Troubleshooting
- Buka DevTools, tab Console. Pelanggaran CSP muncul dengan pesan seperti
Refused to load the script ... because it violates .... - Jalankan
curl -I https://domain-anda/untuk memastikan header benar-benar terkirim. Perubahanvercel.jsonbaru berlaku setelah deploy ulang. - Periksa juga halaman 404. Header yang hanya terpasang di halaman utama sering terlewat di halaman error.
- Cocokkan sumber yang ditolak dengan direktif yang disebut di pesan. Jangan langsung menambahkan
https:atau*; tambahkan hanya domain yang memang diperlukan. - Gunakan CSP Evaluator untuk melihat apakah kebijakan masih mengandung celah umum.
- Setelah tidak ada pelanggaran selama beberapa hari, baru aktifkan mode enforce dan pantau lagi.
Masalah yang paling sering muncul antara lain: atribut onclick pada tombol, URL javascript: di tautan, style="..." yang lupa diizinkan di style-src, gambar dari data: yang tidak masuk img-src, serta font yang dimuat lintas origin tanpa izin font-src. Skrip analitik biasanya butuh connect-src tambahan agar permintaan pengiriman data tidak ditolak.
Kesimpulan
CSP untuk website statis bukan soal menambah server, melainkan soal mendefinisikan batas kepercayaan di browser. Mulai dari kebijakan sederhana dengan default-src 'self', uji dalam mode Report-Only, lalu perketat secara bertahap. Hindari wildcard dan 'unsafe-inline' pada skrip, gunakan hash untuk inline script, dan pastikan header juga hadir di halaman error.
Dengan satu baris header yang terpikir matang, situs statis Anda mendapat lapisan pertahanan tambahan tanpa mengorbankan kecepatan atau menambah kompleksitas runtime.