Dokumentasi WAFio

WAFio adalah Web Application Firewall self-hosted sekaligus platform keamanan tingkat kernel. Inspeksi lalu lintas berjalan di infrastruktur Anda. Penyedia yang Anda konfigurasi memasok threat intelligence dan pembaruan; file upload diperiksa secara lokal.

Perlindungan tiga lapis
WAF HTTP L7 + firewall kernel eBPF + penelusuran runtime, semuanya melapor ke control plane yang sama.
Deteksi
Mesin semantik menganalisis setiap request, lalu agent mengubah temuannya menjadi ALLOW, LOG, atau BLOCK.
Control plane multi-tenant
Satu control plane mengelola banyak proyek. Setiap proyek terisolasi penuh dengan agent, aturan, dan kredensialnya sendiri.
Self-hosted
WAFio menyimpan telemetri lalu lintas di infrastruktur Anda. Pembaruan dan integrasi threat intelligence yang Anda konfigurasi menghubungi penyedianya masing-masing; MalwareBazaar memerlukan Auth-Key abuse.ch.
Server AndaKernelPenelusuran runtimePenelusuran eBPFControl planeKebijakan dan eventInterneteBPF FirewallXDP dan TCWAF agentReverse proxyMesin semantikPemindaian uploadAplikasiTanpa SDKHost agentAturan, penelusuranServer AndaKernelPenelusuran runtimekprobe, tracepointMenulis aturan ke BPF mapKebijakanEventKebijakanEventmTLS gRPCInterneteBPF FirewallXDP dan TCWAF agentReverse proxyMesin semantikPemindaian uploadAplikasiTanpa SDKHost agentPenelusuran eBPFControl planeKebijakan dan event
  • Request diizinkan
  • Request diblokir
  • Kebijakan keluar
  • Event kembali
Yang disertakan
  • 1 control plane (dashboard + REST API + orkestrasi agent lewat gRPC)
  • WAF agent: reverse proxy sidecar untuk inspeksi HTTP L7
  • Host agent: firewall kernel eBPF (XDP/TC) + penelusuran runtime
  • Bundle yang diunduh dari wafio.cloud (gratis, tanpa API key)

Panduan cepat (install.sh)

Cara tercepat memasang WAFio adalah skrip installer all-in-one. Satu perintah mengunduh binary yang ditandatangani, memasang PostgreSQL + TimescaleDB, menjalankan migrasi, membuat akun admin, menerbitkan sertifikat mTLS, dan menjalankan ketiga komponen sebagai layanan systemd.

Ingin melihatnya lebih dulu? Peragaan installer memutar ulang instalasi control plane, enrollment host agent, dan upgrade, baris demi baris.

Persyaratan server
  • Linux. Installer mengenali Ubuntu, Debian, Raspbian, dan Linux Mint, serta keluarga RHEL: RHEL, Rocky, AlmaLinux, CentOS, Fedora, Oracle Linux, dan Amazon Linux (di Amazon Linux gunakan --db docker atau --db existing). Jika OpenSSL-nya 1.1.1 (AlmaLinux 8, Debian 11, Ubuntu 20.04), installer memeriksa tanda tangan bundle dengan python3.
  • Kernel 5.10+ dengan BTF aktif (wajib untuk eBPF host agent; 5.8 dan 5.9 tidak didukung)
  • Arsitektur x86_64 (amd64)
  • Akses root; curl, tar, openssl, dan python3 sudah terpasang
  • PostgreSQL 17+ dengan ekstensi TimescaleDB: installer menjalankannya di container Docker tersendiri, memasangnya di host, atau mengaktifkan TimescaleDB di PostgreSQL Anda yang sudah ada. Hanya diperlukan untuk control plane.
  • Tanpa akun atau API key: WAFio dapat diunduh gratis.
Jalankaninstall.shUnduh bundleDari wafio.cloudVerifikasiSHA-256, Ed25519PasangControl plane, agentProyek pertamaAkun adminJalankaninstall.shUnduh bundleDari wafio.cloudVerifikasiSHA-256, Ed25519PasangControl plane, agentProyek pertamaAkun admin
  • Bundle bertanda tangan
  • Bundle tanpa tanda tangan atau tidak cocok, ditolak
Tentang PostgreSQL + TimescaleDB

Control plane menyimpan semua data di PostgreSQL dan memakai ekstensi TimescaleDB untuk menyimpan event time-series (keputusan WAF, event keamanan host, event firewall) dengan retensi otomatis: 30 hari secara default (event keamanan host 7 hari), dapat diubah di Administration › Data retention. Riwayat yang lebih tua dari satu hari disimpan dalam bentuk terkompresi.

  • Docker (--db docker): PostgreSQL 17 + TimescaleDB dalam container tersendiri (wafio-db), hanya dipublikasikan di 127.0.0.1, data di /var/lib/wafio/postgresql. PostgreSQL lain yang sudah dipakai aplikasi di host tidak disentuh. Memerlukan Docker.
  • Host (--db host): installer memasang PostgreSQL 17 + TimescaleDB dan menyetelnya. Jika sudah ada PostgreSQL versi lain, installer memakai cluster 17 pada port tersendiri.
  • PostgreSQL yang sudah ada (--db existing): installer membuat database wafio khusus dan mengaktifkan ekstensi TimescaleDB hanya di dalam database itu. shared_preload_libraries yang ada dipertahankan (timescaledb digabungkan, tidak ditimpa), dan tuning memori/worker Anda tidak diubah. Jika server belum punya TimescaleDB, installer memasangnya dan mengaturnya sebagai preload hanya untuk cluster di host yang sama, lalu bertanya sebelum me-restart cluster itu (database lain di dalamnya terputus sebentar); untuk server lain, installer berhenti dengan petunjuk. Role wafio juga diberi pg_read_all_settings (lihat di bawah).

Instalasi WAF agent dan host agent tidak memerlukan PostgreSQL.

1
Jalankan installer Satu perintah: gratis, tanpa pendaftaran atau API key

Masuk ke server Linux Anda lewat SSH, lalu jalankan:

curl -fsSL https://wafio.cloud/install.sh | sudo bash

WAFio dapat diunduh gratis, tanpa akun atau API key. Perintah ini boleh di-pipe ke sudo bash: installer membaca jawaban Anda dari terminal (/dev/tty), bukan dari pipe. Untuk melewati menu komponen, sebutkan komponennya (controlplane, waf-agent, host-agent, atau all) sebagai argumen atau lewat --component:

curl -fsSL https://wafio.cloud/install.sh | sudo bash -s -- controlplane
curl -fsSL https://wafio.cloud/install.sh | sudo bash -s -- --component waf-agent

# Or download first, then run (recommended for production)
curl -fsSL https://wafio.cloud/install.sh -o wafio-install.sh
sudo bash wafio-install.sh --help

Installer akan menanyakan:

  1. Pilihan komponen: pilih All Components untuk pemasangan lengkap
  2. Mount path dashboard (control plane): kosongkan agar dashboard dilayani di root domain, atau isi path seperti /wafio-cp jika dashboard berada di belakang reverse proxy pada sub-path. Tulis WAFIO_BASE_PATH setelah sudo (misalnya sudo WAFIO_BASE_PATH=/wafio-cp bash) untuk melewati pertanyaan ini.
  3. Database: container Docker tersendiri, PostgreSQL di host ini, atau server yang sudah ada (--db docker|host|existing melewati pertanyaan ini; tanpa terminal, defaultnya host)
  4. Akun admin: nama, email, dan password untuk dashboard WAFio
  5. Nama project: label untuk proyek keamanan pertama Anda

Installer secara otomatis:

  • Mengunduh binary WAFio yang ditandatangani dari wafio.cloud (gratis, tanpa pendaftaran)
  • Memverifikasi checksum SHA-256 dan tanda tangan rilis Ed25519 setiap bundle, dan menolak memasang bundle yang tidak bertanda tangan atau tidak cocok
  • Memasang atau mengonfigurasi PostgreSQL + TimescaleDB
  • Mengunduh data keamanan (GeoIP, FireHOL, JA4, signature bot); server khusus agent hanya mengunduh yang dibutuhkan agent-nya
  • Menulis /etc/wafio/config.yaml dengan secret JWT dan enkripsi 2FA yang baru
  • Menjalankan semua migrasi database
  • Membuat akun admin dan proyek pertama Anda
  • Menerbitkan sertifikat mTLS untuk WAF agent dan host agent
  • Memasang dan menjalankan semua komponen sebagai layanan systemd, lalu menjalankan health check
2
Buka dashboard http://your-server:9087

Setelah instalasi selesai, dashboard tersedia di http://your-server:9087 (ditambah mount path, jika Anda memilihnya). Masuk dengan kredensial admin yang Anda buat saat instalasi.

Kedua agent sudah terhubung dan berjalan. Buka proyek Anda untuk melihat keduanya online:

  • WAF agents: WAF agent Anda sudah terdaftar dan menunggu konfigurasi lalu lintas
  • Hosts: host agent Anda online dan firewall eBPF aktif
Langkah berikutnya
  1. Buka Applications › New application, pilih WAF agent Anda, lalu atur listen port dan upstream aplikasi Anda
  2. Buka Hosts › Firewall untuk mengonfigurasi aturan L3/L4 host Anda
  3. Buka Hosts › Runtime security untuk meninjau dan menyetel aturan deteksi
3
Hubungkan server lain Satu perintah per host, dibuat oleh dashboard

Untuk melindungi server lain, buka Hosts, klik Register host, lalu ikuti panduan Connect this host. Panduan itu menampilkan perintah instalasi satu baris yang sudah berisi host key, alamat dashboard Anda, dan SHA-256 dari CA agent:

curl -fsSL https://wafio.cloud/install.sh -o wafio-install.sh && printf '%s\n' '<host key>' | sudo bash wafio-install.sh host-agent --host-key-stdin \
  --url 'https://<dashboard>' \
  --ca-sha256 '<CA SHA-256>'

Untuk WAF agent, gunakan waf-agent sebagai ganti host-agent (--agent-name NAME bersifat opsional; nama defaultnya <hostname>@ebpf dan <hostname>@waf).

  • Private key agent dibuat di server dan tidak pernah keluar dari server itu: yang dikirim hanya certificate signing request yang diautentikasi dengan host key
  • Installer tidak menulis apa pun kecuali CA agent milik control plane cocok dengan --ca-sha256
  • --url harus https:// (http:// hanya untuk loopback); gunakan --dashboard-cacert FILE untuk dashboard dengan sertifikat TLS privat
  • Host key dikirim lewat stdin, sehingga tidak pernah muncul di ps maupun log sudo
  • Host key hanya dapat dipakai untuk enrollment dalam 24 jam sejak host dibuat atau key-nya dirotasi: rotasi key di halaman host untuk memulai masa 24 jam yang baru. Setiap host menyimpan paling banyak 4 kredensial hasil enrollment.

Verifikasi layanan

Setelah instalasi, pastikan semua layanan berjalan:

sudo systemctl status wafio wafio-waf-agent wafio-host-agent

# View live logs
sudo journalctl -u wafio -f
sudo journalctl -u wafio-waf-agent -f
sudo journalctl -u wafio-host-agent -f

PostgreSQL sudah terpasang?

Jika server Anda sudah menjalankan PostgreSQL untuk aplikasi lain, pilih docker agar database WAFio terpisah darinya: tidak ada yang berubah di server yang ada dan server itu tidak pernah di-restart. Pilih existing untuk memakai server itu: installer menanyakan detail koneksinya dan membuat user serta database wafio khusus. Database Anda yang sudah ada tidak disentuh. Syarat: PostgreSQL 17+. Jika TimescaleDB belum ada di sana, installer memasang paketnya dan mengaturnya sebagai preload hanya untuk cluster di host yang sama (dan bertanya dulu sebelum me-restart cluster itu); untuk server di tempat lain, installer berhenti dengan petunjuk.

# PostgreSQL in its own container (the server needs Docker)
curl -fsSL https://wafio.cloud/install.sh -o wafio-install.sh
sudo bash wafio-install.sh controlplane --db docker
# back up the container's database
sudo docker exec wafio-db pg_dump -U postgres -Fc wafio > wafio.dump

Untuk database di host yang sama, installer juga memberikan pg_read_all_settings ke role control plane (wafio) saat instalasi dan pada setiap upgrade, agar alert ukuran database dapat memeriksa sisa disk. Role itu lalu dapat membaca semua pengaturan server, tetapi tidak dapat membaca file maupun data; jangan simpan secret di pengaturan (misalnya, password di primary_conninfo sebaiknya ada di passfile). Untuk melewati pemberian ini, tulis WAFIO_SKIP_SETTINGS_GRANT=1 setelah sudo, karena sudo membuang environment pemanggil. Untuk database di host lain, jalankan sendiri GRANT pg_read_all_settings TO wafio; di sana jika Anda ingin pemeriksaan disk.

# Install or upgrade without the grant
curl -fsSL https://wafio.cloud/install.sh | sudo WAFIO_SKIP_SETTINGS_GRANT=1 bash

Upgrade instalasi yang sudah ada

Menjalankan ulang installer di server yang sudah memiliki WAFio aman dan idempoten. Skrip mendeteksi instalasi yang ada dan beralih ke mode upgrade:

  • Mengunduh dan memeriksa setiap bundle, dan memeriksa bahwa WAF agent yang baru dapat memuat engine library yang baru, sebelum menghentikan layanan apa pun. Baru setelah itu installer menghentikan setiap layanan dan memasang file baru, sehingga bundle yang ditolak membiarkan server seperti semula
  • Mempertahankan /etc/wafio/config.yaml apa adanya: secret JWT, kunci enkripsi 2FA, kredensial database, dan pengaturan lain tetap utuh, sehingga pengguna tetap login dan 2FA tetap berfungsi (backup config.yaml.bak.<time> disimpan di sebelahnya)
  • Melewati pembuatan admin, proyek, dan kredensial: tidak ada proyek ganda, tidak ada error setup
  • Mempertahankan sertifikat agent, serta alamat gRPC dan nama agent di file *.env agent (agent yang dijalankan ulang dengan --url setelah rotasi key di-enroll lagi dan mendapat sertifikat baru). Di waf-agent.env, installer menghapus tiga baris rule set versi 1 (WAFIO_CRS_*), mengisi WAFIO_SECURITY_DATA_DIR dari baris itu jika belum ada, dan menambahkan WAFIO_ENGINE_LIB_REQUIRED=1 saat memasang engine library
  • Memperbarui binary, engine library WAF agent, unit systemd agent (diambil dari bundle), aset frontend, migrasi database, dan data keamanan, lalu me-restart layanan
# Same command: upgrades in place
curl -fsSL https://wafio.cloud/install.sh | sudo bash

Sebelum upgrade:

  • Upgrade control plane lebih dulu (komponen ini yang menjalankan migrasi), lalu agent. Agent versi 1 tetap berjalan dengan control plane versi 2 sampai Anda meng-upgrade-nya, dengan tiga batasan. Host agent yang lebih lama dari versi 2 tidak menerapkan filter penerusan yang baru dan mengirim setiap event runtime. WAF agent yang lebih lama dari 1.9 menolak kebijakan yang menyebut jwt atau graphql di path override atau di skip_semantic, lalu tetap melayani dengan kebijakan cache-nya. WAF agent versi 1 mengabaikan Log only pada sebuah mesin dan tetap memblokir. WAF agent versi 1 tidak dapat di-reload menjadi agent versi 2, jadi upgrade pertama dan rollback me-restart-nya.
  • Installer hanya memasang rilis terbaru dan tidak menyimpan salinan versi yang digantinya. Agar bisa kembali ke versi lama, simpan dulu pg_dump database dan salinan /usr/local/bin/wafio*, /usr/lib/wafio/, /etc/wafio/ (file env agent), /etc/systemd/system/wafio*.service, /opt/wafio/frontend, dan /opt/wafio/migrations.
  • Saat Anda meng-upgrade dari versi sebelum 1.9, riwayat yang lebih tua dari satu hari dikompresi oleh background job TimescaleDB (lisensi community, seperti yang diatur installer) setelah upgrade (sekitar 80 detik untuk 1 GB pada satu vCPU).
  • Pada PostgreSQL tanpa TimescaleDB (atau dengan build berlisensi Apache), control plane mulai menghapus telemetri yang lebih tua dari retensinya (30 hari, event keamanan host 7 hari) satu jam setelah pertama kali berjalan. Untuk menyimpan lebih lama, naikkan retensi di Administration › Data retention dalam rentang satu jam itu.

Arsitektur

WAFio memakai arsitektur hub-and-spoke. Control plane menjadi pusatnya: menyimpan konfigurasi, mengumpulkan telemetri, dan mengirim pembaruan aturan ke agent lewat kanal gRPC mTLS.

Control planeHTTP :9087, gRPC :9090Dashboard UIREST APIDecision brokerPostgreSQL + TimescaleDBWAF agentReverse proxy HTTP20 mesin semantikAturan skrip (uddin)Host agentKernel Linux (eBPF)Firewall XDP/TCPenelusuran syscallPengayaan data containergRPC mTLSgRPC mTLSControl planeHTTP :9087, gRPC :9090Dashboard UIREST APIDecision brokerPostgreSQL + TimescaleDBWAF agentReverse proxy HTTP20 mesin semantikAturan skrip (uddin)Host agentKernel Linux (eBPF)Firewall XDP/TCPenelusuran syscallPengayaan data container
  • Kebijakan ke agent
  • Event ke control plane

Peran komponen

BinaryPeranPort
wafioControl plane: dashboard, REST API, orkestrasi agent, penyimpanan telemetriHTTP :9087, gRPC :9090
wafio-waf-agentReverse proxy sidecar HTTP: memeriksa setiap request sebelum sampai ke aplikasi AndaDapat dikonfigurasi (mis. :8080)
wafio-host-agentAgent eBPF khusus Linux: firewall kernel L3/L4 + penelusuran runtimeAPI lokal di 127.0.0.1:18089 (--listen); tanpa port publik

Cara agent terhubung

Agent terhubung ke control plane lewat gRPC (port 9090) dengan mutual TLS (mTLS). Setiap agent menunjukkan sertifikat klien. Sertifikat itu di-enroll dari host lewat instalasi satu perintah atau diterbitkan di halaman Credentials. Fingerprint SHA-256 sertifikat menunjukkan agent itu milik proyek mana, sehingga tidak perlu API key tambahan saat runtime. Sertifikat hasil enrollment juga terikat pada host, jenis agent, dan nama agent-nya.

Saat terhubung, control plane mengirim bundle berisi konfigurasi WAF lengkap. Agent menerapkannya lalu mulai memeriksa lalu lintas. Perubahan konfigurasi berikutnya dikirim otomatis tanpa me-restart agent. WAF agent menyimpan bundle terakhir yang diterapkan (last-bundle.json di direktori state-nya, /var/lib/wafio-waf-agent) dan tetap melayani lalu lintas dengan bundle itu jika control plane tidak dapat dijangkau saat agent mulai berjalan.

Control planeKebijakan, eventWAF agentDi web serverWAF agentDi web serverHost agentDi host LinuxHost agentDi host LinuxmTLS gRPCmTLS gRPCControl planeKebijakan, eventWAF agentWeb serverHost agentHost LinuxWAF agentWeb serverHost agentHost Linux
  • Kebijakan keluar
  • Event kembali

Penyimpanan

PenyimpananFungsi
PostgreSQL + TimescaleDBSemua data control plane: pengguna, proyek, agent, keputusan WAF, event keamanan host, event firewall, dan audit log. Hypertable TimescaleDB untuk menyimpan event time-series, dikompresi setelah satu hari, dengan retensi otomatis (default 30 hari, event runtime security 7 hari, dapat diubah di Administration › Data retention).

Penyiapan data keamanan

WAFio memerlukan data threat intelligence dari luar: database GeoIP, daftar reputasi IP, fingerprint JA4, dan signature bot. Dataset ini tidak disertakan dalam binary dan harus diunduh terpisah.

Otomatis dengan install.sh

Jika Anda memasang WAFio dengan install.sh, data keamanan diunduh otomatis. Bagian ini hanya relevan jika Anda perlu memperbarui data atau memasang secara manual.

Wajib sebelum server pertama kali dijalankan (hanya instalasi manual)

Tanpa data keamanan, WAF agent tidak mau berjalan: agent memerlukan database GeoIP negara, kota, dan ASN, daftar user-agent bot jahat, dan file fingerprint JA4 (atau JA3). Host agent tetap berjalan, tetapi tanpa pengayaan GeoIP.

Infrastruktur AndaDiambilFeed penyediaPembaruan, ancamanControl planeKebijakan, eventPenyimpananPilihan AndaServer aplikasiDengan agentInfrastruktur AndaDiambilUpload tidak dikirim keluarServer aplikasiDengan agentControl planeKebijakan, eventPenyimpananPilihan AndaFeed penyediaPembaruan, ancaman
  • Pembaruan diambil
  • Event dan telemetri
  • Upload tidak dikirim

Feed hash malware memerlukan penyiapan kredensial tersendiri. Lihat Deteksi upload berbahaya untuk mengonfigurasi MalwareBazaar dan memverifikasi sinkronisasi agent.

Mengunduh data keamanan umum

# Download all security data (no MaxMind account required)
./wafio fetch-data

Yang diunduh

KomponenFileKegunaan
geoipsecurity-data/geoip/country.mmdb
city.mmdb, asn.mmdb
Pemblokiran negara berbasis GeoIP, peta geo di dashboard, pengayaan data IP
fireholsecurity-data/firehol/firehol_level1.netset
firehol_level2.netset
Blocklist reputasi IP (IP berbahaya yang dikenal, botnet, scanner)
ja4security-data/ja4/ja4.txt
ja4_allowlist.txt
Daftar bawaan fingerprint TLS milik library klien HTTP, scanner, dan alat exploit, serta allowlist browser dan crawler mesin pencari. WAFIO_JA4_BLOCKLIST_URL dan WAFIO_JA4_ALLOWLIST_URL menggantinya dengan feed.
ja3security-data/ja3/ja3.txtDaftar fingerprint TLS JA3 lama (Salesforce, abuse.ch)
uasecurity-data/user-agents/bot.txtString user-agent bot jahat (scraper, alat serangan)
malwaresecurity-data/malware/malware_hashes.txt
malware_bloom.bin
Hash SHA-256 dari MalwareBazaar untuk pemindaian upload. Memerlukan auth key (lihat Deteksi upload berbahaya); tanpa key, komponen ini dilewati dan database yang ada tetap dipakai.

Penyedia GeoIP: DB-IP vs MaxMind

Secara default, WAFio mengunduh dari DB-IP, penyedia GeoIP gratis yang tidak memerlukan akun atau license key. Jika Anda memerlukan MaxMind GeoLite2, dapatkan license key gratis di maxmind.com lalu isi di konfigurasi:

geo:
  maxmind_license_key: "YOUR_FREE_LICENSE_KEY_HERE"

Lalu jalankan ulang ./wafio fetch-data --force. Di server tanpa control plane, berikan --maxmind-key ke fetch-data milik agent atau atur WAFIO_MAXMIND_LICENSE_KEY.

Profile dan server khusus agent

--profile memilih kumpulan komponen. Untuk wafio fetch-data, pilihannya all (default), control-plane, atau agent; --only geoip,firehol,… mengunduh komponen tertentu dan --dir menentukan direktori tujuan. Server tanpa control plane tidak punya binary wafio: agent membawa perintah fetch-data sendiri, dan installer memakainya. wafio-waf-agent fetch-data memakai default --profile agent dan --dir /etc/wafio/security-data; wafio-host-agent fetch-data hanya menerima --profile host-agent:

sudo wafio-waf-agent fetch-data --dir /opt/wafio/security-data --profile agent

Menjaga data tetap mutakhir

Database GeoIP diperbarui setiap bulan. WAF agent memuat ulang daftar FireHOL sendiri setiap 24 jam: dari GitHub, atau dari file yang disebut WAFIO_IPREP_LEVEL1_FILE dan WAFIO_IPREP_LEVEL2_FILE jika keduanya diatur. Daftar JA4 sudah tertanam. File yang sudah ada dilewati kecuali --force diberikan. Cron bulanan yang disarankan untuk server control plane hasil install.sh (di server khusus agent, jalankan fetch-data milik agent itu dengan profile-nya sendiri):

# /etc/cron.d/wafio-update-security-data
0 3 1 * * root /usr/local/bin/wafio fetch-data --dir /opt/wafio/security-data --profile all --force >> /var/log/wafio-fetch-data.log 2>&1

# On a server with only the WAF agent:
# 0 3 1 * * root /usr/local/bin/wafio-waf-agent fetch-data --dir /opt/wafio/security-data --profile agent --force >> /var/log/wafio-fetch-data.log 2>&1

Deteksi upload berbahaya

Cocokkan file upload yang utuh dengan hash SHA-256 malware yang sudah dikenal, langsung di WAF agent Anda.

Bloom filter menyaring kandidat hash, lalu pencarian SHA-256 yang eksak memastikan setiap kecocokan. Kandidat dari Bloom filter saja tidak pernah memicu vonis malware. Mekanisme ini melindungi dari false positive Bloom filter, tetapi tidak menjamin bahwa threat intelligence bebas kesalahan atau bahwa file yang tidak cocok pasti aman.

1. Hubungkan MalwareBazaar

  1. Masuk ke abuse.ch Authentication Portal dan ambil Auth-Key Anda. Ini kredensial akun abuse.ch, terpisah dari login, lisensi, atau sertifikat agent WAFio Anda.
  2. Sebagai administrator sistem WAFio, buka Administration › Security data › MalwareBazaar. Tempel nilai key lalu simpan. Jika Anda mengunduh file yang berisi key, salin key-nya saja; jangan tempel URL unduhan atau password akun.
  3. Pilih Check access & update hashes. Tinjau log pembaruan dan status database WAF agent yang terhubung sebelum mengaktifkan enforcement.

Control plane menyimpan key penyedia dalam bentuk terenkripsi, mengunduh daftar hash, dan mendistribusikannya ke WAF agent yang kompatibel lewat koneksi terautentikasi. Key tetap berada di control plane; file upload tidak dikirim ke MalwareBazaar. Pembaruan dari layar ini berjalan saat diminta, bukan menurut jadwal otomatis.

Persyaratan penyedia dan ketersediaan ekspor dijelaskan di dokumentasi ekspor MalwareBazaar.

UploadFile tibaControl planeHash malwareWAF agentPemeriksaan lokalHash seluruh filePenyaringan BloomSHA-256 persisTeruskanDiizinkanBlokir403UploadFile tibaControl planeHash malwareWAF agentPemeriksaan lokalHash seluruh filePenyaringan BloomSHA-256 persisTeruskanDiizinkanBlokir403
  • File diteruskan
  • File diblokir
  • Daftar hash

2. Pilih kebijakan upload

Buka Project settings, pindah ke tab Default WAF policy, lalu pilih Uploads and body size (aplikasi dapat menimpa kebijakan proyek di tab Config pada halamannya). Di bagian Malicious uploads, aktifkan Scan uploads for known malware, pilih kebijakan pada tabel di bawah, lalu simpan konfigurasi WAF. Agent yang terhubung menerima konfigurasi terbaru secara otomatis.

PengaturanPerilaku
When malware is detectedBlock upload menolak kecocokan yang terkonfirmasi dengan HTTP 403. Log only mencatat deteksi dan meneruskan request.
When scanning is incompleteForward and log adalah default untuk batas pemindaian dan error. Forward with scan details dan Reject upload juga tersedia. Mode Log only selalu meneruskan request.
Scan budget per requestDefault: 10 MiB (10.485.760 byte), paling besar 100 MiB, dibagi untuk semua file dan field dalam satu request. File yang tidak dapat dibaca utuh dalam sisa kuota tidak dicocokkan hash-nya.
Multipart file uploadsAktif secara default. Memeriksa setiap bagian file dalam upload multipart; pemrosesan juga dibatasi hingga 128 bagian.
Raw request bodiesNonaktif secara default. Aktifkan untuk endpoint yang mengirim file sebagai seluruh body request non-multipart.
Your hash listsEntri SHA-256 opsional di Blocked hashes dan Allowed hashes. File yang cocok dengan Allowed hashes tidak pernah dilaporkan sebagai malware dan didahulukan dari daftar blokir, tetapi perlindungan WAF yang lain tetap berlaku.
Utamakan ketersediaan saat memulai

Mulai dari mode Log only dengan Forward and log untuk pemindaian yang tidak lengkap. Amati ukuran upload dan perilaku aplikasi Anda yang sebenarnya, verifikasi sinkronisasi database, lalu ubah kecocokan malware yang terkonfirmasi ke Block. Aturan WAF lain dan aplikasi Anda tetap dapat menolak upload.

Apa yang terjadi jika database tidak ada?

Jika tidak ada database hasil unduhan, fallback offline saat ini hanya berisi signature uji EICAR. Fallback ini tidak dikategorikan sebagai pemindaian yang tidak lengkap. Karena itu, file yang tidak cocok dapat lolos pemeriksaan hash walaupun feed malware yang sebenarnya tidak ada. Uji EICAR yang berhasil saja tidak membuktikan bahwa database MalwareBazaar terpasang.

Jika pemindaian melaporkan database tidak tersedia, error parsing, atau batas ukuran/bagian, kebijakan pemindaian tidak lengkap berlaku. Biarkan Forward and log terpilih jika kegagalan pemindaian yang dilaporkan itu tidak boleh mengganggu upload klien. Pemindaian tidak lengkap yang diblokir oleh kebijakan tidak diberi label kecocokan malware.

3. Verifikasi sebelum menerapkan enforcement

  1. Gunakan aplikasi uji yang terkendali dan file yang tidak berbahaya. Pastikan upload sampai ke aplikasi, lalu periksa responsnya.
  2. Gunakan file uji EICAR standar untuk memeriksa penanganan kebijakan. Saat pemindaian nonaktif, fitur ini tidak menolaknya. Saat pemindaian aktif dalam mode Block, kecocokan yang terkonfirmasi mengembalikan HTTP 403. Log only meneruskan file dan mencatat deteksinya.
  3. Uji file yang lebih besar dari kuota pemindaian. Forward and log seharusnya tetap meneruskan file; Block seharusnya menolak pemindaian yang tidak lengkap saat mode enforcement adalah Block.
  4. Periksa sumber database, jumlah hash, dan status sinkronisasi agent secara terpisah. Pastikan agent memiliki feed hasil unduhan, bukan hanya fallback EICAR.

Cakupan dan batas

Deteksi hash eksak hanya mengenali file yang sama persis byte demi byte dengan file yang sudah dikenal. Malware yang dimodifikasi, malware yang belum dikenal, dan file di dalam arsip memerlukan pemeriksaan tambahan. Arsip tidak diekstrak, dan file parsial tidak pernah dianggap sebagai kecocokan hash yang lengkap. Gunakan fitur ini bersama validasi file di sisi aplikasi, kontrol penyimpanan, dan pemindaian tambahan yang dibutuhkan aplikasi Anda.

Key konfigurasinya adalah content_scan.on_incomplete, dengan nilai log (default), allow, atau block. Bedakan kebijakan ini dari content_scan.mode, yang mengatur kecocokan malware yang terkonfirmasi.

Bootstrap awal

Memakai install.sh? Lewati bagian ini.

Installer menjalankan kedua perintah di bawah secara otomatis. Bagian ini membahas instalasi manual dan pemulihan saat installer tidak dapat menyelesaikan prosesnya.

Dua perintah di host control plane:

wafio migrate up
wafio admin create --email you@example.com --name "Your Name"

admin create menanyakan password dan membacanya dari terminal. Flag --password memang ada, tetapi jangan dipakai: nilai flag terlihat di ps oleh semua pengguna di mesin itu. Instalasi non-interaktif dapat mengirim satu baris lewat stdin. Password minimal 12 karakter dan paling banyak 72 byte.

Setiap akun yang dibuat dengan cara ini mendapat system role: admin, yang dapat mengakses semua proyek, mengelola member, dan memakai admin API. Pastikan akun itu ada dengan:

wafio admin list

Konfigurasi divalidasi saat boot

Control plane menolak berjalan dengan konfigurasi yang tidak dapat dijalankannya dengan aman, dan melaporkan semua masalah sekaligus, bukan satu masalah setiap restart:

  • jwt.secret harus diisi, minimal 32 karakter, dan tidak boleh berupa placeholder dari contoh konfigurasi atau secret apa pun yang pernah dipublikasikan di repositori WAFio
  • totp.enc_key wajib diisi dan harus didekode menjadi tepat 32 byte (openssl rand -hex 32)
  • database.name, host, dan port harus dapat dipakai
  • origin CORS wildcard yang dikombinasikan dengan credentials ditolak
  • server.trusted_proxies harus berisi IP/CIDR yang valid dan tidak lebih luas dari IPv4 /8 atau IPv6 /16, dan server.proxy_header harus X-Forwarded-For atau X-Real-IP
  • log.level harus debug, info, warn, atau error
Upgrade dengan pengguna 2FA

totp.enc_key wajib diisi. Secret 2FA yang disimpan sebelum key ini diatur tetap berfungsi, dan disimpan terenkripsi saat pengguna mengatur ulang 2FA berikutnya. Jaga key ini tetap sama dan simpan cadangannya: mengganti atau kehilangan key membuat secret yang terenkripsi tidak dapat dibaca, sehingga pengguna itu tidak dapat masuk dengan 2FA.

Setelah bootstrap

  1. Masuk di http://your-server:9087/login
  2. Klik New project untuk membuat proyek keamanan pertama Anda
  3. Buka Hosts, klik Register host, lalu jalankan instalasi satu perintah dari panduan Connect this host di setiap server (lihat Pemasangan host agent)
  4. Atau, untuk instalasi manual, terbitkan kredensial proyek di halaman Credentials dan pasang agent dengan kredensial itu

Instalasi manual

Hanya untuk pengguna tingkat lanjut

Bagian ini menjelaskan instalasi manual. Jika Anda memasang untuk pertama kali, gunakan Panduan cepat (install.sh) di atas: skrip installer mengerjakan semuanya secara otomatis.

1

Prasyarat

  • Server Linux, x86_64
  • Kernel 5.10+ dengan BTF untuk host agent (ls /sys/kernel/btf/vmlinux harus menemukan file itu)
  • PostgreSQL 17+ (TimescaleDB disarankan)
  • Port 9087 (HTTP) dan 9090 (gRPC) terbuka di firewall Anda
2

Unduh binary

Unduh bundle dari portal (gratis, tanpa API key):

# Download WAFio bundles
curl -fsSL "https://wafio.cloud/api/download/controlplane" -o wafio-controlplane.tar.gz
curl -fsSL "https://wafio.cloud/api/download/waf-agent" -o wafio-waf-agent.tar.gz
curl -fsSL "https://wafio.cloud/api/download/host-agent" -o wafio-host-agent.tar.gz

# Verify checksums (from manifest)
MANIFEST=$(curl -fsSL https://wafio.cloud/api/download/manifest)
# Extract sha256 values and verify with sha256sum;
# the Ed25519 signature of each bundle: /api/download/<component>/sig
3

Siapkan dependensi

WAFio memerlukan PostgreSQL 17+. Ekstensi TimescaleDB disarankan dan dipakai otomatis jika ada; tanpa ekstensi itu, tabel event berupa tabel biasa tanpa chunking atau kompresi, dan control plane sendiri menghapus baris yang melewati retensinya setiap jam.

# Add the apt.postgresql.org repository first, as install.sh does
sudo apt-get install -y postgresql-17
# Optional but recommended (chunking, compression, fast retention):
# add the TimescaleDB package and extension for your distro
4

Konfigurasikan control plane

Bundle tidak berisi direktori config. Tulis config/config.yaml di sebelah binary wafio (control plane membaca config/config.yaml atau ./config.yaml dari direktori kerjanya) dengan setidaknya pengaturan berikut:

# config/config.yaml
server:
  http_addr: ":9087"

database:
  host: localhost
  port: 5432
  name: wafio
  user: wafio
  password: your-db-password

jwt:
  secret: "output-of-openssl-rand-hex-32"

totp:
  enc_key: "openssl-rand-hex-32-output"
5

Jalankan control plane

# The dashboard files carry the placeholder /__WAFIO_BASE__: replace it with
# your mount path, or with nothing when the dashboard is at the domain root
find frontend -type f \( -name '*.html' -o -name '*.js' -o -name '*.json' -o -name '*.css' \) \
  -exec sed -i 's#/__WAFIO_BASE__##g' {} +

# Run migrations + start server
./wafio serve --migrate

# Or run in background
nohup ./wafio serve --migrate > wafio-server.log 2>&1 &

File dashboard di frontend/ berisi placeholder /__WAFIO_BASE__, yang ditulis ulang oleh installer. Untuk instalasi manual, tulis ulang placeholder itu dengan perintah sed di atas sebelum Anda membuka dashboard: seperti contohnya, dashboard dilayani di root domain; untuk sub-path, tulis mount path (misalnya /wafio-cp) setelah tanda # kedua. Buat administrator pertama di host dengan wafio admin create --email you@example.com --name "Your Name", lalu masuk di http://your-server:9087/login. Setup wizard di browser sudah dihapus; lihat Bootstrap awal.

6

Terbitkan kredensial

Cara paling sederhana adalah instalasi satu perintah dari Hosts › Register host › Connect this host (lihat Pemasangan host agent): perintah itu meng-enroll setiap agent dengan key yang dibuat di server agent itu sendiri. Untuk instalasi yang sepenuhnya manual, buka Credentials di sidebar proyek Anda, isi nama, lalu klik Issue credential. Unduh bundle kredensial segera: private key hanya ditampilkan sekali.

Bundle (wafio-<name>-bundle.tar) berisi ca.crt, client.crt, client.key, dan unit systemd wafio-<name>.service. Installer juga menerimanya langsung: sudo bash wafio-install.sh waf-agent --bundle credential.tar.

7

Pasang WAF agent

Salin binary agent dan bundle sertifikat yang sudah diterbitkan, lalu jalankan dengan path mTLS. Rute dan listen port dikirim dari control plane: agent hanya memerlukan path transport dan data.

sudo install wafio-waf-agent /usr/local/bin/wafio-waf-agent
sudo install -D -m 0644 libwafio_semantic_engine.so /usr/lib/wafio/libwafio_semantic_engine.so
id wafio >/dev/null 2>&1 || sudo useradd --system --no-create-home --shell /usr/sbin/nologin wafio
sudo mkdir -p /etc/wafio/certs/waf
sudo cp ca.crt client.crt client.key /etc/wafio/certs/waf/
sudo chown -R root:wafio /etc/wafio/certs/waf
sudo chmod 0750 /etc/wafio/certs/waf
sudo chmod 0640 /etc/wafio/certs/waf/client.key

# Security data the agent needs to start (GeoIP, bot list, JA4)
sudo wafio-waf-agent fetch-data --dir /opt/wafio/security-data --profile agent
sudo chown -R wafio:wafio /opt/wafio/security-data

# /etc/wafio/waf-agent.env
WAFIO_GRPC_SERVER=your-control-plane:9090
WAFIO_GRPC_CA_CERT=/etc/wafio/certs/waf/ca.crt
WAFIO_GRPC_CLIENT_CERT=/etc/wafio/certs/waf/client.crt
WAFIO_GRPC_CLIENT_KEY=/etc/wafio/certs/waf/client.key
WAFIO_AGENT_NAME=edge-waf-prod
WAFIO_ENGINE_LIB_REQUIRED=1
WAFIO_SECURITY_DATA_DIR=/opt/wafio/security-data
WAFIO_GEO_COUNTRY_DB_PATH=/opt/wafio/security-data/geoip/country.mmdb
WAFIO_GEO_CITY_DB_PATH=/opt/wafio/security-data/geoip/city.mmdb
WAFIO_GEO_ASN_DB_PATH=/opt/wafio/security-data/geoip/asn.mmdb
WAFIO_UA_BAD_BOT_FILE=/opt/wafio/security-data/user-agents/bot.txt
WAFIO_JA4_BLACKLIST_FILE=/opt/wafio/security-data/ja4/ja4.txt
WAFIO_JA4_ALLOWLIST_FILE=/opt/wafio/security-data/ja4/ja4_allowlist.txt

Agent mendaftarkan dirinya saat pertama kali terhubung (atau daftarkan dengan nama di WAF agents › Register agent). Lalu tambahkan aplikasi di Applications › New application dengan listen port dan upstream-nya, pilih agent ini, lalu bundle dikirim ke agent lewat gRPC mTLS dalam hitungan detik.

8

Verifikasi

Di dashboard, buka WAF agents. Agent Anda seharusnya tampil dengan status Online. Uji dengan payload SQL injection:

curl "http://your-agent:8080/?id=1' OR '1'='1"
# Expected: 403 Forbidden (if blocking mode is enabled)

Tur dashboard

Dashboard WAFio menampilkan kondisi keamanan infrastruktur Anda secara real-time. Bagian ini menjelaskan setiap halamannya.

Daftar proyek

Semuanya berawal dari daftar proyek. Setiap proyek adalah lingkungan keamanan yang terisolasi, dengan agent, kredensial, aturan WAF, dan log event sendiri.

Overview proyek

Overview adalah pusat kendali untuk satu proyek: volume keputusan WAF, paket yang dibuang firewall, latensi keputusan, dan antrean "Needs attention" yang mencakup insiden, heartbeat yang terlewat, pengiriman konfigurasi yang tertunda, dan sertifikat yang segera kedaluwarsa. Grafik time-series merinci request menjadi Allow, Block, dan "Log, monitor, challenge", di samping IP penyerang teratas, kategori serangan yang cocok, negara asal, dan infrastruktur host yang aktif.

Recorded requests
Keputusan WAF yang tercatat pada rentang waktu yang dipilih (5 menit hingga 30 hari), dengan grafik aktivitas per bucket.
Blocked decisions
Request yang diblokir WAF agent. Detail forensik lengkapnya dapat dibuka dari event log WAF.
Firewall drops
Event drop yang disimpan firewall eBPF pada host Anda dalam rentang waktu yang dipilih.
Average decision latency
Rata-rata waktu inspeksi inline per keputusan yang tercatat.

Sidebar proyek mengikuti urutan yang sama dengan tur ini: Overview, Applications, WAF agents, Custom rules, Hosts (dengan Firewall dan Runtime security), Project settings, Credentials, Members, dan Audit log. Administrator sistem juga dapat membuka Administration: pengguna, undangan, data keamanan, email (SMTP), retensi data, dan audit log global.

Applications

Applications mencantumkan setiap aplikasi dalam proyek: modenya (Block atau Monitor), WAF agent yang melayaninya, dan rutenya. New application membuat aplikasi dengan listen port dan URL upstream-nya; pilih WAF agent agar aplikasi langsung aktif, atau simpan dulu tanpa agent. Setiap aplikasi punya halaman sendiri dengan tab Monitoring, Decisions (live), Config (kebijakan WAF-nya, atau mewarisi kebijakan proyek), Block window, Maintenance (lihat Mode pemeliharaan), Routing, dan Assignment.

WAF agents

Halaman WAF agents mencantumkan setiap agent yang terdaftar untuk proyek ini dalam tabel inventaris: status online, jumlah aplikasi yang dilindungi, dan waktu terakhir terlihat. Agent mendaftarkan dirinya saat pertama kali terhubung, atau Anda dapat mendaftarkannya dengan nama. Halaman agent menampilkan aplikasinya, kesehatan inspeksi, pengiriman SIEM, dan status data keamanan; bundle konfigurasi dikirim ke agent lewat gRPC mTLS dalam hitungan detik. Tidak ada file konfigurasi di server tempat agent berjalan.

Custom rules

Custom rules menambahkan aturan untuk satu aplikasi, di atas mesin deteksi: aturan kondisi, aturan skrip, dan aturan tuning. Aturan kondisi mencocokkan field request lalu melakukan allow, block, log, atau challenge; hanya allow dan block yang mengakhiri inspeksi, 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.

Hosts

Halaman Hosts menampilkan semua host milik proyek dalam satu tabel: status tiap host, perlindungan yang aktif (firewall, runtime security), insiden terbuka, dan versi agent, lengkap dengan filter dan label. Pilih beberapa host untuk mengubah label, menambah atau menghapus aturan firewall, atau menyalin kebijakan runtime dan aturan deteksi sekaligus. Register host menampilkan key sekali pakai milik host di dalam panduan Connect this host; rotasi key, pencabutan, dan penghapusan ada di halaman host itu sendiri.

Firewall

Halaman Firewall mengelola firewall kernel eBPF di setiap host. Konfigurasikan aturan inbound/outbound, allowlist dan blocklist IP, pemblokiran negara (atau hanya mengizinkan negara tertentu), dan perlindungan SYN flood, mula-mula dalam mode monitor, lalu enforce. Aturan diterapkan seketika lewat BPF map, tanpa iptables dan tanpa restart layanan.

Runtime security

Runtime security memakai tracepoint eBPF untuk memantau eksekusi proses, akses file, koneksi jaringan, dan privilege escalation di tingkat kernel, tanpa instrumentasi aplikasi. Event dikategorikan menurut tingkat keparahan (INFO, LOW, MEDIUM, HIGH, CRITICAL) dan dikelompokkan ke antrean insiden yang dipetakan ke teknik MITRE ATT&CK.

Mengaktifkan penelusuran runtime

Host agent hanya melakukan penelusuran dengan flag --trace (flag firewall kernel --ebpf aktif secara default, penelusuran tidak). Unit yang dipasang installer memberikan --trace=true, jadi host agent hasil instalasi melakukan penelusuran. Pada kernel yang diperketat dengan kernel.perf_event_paranoid bernilai 4 atau lebih, turunkan nilainya (sudo sysctl -w kernel.perf_event_paranoid=1) jika tidak, sebagian tracepoint dilewati saat attach. Runtime security menampilkan Probes loaded N of M untuk setiap host agent.

Project settings

Project settings berisi detail proyek dan, di tab Default WAF policy, kebijakan yang diwarisi setiap aplikasi: deteksi (tiap mesin nyala atau mati, blokir atau hanya catat, dan sensitivitasnya), kontrol akses, rate limit, perlindungan bot, reputasi IP, challenge bot, upload dan ukuran body, tujuan SSRF, path aturan, respons kustom, dan pengiriman SIEM. Pengaturan WebSocket diatur per aplikasi, di tab Config pada halaman aplikasi itu.

Credentials

Halaman Credentials menerbitkan sertifikat klien mTLS tingkat proyek untuk instalasi agent manual. Private key ditampilkan sekali saat penerbitan: unduh dan simpan dengan aman. Key itu tidak pernah disimpan di control plane. Agent yang dipasang dengan instalasi satu perintah dari Hosts tidak memerlukannya: agent itu meng-enroll sertifikatnya sendiri.

Members

Di halaman Members, Anda mengundang orang ke proyek dan menetapkan role-nya: viewer (hanya baca), member (mengubah konfigurasi dan agent), atau owner (juga mengelola member, undangan, serta menghapus proyek, aplikasi, dan host). Hanya owner yang mengelola member.

Audit log

Audit log mencatat setiap tindakan member proyek: perubahan konfigurasi, penerbitan kredensial, pendaftaran agent, dan perubahan aturan WAF. Gunakan log ini untuk keperluan kepatuhan, investigasi insiden, dan pelacakan perubahan. Login tidak dicatat di sini: administrator sistem dapat melihatnya di Administration › Global audit log.

ProjectProjectsOverviewApplicationsWAF agentsCustom rulesHostsFirewallRuntime securityProject settingsCredentialsMembersAudit logAdministrationAdministrator sistem
  • Tujuan berikutnya

Pemasangan WAF agent

WAF agent adalah reverse proxy sidecar HTTP yang ringan. Pasang di depan aplikasi HTTP/HTTPS mana pun. WAF agent mencegat setiap request, memeriksanya lewat pipeline deteksi, lalu meneruskan, mencatat, atau memblokirnya. Agent terdiri dari dua berkas: agent terbuka <code>/usr/local/bin/wafio-waf-agent</code> dan library mesin <code>/usr/lib/wafio/libwafio_semantic_engine.so</code>. Agent membutuhkan glibc 2.28 atau lebih baru. Installer mengatur <code>WAFIO_ENGINE_LIB_REQUIRED=1</code>, sehingga agent tidak mau berjalan tanpa library itu. Tanpa pengaturan itu, agent tetap berjalan dan meneruskan trafik tanpa deteksi semantik.

Pipeline deteksi

  1. Klien mengirim request ke WAF agent (mis. :8080)
  2. Pemeriksaan ukuran body dan request, batas per path, L7 flood, kebijakan blokir, perlindungan geo dan bot (user agent, JA4, dan JA3), custom rules, lalu aturan IP per path dan perlindungan login
  3. 20 analyzer semantik (SQL, XSS, CMD, PHP, Python, LFI, SSRF, Java, LDAP, NoSQL, Prototype Pollution, SSTI, XXE, Deserialization, Open Redirect, Header Injection, Prompt Injection, Anomaly, GraphQL, JWT)
  4. Agent mengubah temuan mesin-mesin itu menjadi ALLOW / LOG / BLOCK
  5. Request diteruskan ke upstream (ALLOW/LOG) atau ditolak dengan 403 (BLOCK)
RequestHTTPSQL injectionSatu dari 20 mesinXSSSatu dari 20 mesinSSRFSatu dari 20 mesinPutusanKuat atau lemahRequestHTTPSQL injectionSatu dari 20 mesinXSSSatu dari 20 mesinSSRFSatu dari 20 mesinPutusanKuat atau lemah
  • Request yang lolos
  • Request diblokir

Instalasi

Gunakan instalasi satu perintah dari Hosts › Connect this host dengan komponen waf-agent (lihat Pemasangan host agent), atau sudo bash wafio-install.sh waf-agent --bundle credential.tar dengan kredensial dari halaman Credentials. Installer menulis /etc/wafio/waf-agent.env, sertifikat di /etc/wafio/certs/, dan unit systemd. Listen port dan upstream tidak diatur di agent: keduanya berasal dari aplikasi yang Anda tetapkan ke agent itu di dashboard.

Layanan systemd

Installer memasang unit ini dari bundle WAF agent (systemd/wafio-waf-agent.service); untuk instalasi manual, salin dari sana. Agent berjalan sebagai user sistem wafio, yang harus ada dan dapat membaca sertifikat serta data keamanan. Data keamanan di luar /etc/wafio/security-data memerlukan drop-in dengan ReadWritePaths= (systemctl edit wafio-waf-agent). Komentar dari berkas aslinya tidak ditampilkan di sini:

[Unit]
Description=WAFio WAF Agent
After=network.target

[Service]
Type=notify
NotifyAccess=all
User=wafio
Group=wafio
Environment=MIMALLOC_PURGE_DELAY=10
EnvironmentFile=/etc/wafio/waf-agent.env
ExecStart=/usr/local/bin/wafio-waf-agent
ExecReload=/bin/kill -SIGUSR2 $MAINPID
ExecStop=/bin/sh -c 'p="$1 $(cat /proc/$1/task/*/children 2>/dev/null)"; kill -TERM $p 2>/dev/null; for i in $p; do while kill -0 $i 2>/dev/null; do sleep 0.2; done; done' sh $MAINPID
Restart=on-failure
RestartSec=5
StandardOutput=journal
StandardError=journal
SyslogIdentifier=wafio-waf-agent
LimitNOFILE=65536
StateDirectory=wafio-waf-agent
StateDirectoryMode=0700
NoNewPrivileges=yes
AmbientCapabilities=CAP_NET_BIND_SERVICE
CapabilityBoundingSet=CAP_NET_BIND_SERVICE
PrivateTmp=yes
PrivateDevices=yes
ProtectSystem=strict
ProtectHome=yes
ProtectKernelTunables=yes
ProtectKernelModules=yes
ProtectControlGroups=yes
ProtectClock=yes
ProtectHostname=yes
RestrictSUIDSGID=yes
RestrictRealtime=yes
RestrictNamespaces=yes
LockPersonality=yes
MemoryDenyWriteExecute=yes
SystemCallArchitectures=native
SystemCallFilter=@system-service
SystemCallFilter=~@privileged @resources @obsolete
RestrictAddressFamilies=AF_INET AF_INET6 AF_UNIX
ReadWritePaths=-/etc/wafio/security-data

[Install]
WantedBy=multi-user.target
# /etc/wafio/waf-agent.env
WAFIO_GRPC_SERVER=10.1.1.2:9090
WAFIO_GRPC_CA_CERT=/etc/wafio/certs/waf/ca.crt
WAFIO_GRPC_CLIENT_CERT=/etc/wafio/certs/waf/client.crt
WAFIO_GRPC_CLIENT_KEY=/etc/wafio/certs/waf/client.key
WAFIO_AGENT_NAME=waf-prod-01
WAFIO_ENGINE_LIB_REQUIRED=1
WAFIO_SECURITY_DATA_DIR=/opt/wafio/security-data
WAFIO_GEO_COUNTRY_DB_PATH=/opt/wafio/security-data/geoip/country.mmdb
WAFIO_GEO_CITY_DB_PATH=/opt/wafio/security-data/geoip/city.mmdb
WAFIO_GEO_ASN_DB_PATH=/opt/wafio/security-data/geoip/asn.mmdb
WAFIO_UA_BAD_BOT_FILE=/opt/wafio/security-data/user-agents/bot.txt
WAFIO_JA4_BLACKLIST_FILE=/opt/wafio/security-data/ja4/ja4.txt
WAFIO_JA4_ALLOWLIST_FILE=/opt/wafio/security-data/ja4/ja4_allowlist.txt
systemctl daemon-reload
systemctl enable --now wafio-waf-agent
systemctl status wafio-waf-agent

Reload tanpa downtime

systemctl reload wafio-waf-agent mengirim SIGUSR2: proses baru mengambil alih socket yang sedang listen, dan proses lama menyelesaikan request yang tersisa. Unit memakai Type=notify dengan NotifyAccess=all. Agent mengirim READY=1 setelah bundle pertama diterapkan, baik bundle yang diterima langsung dari control plane maupun last-bundle.json dari cache jika control plane tidak dapat dijangkau saat agent mulai berjalan, atau setelah 20 detik jika belum ada bundle yang datang.

Variabel environment utama

VariabelWajibDeskripsi
WAFIO_GRPC_SERVERYaAlamat gRPC control plane (mis. 10.1.1.2:9090)
WAFIO_GRPC_CA_CERTYaPath ke sertifikat CA agent
WAFIO_GRPC_CLIENT_CERTYaPath ke sertifikat klien agent
WAFIO_GRPC_CLIENT_KEYYaPath ke private key agent
WAFIO_AGENT_NAMEYaNama agent yang ditampilkan di dashboard. Sertifikat hasil enrollment hanya menerima nama yang dipakai saat enrollment
WAFIO_GEO_COUNTRY_DB_PATHYaDatabase GeoIP negara, mis. /opt/wafio/security-data/geoip/country.mmdb. Berkas harus ada dan tidak kosong, jika tidak agent tidak mau berjalan
WAFIO_GEO_CITY_DB_PATHYaDatabase GeoIP kota, mis. /opt/wafio/security-data/geoip/city.mmdb
WAFIO_GEO_ASN_DB_PATHYaDatabase GeoIP ASN, mis. /opt/wafio/security-data/geoip/asn.mmdb
WAFIO_UA_BAD_BOT_FILEYaDaftar user agent bot jahat, mis. /opt/wafio/security-data/user-agents/bot.txt
WAFIO_JA4_BLACKLIST_FILEYaDaftar fingerprint JA4, mis. /opt/wafio/security-data/ja4/ja4.txt. Jika tidak diatur, agent memakai ja4.txt pertama yang ditemukan di security-data/ja4/, /etc/wafio/security-data/ja4/, dan /usr/local/share/wafio/ja4/; daftar JA3 (WAFIO_JA3_BLACKLIST_FILE) juga memenuhi syarat ini
WAFIO_GRPC_SERVER_NAMETidakNama dalam sertifikat gRPC control plane (server.grpc_domain), diperlukan jika WAFIO_GRPC_SERVER berupa alamat IP atau nama lain
WAFIO_SECURITY_DATA_DIRTidakDirektori data keamanan (default /etc/wafio/security-data); installer mengatur /opt/wafio/security-data
WAFIO_ENGINE_LIB_REQUIREDTidak1 membuat library mesin yang hilang atau tidak dapat dipakai menjadi fatal saat agent mulai. Installer mengaturnya. Tanpa pengaturan ini, agent tetap berjalan dan meneruskan trafik tanpa deteksi semantik
WAFIO_STATE_DIRTidakDirektori cache bundle; defaultnya StateDirectory milik systemd
WAFIO_BUNDLE_CACHE_MAX_AGETidakUsia bundle di cache sebelum dilaporkan usang (default 168h); bundle itu tetap dipakai
WAFIO_BODY_DECODE_BUDGET_BYTESTidakBatas memori untuk mendekode body request terkompresi di seluruh proses (default 64 MiB, 0 = tanpa batas)
WAFIO_WAF_STORE_MAX_ENTRIESTidakKapasitas setiap store rate limit dan blokir L7 (default 100.000, minimum 1.000)
WAFIO_METRICS_ADDRTidakEndpoint OpenMetrics opt-in GET /metrics pada IP literal loopback, mis. 127.0.0.1:9100

Mode pemeliharaan

Mode pemeliharaan (maintenance mode) membuat WAF agent menjawab setiap request untuk satu aplikasi dengan halaman 503 selama Anda mengerjakan aplikasi atau upstream-nya. WAF agent menjawab sebelum langkah lain: tanpa inspeksi, tanpa menghubungi upstream, dan tidak ada keputusan yang dicatat. Ini berlaku untuk semua method dan juga di mode Monitor. Sakelarnya ada di tab Maintenance pada halaman aplikasi, dan control plane mengirim perubahan itu ke WAF agent yang melayani aplikasi. Mode pemeliharaan tidak pernah berakhir sendiri: matikan setelah pekerjaan selesai. Perkiraan waktu selesai yang dapat Anda isi ditampilkan kepada pengunjung dan dikirim sebagai Retry-After, tetapi tidak mematikan sakelar.

Siapa yang tetap dapat masuk

Request yang cocok dengan salah satu pengaturan ini menjalankan seluruh pipeline normal, seolah-olah mode pemeliharaan mati.

PengaturanPerilaku
Allowed IP addressesAlamat IPv4 atau IPv6 dan rentang CIDR. Request dinilai dari IP klien setelah penanganan trusted proxy, yaitu alamat yang sama dengan yang dipakai bagian lain dari agent.
Allowed pathsPath yang diawali /. Path itu dibandingkan dengan path yang sudah di-decode dan dot segment-nya sudah diselesaikan, yaitu path yang diterima upstream Anda. Request cocok jika path-nya sama dengan sebuah entri atau berada di bawahnya (/healthz mencakup /healthz/x, bukan /healthzx), atau diawali entri yang berakhir dengan /. Pencocokan membedakan huruf besar dan kecil. Path yang memuat ; juga harus cocok setelah path parameter dibuang dari path itu dan dari entri, karena servlet container merutekan /healthz/..;/admin ke /admin. / saja ditolak: entri itu meloloskan setiap request.

Yang diterima pengunjung

Format jawaban mengikuti header Accept: text/html mendapat HTML, jika tidak maka header yang memuat json mendapat JSON, jika tidak maka yang memuat xml mendapat XML, selain itu HTML. Hanya halaman HTML yang dapat diganti, lewat Custom HTML. Di halaman kustom, {{WAFIO_MESSAGE}} adalah pesan Anda, atau teks bawaan, yang sudah di-escape sesuai format, dan {{WAFIO_END_TIME}} adalah perkiraan waktu selesai dalam bentuk YYYY-MM-DDTHH:MM:SSZ selama waktu itu belum lewat, selain itu kosong. Waktu selesai yang sudah lewat dianggap tidak ada. Jawaban JSON memuat key status, maintenance, message, dan expected_end. Request HEAD hanya mendapat header.

HeaderNilai
Cache-Controlno-store
X-Content-Type-Optionsnosniff
Retry-AfterJumlah detik sampai perkiraan waktu selesai, hanya selama waktu itu belum lewat
VaryOrigin

Diputuskan dari head request

WAF agent memutuskan dari request line dan header. Body request tidak dibaca ke memori dan tidak diteruskan. Upload yang melebihi batas body mendapat 503, bukan 413, dan request dengan Expect: 100-continue langsung mendapat 503 final tanpa 100 Continue lebih dulu.

  • Tanpa body, atau Content-Length: 0: koneksi tetap terbuka dan request berikutnya pada koneksi itu dijawab.
  • Dengan body (Content-Length di atas 0, body chunked, atau Expect: 100-continue): 503 membawa Connection: close. Setelah itu WAF agent menutup koneksi sesudah membuang hingga 256 KiB atau satu detik dari data yang masih dikirim klien, agar klien sempat membaca jawabannya. Data itu tidak disimpan. Request yang di-pipeline setelah request tersebut tidak dijawab; klien dapat mengirimnya lagi pada koneksi baru.

WAF agent tidak membaca upload sampai habis hanya demi mempertahankan koneksi: itu tidak berguna selama pemeliharaan. Request yang diloloskan dibaca dan diperiksa seperti biasa.

Koneksi yang sudah terbuka

Saat mode pemeliharaan menyala, atau saat daftar yang diizinkan berubah, WAF agent menerapkannya juga pada koneksi yang sudah terbuka milik klien yang tidak diizinkan. Sebuah koneksi dianggap diizinkan menurut IP klien dan path yang dipakai saat koneksi dibuka. Aplikasi lain pada agent yang sama tidak terpengaruh. Mematikan mode pemeliharaan tidak mengubah koneksi apa pun.

KoneksiYang terjadi
Handshake WebSocketDitolak dengan 503. Tidak ada yang di-upgrade.
Sesi WebSocket yang terbukaDitutup dalam sekitar 2 detik setelah agent menerapkan perubahan. Agent mengirim close frame dengan kode 1001 dan alasan Maintenance ke klien dan ke upstream sekaligus, lalu menutup kedua koneksi. Agent tidak menunggu balasan mereka. Sesi dari IP yang diizinkan atau pada path yang diizinkan tetap berjalan; jika kemudian Anda menghapus IP atau path itu dari daftar, sesinya ditutup.
Event stream (Content-Type: text/event-stream)Berakhir untuk klien yang tidak diizinkan: agent mengirim chunk terakhir jika responsnya chunked, menutup koneksi, dan melepas koneksi ke upstream. Event stream milik klien yang diizinkan tetap berlanjut.
Respons streaming lain (unduhan, ekspor, jawaban API yang di-stream)Selesai sampai habis.

Event stream tidak punya akhir dan akan membuat backend Anda terus sibuk selama seluruh masa pemeliharaan. Unduhan adalah request yang dimulai sebelum pemeliharaan: memutusnya menyisakan file rusak bagi pengunjung, dan timeout upstream sudah menghentikan unduhan yang macet.

Saat agent di-reload (lihat Reload tanpa downtime), proses lama menutup setiap sesi WebSocket yang masih dipegangnya dengan kode 1001 dan alasan Going away. Klien terhubung kembali ke proses baru, yang memegang konfigurasi terbaru dan menjawab handshake dengan 503 selama mode pemeliharaan menyala.

Aplikasi browser di situs lain

Aplikasi browser dari origin lain dapat membaca jawaban pemeliharaan, sehingga single-page app dapat menampilkan pesan Anda alih-alih network error. Hanya jawaban pemeliharaan yang mendapat header ini. Request yang melewati pemeliharaan, dan aplikasi yang tidak dalam mode pemeliharaan, tidak diubah.

RequestDitambahkan pada jawaban
Tanpa header Origin, atau yang tidak validVary: Origin
Origin yang valid: null, atau scheme://host[:port] dalam ASCII yang dapat dicetak, tanpa koma, paling panjang 256 byteVary: Origin, Access-Control-Allow-Origin berisi origin itu, Access-Control-Allow-Credentials: true, dan Access-Control-Expose-Headers: Retry-After
Preflight: OPTIONS dengan Origin yang valid dan Access-Control-Request-Method berupa token sepanjang paling banyak 32 byteStatus 204 tanpa body, Access-Control-Allow-Origin berisi origin itu, Access-Control-Allow-Methods berisi method yang diminta, Access-Control-Allow-Headers berisi daftar yang diminta (hanya jika isinya token dan koma dan paling panjang 1024 byte), Access-Control-Max-Age: 0, Cache-Control: no-store, X-Content-Type-Options: nosniff, dan Vary: Origin, Access-Control-Request-Method, Access-Control-Request-Headers. Tanpa Access-Control-Allow-Credentials.

Mengapa ini aman: isi jawabannya teks publik, yaitu pesan Anda dan perkiraan waktu selesai. 503 itu tidak menyetel cookie dan tidak memuat data upstream Anda, sehingga mengizinkan halaman di situs lain membacanya, bahkan dengan cookie, tidak membocorkan apa pun. Browser sudah mengirim simple request lintas origin; header ini hanya membuat halaman dapat membaca jawabannya.

Batasnya

Request yang membawa cookie dan memerlukan preflight, misalnya POST JSON dengan credentials, tetap gagal di browser selama mode pemeliharaan menyala. Agent tidak dapat mengetahui bahwa sebuah preflight dan request sesudahnya berkaitan. Jika preflight mengizinkan credentials dan mode pemeliharaan berakhir di antaranya, halaman di situs lain dapat meloloskan request dengan credentials yang memerlukan preflight sampai ke aplikasi Anda. Karena alasan yang sama Access-Control-Max-Age bernilai 0, sehingga persetujuan itu tidak tersimpan di cache preflight browser, dan agent tidak mengirim header Access-Control-Allow-Private-Network.

Batas

PengaturanBatas
MessagePaling banyak 500 karakter, teks biasa. Jika kosong, dipakai "We are carrying out planned maintenance. Please check back soon."
Custom HTMLPaling besar 64 KiB (65.536 byte).
Allowed IP addressesPaling banyak 50 entri.
Allowed pathsPaling banyak 20 entri, masing-masing paling panjang 256 byte. Satuannya byte, bukan karakter: satu karakter di luar ASCII memakai 2 sampai 4 byte.
Expected endHarus di masa depan saat Anda mengisi atau mengubahnya atau menyalakan mode pemeliharaan, dan dalam 365 hari.
Konfigurasi satu WAF agentWAF agent menerima konfigurasi paling besar 4 MiB dalam satu pesan, sehingga control plane menjaga seluruh konfigurasi yang dikirimnya ke satu agent paling besar 4.193.280 byte. Halaman kustom semua aplikasi dalam mode pemeliharaan pada agent itu ikut dihitung, dan <, >, serta & dihitung 6 byte per karakter di sana. Menyalakan mode pemeliharaan, menyimpan pengaturannya, memindahkan aplikasi dalam mode pemeliharaan ke agent lain, atau memberi aplikasi seperti itu listen port dan upstream untuk pertama kalinya ditolak dengan 409 dan kode MAINTENANCE_BUNDLE_TOO_LARGE jika akan melewati ukuran itu, dan pesan error menunjukkan ukuran yang akan tercapai. Mematikan mode pemeliharaan tidak pernah ditolak.

Dukungan agent

  • Mode pemeliharaan memerlukan WAF agent yang melaporkan fitur maintenance_mode. Control plane menolak menyalakannya jika agent yang melayani aplikasi sudah terhubung tetapi tidak melaporkan fitur itu (409, kode MAINTENANCE_UNSUPPORTED).
  • Selama mode pemeliharaan menyala, aplikasi hanya dapat dipindah ke WAF agent yang melaporkan fitur itu; jika tidak, control plane menolak pemindahan dengan kode yang sama. Pemindahan ke agent yang konfigurasinya akan melewati batas di atas ditolak dengan MAINTENANCE_BUNDLE_TOO_LARGE.
  • Agent yang mendukung mode pemeliharaan tetapi lebih lama daripada rilis yang menambahkan perilaku di halaman ini tetap mengirim 503, tetapi membaca body request lebih dulu, tidak mengirim header CORS, dan membiarkan sesi WebSocket yang terbuka tetap berjalan. Upgrade agent itu untuk mendapatkan semua yang dijelaskan di sini.

Pemasangan host agent

Host agent berjalan di Linux dan menyediakan dua kemampuan: firewall eBPF tingkat kernel (XDP/TC) dan penelusuran runtime (hook syscall/tracepoint). Host agent memerlukan hak akses root dan kernel Linux 5.10+ dengan BTF aktif.

Persyaratan
  • Kernel Linux 5.10+ dengan BTF (CONFIG_DEBUG_INFO_BTF=y); kernel 5.8 dan 5.9 tidak didukung
  • Hak akses root (layanan systemd berjalan sebagai root)
  • Verifikasi BTF: ls /sys/kernel/btf/vmlinux; file itu harus ada
  • Objek eBPF berformat CO-RE (Compile Once, Run Everywhere), sehingga tidak perlu kernel header saat pemasangan
  • Hanya Linux amd64 (x86_64): host agent tidak berjalan di macOS maupun ARM
KernelControl planeAturan jaringanPaketMasukHost agentPerbarui mapBPF mapData aturanXDP dan TCHook paketXDP_PASSXDP_DROPKernelPencarianControl planeAturan jaringanHost agentPerbarui mapBPF mapData aturanXDP dan TCHook paketPaketMasukXDP_PASSXDP_DROP
  • Pembaruan aturan
  • Paket diizinkan
  • Paket dibuang

Mendaftarkan host

  1. Buka Hosts di sidebar proyek Anda
  2. Klik Register host dan isi nama
  3. Panduan Connect this host menampilkan host key satu kali, beserta perintah instalasi yang sudah siap pakai
  4. Jalankan perintah itu di server sebagai root:
curl -fsSL https://wafio.cloud/install.sh -o wafio-install.sh && printf '%s\n' '<host key>' | sudo bash wafio-install.sh host-agent --host-key-stdin \
  --url 'https://<dashboard>' \
  --ca-sha256 '<CA SHA-256>'

# WAF agent on the same host (optional name, default <hostname>@waf)
curl -fsSL https://wafio.cloud/install.sh -o wafio-install.sh && printf '%s\n' '<host key>' | sudo bash wafio-install.sh waf-agent --host-key-stdin \
  --url 'https://<dashboard>' \
  --ca-sha256 '<CA SHA-256>' \
  --agent-name 'web-01@waf'

Installer membuat private key agent di server dan hanya mengirim certificate signing request, yang diautentikasi dengan host key, ke POST /api/internal/host-enroll. Installer tidak menulis apa pun kecuali CA agent milik control plane cocok dengan --ca-sha256. --url harus https:// (http:// hanya untuk loopback). Key dikirim lewat stdin sehingga tidak muncul di ps maupun log sudo; tanpa --host-key-stdin, installer meminta key tanpa menampilkan ketikan (tanpa echo).

Masa enrollment

Host key hanya dapat dipakai untuk enrollment dalam 24 jam sejak host dibuat atau key-nya dirotasi, satu kali per agent untuk setiap key. Satu host menyimpan paling banyak 4 kredensial hasil enrollment. Untuk menambah agent nanti atau memperbarui sertifikat, rotasi key di halaman host lalu jalankan perintah yang baru. Mencabut atau menghapus host juga mencabut kredensial hasil enrollment-nya dan memutus koneksi agent-nya.

Alternatif manual: terbitkan kredensial proyek di halaman Credentials lalu jalankan sudo bash wafio-install.sh host-agent --bundle credential.tar; installer kemudian menanyakan host key dan menyimpannya sebagai WAFIO_HOST_KEY di /etc/wafio/host-agent.env.

Layanan systemd

Installer memasang unit ini dari bundle host agent. Unit membaca interface, path objek BPF, dan path database GeoIP dari <code>/etc/wafio/host-agent.env</code>, yang diisi installer sesuai server Anda. Komentar dari berkas aslinya tidak ditampilkan di sini:

[Unit]
Description=WAFio Host Agent (eBPF Firewall + Runtime Security)
After=network.target

[Service]
Type=simple
User=root
SupplementaryGroups=wafio
EnvironmentFile=-/etc/wafio/host-agent.env
ExecStart=/usr/local/bin/wafio-host-agent \
  --interface         ${WAFIO_INTERFACE} \
  --ebpf=true \
  --xdp-obj           ${WAFIO_EBPF_XDP_OBJ} \
  --tc-obj            ${WAFIO_EBPF_TC_OBJ} \
  --geoip-db          ${WAFIO_GEOIP_DB} \
  --trace=true \
  --trace-obj         ${WAFIO_TRACE_OBJ}
Restart=on-failure
RestartSec=5
StandardOutput=journal
StandardError=journal
SyslogIdentifier=wafio-host-agent
LimitMEMLOCK=infinity
AmbientCapabilities=CAP_BPF CAP_NET_ADMIN CAP_SYS_ADMIN CAP_PERFMON CAP_KILL CAP_SYS_RESOURCE CAP_SYS_PTRACE
CapabilityBoundingSet=CAP_BPF CAP_NET_ADMIN CAP_SYS_ADMIN CAP_PERFMON CAP_KILL CAP_SYS_RESOURCE CAP_SYS_PTRACE
NoNewPrivileges=yes
PrivateTmp=yes
ProtectSystem=strict
ProtectHome=yes
BindReadOnlyPaths=-/etc/wafio/certs/host/client.crt -/etc/wafio/certs/host/client.key -/etc/wafio/certs/host/ca.crt
RestrictSUIDSGID=yes
LockPersonality=yes
RuntimeDirectory=wafio
RuntimeDirectoryMode=0755
RuntimeDirectoryPreserve=yes
StateDirectory=wafio-host-agent
StateDirectoryMode=0700
LogsDirectory=wafio
ReadWritePaths=/sys/fs/bpf -/etc/wafio/ebpf

[Install]
WantedBy=multi-user.target
# /etc/wafio/host-agent.env
WAFIO_GRPC_SERVER=cp.example.com:9090
WAFIO_GRPC_CA_CERT=/etc/wafio/certs/host/ca.crt
WAFIO_GRPC_CLIENT_CERT=/etc/wafio/certs/host/client.crt
WAFIO_GRPC_CLIENT_KEY=/etc/wafio/certs/host/client.key
WAFIO_AGENT_NAME=web-01@ebpf
WAFIO_INTERFACE=eth0
WAFIO_EBPF_XDP_OBJ=/opt/wafio/ebpf/wafio_xdp.o
WAFIO_EBPF_TC_OBJ=/opt/wafio/ebpf/wafio_tc.o
WAFIO_TRACE_OBJ=/opt/wafio/ebpf/wafio_trace.o
WAFIO_GEOIP_DB=/opt/wafio/security-data/geoip/country.mmdb
WAFIO_LOCAL_API_TOKEN_GROUP=wafio

Yang dipantau host agent

Eksekusi proses
Setiap execve beserta command line lengkap, parent/grandparent, UID, cgroup, dan konteks container.
Akses file
Pembukaan file pada path sensitif (/etc/passwd, /proc/, web shell) beserta flag baca/tulis.
Koneksi jaringan
Koneksi TCP keluar: mendeteksi callback C2, reverse shell, dan eksfiltrasi data.
Privilege escalation
Panggilan setuid dan setgid, prctl, ptrace, mount, pemuatan modul kernel, dan pemuatan program BPF, terlihat di tingkat syscall.

Pengayaan data container

Host agent mengikuti event start dan stop container di socket Docker API (Docker, Podman, atau Docker rootless; <code>WAFIO_CONTAINER_SOCKET</code> memilih salah satunya) dan memperbarui seluruh daftar setiap 30 detik. Host agent memetakan cgroup ID ke metadata container (image, nama, label, pod/namespace Kubernetes). Semua event penelusuran dari container diberi tag konteks ini. Tanpa socket, host agent tetap berjalan tanpa konteks ini.

Kredensial (mTLS)

Setiap agent mengautentikasi diri ke control plane dengan sertifikat klien mutual TLS yang ditandatangani oleh CA agent internal milik control plane, tanpa CA publik. Fingerprint sertifikat menghubungkan agent dengan proyeknya.

Control planeMenandatanganiKredensialDiterbitkan CAAgentMemasangnyamTLS gRPCControl planeMenandatanganiKredensialDiterbitkan CAAgentMemasangnya
  • Kredensial dan kebijakan keluar
  • Event kembali

Dua jenis kredensial

KredensialCara pembuatanTerikat pada
Hasil enrollment (disarankan)Instalasi satu perintah dari Hosts › Connect this host: private key dibuat di host, control plane menandatangani CSR-nya (berlaku 365 hari). Yang disimpan hanya sertifikat dan fingerprint-nya.Satu host, jenis agent (host atau WAF), dan nama agent
Tingkat proyekDiterbitkan di halaman Credentials; private key dibuat oleh control plane dan ditampilkan sekali.Proyek: agent boleh terhubung dengan nama apa pun

Menerbitkan kredensial proyek

  1. Buka Credentials di proyek Anda
  2. Isi nama yang deskriptif (mis. waf-prod-edge atau host-vpn-server)
  3. Tentukan masa berlaku dalam hari (default: 365)
  4. Pilih Agent type (WAF agent atau Host agent); pilihan ini menentukan unit systemd di dalam bundle
  5. Klik Issue credential
  6. Panel menampilkan kredensial satu kali saja: klik Download bundle (.tar) sebelum meninggalkan halaman, lalu berikan file itu ke installer dengan --bundle

Isi bundle kredensial (wafio-<name>-bundle.tar)

FileDeskripsi
ca.crtSertifikat CA agent: dipakai agent untuk memverifikasi identitas control plane
client.crtSertifikat klien agent: ditunjukkan ke control plane saat handshake TLS
client.keyPrivate key agent: ditampilkan sekali, tidak pernah disimpan di server
wafio-<name>.serviceContoh unit systemd untuk instalasi manual tanpa installer
Catatan keamanan

Private key (client.key) tidak pernah disimpan di control plane. Jika hilang, cabut kredensialnya dan terbitkan yang baru. Pencabutan berlaku dalam hitungan detik: agent langsung terputus.

Mencabut kredensial

Klik Revoke di samping kredensial yang sudah diterbitkan. Koneksi agent terputus dalam hitungan detik. Pencabutan berlaku seketika dan permanen: terbitkan kredensial baru agar agent dapat terhubung kembali. Kredensial hasil enrollment dicabut bersama host-nya: mencabut atau menghapus host akan menghapus kredensial itu dan menutup koneksi agent-nya.

Firewall

Firewall WAFio bekerja di tingkat kernel dengan hook eBPF XDP dan TC. Paket masuk diperiksa di XDP, sebelum sampai ke network stack kernel; paket keluar diperiksa di TC egress.

AntarmukaPaket masukHost agentPerbarui mapCek aturanDi BPF mapXDP_PASSDiizinkanXDP_DROPDitolakAntarmukaPaket masukCek aturanDi BPF mapHost agentPerbarui mapXDP_PASSDiizinkanXDP_DROPDitolak
  • Paket diizinkan
  • Paket dibuang
  • Pembaruan aturan

Jenis aturan firewall

Jenis aturanDeskripsi
BlocklistMembuang semua lalu lintas masuk dari alamat IPv4/IPv6, prefiks CIDR, atau rentang tertentu
AllowlistSelalu meloloskan lalu lintas dari sumber tepercaya, sebelum aturan blokir. Satu entri dapat dibatasi ke port TCP/UDP tertentu (hingga 8 cakupan port; memerlukan agent yang melaporkan fitur allowlist_ports)
Egress blocklistMembuang paket keluar ke alamat tertentu di TC egress (eksfiltrasi, callback C2)
Geo-blockingBerbasis GeoIP: mode block membuang lalu lintas dari negara yang terdaftar; mode allow membuang setiap sumber publik di luar negara yang terdaftar (memerlukan conntrack dan konfirmasi eksplisit)
Port rulesMengizinkan, membuang, atau mencatat paket menurut port, protokol, dan arah. Deny all untuk lalu lintas masuk atau keluar adalah default yang Anda atur di Firewall › Settings
SYN flood protectionSakelar di Firewall › Settings: mendeteksi dan meredam SYN flood
Port scan detectionSakelar di Firewall › Settings: menghitung port tujuan yang berbeda per sumber; dengan Drop on detect, paket dari sumber yang memindai dibuang

Penerapan aturan

Aturan dikirim ke agent sebagai pembaruan BPF map: aturan berlaku seketika tanpa mengganggu lalu lintas. Agent tidak perlu di-restart. Perubahan tampil di dashboard dalam 1 sampai 2 detik. Agent menyimpan kondisi terakhir yang berfungsi di disk dan menerapkannya kembali setelah restart.

Perlindungan lockout

Sebelum kumpulan aturan diterapkan, control plane dan agent memastikan aturan itu tidak membuat Anda terkunci dari server: Deny All inbound memerlukan connection tracking dan allow TCP permanen pada port SSH yang dilaporkan (22 jika tidak ada yang dilaporkan); Deny All egress memerlukan connection tracking; blokir wildcard atau blokir seluruh address family memerlukan connection tracking dan entri allowlist lockout-escape; mode geo allow memerlukan connection tracking, minimal satu negara, dan konfirmasi. Kumpulan aturan yang ditolak ditampilkan di halaman host beserta alasannya; tidak ada yang diterapkan.

Mode enforcement

ModePerilaku
MonitorHanya memantau: paket yang cocok dihitung sebagai would-drop, dan dicatat jika Log dropped packets aktif (default); semua paket tetap diteruskan
EnforcePaket yang cocok dibuang di kernel

Pemakaian memori

Firewall menyimpan statusnya di BPF map yang dialokasikan kernel saat host agent mulai, berapa pun lalu lintasnya. Agent menentukan ukuran map ini dari memori host, sehingga server kecil tidak menanggung kapasitas server besar. Host dengan memori 8 GB atau lebih mendapat ukuran penuh.

Memori hostMemori kernel untuk map yang diukur (perkiraan)
1 GB28 MB
2 GB45 MB
4 GB90 MB
8 GB atau lebih180 MB

Untuk mengatur skalanya sendiri, isi WAFIO_EBPF_MAP_SCALE di /etc/wafio/host-agent.env lalu restart host agent. Nilai bawaannya auto. Angka di atas 0 dan paling besar 1 menggantikan skala hasil hitungan: 1 memberi ukuran penuh di host mana pun. Agent mencatat ukuran yang dipakai setiap kali mulai.

Map yang penuh tidak membuang lalu lintas yang sah. Tabel koneksi membuang alur yang paling lama tidak dipakai, dan balasan untuk koneksi yang dibuka host tetap lolos. Tabel per sumber yang penuh (SYN flood, rate limit, port scan) melewatkan pemeriksaan untuk sumber baru dan menghitungnya; sumber yang sudah dilacak tetap dilacak. Dashboard menampilkan skala, ukuran tiap map, dan apakah sebuah map pernah penuh: Firewall › Overview untuk map firewall, Runtime security › Agent untuk map trace.

Runtime Security

Runtime Security memasang hook pada syscall kernel lewat tracepoint eBPF dan mendeteksi perilaku mencurigakan di sumbernya, tanpa menunggu deteksi berbasis log setelah kejadian.

AmatiexecveopenatconnectPerkayaProses, parentUser, pathContainerCocokkanKebijakan hostAlertDashboardTegakkanHentikan prosesAmatiexecveopenatconnectPerkayaProses, parentUser, pathContainerCocokkanKebijakan hostAlertDashboardTegakkanHentikan proses
  • Event yang memunculkan alert
  • Proses dihentikan

Aturan deteksi

WAFio menambahkan sekumpulan aturan deteksi bawaan ke setiap host saat host itu didaftarkan. Aturan bawaan tidak dapat dihapus (hanya dinonaktifkan). Aturan kustom dapat ditambah, diubah, atau dihapus oleh member proyek (role member atau lebih tinggi). Setiap aturan memiliki kondisi berurutan yang digabung dengan AND dan satu aksi:

AksiEfek
suppressMembuang event: mengurangi noise dari proses yang sudah dikenal aman
escalateMenaikkan tingkat keparahan event: memastikan event bernilai tinggi mendapat perhatian
downgradeMenurunkan tingkat keparahan: menyetel aturan yang berisik tanpa menonaktifkannya
tagMenambahkan label ke event: berguna untuk korelasi SIEM

Field kondisi

Aturan dapat mencocokkan: comm, parent_comm, grandparent_comm, event_name, category, severity, filename, addr, port, uid, gid, addr_family, flags, detail, ret_val, is_container, exe_verified, container_image, container_name. ret_val adalah hasil syscall: negatif untuk open yang gagal, dan 0 untuk open yang hasilnya tidak tercatat.

Operator yang didukung: eq, neq, in, not_in, contains, starts_with, starts_with_any, glob, gte, lte, dan uji bit bit_and / bit_none pada flags dan detail.

Nama proses (comm beserta parent-nya) ditentukan oleh proses itu sendiri. exe_verified bernilai true hanya untuk PID 1 dan kumpulan proses terlindungi yang diverifikasi agent: agent itu sendiri, serta proses seperti sshd, systemd, containerd, dockerd, dan kubelet (ditambah nama yang diatur lewat WAFIO_PROTECTED_PROCESSES) saat proses itu menjalankan binary milik host. Aturan yang membuang event sebaiknya mewajibkannya; aturan suppress bawaan yang menyebut nama proses sudah mewajibkannya, seperti pada contoh di bawah.

Contoh: suppress event jaringan dari dockerd yang terverifikasi

conditions:
  - field: comm
    op: eq
    value: dockerd
  - field: category
    op: eq
    value: network
  - field: exe_verified
    op: eq
    value: true
action: suppress

Kebijakan enforcement

Selain aturan deteksi, kebijakan runtime menentukan apa yang terjadi saat event yang ditelusuri cocok:

AksiPerilaku
MonitorHanya mencatat
AlertMencatat dan mengirim alert ke control plane
SimulateMencatat seolah-olah kebijakan diterapkan, tanpa bertindak
KillMengirim SIGKILL ke proses yang cocok lewat pidfd yang terverifikasi; tidak pernah menyasar proses sistem yang dilindungi seperti PID 1, sshd, atau systemd

Untuk memblokir lalu lintas keluar ke suatu alamat, pakai egress blocklist di firewall (Firewall, Access rules, Egress blocklist); untuk menghentikan proses, pakai Kill. Kebijakan Kill yang tidak mempersempit kecocokannya (menurut proses, path, atau tujuan) memerlukan konfirmasi eksplisit di dashboard sebelum diterapkan.

Ekspor SIEM

Keputusan WAF BLOCK dan LOG dapat dikirim sebagai JSON ke webhook untuk SIEM atau log collector Anda. Atur di kebijakan WAF (Project settings › Default WAF policy › SIEM delivery, atau per aplikasi); halaman setiap WAF agent menampilkan status pengirimannya.

Mesin deteksi

WAFio menganalisis setiap request dengan mesin semantik, satu mesin untuk setiap kelas serangan. Setiap mesin menimbang bukti yang ditemukannya di dalam request: bukti kuat memblokir request, bukti yang lebih lemah dicatat dan request diteruskan. Baca panduan bergambar tentang pemindaian semantik

Mesin semantik (20 analyzer)

Dua puluh analyzer khusus bahasa dan struktural memakai campuran parser, tokenisasi, heuristik, dan pemeriksaan pola. Analyzer memeriksa input ternormalisasi yang didukung, dengan pre-filter dan konkurensi mesin yang dibatasi. Tidak semua mesin memakai AST, dan cakupan bergantung pada input serta kebijakan yang aktif.

CegatReverse proxyPeriksaBatas, aturanHash uploadMesin semantikPutusanKuat atau lemahAplikasiIzinkan/catatDiblokir403CegatReverse proxyPeriksaBatas, aturanHash uploadMesin semantikPutusanKuat atau lemahAplikasiIzinkan/catatDiblokir403
  • Request diizinkan
  • Request diblokir
AnalyzerMendeteksiTeknik utama
SQLSQL injectionParsing AST SQL penuh, UNION, subquery, boolean blind, komentar berversi (/*!50000*/)
XSSCross-site scriptingParser HTML/JS, analisis event handler, penghindaran CRLF, rantai decode entity, obfuskasi protokol
CMDOS command injectionDeteksi metakarakter shell, ekspansi $IFS, escape oktal ANSI-C, substitusi backtick/proses
Prompt InjectionJailbreak pada aplikasi LLM / AI (tier LOG; memblokir jika ada di alamat path chat)Penimpaan system prompt, pelarian lewat roleplay, pembajakan delimiter/tag, injeksi markdown/eksfiltrasi
Open RedirectRedirect tanpa validasi & relay phishing (tier LOG)Parameter redirect (next, return_to, goto, dan lainnya) yang menunjuk ke origin lain, termasuk bentuk // dan /\
LFILocal file inclusion / path traversalPola ../, null byte, varian ter-encode, nama pendek Windows 8.3
SSRFServer-side request forgeryTarget RFC-1918, endpoint metadata cloud (169.254.169.254), alamat terjemahan IPv6
JavaDeserialisasi Java, SpEL/OGNL, Log4ShellPembukaan lookup Log4j secara rekursif, obfuskasi bersarang, varian protokol JNDI
PHPPHP code injection, penyalahgunaan wrapperphp://, data://, deteksi fungsi berbahaya, eval hasil penggabungan string
PythonPython code / template injectioneval/exec, os.system, gadget chain __class__.__mro__, opcode pickle
NoSQLNoSQL injectionInjeksi operator MongoDB ($where, $ne, $gt), injeksi ekspresi JS, penyelundupan operator berenkode JSON
LDAPLDAP injectionInjeksi metakarakter filter, filter boolean blind, penyalahgunaan wildcard / null byte pada DN dan filter pencarian
SSTIServer-side template injectionSintaks ekspresi Jinja2 / Twig / Freemarker / Velocity, gadget sandbox escape, probe aritmetika
XXEXML external entityDeklarasi external / parameter entity, DTD SYSTEM / PUBLIC, eksfiltrasi OOB, ekspansi billion laughs
DeserDeserialisasi yang tidak amanStream serialisasi Java (rO0 / ac ed), objek PHP O:/a:, pickle Python, penanda gadget .NET / YAML
Proto PollutionPrototype pollutionInjeksi key __proto__ / constructor / prototype pada JSON dan parameter query/body
Header InjectionCRLF / response splittingPerintah header, mail, atau cache setelah pemisah baris. Diblokir jika pemisah barisnya ter-encode atau perintahnya perintah mail atau cache; header setelah pemisah baris biasa hanya dicatat
GraphQLPenyalahgunaan GraphQLQuery introspeksi (dicatat); batch yang melebihi batas operasi diblokir dengan HTTP 400
JWTToken palsu (tier block)alg: none, path traversal lewat kid
AnomalyRequest yang tidak biasaKarakter kontrol dan entropi tinggi pada nilai yang panjang, parameter query yang belum pernah dilihat proyek (dicatat); User-Agent dari pemindai kerentanan yang dikenal (diblokir)

Agent mengubah laporan mesin-mesin itu menjadi satu keputusan untuk request: ALLOW, LOG, atau BLOCK. Jika sebagian request tidak diperiksa penuh (nilai yang terlalu besar atau terpotong, batas jumlah field, body biner), keputusan mencatat celah cakupan itu, dan request menjadi LOG, bukan ALLOW yang bersih. Dengan "on_uninspected": "block" di bawah semantic_policies pada JSON kebijakan, request itu menjadi BLOCK, kecuali jika setiap celahnya berasal dari beban atau dari pilihan Anda sendiri, misalnya mesin yang Anda matikan; dalam hal itu request tetap LOG.

Cara sebuah request diputuskan

Dua belas mesin menimbang bukti dan punya dua nilai bukti, nilai blokir dan satu nilai yang lebih rendah. Parser mesin itu membandingkan bukti yang ditemukannya dengan keduanya. Pemeriksaan pola cepat berjalan lebih dulu dan tidak memakai nilai ini:

evidence >= block value   → BLOCK (403)
evidence >= lower value   → LOG, the request passes
otherwise                 → ALLOW

Request berstatus LOG tetap sampai ke aplikasi; itu deteksi lemah. Jika Record weak detections dimatikan, request itu dicatat sebagai request yang diizinkan biasa. Mesin yang diatur ke Log only tidak pernah memblokir: yang seharusnya diblokir dicatat sebagai LOG. Mesin yang dimatikan tidak memeriksa apa pun.

Tingkat sensitivitas

Tingkat diatur untuk tiap mesin. Dua belas mesin punya tingkat: SQL, XSS, CMD, PHP, Python, LFI, SSRF, Java, NoSQL, SSTI, XXE, dan Deser. Delapan mesin lainnya tidak punya tingkat: pilihannya Block, Log only, atau Off.

TingkatBukti yang dibutuhkan mesinAkibat
RelaxedSekitar seperempat lebih banyak daripada BalancedLebih sedikit deteksi dan lebih sedikit false positive.
BalancedNilai bawaanDefault.
StrictSekitar seperlima lebih sedikit daripada BalancedLebih banyak deteksi dan lebih banyak false positive.

Mengurangi false positive

  • Atur mesin yang memicu false positive ke Relaxed, di Project settings › Default WAF policy › Detection
  • Atur mesin itu ke Log only selama Anda menyelidikinya: mesin mencatat dan tidak memblokir apa pun
  • Tambahkan aturan di Rule paths untuk rute yang sudah diketahui aman (health check, webhook)
  • Matikan sebuah mesin untuk satu path di Rule paths, bukan untuk seluruh proyek

Referensi konfigurasi

Konfigurasi dibaca dari config/config.yaml, dan variabel environment WAFIO_* menimpa nilainya. Setiap key YAML punya padanan env var: server.http_addr menjadi WAFIO_SERVER_HTTP_ADDR.

Pengaturan wajib dan ukuran pool

KeyEnv varDeskripsi
database.nameWAFIO_DATABASE_NAMENama database PostgreSQL: server menolak berjalan jika kosong
jwt.secretWAFIO_JWT_SECRETMinimal 32 karakter. Boot ditolak jika kosong atau masih berupa placeholder dari contoh konfigurasi, di semua environment, bukan hanya production
totp.enc_keyWAFIO_TOTP_ENC_KEYMengenkripsi secret 2FA saat disimpan. Wajib, dan harus didekode menjadi tepat 32 byte: openssl rand -hex 32
database.max_connsWAFIO_DATABASE_MAX_CONNSOpsional. Ukuran pool bersama, default 20. Satu pool melayani ingest keputusan, query dashboard, autentikasi, dan jalur host, sehingga default driver max(4, NumCPU) membuat lonjakan lalu lintas WAF dapat menghabiskan koneksi untuk dashboard. Jaga jumlah total dari semua proses yang menuju satu database tetap di bawah max_connections-nya
database.min_connsWAFIO_DATABASE_MIN_CONNSOpsional. Koneksi yang dijaga tetap terbuka, default 2. Tidak boleh lebih besar dari database.max_conns

Hot reload atau perlu restart

Kelompok pengaturanPerilaku reload
server.*, database.*, jwt.*, log.levelPerlu restart: dibaca saat boot
smtp.*, server.base_urlDibaca saat boot; jika diisi, nilainya didahulukan dari dashboard (smtp.host yang tidak kosong membuat seluruh konfigurasi mail server dikelola lewat file konfigurasi)
Administration › Email (SMTP)Dipakai jika smtp.host kosong: diterapkan langsung, tanpa restart (password disimpan terenkripsi dan tidak pernah ditampilkan lagi)
Administration › Data retentionRetensi per tabel dan batas ukuran database: diterapkan langsung, tanpa restart
JSON aturan WAF proyekDikirim ke agent lewat gRPC secara otomatis: tanpa restart

Pengaturan umum

server:
  http_addr: ":9087"              # HTTP listen address (dashboard + API)
  agent_grpc_addr: "0.0.0.0:9090" # gRPC mTLS listen address for agents
  grpc_domain: "cp.example.com"   # name in the gRPC server certificate
  base_url: "https://cp.example.com"  # absolute link base for emails
  trusted_proxies: ["127.0.0.1", "::1"]  # reverse proxies whose header is trusted (empty = none)
  proxy_header: X-Forwarded-For   # or X-Real-IP
  agent_recv_account_mib_per_sec: 64   # agent data taken in per account, MiB/s (0 = default)
  agent_recv_total_mib_per_sec: 128    # all accounts together, shared fairly (0 = default)

database:
  host: localhost
  port: 5432
  name: wafio
  user: wafio
  password: secret                # raw, never percent-encoded
  max_conns: 20
  statement_timeout_ms: 15000     # 0 = off, else 1000–600000

jwt:
  secret: "output-of-openssl-rand-hex-32"
  expire_hours: 72

totp:
  enc_key: "output-of-openssl-rand-hex-32"

log:
  level: info                     # debug | info | warn | error

smtp:                             # optional; or Administration › Email (SMTP)
  host: smtp.example.com
  port: 587
  encryption: starttls            # auto | starttls | ssl | none
  username: noreply@example.com
  password: smtp-password
  from: "Wafio <noreply@example.com>"

Di belakang reverse proxy pada host yang sama, atur trusted_proxies seperti di atas dan konfigurasikan proxy agar mengirim X-Forwarded-For $proxy_add_x_forwarded_for (atau X-Real-IP $remote_addr dengan proxy_header: X-Real-IP); jika tidak, semua klien tampak sebagai 127.0.0.1 bagi login lockout, rate limit, dan audit log.

Metrik

Atur WAFIO_METRICS_ADDR=127.0.0.1:9100 (IP literal loopback; nilai lain menghentikan proses saat mulai berjalan) pada control plane, WAF agent, atau host agent untuk menyajikan OpenMetrics di GET /metrics pada listener terpisah. Control plane juga melaporkan ukuran dan retensi database (wafio_db_size_bytes, wafio_db_size_alert_level, wafio_retention_days, …) serta batas penerimaan data agent (wafio_agent_recv_*).

Konfigurasi WAF proyek (JSON per proyek)

Setiap proyek menyimpan kebijakan WAF-nya sebagai rules_json (diubah di Project settings › Default WAF policy); kebijakan aplikasi yang berisi {} mewarisi kebijakan proyek. Key yang tidak ditulis memakai nilai default: menghilangkan key tidak pernah mematikan mesin; hanya disabled: true yang melakukannya. Mesin dengan action: "log" mencatat temuannya dan tidak memblokir apa pun.

{"semantic_policies": {
    "scan_all_headers": true,
    "sql": {"block_threshold": 4.0, "soft_threshold": 2.5},
    "graphql": {"action": "log"},
    "ldap": {"disabled": true}
  },
  "geo": {"block_countries": [], "allow_countries": []},
  "bot_protection": {"enabled": false, "mode": "off"},
  "l7_flood": {"enabled": true, "window_sec": 60, "max_requests": 500},
  "request_body_limit": "5M"
}

Timeout upstream

Timeout proxy setiap aplikasi diatur dari dashboard, di halaman WAF Agent dan Application. Nilainya dibaca sebagai tiga keadaan:

NilaiArti
0Tidak diatur: default bawaan berlaku
-1Tanpa batas: tidak ada tenggat yang diberlakukan. Tampil sebagai checkbox Unlimited di dashboard
di atas 0Milidetik

Timeout upstream berlaku untuk upstream HTTP maupun FastCGI. Jika tidak diatur, nilainya 30 detik.

Yang sebenarnya dihilangkan Unlimited

Hanya tenggat untuk respons backend. Request yang tidak pernah selesai menahan koneksi (dan worker PHP-FPM di belakangnya) sampai backend menjawab atau klien menyerah. Timeout dial, antrean connection pool, dan idle tetap dibatasi; timeout itu melindungi sumber daya WAFio sendiri, bukan waktu kerja backend.

Pilih nilai terbatas yang sedikit di bawah batas proxy front-end Anda, dan beri backend batas sendiri (request_terminate_timeout untuk PHP-FPM). Unlimited mengubah error pada detik ke-30 menjadi request yang menggantung: kadang memang itu yang Anda inginkan, kadang justru lebih buruk.

Rilis bertanda tangan

Setiap bundle rilis WAFio di wafio.cloud memiliki tanda tangan Ed25519 di manifest rilis (latest.json), bukan di dalam arsipnya. install.sh memeriksa SHA-256 dari manifest, lalu memeriksa tanda tangannya terhadap public key rilis yang tertanam di installer, dan menolak memasang bundle yang tidak bertanda tangan, ditandatangani oleh key lain, atau yang manifest-nya menyebut public key yang berbeda.

Checksum hanya membuktikan bahwa byte tiba dengan utuh, bukan dari mana asalnya: siapa pun yang mengendalikan tempat unduhan dapat menyajikan binary apa saja bersama hash yang benar. Tanda tangan menutup celah itu. Payload yang ditandatangani mengikat versi ke hash bundle, sehingga tanda tangan yang valid untuk rilis lama tidak dapat dipakai untuk menyamar sebagai rilis yang lebih baru.

Agent tidak memperbarui dirinya sendiri: tidak ada jalur self-update. Upgrade server mana pun dengan menjalankan ulang installer (lihat Upgrade instalasi yang sudah ada), yang menerapkan pemeriksaan yang sama.

Verifikasi manual

GET /api/download/<component>/sig mengembalikan versi, SHA-256, tanda tangan, dan public key sebuah bundle. Payload yang ditandatangani adalah wafio-release-v1, versi, dan SHA-256, masing-masing pada barisnya sendiri.

Unduhan

WAFio dapat diunduh gratis dari portal wafio.cloud, tanpa akun, pendaftaran, atau API key. Setiap unduhan bundle menambah satu pada hitungan harian per komponen dan jenis klien (installer, browser, atau crawler). Alamat dan data lain tentang klien tidak disimpan.

Endpoint unduhan

EndpointAuthDeskripsi
GET /api/download/manifestTidak adaMengembalikan latest.json berisi versi dan checksum SHA-256 semua bundle
GET /api/download/controlplaneTidak adaMengunduh bundle control plane (amd64)
GET /api/download/waf-agentTidak adaMengunduh bundle WAF agent (amd64)
GET /api/download/host-agentTidak adaMengunduh bundle host agent (amd64)
GET /api/download/<component>/sigTidak adaTanda tangan rilis Ed25519, versi, SHA-256, dan public key sebuah bundle
GET /api/download/<component>/sbomTidak adaSoftware bill of materials (SBOM) berformat SPDX JSON untuk sebuah bundle, jika dipublikasikan
GET /api/download/statsTidak adaJumlah bundle yang diunduh installer dan browser, serta hari pertama yang dihitung

Memakai API

# Check current version and checksums
curl -s https://wafio.cloud/api/download/manifest | python3 -m json.tool

# Download WAF agent bundle (no key needed)
curl -fsSL "https://wafio.cloud/api/download/waf-agent" -o wafio-waf-agent.tar.gz

# Verify checksum
EXPECTED=$(curl -s https://wafio.cloud/api/download/manifest \
  | python3 -c "import sys,json; print(json.load(sys.stdin)['bundles']['waf-agent']['sha256'])")
echo "$EXPECTED  wafio-waf-agent.tar.gz" | sha256sum -c

Isi bundle

Setiap bundle berupa arsip .tar.gz yang berisi binary, skrip bantu install.sh, NOTICES.txt, dan README.txt. Bundle control plane juga membawa dashboard (frontend/) dan migrations/ database. Bundle WAF agent juga membawa engine library libwafio_semantic_engine.so beserta .sha256-nya, dan unit systemd-nya. Bundle host agent juga membawa objek eBPF CO-RE dan unit systemd-nya.

Respons error

Status HTTPKondisi
400Nama komponen tidak dikenal (harus controlplane, waf-agent, atau host-agent)
429Lebih dari 60 request dalam satu menit dari satu klien (RATE_LIMITED)
503Bundle, tanda tangan, atau SBOM belum dipublikasikan: periksa manifest untuk versi terkini