BSrE - BSSN Integration Guide

Panduan & Kriteria Integrasi Sistem TTE BSrE

Pedoman teknis, alur tahapan, dan kriteria kepatuhan integrasi Tanda Tangan Elektronik menggunakan Esign Client Service API v2 di lingkungan Pemerintah Kota Mojokerto.

Infrastruktur Server Esign Client (Diskominfo Kota Mojokerto)
Server Esign Client Dev dan Esign Client Prod dikelola sepenuhnya oleh Dinas Kominfo Kota Mojokerto dan telah beroperasi aktif. Pengembang aplikasi OPD tidak perlu menyediakan server client fisik sendiri, namun server aplikasi pemohon wajib terhubung ke Jaringan Intranet Pemkot Mojokerto (VPN / Local Fiber FO) untuk mengakses endpoint API.
Server Ready (Intranet Only)

Aplikasi yang Telah Terintegrasi

Daftar aplikasi Pemerintah Kota Mojokerto yang telah mengantongi Surat Rekomendasi/Registrasi resmi BSrE.

Total 6 Aplikasi
NoNama AplikasiNomor Surat RegistrasiTanggal RegistrasiTahunOrganisasi Perangkat Daerah (OPD)
1E-surat2092/BSSN/BS/KH.02.01/06/202114 June 20212021Bagian Umum
2Simojo--2020DPMPTSP
3SiraSa5816/BSSN/BS/SE.02.01/10/202310 October 20232023BPKPD
4Ekinerja5235/BSSN/BS/SE.02.01/08/202519 September 20252025BKPSDM
5Esign (Sicantik)1745/BSSN/BS/SE.02.01/02/2026Feb 20262026BKPSDM
6Tapak Asta1794/BSSN/BS/SE.02.01/02/2026Feb 20262026Diskominfo

Alur Tahapan Integrasi & Estimasi Waktu Pelaksanaan

Rangkaian tahapan pelaksanaan integrasi sistem aplikasi SKPD dengan layanan Esign Client BSrE Kota Mojokerto.

1 1 - 3 Hari Kerja

Pengajuan & Konsultasi

OPD mengajukan permohonan integrasi dan melakukan konsultasi terkait kebutuhan sistem, alur proses bisnis tanda tangan, identifikasi penandatangan, serta kesiapan integrasi.

Pelaksana: OPD Pemohon & Diskominfo
2 2 - 4 Hari Kerja

Pemberian Akses Dev Client + Bimtek

Diskominfo menyediakan kredensial akses ke server Esign Client Development (intranet) dan memberikan bimbingan teknis (bimtek) terkait integrasi API v2 serta standar implementasi.

Pelaksana: Diskominfo
3 5 - 14 Hari Kerja

Penerapan Modul

Tim pengembang OPD mengimplementasikan pemanggilan API v2 (Sign PDF / E-Seal / User / Verify) pada aplikasi serta menerapkan 11 Kriteria Wajib Integrasi Sistem BSrE.

Pelaksana: OPD
4 2 - 3 Hari Kerja

Evaluasi Internal

Uji coba dan evaluasi bersama antara OPD dan Diskominfo untuk memverifikasi kesesuaian form passphrase, keamanan sistem, penanganan error, pencatatan log, dan keabsahan dokumen keluaran.

Pelaksana: OPD + Diskominfo
5 3 - 7 Hari Kerja

Uji Modul BSrE + Penerbitan Surat

Pelaksanaan asesmen resmi Uji Penerapan Modul bersama pihak BSrE BSSN dan penerbitan surat rekomendasi/pengesahan sistem dari Diskominfo untuk OPD pemohon.

Pelaksana: Diskominfo, BSrE & OPD
6 1 - 2 Hari Kerja

Pemberian Akses Prod + Go-Live

Diskominfo membuka akses ke server Esign Client Production, OPD mengalihkan konfigurasi production, dan sistem resmi go-live melayani tanda tangan elektronik tersertifikasi.

Pelaksana: Diskominfo + OPD

11 Kriteria Wajib Integrasi Sistem (BSrE - BSSN)

Berdasarkan Bab IV Pedoman Kriteria Integrasi Sistem BSrE, seluruh poin di bawah ini wajib dipenuhi untuk lulus asesmen Uji Penerapan Modul.

Kriteria I

Informasi Dokumen Keluaran Aplikasi

Mencantumkan informasi catatan kaki/footer pada dokumen keluaran aplikasi bahwa dokumen telah ditandatangani secara elektronik menggunakan Sertifikat Elektronik yang diterbitkan oleh Balai Sertifikasi Elektronik (BSrE) - BSSN.

Kriteria II

Mekanisme Pendaftaran Verifikator

Memisahkan akun masing-masing pengguna penandatangan karena satu akun memiliki satu sertifikat, dan akun melekat langsung pada sertifikat pribadi.

Kriteria III

Form Passphrase

Menambahkan input form khusus untuk pengisian passphrase pada saat penandatanganan dilakukan oleh pemilik sertifikat elektronik.

Kriteria IV

Nonaktifkan Fitur Auto Complete

Menonaktifkan fitur autocomplete (autocomplete='off') pada form pengisian passphrase agar browser tidak menyimpan frasa sandi pengguna.

Kriteria V

Tidak Mengaplikasikan Penyimpanan Passphrase

DILARANG KERAS menyimpan passphrase pada aplikasi, database, session, cookie, local storage, maupun log aplikasi.

Kriteria VI

Menggunakan Secure Sockets Layer (SSL/HTTPS)

Memasang sertifikat SSL terpercaya pada seluruh domain & subdomain aplikasi untuk menjamin enkripsi transmisi data penandatanganan.

Kriteria VII

Notifikasi Penandatangan Berhasil

Menampilkan notifikasi/feedback jelas kepada pengguna jika proses tanda tangan berhasil serta menyediakan akses unduh dokumen.

Kriteria VIII

Notifikasi Penandatangan Gagal

Menampilkan notifikasi kegagalan secara transparan dan menyajikan pesan respon dari server BSrE agar pengguna mengetahui alasan gagal.

Kriteria IX

Perekaman Log Gagal Tandatangan

Menerapkan pencatatan log audit trail untuk setiap kejadian kegagalan transaksi tanda tangan di sisi backend aplikasi.

Kriteria X

Perubahan Status Dokumen

Menerapkan mekanisme perubahan status dokumen secara berjenjang sebelum dan setelah dilakukan penandatanganan.

Kriteria XI

Status Dokumen Keluaran Aplikasi: Valid

Hasil tanda tangan pada dokumen keluaran aplikasi harus valid dan dapat diverifikasi keasliannya via verifikator PDF resmi.

Uji Coba API v2 di Playground Interaktif

Dilengkapi simulasi request, konversi PDF/Gambar Base64, dan generator code snippet (cURL, PHP, JS Fetch).

Buka API Playground