Library dan API tanda tangan elektronik

PAdES (PDF Advanced Electronic Signatures) adalah format tanda tangan elektronik yang menyematkan tanda tangan di dalam file PDF; didefinisikan oleh standar ETSI EN 319 142. Dokumen yang ditandatangani tetap berupa PDF, diverifikasi di panel tanda tangan pembaca PDF seperti Adobe Reader, dan dapat memiliki kolom tanda tangan yang terlihat di halaman. Tingkatannya naik dari B-B ke B-T (dengan stempel waktu), B-LT, dan B-LTA (arsip jangka panjang).

CAdES (CMS Advanced Electronic Signatures) adalah format tanda tangan elektronik berbasis struktur CMS/PKCS#7; didefinisikan oleh standar ETSI EN 319 122. Format ini dapat menandatangani file jenis apa pun; tanda tangan biasanya menyertai dokumen sebagai .p7s atau di dalam amplop bertanda tangan. Di Turki, ini adalah format yang paling banyak digunakan dalam korespondensi resmi bertanda tangan elektronik.

XAdES (XML Advanced Electronic Signatures) adalah format tanda tangan elektronik yang dikembangkan untuk dokumen XML; didefinisikan oleh standar ETSI EN 319 132. Tanda tangan dapat disematkan di dalam XML atau berdiri terpisah. Format ini digunakan untuk dokumen berbasis XML seperti e-faktur dalam format UBL-TR.

Library tanda tangan elektronik adalah komponen pengembang (SDK) yang menanamkan pembuatan dan verifikasi tanda tangan elektronik ke perangkat lunak Anda. Aplikasi tanda tangan siap pakai menampilkan layar bagi pengguna; library adalah blok penyusun tanpa layar — aplikasi Anda yang menandatangani, dalam alur kerja Anda. Library ini bekerja dengan kartu pintar, token, atau HSM serta membuat dan memverifikasi format CAdES, XAdES, dan PAdES.

Paket e-Yazışma adalah paket standar yang digunakan dalam korespondensi elektronik resmi dengan instansi pemerintah Turki: dokumen bertanda tangan, file metadata, dan lampiran (jika ada) digabungkan menjadi satu paket. Antarinstansi, paket ini biasanya dikirim melalui KEP (surel tercatat).

Paket e-Yazışma resmi adalah file metadata dan dokumen bertanda tangan yang dikemas bersama. Library melakukannya dalam satu panggilan: menandatangani dokumen dengan CAdES atau XAdES, membuat metadata sesuai skema, dan menutup paket. e-Yazışma versi 1.3 dan 2.0 didukung, dan sertifikat root KamuSM sudah tertanam. Jika Anda memberikan folder, dokumen di dalamnya ditandatangani secara massal.

Library masuk ke dalam perangkat lunak Anda: alur kerja Anda yang memicu penandatanganan dan antarmukanya milik Anda. Aplikasi siap pakai (İmzacı) berjalan di desktop: pengguna memilih file lalu menandatanganinya. Keduanya memakai infrastruktur tanda tangan yang sama; mana yang cocok bergantung pada siapa yang memulai tanda tangan — perangkat lunak Anda atau pengguna.

CAdES (BES, EPES, T, C, X, XL, A), XAdES (BES, T, C, X, XL, A), PAdES (B-B, B-T, B-LT, B-LTA), serta ASiC-S dan ASiC-E. Dengan satu library Anda mencapai tingkat arsip jangka panjang.

Tidak. Library ini modular; untuk PDF cukup paket eSignature.PAdES. Standar, TSA, dan penyedia perangkat keras yang tidak Anda pakai tidak akan pernah masuk ke proyek.

Tanda tangan tidak dibuat di browser, melainkan di sisi server aplikasi web Anda: paket eSignature.PAdES dipanggil dan PDF bertanda tangan dikembalikan ke pengguna. Penentunya adalah di mana kunci berada — dengan HSM cloud, HSM jaringan, atau tanda tangan seluler, server dapat mengakses kunci sehingga seluruh alur berjalan lewat web. Jika kunci ada di kartu pintar pengguna, browser tidak dapat mengakses kartu; dalam skenario itu penandatanganan dilakukan di desktop dengan İmzacı.

Ya. Sumber tanda tangan diabstraksikan: kartu pintar dan token USB (CNG/PKCS#11), HSM jaringan, layanan HSM cloud, dan tanda tangan seluler digunakan dengan alur yang sama. Setiap penyedia adalah paket yang berdiri sendiri.

Ya. Validasi rantai sertifikat sesuai RFC 5280, CRL, OCSP, Delta CRL, dan validasi offline ada di dalam library; komponen yang sama membuat sekaligus memverifikasi tanda tangan.

Ada. Aplikasi desktop yang digunakan tanpa menulis kode adalah İmzacı: menandatangani PDF dan XML dengan kartu pintar, membuat paket e-Yazışma, dan menandatangani seluruh folder secara massal.

Menambahkan paket standar yang dibutuhkan ke proyek: eSignature.PAdES untuk tanda tangan PDF, paket XAdES untuk XML. Karena library dipecah menjadi 39 paket NuGet, Anda hanya memasang yang Anda pakai; tidak ada satu dependensi besar yang masuk ke proyek.

Melalui Windows CNG dan PKCS#11 didukung perangkat seperti AKİS, SafeNet/eToken, Gemalto/Thales, IDEMIA, Feitian, YubiKey, dan Nitrokey. Setiap penyedia adalah paket terpisah yang berdiri sendiri; driver yang tidak Anda pakai tidak masuk ke proyek.

Bisa. HSM jaringan Thales Luna, Utimaco, dan Entrust nShield didukung, begitu pula AWS CloudHSM/KMS, Azure Key Vault HSM, dan Google Cloud KMS. Dengan cara ini alur penandatanganan otomatis dibangun di server tanpa pengguna yang memegang kartu.

Tidak; komponen yang sama membuat sekaligus memverifikasi tanda tangan. Validasi rantai sertifikat sesuai RFC 5280, CRL, OCSP, Delta CRL, dan validasi offline ada di dalam library.