Bibliothèque et API de signature électronique

PAdES (PDF Advanced Electronic Signatures) est un format de signature électronique dans lequel la signature est intégrée au fichier PDF ; il est défini par la norme ETSI EN 319 142. Le document signé reste un PDF, il se vérifie dans le panneau de signatures des lecteurs PDF comme Adobe Reader et peut porter un champ de signature visible sur la page. Les niveaux montent de B-B à B-T (horodaté), B-LT et B-LTA (archivage longue durée).

CAdES (CMS Advanced Electronic Signatures) est un format de signature électronique fondé sur la structure CMS/PKCS#7 ; il est défini par la norme ETSI EN 319 122. Il peut signer tout type de fichier ; la signature accompagne généralement le document sous forme de .p7s ou dans une enveloppe signée. En Turquie, c'est le format le plus utilisé dans la correspondance officielle signée électroniquement.

XAdES (XML Advanced Electronic Signatures) est un format de signature électronique conçu pour les documents XML ; il est défini par la norme ETSI EN 319 132. La signature peut être intégrée au XML ou rester séparée. Il est utilisé pour les documents XML comme la facture électronique au format UBL-TR.

Une bibliothèque de signature électronique est un composant pour développeurs (SDK) qui intègre la création et la vérification de signatures électroniques dans votre propre logiciel. Une application de signature prête à l'emploi présente un écran à l'utilisateur ; la bibliothèque est une brique sans écran : c'est votre application qui signe, dans votre flux. Elle fonctionne avec carte à puce, token ou HSM et produit et vérifie les formats CAdES, XAdES et PAdES.

Le paquet e-Yazışma est le paquet standard utilisé pour la correspondance électronique officielle avec les institutions publiques turques : le document signé, le fichier de métadonnées et les éventuelles pièces jointes sont réunis en un seul paquet. Entre institutions, il est généralement transmis par KEP (courrier électronique recommandé).

Un paquet e-Yazışma officiel réunit le fichier de métadonnées et le document signé. La bibliothèque le fait en un seul appel : elle signe le document en CAdES ou XAdES, produit des métadonnées conformes au schéma et ferme le paquet. Les versions 1.3 et 2.0 d'e-Yazışma sont prises en charge et le certificat racine KamuSM est intégré. Si vous fournissez un dossier, elle signe en lot les documents qu'il contient.

La bibliothèque s'intègre à votre logiciel : c'est votre flux qui déclenche la signature et l'interface vous appartient. L'application prête à l'emploi (İmzacı) fonctionne sur le poste de travail : l'utilisateur choisit le fichier et le signe. Les deux utilisent la même infrastructure de signature ; le bon choix dépend de qui lance la signature, votre logiciel ou l'utilisateur.

CAdES (BES, EPES, T, C, X, XL, A), XAdES (BES, T, C, X, XL, A), PAdES (B-B, B-T, B-LT, B-LTA) ainsi qu'ASiC-S et ASiC-E. Une seule bibliothèque vous mène jusqu'au niveau d'archivage longue durée.

Non. La bibliothèque est modulaire ; pour le PDF, le paquet eSignature.PAdES suffit. Les standards, TSA et fournisseurs matériels que vous n'utilisez pas n'entrent jamais dans le projet.

La signature n'est pas produite dans le navigateur mais côté serveur de votre application web : le paquet eSignature.PAdES est appelé et le PDF signé est renvoyé à l'utilisateur. Tout dépend de l'endroit où se trouve la clé : avec un HSM cloud, un HSM réseau ou la signature mobile, le serveur peut accéder à la clé et tout le flux passe par le web. Si la clé est sur la carte à puce de l'utilisateur, le navigateur ne peut pas accéder à la carte ; dans ce cas, la signature se fait sur le poste avec İmzacı.

Oui. La source de signature est abstraite : carte à puce et token USB (CNG/PKCS#11), HSM réseau, services HSM cloud et signature mobile s'utilisent avec le même flux. Chaque fournisseur est un paquet indépendant.

Oui. La validation de chaîne de certificats RFC 5280, les CRL, OCSP, Delta CRL et la validation hors ligne sont dans la bibliothèque ; le même composant produit et vérifie la signature.

Oui. L'application de bureau qui s'utilise sans écrire de code s'appelle İmzacı : elle signe PDF et XML avec une carte à puce, crée des paquets e-Yazışma et signe en lot par dossier.

Ajouter au projet le paquet du standard nécessaire : eSignature.PAdES pour la signature PDF, le paquet XAdES pour le XML. Comme la bibliothèque est découpée en 39 paquets NuGet, vous installez seulement ce que vous utilisez ; aucune grosse dépendance unique n'entre dans le projet.

Des appareils comme AKİS, SafeNet/eToken, Gemalto/Thales, IDEMIA, Feitian, YubiKey et Nitrokey sont pris en charge via Windows CNG et PKCS#11. Chaque fournisseur est un paquet séparé et indépendant ; les pilotes que vous n'utilisez pas n'entrent pas dans le projet.

Oui. Les HSM réseau Thales Luna, Utimaco et Entrust nShield ainsi qu'AWS CloudHSM/KMS, Azure Key Vault HSM et Google Cloud KMS sont pris en charge. C'est ainsi qu'on met en place une signature automatique sur le serveur, sans utilisateur muni d'une carte.

Non ; le même composant produit et vérifie la signature. La validation de chaîne de certificats RFC 5280, les CRL, OCSP, Delta CRL et la validation hors ligne sont dans la bibliothèque.