Client IP Whitelist

Mandatory — Client IP Whitelist

Setiap klien wajib mengonfigurasi IP Whitelist sebelum menggunakan Brick API di lingkungan Production. Brick hanya akan menerima permintaan API dari alamat IP yang telah didaftarkan dan diizinkan. Pastikan seluruh server yang mengirim permintaan ke Brick menggunakan static public IP.

Mengapa IP Whitelist Penting?

IP Whitelist adalah mekanisme keamanan yang membatasi akses API hanya dari alamat IP yang telah disetujui. Dengan mekanisme ini, permintaan dari alamat IP di luar daftar yang diizinkan akan ditolak, meskipun pihak tersebut mencoba mengakses endpoint Brick API.

Penerapan IP Whitelist penting karena Brick API memproses aktivitas finansial, termasuk penerimaan pembayaran dan pengiriman dana. Pembatasan sumber permintaan membantu:

Mencegah akses tidak sah: Hanya infrastruktur klien yang telah terdaftar yang dapat mengirim permintaan API.
Mengurangi risiko penyalahgunaan API: Permintaan dari jaringan atau server yang tidak dikenal dapat diblokir sebelum diproses lebih lanjut.
Melindungi transaksi finansial: Menambahkan lapisan pengamanan untuk mengurangi risiko permintaan transaksi dari sumber yang tidak diizinkan.
Mendukung kontrol dan audit keamanan: Memudahkan pengelolaan serta peninjauan alamat IP yang memiliki izin akses.

IP Whitelist merupakan lapisan keamanan tambahan, bukan pengganti API authentication, perlindungan credential, maupun kontrol keamanan lainnya.

Kriteria IP Whitelist

Kriteria	Ketentuan
Kewajiban	Mandatory untuk akses Brick API di Production
Jenis IP	Static public IP only
Jumlah maksimal	10 alamat IP per konfigurasi whitelist
Dynamic IP	Tidak didukung
Private/local IP	Tidak dapat digunakan sebagai sumber IP publik permintaan API
Cakupan	Permintaan masuk ke Brick API, termasuk Send Money dan Receive Money
Environment	Konfigurasi Sandbox dan Production dikelola secara terpisah
Sub-account	Konfigurasi dikelola secara terpisah untuk masing-masing sub-account

Important: Daftarkan public outbound IP yang benar-benar digunakan server Anda ketika mengirim permintaan ke Brick. Apabila menggunakan NAT Gateway, proxy, atau infrastruktur cloud, gunakan static public egress IP yang terlihat oleh Brick, bukan private IP server.

Cara Mengonfigurasi IP Whitelist

Login ke Brick Dashboard.
Buka halaman Configuration di Brick Dashboard.
Pilih tab Callback URL, tempat pengaturan IP Whitelist tersedia.
Temukan pengaturan IP Whitelist / Incoming Request Validation.
Tambahkan alamat static public IP yang digunakan server Anda untuk mengakses Brick API, maksimal 10 IP.
Simpan konfigurasi, lalu pastikan IP Whitelist telah aktif.
Lakukan pengujian API dari IP yang sudah terdaftar untuk memastikan permintaan dapat diproses.

Halaman Configuration dengan tab Callback URL dipilih

Pengaturan Client IP Whitelist di Brick Dashboard

Note: Periksa environment dan sub-account yang sedang dipilih sebelum menyimpan konfigurasi. Daftar IP pada Sandbox tidak otomatis berlaku untuk Production, begitu pula sebaliknya.

Bagaimana Validasi IP Bekerja?

Setiap permintaan API diperiksa berdasarkan alamat IP sumbernya.

Kondisi	Hasil
IP sumber terdaftar dalam whitelist	Permintaan diterima untuk melanjutkan proses autentikasi dan validasi API lainnya.
IP sumber tidak terdaftar	Permintaan ditolak dengan HTTP `401` dan kode error `ip_not_whitelisted`.

Contoh Respons IP Tidak Terdaftar

Code
{
  "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
}

Jika menerima error ip_not_whitelisted, verifikasi alamat public outbound IP yang digunakan oleh server dan pastikan IP tersebut sudah ditambahkan ke whitelist pada environment serta sub-account yang sesuai.

Sebelum Menggunakan Production

Pastikan seluruh aplikasi atau server yang akan mengakses Brick API menggunakan static public IP.
Daftarkan seluruh IP outbound yang diperlukan tanpa melebihi batas 10 IP.
Pastikan konfigurasi tersimpan pada environment Production dan sub-account yang benar.
Uji koneksi API dari IP yang terdaftar sebelum menjalankan transaksi Production.
Jika IP outbound berubah, perbarui whitelist terlebih dahulu agar integrasi tidak terganggu.

Untuk informasi tambahan, lihat Configuration Overview.

Last modified on November 11, 2026