Folder privat dan URL publik: jangan tertukar saat mengamankan PHP
Cara memisahkan file konfigurasi rahasia, endpoint unduh yang sah, aturan .htaccess, dan pengujian akses sesudah redesign.

Satu temuan yang mengubah cara memeriksa aturan akses
Dalam audit paket situs ini, ada aturan penolakan langsung terhadap sebuah URL yang namanya mengandung config. Setelah kode dibaca, berkas tersebut ternyata memanggil pemeriksaan administrator dan membuat unduhan konfigurasi untuk aplikasi. Ia bukan penyimpanan rahasia yang semestinya dibuka langsung.
Masalahnya bukan bahwa semua file konfigurasi perlu diizinkan. Masalahnya adalah nama saja dipakai sebagai dasar keputusan. Temuan ini berasal dari pemeriksaan aturan dan kode paket; tidak berarti fungsi unduh tersebut sudah diuji dengan akun serta database produksi. Rute pada contoh berikut sengaja digeneralisasi.
| Permintaan GET tanpa sesi admin | Paket sebelum koreksi | Paket sesudah koreksi |
|---|---|---|
| Endpoint unduh konfigurasi aplikasi | 403, ditolak aturan server | 302, dialihkan ke halaman login |
| File konfigurasi rahasia perangkat | 403 | 403 |
Perbandingan HTTP dilakukan secara lokal pada 21 Oktober 2026 dengan Apache 2.4 dan PHP 8.4. Perubahan 403 menjadi 302 menunjukkan permintaan endpoint sah sudah mencapai pemeriksaan login, sementara file rahasia tetap ditolak. Hasil itu belum membuktikan transaksi unduh setelah login berhasil: tahap tersebut membutuhkan akun dan database yang sesuai.
Pisahkan tiga peran yang berbeda
| Peran | Contoh umum | Perlindungan |
|---|---|---|
| Penyimpanan rahasia | Kredensial database dan kunci aplikasi | Di luar webroot bila memungkinkan; akses berkas dibatasi. |
| Library internal | Fungsi autentikasi yang di-include | Tidak tersedia sebagai halaman publik; tetap bisa dimuat oleh PHP. |
| Endpoint sah | Unduh konfigurasi setelah login | Metode, autentikasi, dan otorisasi sesuai fungsinya. |
Menghalangi akses HTTP ke library tidak menghalangi PHP memuat berkas lewat filesystem. Sebaliknya, menghapus library dari paket karena tidak tampil di menu dapat merusak endpoint yang bergantung padanya. Inventaris dependensi diperlukan sebelum membersihkan file.
Aturan server berlaku lebih luas daripada satu halaman
Pada Apache, .htaccess dapat memengaruhi direktori beserta turunannya, bergantung pada pengaturan server [1]. Aturan di akar situs karena itu perlu diperiksa terhadap API, dashboard, halaman privasi aplikasi, dan direktori data yang berbagi domain.
# Contoh: tolak akses HTTP ke direktori privat.
# Bukan konfigurasi lengkap untuk seluruh situs.
RewriteEngine On
RewriteRule ^(?:private-data|internal-lib)(?:/|$) - [F,L]Pola contoh ini tidak boleh dipindahkan ke proyek lain tanpa memeriksa nama direktori serta aturan yang sudah ada. Endpoint yang sah tidak boleh otomatis masuk daftar blokir hanya karena menghasilkan berkas JSON. Sebaliknya, membolehkan semua JSON demi satu unduhan dapat membuka file status atau data pengguna.
Untuk situs yang hanya mempunyai sedikit rute publik, daftar izin yang jelas dapat membantu menolak sisa halaman lama setelah ekstraksi paket. Namun daftar itu harus mencakup aset, URL verifikasi, serta kebutuhan layanan yang memang dipertahankan.
Jangan samakan 200 dengan aman
Uji sedikitnya empat keadaan: pengunjung tanpa login, pengguna yang berhak, pengguna yang tidak berhak, dan permintaan ke file privat secara langsung. Sebuah unduhan admin semestinya tidak memberi isi privat hanya karena URL ditemukan. Penolakan 401 atau 403 bisa merupakan hasil yang benar untuk permintaan tidak sah.
Sebaliknya, 403 yang dipaksakan oleh aturan akar untuk semua pengguna dapat menunjukkan endpoint tertutup sebelum aplikasinya sempat memeriksa hak akses. Pengujian perlu membedakan penolakan yang direncanakan dari fungsi yang rusak. Dokumentasi mod_rewrite menjelaskan bahwa urutan kondisi serta aturan memengaruhi bagaimana URL diproses [2].
Perhatikan pengalihan dan cache
Jangan mengalihkan seluruh permintaan secara seragam jika perangkat memakai kontrak koneksi tertentu. Uji metode POST, header, dan format respons di lingkungan yang aman. Browser manusia mungkin mengikuti pengalihan otomatis, tetapi perilaku klien perangkat bisa berbeda.
Respons yang memuat data pribadi atau terkait sesi juga tidak seharusnya mendapat cache publik hanya karena ekstensi atau namanya menyerupai aset. Aturan cache untuk artikel statis dan aturan untuk dashboard perlu dipisahkan.
Instruksi noindex membantu mengelola indeks pencarian, bukan hak akses. Jangan menjadikan robots.txt atau noindex sebagai satu-satunya cara melindungi file privat. Siapa pun yang mengetahui alamat tetap dapat meminta berkas jika server mengizinkannya.
Audit perubahan sebagai kontrak yang harus dijaga
Buat daftar berisi URL, metode yang diterima, jenis autentikasi, jenis respons, dan dependensi. Simpan rahasia pada tempat terpisah; daftar audit tidak perlu memuat nilainya. Sesudah perubahan, ulangi uji untuk rute yang disentuh serta rute tetangganya.
Bandingkan kode layanan dengan versi sebelumnya agar perombakan desain tidak diam-diam mengganti logika operasional. Jika database atau perangkat nyata belum tersedia untuk uji, tulis keterbatasannya. Pemeriksaan sintaks dan akses lokal adalah bukti yang berguna, tetapi bukan pengganti pengujian transaksi atau perangkat di produksi.
Lanjutkan ke checklist penggantian public_html untuk memasukkan pemeriksaan akses ke proses pemasangan, bukan menjadikannya pekerjaan setelah muncul keluhan.
Rujukan untuk memeriksa konsepnya
Dokumentasi resmi dan standar di bawah membantu pembaca meninjau istilah serta langkah teknis. Tautan ini bukan klaim bahwa setiap contoh dalam artikel telah diuji di semua perangkat atau hosting.
- OWASP: Secrets Management
Cara menjaga rahasia yang tidak boleh diletakkan di folder publik.
- Apache: .htaccess
Perlindungan akses berbasis konfigurasi direktori di Apache.
Laporkan bagian artikel yang perlu diperbaiki agar redaksi dapat memeriksa informasi dan sumbernya.
Kirim koreksi ke redaksi