EN — English

Muhamad Irga

Purwokerto, Jawa Tengah

Diperbarui

Aksara Office TTE — Hub Tanda Tangan Elektronik untuk Empat Aplikasi

Satu hub tanda tangan elektronik untuk SmartGovt, ASIS, Basmalah, dan Dumoro. Pengguna masuk lewat SSO dari aplikasinya sendiri, hanya melihat dokumen miliknya, lalu menandatangani; aplikasi diberi tahu lewat webhook bertanda tangan.

Pelajari layanannya: Jasa Pembuatan Aplikasi Pemerintah Daerah

Tangkapan layar

Kontrak integrasi v1: endpoint hub dan aplikasi, header HMAC, serta contoh permintaan dan respons dari dokumentasi
Tampilan utama aplikasi · Buka gambar untuk resolusi penuh
Halaman awal Aksara Office TTE yang meminta pengguna membuka layanan dari aplikasinya sendiri, dengan atribusi DocuSeal dan tautan kode sumber
Tampilan aplikasi 2 · Buka gambar untuk resolusi penuh

Ringkasan

Apa yang dikerjakan sistem ini.

Aksara Office TTE adalah hub tanda tangan elektronik (TTE) di tte.aksaraoffice.id untuk empat aplikasi: SmartGovt, ASIS, Basmalah, dan Dumoro. Pengguna membuka hub dari aplikasi yang sudah ia pakai. Hub mengenali akunnya lewat SSO dan hanya menampilkan dokumen milik akun itu. Tanda tangan hanya bisa dilakukan bila TTE pengguna aktif di aplikasi asalnya; hub membaca status itu, bukan menjalankan aktivasi sendiri.

Hub dibangun di atas DocuSeal, aplikasi tanda tangan dokumen open source berlisensi AGPL-3.0, yang dikunci dengan digest image. Proyek ini menambahkan lapisan Aksara di atasnya: satu akun hub per aplikasi asal, peran penanda tangan yang dibuat saat SSO pertama, SSO kode otorisasi dengan state, halaman "Dokumen Saya", dan API berversi yang dipanggil aplikasi untuk mengirim dokumen PDF atau HTML untuk ditandatangani. Setiap panggilan server-ke-server di kedua arah membawa tanda tangan HMAC-SHA256 atas string kanonik dengan timestamp dan nonce sekali pakai, dan kontraknya disertai vektor uji yang wajib lolos di setiap aplikasi. Saat dokumen selesai, ditolak, atau kedaluwarsa, hub mengirim webhook bertanda tangan, lalu aplikasi mengambil status resminya lagi dari API.

Berkas disimpan di bucket S3 privat dengan satu folder per aplikasi dan diakses lewat presigned URL berumur pendek. Merek vendor, analitik, dan halaman pemasaran dihapus saat build, dan build gagal bila nama vendor masih tersisa, sementara atribusi asli DocuSeal dan tautan kode sumber AGPL tetap ada di halaman tanda tangan. Nama produk, logo, dan stempel diatur di pengaturan admin. Deploy berupa stack Docker Compose dengan PostgreSQL, Gotenberg untuk HTML ke PDF, dan Caddy untuk HTTPS, lengkap dengan perintah build, backup, provisioning, dan cek penyimpanan, serta migrasi sekali jalan dari tata letak vendor. VIDA, PSrE berizin di Indonesia, bisa diaktifkan setelah kredensialnya diisi.

Daftar fitur

Rincian kemampuan

20 kemampuan yang diverifikasi langsung terhadap kode sumber proyek.

SSO & akun

  • Satu hub untuk SmartGovt, ASIS, Basmalah, dan Dumoro
  • SSO dari aplikasi asal dengan kode otorisasi, state, dan kode sekali pakai berumur 60 detik
  • Satu akun hub per aplikasi; identitas berupa pasangan aplikasi dan ID pengguna yang stabil
  • Halaman "Dokumen Saya" yang hanya menampilkan dokumen pengguna yang masuk
  • Tanda tangan hanya bisa dilakukan selama TTE pengguna aktif di aplikasi asal

API tanda tangan

  • API berversi untuk mengirim dokumen PDF (maks. 20 MB) atau HTML untuk ditandatangani
  • Permintaan idempoten berdasarkan external ID dari aplikasi
  • Satu sampai lima penanda tangan dengan kotak tanda tangan berkoordinat halaman ternormalisasi

Keamanan & penyimpanan

  • HMAC-SHA256 di setiap panggilan server-ke-server, dua arah, dengan timestamp dan nonce sekali pakai
  • Vektor uji yang wajib dihasilkan persis oleh helper di setiap aplikasi
  • Webhook bertanda tangan untuk dokumen selesai, ditolak, dan kedaluwarsa
  • Halaman dokumen selesai dan unduhan dijaga per penanda tangan
  • Penyimpanan S3 privat dengan folder per aplikasi dan presigned URL berumur pendek

Merek & lisensi

  • Nama, logo, dan stempel diatur di pengaturan admin, tanpa merek yang ditanam di kode
  • Penghapusan merek vendor saat build, dan build gagal bila masih tersisa
  • Atribusi DocuSeal dan paket kode sumber AGPL-3.0 disertakan di setiap build

Deploy

  • Tanda tangan lewat PSrE VIDA (opsional) setelah kredensial diisi
  • Stack Docker Compose dengan PostgreSQL, Gotenberg, dan Caddy
  • Skrip deploy untuk build, backup, provisioning, dan cek penyimpanan, serta rollback lewat tag image
  • Rangkaian uji end-to-end berisi 47 skenario terhadap aplikasi tiruan

Kapabilitas

Yang dirancang untuk ditangani.

Sorotan implementasi yang terdokumentasi di kode sumber proyek.

Aplikasi terhubung
4
SmartGovt, ASIS, Basmalah, dan Dumoro
Skenario end-to-end
47
Dijalankan terhadap aplikasi tiruan

Teknologi

Dibangun dengan 8 teknologi.

  • DocuSeal (Ruby on Rails)
  • PostgreSQL
  • Gotenberg
  • Caddy
  • Docker
  • Amazon S3
  • HMAC-SHA256
  • Python

Pertanyaan umum

Yang biasanya ditanyakan.

Kenapa satu hub, bukan tanda tangan di masing-masing aplikasi?

Tanpa hub, empat aplikasi butuh empat implementasi tanda tangan, empat pengaturan penyimpanan, dan empat integrasi PSrE. Dengan satu hub, setiap aplikasi cukup mengikuti kontrak kecil yang sama: endpoint SSO, endpoint status, webhook, dan panggilan ke API permintaan.

Apakah ini ditulis dari nol?

Tidak. Mesin tanda tangannya DocuSeal, dipakai sesuai lisensi AGPL-3.0 dengan atribusi dan tautan kode sumber tetap ada. Pekerjaan di proyek ini adalah lapisan integrasi, kontrak keamanan, penggantian merek saat build, tata letak penyimpanan, deploy, dan uji end-to-end.

Bagaimana aplikasi memercayai hub, dan sebaliknya?

Kedua sisi menandatangani setiap permintaan dengan rahasia bersama atas method, path, hash body, timestamp, dan nonce yang hanya boleh dipakai sekali. Permintaan yang lebih tua dari lima menit atau memakai nonce ulang ditolak, dan webhook diperlakukan sebagai pemberitahuan saja: aplikasi selalu mengambil status sebenarnya dari API.

Satu bidang

Butuh sistem seperti ini?

Kirim ringkasan singkat, saya balas dengan lingkup kerja, pendekatan, dan estimasi waktu yang jujur.