-
Register Signing Key (RSA) Kunci kriptografi untuk menandatangani setiap request. Wajib sebelum credential bisa digunakan.Wajib
-
Generate Credential Pertama Client ID + Client Secret untuk autentikasi aplikasi ke API sandbox.Wajib
-
IP Whitelist Daftarkan IP server yang boleh mengirim request. Wajib untuk production.Opsional
-
Callback URL Endpoint di server Anda untuk menerima notifikasi status transaksi.Opsional
Langkah 1 dan 2 wajib diselesaikan sebelum dapat mengirim request ke sandbox.
① RSA Public Key
Daftarkan sekali. Dipakai server untuk verifikasi tanda tangan digitalmu di setiap request.
② Credential (Client ID + Secret)
Identitas aplikasimu di API. Digabung dengan RSA Private Key oleh kodemu untuk menghasilkan Access Token.
③ Access Token
Dibuat otomatis oleh kodemu, berlaku 15 menit. Kamu tidak perlu membuat ini secara manual.
| Nama | Project | Env | Status | Sisa Aktif | Aksi | |
|---|---|---|---|---|---|---|
| payroll-1 | Project A | Sandbox | Aktif | 87 hari | ||
| payroll-2 | Project A | Production | Aktif | 45 hari | ||
| health-1 | Project B | Sandbox | Aktif | 45 hari | ||
| health-old | Project C | Sandbox | Kedaluwarsa | 0 hari | ||
| health-2 | Project B | Sandbox | Aktif | 60 hari | ||
| health-3 | Project B | Production | Aktif | 90 hari | ||
| retail-1 | Project D | Sandbox | Akan Kedaluwarsa | 5 hari |
Public key aktif terdaftar
Sistem Anda siap menandatangani request ke API Bank ABC menggunakan RSA.
Belum ada public key terdaftar
Daftarkan RSA public key Anda untuk mulai menandatangani request ke API Bank ABC.
Langkah berikutnya: kembali ke tab Credential untuk menggunakan credential yang sudah kamu buat, atau generate credential baru.
Public key terdaftar
Maks. 2 key aktif bersamaan (untuk rotasi)SHA256:7f3a9b2e1d4c6e8f0a5b3c7d9e2f4a6b
Generate RSA key pair
Jalankan di terminal. Simpan private_key.pem dengan aman; jangan unggah atau bagikan.
openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 \
-out private_key.pem
openssl rsa -pubout -in private_key.pem -out public_key.pemTempel dan daftarkan public key
Tempel isi key di antara baris BEGIN dan END
demo_snap_cid_7f3a9b2e1ddemo_privkey_sandbox_not_for_productionhttps://sandbox-api.bankabc.co.id/v1Daftarkan key baru
Generate key pair baru dan daftarkan di form di atas. Sistem menerima dua key aktif bersamaan selama 24 jam transisi.
Alihkan aplikasi
Update konfigurasi aplikasi ke private key baru, deploy, dan verifikasi request berhasil masuk.
Cabut key lama
Cabut key lama via tombol "Cabut" di tabel di atas. Key yang dicabut tidak dapat dipulihkan.
Pertanyaan umum
Apakah saya perlu mendaftarkan key sebelum generate credential?
Tidak wajib secara teknis, tapi credential hanya bisa digunakan untuk mengirim request bertanda tangan jika RSA Public Key sudah terdaftar. Urutan yang direkomendasikan: daftarkan key dulu, baru generate credential.
Apakah RSA key kedaluwarsa setelah 15 menit?
Tidak. RSA key pair tidak kedaluwarsa. Yang berumur 15 menit adalah token JWT yang dibuat otomatis oleh kode program Anda setiap kali mengirim request. Developer tidak perlu melakukan apa pun secara manual.
Berapa lama proses verifikasi setelah public key didaftarkan?
Di sandbox aktif dalam detik. Di production, verifikasi membutuhkan 1x24 jam kerja.
Bolehkah menggunakan key yang sama untuk sandbox dan production?
Tidak disarankan. Gunakan key pair terpisah per environment untuk membatasi eksposur risiko.
| Alamat IP | Label | Environment | Didaftarkan | Status | Aksi |
|---|---|---|---|---|---|
| 103.23.45.67 | Backend Project A (Prod) | Sandbox | 15 Jan 2026 | Aktif | |
| 114.79.23.11 | Backend Project B | Sandbox | 20 Feb 2026 | Aktif | |
| 202.95.88.1 | Backend Project C (review) | Sandbox | 19 Mei 2026 | Menunggu Review |
Tambah IP baru
Gunakan IP statis. IP dinamis akan menyebabkan koneksi terputus setelah perubahan alamat.
200 OK dalam 5 detik.
| URL Endpoint | Project | Event | Didaftarkan | Status Terakhir | Aksi |
|---|---|---|---|---|---|
| https://erp.proyeka.co.id/api/callback | Project A | Semua event | 15 Jan 2026 | 200 OK · 09:41 | |
| https://hms.proyekb.id/webhook/bank | Project B | Semua event | 20 Feb 2026 | Timeout · 08:17 |
Tambah callback URL baru
| Waktu | Tindakan | Credential / Objek | Project | Oleh | IP Asal | Status |
|---|---|---|---|---|---|---|
| 23 Mei 2026 09:41 WIB | Generate | payroll-3 | Project A | dev@proyeka.co.id | 103.23.45.67 | Berhasil |
| 20 Mei 2026 14:32 WIB | Rotasi | payroll-1 | Project A | dev@proyeka.co.id | 103.23.45.67 | Berhasil |
| 15 Mei 2026 10:05 WIB | Autentikasi | public_key terdaftar | Semua | dev@proyeka.co.id | 103.23.45.67 | Berhasil |
| 10 Apr 2026 11:20 WIB | Cabut | health-old | Project C | admin@bank-abc.co.id | 10.0.0.1 | Berhasil |
| 05 Apr 2026 16:48 WIB | Generate | health-2 | Project B | ops@proyekb.id | 114.79.23.11 | Berhasil |
| 01 Mar 2026 09:10 WIB | Generate | health-3 | Project B | ops@proyekb.id | 114.79.23.11 | Berhasil |
| 20 Feb 2026 08:55 WIB | Generate | health-1 | Project B | ops@proyekb.id | 114.79.23.11 | Berhasil |
| 20 Feb 2026 08:30 WIB | Generate | retail-1 | Project D | dev@proyekd.id | 202.95.88.1 | Berhasil |
| 01 Feb 2026 13:22 WIB | Generate | payroll-2 | Project A | dev@proyeka.co.id | 103.23.45.67 | Berhasil |
| 15 Jan 2026 09:10 WIB | Generate | payroll-1 | Project A | dev@proyeka.co.id | 103.23.45.67 | Berhasil |
Log disimpan 90 hari. Seluruh tindakan pada credential tercatat dan tidak dapat diubah.