Biblioteka i API podpisu elektronicznego

PAdES (PDF Advanced Electronic Signatures) to format podpisu elektronicznego, w którym podpis jest osadzony w pliku PDF; definiuje go norma ETSI EN 319 142. Podpisany dokument pozostaje plikiem PDF, weryfikuje się go w panelu podpisów czytników PDF, takich jak Adobe Reader, i może mieć widoczne pole podpisu na stronie. Poziomy rosną od B-B przez B-T (ze znacznikiem czasu) i B-LT do B-LTA (długoterminowe archiwum).

CAdES (CMS Advanced Electronic Signatures) to format podpisu elektronicznego oparty na strukturze CMS/PKCS#7; definiuje go norma ETSI EN 319 122. Można nim podpisać plik dowolnego typu; podpis zwykle towarzyszy dokumentowi jako .p7s lub w podpisanej kopercie. W Turcji to najczęściej stosowany format w urzędowej korespondencji z podpisem elektronicznym.

XAdES (XML Advanced Electronic Signatures) to format podpisu elektronicznego opracowany dla dokumentów XML; definiuje go norma ETSI EN 319 132. Podpis może być osadzony w XML lub przechowywany osobno. Stosuje się go w dokumentach XML, takich jak e-faktura w formacie UBL-TR.

Biblioteka podpisu elektronicznego to komponent dla programistów (SDK), który wbudowuje składanie i weryfikację podpisów elektronicznych w Twoje oprogramowanie. Gotowa aplikacja do podpisu pokazuje użytkownikowi ekran; biblioteka to element bez ekranu — podpis składa Twoja aplikacja, w Twoim procesie. Działa z kartą kryptograficzną, tokenem lub HSM i tworzy oraz weryfikuje formaty CAdES, XAdES i PAdES.

Pakiet e-Yazışma to standardowy pakiet używany w urzędowej korespondencji elektronicznej z tureckimi instytucjami publicznymi: podpisany dokument, plik metadanych i ewentualne załączniki łączy się w jeden pakiet. Między instytucjami przesyła się go zwykle przez KEP (rejestrowaną pocztę elektroniczną).

Urzędowy pakiet e-Yazışma to plik metadanych i podpisany dokument spakowane razem. Biblioteka robi to jednym wywołaniem: podpisuje dokument w formacie CAdES lub XAdES, tworzy metadane zgodne ze schematem i zamyka pakiet. Obsługiwane są wersje e-Yazışma 1.3 i 2.0, a certyfikat główny KamuSM jest wbudowany. Jeśli wskażesz folder, dokumenty w nim zostaną podpisane zbiorczo.

Biblioteka trafia do Twojego oprogramowania: podpisywanie uruchamia Twój proces, interfejs należy do Ciebie. Gotowa aplikacja (İmzacı) działa na komputerze: użytkownik wybiera plik i go podpisuje. Obie korzystają z tej samej infrastruktury podpisu; co Ci odpowiada, zależy od tego, kto inicjuje podpis — Twoje oprogramowanie czy użytkownik.

CAdES (BES, EPES, T, C, X, XL, A), XAdES (BES, T, C, X, XL, A), PAdES (B-B, B-T, B-LT, B-LTA) oraz ASiC-S i ASiC-E. Z jedną biblioteką dochodzisz do poziomu długoterminowego archiwum.

Nie. Biblioteka jest modułowa; do PDF wystarczy pakiet eSignature.PAdES. Standardy, TSA i dostawcy sprzętu, których nie używasz, w ogóle nie trafiają do projektu.

Podpis nie powstaje w przeglądarce, lecz po stronie serwera Twojej aplikacji webowej: wywoływany jest pakiet eSignature.PAdES, a podpisany PDF wraca do użytkownika. Kluczowe jest to, gdzie znajduje się klucz — przy chmurowym HSM, sieciowym HSM lub podpisie mobilnym serwer ma dostęp do klucza, więc cały proces przebiega przez sieć. Jeśli klucz jest na karcie użytkownika, przeglądarka nie ma do niej dostępu; wtedy podpisuje się na komputerze za pomocą İmzacı.

Tak. Źródło podpisu jest wyabstrahowane: karta kryptograficzna i token USB (CNG/PKCS#11), sieciowe HSM, chmurowe usługi HSM i podpis mobilny działają w tym samym procesie. Każdy dostawca to niezależny pakiet.

Tak. Weryfikacja łańcucha certyfikatów wg RFC 5280, CRL, OCSP, Delta CRL i weryfikacja offline są w bibliotece; ten sam komponent tworzy i weryfikuje podpis.

Tak. Aplikacją desktopową, z której korzysta się bez pisania kodu, jest İmzacı: podpisuje PDF i XML kartą kryptograficzną, tworzy pakiety e-Yazışma i podpisuje zbiorczo całe foldery.

Dodać do projektu pakiet potrzebnego standardu: eSignature.PAdES do podpisu PDF, pakiet XAdES do XML. Ponieważ biblioteka jest podzielona na 39 pakietów NuGet, instalujesz tylko to, czego używasz; do projektu nie trafia jedna duża zależność.

Przez Windows CNG i PKCS#11 obsługiwane są urządzenia takie jak AKİS, SafeNet/eToken, Gemalto/Thales, IDEMIA, Feitian, YubiKey i Nitrokey. Każdy dostawca to osobny, niezależny pakiet; sterowniki, których nie używasz, nie trafiają do projektu.

Tak. Obsługiwane są sieciowe HSM Thales Luna, Utimaco i Entrust nShield, a także AWS CloudHSM/KMS, Azure Key Vault HSM i Google Cloud KMS. W ten sposób buduje się automatyczne podpisywanie na serwerze, bez użytkownika z kartą.

Nie; ten sam komponent tworzy i weryfikuje podpis. Weryfikacja łańcucha certyfikatów wg RFC 5280, CRL, OCSP, Delta CRL i weryfikacja offline są w bibliotece.