Dokumentasi
Instalasi, konfigurasi, referensi arsitektur, dan dokumentasi API. Mulai dari sini.
Baca dokumentasiDokumentasi, saluran email dan laporan bug, serta FAQ tentang instalasi, konfigurasi, deteksi, dan pemecahan masalah.
Instalasi, konfigurasi, referensi arsitektur, dan dokumentasi API. Mulai dari sini.
Baca dokumentasiMenemukan bug atau punya usulan fitur? Kirim laporan yang rinci dan kami akan segera menyelidikinya.
Kirim laporan bug lewat emailUntuk pertanyaan yang sensitif atau bantuan profesional. Kami membalas dalam 48 jam pada hari kerja.
Email hello@wafio.cloudBerencana menjual WAFio kepada klien Anda, merilisnya dengan merek sendiri, atau butuh instalasi, audit, dan dukungan ber-SLA dari tim yang membuatnya? Kirim email kepada kami.
Email hello@wafio.cloud soal layanan profesionalJawaban seputar hal umum, instalasi, deteksi, konfigurasi, performa, privasi data, dan pemecahan masalah, dikelompokkan per topik.
Dapatkan kuncinya dari Authentication Portal abuse.ch, lalu simpan nilainya di Administration › Security Data › MalwareBazaar. Pilih Check access & update hashes dan periksa status database di setiap WAF agent. Kunci ini bukan lisensi WAFio atau kredensial agent.
Kebijakan bawaan untuk pemindaian yang tidak lengkap adalah Forward and log. Reject upload dapat memblokir upload dengan pemindaian tidak lengkap dalam mode Block; mode Log only tetap meneruskannya. Aturan WAF lain dan aplikasi bisa menolak request secara terpisah.
Tidak. Data cadangan offline hanya berisi EICAR dan saat ini tidak digolongkan sebagai pemindaian yang tidak lengkap. Periksa sumber database, jumlah hash, dan sinkronisasi secara terpisah. Malware yang belum dikenal atau sudah dimodifikasi mungkin tidak cocok; arsip tidak diekstrak.
20 mesin semantik WAFio mendeteksi: SQL injection, XSS, command injection, Prompt Injection (jailbreak AI/LLM), Open Redirect, Local File Inclusion (LFI), Server-Side Request Forgery (SSRF), LDAP injection, prototype pollution, Java injection / Log4Shell, PHP injection, Python injection, NoSQL injection, Server-Side Template Injection (SSTI), XML External Entity (XXE), serangan deserialisasi, HTTP header injection (CRLF), penyalahgunaan introspection dan batch GraphQL, serangan pada header JWT (alg:none, kid path traversal), dan input anomali.
Setiap mesin semantik mendekode, menormalkan, dan mem-parse payload sesuai kategori serangan yang menjadi targetnya. URL encoding, Base64, hex encoding, comment injection, trik whitespace, dan pengaburan protokol semuanya dibuka sebelum dianalisis. Mesin menilai maksud payload, bukan hanya bentuknya, sehingga tahan terhadap teknik bypass signature yang umum.
eBPF Firewall memakai hook XDP (eXpress Data Path) dan TC untuk memeriksa dan membuang paket di level driver kernel, sebelum diproses network stack Linux. Firewall ini memblokir lalu lintas berdasarkan IP individual, rentang CIDR, kombinasi port/protokol, dan rate limit per sumber. Efektif terhadap SYN flood, port scan, brute force, dan infrastruktur serangan berbasis IP.
Runtime Security memakai kprobe dan tracepoint eBPF untuk memantau aktivitas kernel secara langsung: eksekusi proses (execve), operasi file system (open, write, unlink pada path sensitif), koneksi keluar (connect, bind), perubahan hak akses, dan event batas container. Setiap event diperkaya dengan PID, pohon proses parent, hash binary, user, cgroup, dan identifier namespace.
Bisa. Mesin semantik Java secara khusus menangani pengaburan lookup JNDI Log4j: lookup ${lower:...} dan ${upper:...} yang bersarang dibuka secara rekursif hingga 10 level. Titik dua dan garis miring yang di-URL-encode dalam string JNDI didekode sebelum dianalisis. Varian Log4Shell yang lolos dari deteksi satu lintasan (single-pass) juga tercakup.
WAFio memblokir vektor serangan yang berujung pada SEO hijacking (SQL injection, LFI, upload file berbahaya) di lapisan HTTP sebelum mencapai aplikasi. Jika penyerang menemukan jalan masuk lain, Runtime Security mendeteksi proses web shell yang dijalankan lewat kprobe pada execve: web server yang menjalankan /bin/bash langsung memicu alert.
Semua WAF bisa menghasilkan false positive. Untuk menguranginya, atur sebuah mesin ke Log only atau Off untuk seluruh proyek atau untuk satu path, atur mesin yang punya tingkat sensitivitas ke Relaxed, atau tambahkan rule path untuk endpoint yang terdampak.
Sensitivitas diatur per mesin, bukan per proyek. Di Project settings › Default WAF policy › Detection › Engine sensitivity, dua belas mesin dapat diatur ke Relaxed, Balanced, atau Strict. Relaxed meminta bukti lebih banyak dan melewatkan sebagian serangan. Strict melapor dengan bukti lebih sedikit dan memunculkan lebih banyak alarm palsu. Balanced adalah bawaannya. Delapan mesin lainnya tidak punya tingkat: mesin itu diatur ke Block, Log only, atau Off.
Tidak. Sejak versi 2, sebuah deteksi bersifat kuat atau lemah. Deteksi kuat memblokir request dengan HTTP 403. Deteksi lemah dicatat sebagai LOG dan request tetap diteruskan. Sakelar Record weak detections, di bagian Detection pada kebijakan WAF, mematikan catatan LOG tersebut: deteksi lemah lalu lewat sebagai request biasa yang diizinkan. Key ambang dalam konfigurasi yang disimpan oleh versi 1 dihapus saat konfigurasi itu dibaca atau disimpan.
WAFio mendukung pengecualian path: Anda dapat mengatur path URL tertentu agar melewati kategori aturan tertentu (misalnya melewati pemeriksaan semantik SQL di /api/search sementara perlindungan XSS tetap aktif). Ini diatur per proyek di konfigurasi WAF. Path health check dan endpoint webhook adalah kandidat umum untuk pengecualian parsial.
Bisa. WAFio menyediakan pemblokiran negara lewat GeoIP. Di konfigurasi WAF proyek, tambahkan kode negara ke daftar blokir. Identifikasi negara memakai database GeoIP yang diunduh oleh installer dan wafio-waf-agent fetch-data: DB-IP secara bawaan, atau MaxMind GeoLite2 dengan license key. Request yang diblokir menerima respons HTTP yang dapat dikonfigurasi.
Bisa, di dua lapisan. eBPF Firewall menangani blokir IP dan CIDR di level kernel (paket dibuang sebelum sampai ke userspace). WAF agent juga memiliki daftar blokir dan izin di lapisan aplikasi. Keduanya dapat dikelola dari dashboard secara real-time, tanpa perlu me-restart agent.
Buka Custom Rules di sidebar proyek. Aturan berbasis kondisi mencocokkan field request lalu allow, block, log, atau challenge; hanya allow dan block yang mengakhiri pemeriksaan, sedangkan log dan challenge mencatat kecocokan dan membiarkan pipeline berlanjut. Aturan skrip berjalan di sandbox dengan batas waktu dan memori yang tetap, dan hanya owner proyek yang dapat menyimpan atau mengubahnya.
Bisa. Setiap proyek punya kebijakan WAF bawaan, dan setiap aplikasi dapat menimpanya. Sebuah kebijakan berisi apa yang dilakukan tiap mesin (Block, Log only, atau Off, serta tingkat sensitivitas untuk dua belas mesin), negara yang diblokir, rate limit, dan rule path. Satu control plane mengelola banyak proyek dan agent secara independen.
Pertama, buka request yang diblokir di dashboard. Di sana tampil kategori, kekuatan deteksi (strength), lokasi kecocokan (Matched in), dan detail kecocokannya. Pilihan perbaikan: (1) Atur mesin yang terpicu ke Log only untuk path yang terdampak, di Project settings › Default WAF policy › Rule paths. (2) Jika mesin itu punya tingkat sensitivitas, atur ke Relaxed di Detection › Engine sensitivity. (3) Jika path itu memerlukannya, matikan mesin tersebut untuk path itu. Mulailah dengan Log only, agar deteksinya tetap tercatat.
Pastikan WAF agent terhubung: periksa statusnya di halaman WAF agents, atau baca journalctl -u wafio-waf-agent untuk melihat error koneksi. Pastikan agent dikonfigurasi sebagai upstream proxy untuk aplikasi Anda (lalu lintas harus melewati WAF agent, bukan menghindarinya). Pastikan control plane dapat dijangkau dari host agent di port gRPC (bawaan :9090).
Penyebab umum: (1) sertifikat mTLS tidak cocok: jalankan ulang perintah instalasi dari Hosts › Connect this host (rotasi host key terlebih dahulu jika jendela pendaftaran 24 jamnya sudah tertutup), atau siapkan ulang kredensial dari halaman Credentials. (2) Alamat atau port server gRPC salah: periksa WAFIO_GRPC_SERVER di konfigurasi agent. (3) SNI tidak cocok jika terhubung lewat IP: atur WAFIO_GRPC_SERVER_NAME ke hostname server. (4) Firewall memblokir port 9090 di host control plane.
Host agent membutuhkan kernel Linux ≥ 5.10 dengan BTF (BPF Type Format) aktif. Periksa: uname -r (versi kernel) dan ls /sys/kernel/btf/vmlinux (BTF tersedia). Agent berjalan sebagai root. Unit systemd-nya memberi CAP_BPF, CAP_NET_ADMIN, CAP_SYS_ADMIN, CAP_PERFMON, CAP_KILL, CAP_SYS_RESOURCE, dan CAP_SYS_PTRACE dengan LimitMEMLOCK=infinity; pastikan unit di host masih memuat semuanya.
Endpoint login sering mengirim password atau token yang memicu aturan deteksi (karakter khusus, konten base64). Solusi: (1) Tambahkan pengecualian path untuk /login atau /api/auth yang melewati kategori aturan tertentu. (2) Jika endpoint hanya untuk internal, gunakan konfigurasi AllowLocalIPs untuk melewati bot challenge bagi rentang alamat lokal/privat. (3) Tambahkan endpoint ke daftar pengecualian path di konfigurasi WAF proyek.
Jalankan wafio migrate up secara manual dari direktori yang berisi config.yaml untuk melihat error spesifiknya. Penyebab umum: ekstensi TimescaleDB PostgreSQL belum terpasang (jalankan CREATE EXTENSION IF NOT EXISTS timescaledb di psql), kredensial database salah, atau versi migrasi tidak cocok. Untuk memeriksa versi yang sudah diterapkan, jalankan SELECT version, dirty FROM schema_migrations; di psql.
Gunakan formulir laporan privat di repositori yang terdampak di GitHub (tab Security, lalu Report a vulnerability), atau kirim laporan rinci ke hello@wafio.cloud yang berisi deskripsi kerentanan, langkah reproduksi, dan dampak potensialnya. Jangan membahas kerentanan keamanan di saluran publik. Kami berupaya mengonfirmasi penerimaan laporan dalam 48 jam dan memberikan jadwal perbaikan dalam 5 hari kerja.
Perangkat lunak WAFio gratis: tanpa tingkatan paket, tanpa fitur yang dikunci, tanpa kunci lisensi, dan tanpa batas jumlah agent. Semua fitur, termasuk seluruh 20 mesin semantik, eBPF Firewall, Runtime Security, dan dashboard lengkap, tersedia tanpa biaya. Untuk tim yang membutuhkan bantuan langsung, tersedia layanan profesional: instalasi, kontrak dukungan ber-SLA, dan audit hardening. Lihat halaman Layanan untuk bantuan profesional.
Kode sumber control plane, dashboard, WAF agent, dan host agent terbuka untuk umum di github.com/Wafio dengan lisensi GPL-3.0-only (program BPF milik host agent berlisensi GPL-2.0), dan interpreter skrip uddin, uddin-lang-rs, berlisensi MIT. Unduhannya gratis dan tidak memerlukan pendaftaran atau kunci lisensi. Versi 2 adalah rilis saat ini. WAF agent-nya ditulis dengan Rust, dan itulah yang ada di repositori publik. Baca tulisan rilis versi 2.
Tidak. Unduh binary, konfigurasikan, lalu jalankan. Tanpa pendaftaran, tanpa API key, dan tanpa phone-home. WAFio tidak memerlukan akun eksternal apa pun untuk beroperasi.
WAFio mencakup fungsi yang sama dengan WAF cloud: pemeriksaan lalu lintas, deteksi injection, rate limiting, dan pemfilteran jaringan. Bedanya, seluruh data tetap di infrastruktur Anda sendiri. WAFio juga menambahkan pemfilteran jaringan eBPF di level kernel dan keamanan proses runtime di dalam host.
WAFio membutuhkan host Linux x86_64 64-bit dan akses root. WAF agent membutuhkan glibc 2.28 atau lebih baru, sehingga Ubuntu 18.04 dan CentOS 7 ditolak. Host agent membutuhkan kernel 5.10 atau lebih baru dengan BTF (/sys/kernel/btf/vmlinux). Kernel 5.8 dan 5.9 tidak didukung.
Installer mendukung keluarga Debian (Debian, Ubuntu) dan keluarga RHEL (RHEL, Rocky Linux, AlmaLinux, Oracle Linux, CentOS Stream, Fedora, Amazon Linux). Build rilis WAF agent sudah dijalankan di AlmaLinux 8.10, Rocky Linux 8.9 dan 9.3, Debian 11, 12, dan 13, serta Ubuntu 20.04, 22.04, dan 24.04. WAF agent membutuhkan glibc 2.28 atau lebih baru; distribusi lain dengan glibc 2.28 atau lebih baru seharusnya berfungsi, tetapi belum dijalankan. Host agent membutuhkan kernel 5.10 atau lebih baru dengan BTF. Host dengan kernel lebih lama atau tanpa BTF tetap bisa menjalankan WAF agent, tetapi tidak bisa menjalankan host agent.
Bisa. Satu server dapat menjalankan control plane, WAF agent, dan host agent sekaligus. Untuk sistem produksi, host agent yang terpisah lebih baik, tetapi itu tidak wajib.
Dengan install.sh, deployment dasar (control plane + WAF agent yang melindungi satu aplikasi) hanya butuh satu perintah: installer memasang PostgreSQL dan TimescaleDB, mengunduh dan memverifikasi binary yang sudah ditandatangani, menulis konfigurasi, lalu menjalankan layanan systemd. Menambah host agent cukup satu perintah yang disalin dari dashboard (Hosts › Connect this host). Halaman Unduh memuat peragaan installer untuk setiap jenis instalasi.
Tidak. WAF agent adalah reverse proxy. WAF agent berada di depan aplikasi Anda dan mencegat lalu lintas HTTP secara transparan. Tanpa SDK, tanpa library, tanpa perubahan kode. WAFio bekerja dengan bahasa, framework, atau runtime apa pun.
Bisa, setelah terpasang. WAFio tidak memerlukan koneksi keluar untuk berjalan: perubahan konfigurasi dikirim dari control plane Anda sendiri ke agent lewat gRPC. Instalasi dengan installer satu baris memerlukan akses ke wafio.cloud, dan data keamanan (GeoIP, daftar bot, hash malware) diunduh dari penyedianya.
Sebagian. WAF agent berjalan di host sebagai service systemd dan meneruskan request ke alamat upstream yang Anda atur, yang bisa berupa container di host itu. Tidak ada image container WAF agent yang dipublikasikan. Host agent memberi tag pada event berupa container ID, image, serta label pod dan namespace Kubernetes bila socket Docker, containerd, atau Podman tersedia.
Tidak. WAFio hanya untuk Linux. WAF agent, host agent, dan subsistem eBPF dikompilasi khusus untuk Linux x86_64. Windows Server tidak didukung dan tidak ada rencana menambahkan dukungan Windows, karena eBPF adalah fitur kernel Linux yang tidak punya padanan di Windows, dan lapisan keamanan runtime bergantung pada kprobe dan tracepoint Linux. Jika aplikasi Anda berjalan di Windows Server, pertimbangkan menjalankan WAFio di VM atau container Linux di depan server Windows itu dan meneruskan lalu lintas HTTP melaluinya.
macOS didukung untuk control plane di lingkungan pengembangan: Anda dapat menjalankan binary control plane wafio di macOS untuk pengujian lokal. Namun, WAF agent dan host agent hanya untuk Linux di lingkungan produksi. FreeBSD, OpenBSD, dan BSD lainnya tidak didukung. Deployment produksi harus memakai host Linux untuk node agent.
Build resmi saat ini menargetkan Linux x86_64. Build ARM64 belum masuk pipeline rilis resmi. Menjalankan WAFio di AWS Graviton, Ampere, atau Raspberry Pi berarti mengompilasi sendiri bagian yang open source, misalnya control plane dan host agent yang ditulis dengan Go memakai GOARCH=arm64. Codebase Go-nya tidak bergantung pada arsitektur, tetapi objek eBPF CO-RE harus dikompilasi dengan arsitektur target yang benar. Hubungi kami di hello@wafio.cloud untuk status build ARM64 terbaru.
Tergantung jenis hosting-nya. Shared hosting cPanel tidak didukung: shared host tidak memberi akses root atau kemampuan menjalankan layanan sistem kustom. Di VPS atau dedicated server cPanel dengan akses root, WAFio dapat berjalan berdampingan dengan cPanel/WHM dengan sedikit konfigurasi. Pendekatan standarnya: ubah Apache agar listen di port non-standar (misalnya 8080) lewat WHM › Apache Configuration › Global Configuration › HTTP Port, lalu jalankan WAF agent WAFio di port 80/443 sebagai proxy yang menghadap publik. WAFio meneruskan lalu lintas yang bersih ke Apache di 8080. Fitur "Reverse Proxy" cPanel di WHM (Apache › Module Handlers) juga bisa membantu perutean ini. WAF agent membutuhkan glibc 2.28 atau lebih baru, dan fitur eBPF Firewall serta Runtime Security membutuhkan kernel 5.10 atau lebih baru dengan BTF. Host cPanel CloudLinux 9 atau AlmaLinux 9 modern memenuhi keduanya; CentOS 6 dan 7 lama tidak memenuhi keduanya. Untuk lingkungan cPanel terkelola yang membatasi perubahan port, tanyakan ke penyedia hosting Anda apakah konfigurasi reverse proxy diizinkan sebelum melakukan deployment.
Setiap request melewati pipeline deteksi WAF agent sebelum sampai ke aplikasi Anda, jadi agent menambah waktu pemeriksaan pada tiap request. eBPF Firewall membuang paket yang diblokir di level driver kernel, sebelum network stack Linux. Ukur overhead pada lalu lintas Anda sendiri: Overview proyek menampilkan rata-rata latensi keputusan dari keputusan yang tercatat.
WAFio dirancang fail-open saat agent mengalami panic. Jika sebuah mesin deteksi panic, request tetap diteruskan dengan metrik error yang dicatat, dan aplikasi Anda terus melayani lalu lintas. Agent juga dapat dimuat ulang di tempat: systemctl reload wafio-waf-agent mengirim SIGUSR2, proses baru mengambil alih socket yang sedang listen, lalu proses lama menyelesaikan koneksi yang tersisa dan keluar.
Jalankan installer lagi dengan perintah yang sama. Installer menemukan instalasi yang sudah ada, mempertahankan konfigurasi Anda, dan mengganti binary. Untuk WAF agent, installer memasang agent dan library mesinnya sekaligus, lalu memeriksa keduanya sebelum menghentikan service. Upgrade pertama dari versi 1 me-restart WAF agent, karena agent Go tidak dapat menyerahkan tugasnya ke agent Rust. Installer juga menjalankan migrasi database; secara manual, migrasi berjalan dengan wafio migrate up, atau saat startup dengan wafio serve --migrate.
Ya. Beberapa WAF agent dapat terhubung ke satu control plane. Agent menerima pembaruan konfigurasi lewat gRPC bidirectional streaming: perubahan aturan dikirim ke semua agent tanpa restart. Control plane sendiri dapat berjalan di belakang load balancer. Database (PostgreSQL + TimescaleDB) adalah komponen yang menyimpan state.
Control plane menjaga stream gRPC bidirectional yang persisten dengan setiap agent. Saat Anda memperbarui konfigurasi WAF proyek di dashboard, bundle baru langsung dikirim ke semua agent yang terhubung. Tanpa restart agent, tanpa jeda polling.
Tidak. WAFio sepenuhnya berjalan di server Anda sendiri. Tidak ada payload request, alamat IP, sesi pengguna, atau log keamanan yang dikirim ke server WAFio atau infrastruktur pihak ketiga mana pun. Semua data tetap di dalam jaringan Anda sendiri. Tidak ada telemetri, tidak ada phone-home, dan tidak ada ketergantungan ke cloud di jalur data.
Event keputusan WAF disimpan di database PostgreSQL + TimescaleDB Anda (tabel waf_decisions, sebuah hypertable yang dipartisi berdasarkan waktu dan dikompresi setelah satu hari). Event keamanan host disimpan di database yang sama. Retensi berjalan otomatis: 30 hari secara bawaan (7 hari untuk event keamanan host), dapat diubah oleh administrator sistem di Administration › Data retention, dengan peringatan ukuran database yang opsional. Kredensial di header, query string, dan body request disamarkan sebelum keputusan disimpan. Semua penyimpanan berada di dalam infrastruktur Anda sendiri.
Arsitektur WAFio mendukung persyaratan kepatuhan yang mewajibkan kedaulatan data: tidak ada payload request yang keluar dari server Anda, tidak ada pihak ketiga yang memproses lalu lintas Anda, dan log audit sepenuhnya berada di bawah kendali Anda. Status kepatuhan bergantung pada keseluruhan lingkungan dan kontrol Anda. WAFio menyediakan fondasi infrastrukturnya, bukan sertifikat kepatuhan.
Bisa. WAFio tidak memerlukan koneksi keluar untuk berjalan, dan semua pemrosesan terjadi di dalam jaringan Anda. Installer satu baris dan unduhan data keamanan memerlukan akses internet.
Jika FAQ belum menjawab kebutuhan Anda, kirim email yang rinci. Kami menanggapi pertanyaan teknis, laporan bug, dan masalah yang khusus pada deployment Anda.