01 / Pahami dasarnya
Credential mengenali Anda.
Whitelist mengenali sumbernya.
IP Whitelist adalah daftar alamat IP yang diizinkan mengakses Brick API. Saat request masuk, Brick memeriksa IP sumbernya. IP yang terdaftar dapat melanjutkan ke autentikasi dan validasi lainnya; IP di luar daftar akan ditolak.
Untuk aktivitas finansial seperti mengirim dana dan menerima pembayaran, pembatasan ini membantu mengurangi akses dari server yang tidak dikenal sekaligus memudahkan peninjauan infrastruktur yang diizinkan.
Tetap lindungi credential API dan jalankan kontrol keamanan lain pada integrasi Anda.
02 / Sebelum mulai
IP yang tepat, konfigurasi yang tepat.
Gunakan alamat IP publik statis yang benar-benar terlihat oleh Brick saat server Anda mengirim request.
IP publik statis
IP dinamis dan alamat IP privat/lokal tidak dapat digunakan sebagai IP sumber publik.
Maksimal 10 alamat
Batas berlaku untuk setiap konfigurasi whitelist.
Terpisah per environment
Daftar di Sandbox tidak otomatis berlaku di Production, begitu juga sebaliknya.
Terpisah per sub-account
Pastikan daftar IP disimpan untuk sub-account yang sesuai.
Menggunakan NAT Gateway atau proxy?
Daftarkan IP
publik keluar (egress IP) yang terlihat oleh Brick, bukan IP
privat server di belakangnya.
03 / Konfigurasi
Aktifkan dari Brick Dashboard.
Siapkan daftar IP publik statis Anda, lalu ikuti langkah berikut.
-
Buka pengaturan integrasi
Masuk ke Brick Dashboard, pilih Configuration → Callback URL, lalu temukan IP Whitelist / Incoming Request Validation.
-
Tambahkan IP publik statis
Periksa environment dan sub-account yang dipilih. Masukkan semua IP keluar yang diperlukan, maksimal 10 alamat IP.
-
Simpan, aktifkan, lalu uji
Simpan konfigurasi dan pastikan IP Whitelist aktif. Uji akses API dari IP yang terdaftar untuk memastikan request dapat diproses.
04 / Troubleshooting
Request ditolak? Periksa IP sumbernya.
IP yang tidak terdaftar akan menerima HTTP 401 dengan kode
ip_not_whitelisted. Cocokkan IP publik keluar server dengan
daftar pada environment dan sub-account yang benar.
{
"status": 401,
"error": {
"code": "ip_not_whitelisted",
"message": "Request is not coming from whitelisted IP",
"reason": "Source IP is not whitelisted in Brick servers"
},
"data": null
}Contoh respons dari dokumentasi resmi Brick.
05 / Pemeriksaan akhir
Sebelum transaksi pertama Anda.
Gunakan daftar ini untuk memeriksa kesiapan konfigurasi.
Jika IP keluar berubah, perbarui whitelist terlebih dahulu agar integrasi tetap berjalan. Checklist ini hanya catatan di halaman, bukan verifikasi akun.
06 / Pertanyaan umum
Hal yang sering ditanyakan.
Apakah IP Whitelist wajib?
Ya. Berdasarkan dokumentasi Brick saat ini, setiap client wajib mengonfigurasi IP Whitelist sebelum memakai Brick API di Production.
Bisakah saya memakai IP dinamis atau IP lokal?
Tidak. Gunakan IP publik statis sebagai sumber request. Untuk server di belakang NAT atau proxy, daftarkan IP publik keluar yang terlihat oleh Brick.
Apakah pengaturan Sandbox berlaku di Production?
Tidak. Sandbox dan Production dikelola terpisah. Konfigurasi setiap sub-account juga terpisah.
Apakah whitelist menggantikan autentikasi API?
Tidak. IP yang lolos whitelist tetap harus melewati autentikasi dan validasi API lainnya.
