Libreria e API di firma digitale

PAdES (PDF Advanced Electronic Signatures) è un formato di firma elettronica in cui la firma è incorporata nel file PDF; è definito dalla norma ETSI EN 319 142. Il documento firmato resta un PDF, si verifica nel pannello firme di lettori come Adobe Reader e può avere un campo firma visibile sulla pagina. I livelli salgono da B-B a B-T (con marca temporale), B-LT e B-LTA (archiviazione a lungo termine).

CAdES (CMS Advanced Electronic Signatures) è un formato di firma elettronica basato sulla struttura CMS/PKCS#7; è definito dalla norma ETSI EN 319 122. Può firmare qualsiasi tipo di file; la firma viaggia di solito con il documento come .p7s o in una busta firmata. In Turchia è il formato più usato nella corrispondenza ufficiale firmata elettronicamente.

XAdES (XML Advanced Electronic Signatures) è un formato di firma elettronica sviluppato per i documenti XML; è definito dalla norma ETSI EN 319 132. La firma può essere incorporata nell'XML oppure separata. Si usa per documenti XML come la fattura elettronica in formato UBL-TR.

Una libreria di firma digitale è un componente per sviluppatori (SDK) che aggiunge la creazione e la verifica di firme elettroniche al suo software. Un'applicazione di firma pronta offre una schermata all'utente; la libreria è un mattone senza schermata: firma la sua applicazione, nel suo flusso. Funziona con smart card, token o HSM e genera e verifica i formati CAdES, XAdES e PAdES.

Il pacchetto e-Yazışma è il pacchetto standard usato nella corrispondenza elettronica ufficiale con le istituzioni pubbliche turche: documento firmato, file di metadati ed eventuali allegati vengono riuniti in un unico pacchetto. Tra istituzioni viene di solito inviato tramite KEP (posta elettronica certificata).

Un pacchetto e-Yazışma ufficiale unisce il file di metadati e il documento firmato. La libreria lo fa con una sola chiamata: firma il documento in CAdES o XAdES, genera metadati conformi allo schema e chiude il pacchetto. Sono supportate le versioni 1.3 e 2.0 di e-Yazışma e il certificato radice KamuSM è integrato. Se indica una cartella, firma in blocco i documenti che contiene.

La libreria entra nel suo software: è il suo flusso ad avviare la firma e l'interfaccia è sua. L'applicazione pronta (İmzacı) funziona sul desktop: l'utente sceglie il file e lo firma. Entrambe usano la stessa infrastruttura di firma; quale le serve dipende da chi avvia la firma, il suo software o l'utente.

CAdES (BES, EPES, T, C, X, XL, A), XAdES (BES, T, C, X, XL, A), PAdES (B-B, B-T, B-LT, B-LTA) e ASiC-S e ASiC-E. Con un'unica libreria arriva fino al livello di archiviazione a lungo termine.

No. La libreria è modulare; per il PDF basta il pacchetto eSignature.PAdES. Standard, TSA e fornitori hardware che non usa non entrano mai nel progetto.

La firma non si genera nel browser ma lato server della sua applicazione web: si richiama il pacchetto eSignature.PAdES e il PDF firmato torna all'utente. Conta dove si trova la chiave: con HSM cloud, HSM di rete o firma mobile il server può accedere alla chiave, quindi tutto il flusso passa dal web. Se la chiave è sulla smart card dell'utente, il browser non può accedere alla carta; in quel caso si firma sul desktop con İmzacı.

Sì. La fonte di firma è astratta: smart card e token USB (CNG/PKCS#11), HSM di rete, servizi HSM cloud e firma mobile si usano con lo stesso flusso. Ogni fornitore è un pacchetto indipendente.

Sì. Verifica della catena di certificati RFC 5280, CRL, OCSP, Delta CRL e verifica offline sono nella libreria; lo stesso componente genera e verifica la firma.

Sì. L'applicazione desktop che si usa senza scrivere codice è İmzacı: firma PDF e XML con smart card, crea pacchetti e-Yazışma e firma in blocco per cartella.

Aggiungere al progetto il pacchetto dello standard che serve: eSignature.PAdES per la firma PDF, il pacchetto XAdES per l'XML. Poiché la libreria è suddivisa in 39 pacchetti NuGet, installa solo ciò che usa; nel progetto non entra un'unica grande dipendenza.

Tramite Windows CNG e PKCS#11 sono supportati dispositivi come AKİS, SafeNet/eToken, Gemalto/Thales, IDEMIA, Feitian, YubiKey e Nitrokey. Ogni fornitore è un pacchetto separato e indipendente; i driver che non usa non entrano nel progetto.

Sì. Sono supportati gli HSM di rete Thales Luna, Utimaco ed Entrust nShield, oltre ad AWS CloudHSM/KMS, Azure Key Vault HSM e Google Cloud KMS. Così si realizza un flusso di firma automatica sul server, senza un utente con la carta.

No; lo stesso componente genera e verifica la firma. Verifica della catena di certificati RFC 5280, CRL, OCSP, Delta CRL e verifica offline sono nella libreria.