Βιβλιοθήκη και API ηλεκτρονικής υπογραφής

Η PAdES (PDF Advanced Electronic Signatures) είναι μορφή ηλεκτρονικής υπογραφής στην οποία η υπογραφή ενσωματώνεται μέσα στο αρχείο PDF· ορίζεται από το πρότυπο ETSI EN 319 142. Το υπογεγραμμένο έγγραφο παραμένει PDF, επαληθεύεται από τον πίνακα υπογραφών προγραμμάτων ανάγνωσης PDF όπως το Adobe Reader και μπορεί να έχει ορατό πεδίο υπογραφής στη σελίδα. Τα επίπεδα ανεβαίνουν από B-B σε B-T (με χρονοσήμανση), B-LT και B-LTA (μακροχρόνια αρχειοθέτηση).

Η CAdES (CMS Advanced Electronic Signatures) είναι μορφή ηλεκτρονικής υπογραφής βασισμένη στη δομή CMS/PKCS#7· ορίζεται από το πρότυπο ETSI EN 319 122. Μπορεί να υπογράψει κάθε τύπο αρχείου· η υπογραφή συνήθως συνοδεύει το έγγραφο ως .p7s ή μέσα σε υπογεγραμμένο φάκελο. Στην Τουρκία είναι η πιο διαδεδομένη μορφή στην επίσημη αλληλογραφία με ηλεκτρονική υπογραφή.

Η XAdES (XML Advanced Electronic Signatures) είναι μορφή ηλεκτρονικής υπογραφής που αναπτύχθηκε για έγγραφα XML· ορίζεται από το πρότυπο ETSI EN 319 132. Η υπογραφή μπορεί να ενσωματωθεί στο XML ή να βρίσκεται χωριστά. Χρησιμοποιείται σε έγγραφα XML όπως το ηλεκτρονικό τιμολόγιο σε μορφή UBL-TR.

Η βιβλιοθήκη ηλεκτρονικής υπογραφής είναι στοιχείο για προγραμματιστές (SDK) που προσθέτει τη δημιουργία και την επαλήθευση ηλεκτρονικών υπογραφών στο δικό σας λογισμικό. Μια έτοιμη εφαρμογή υπογραφής προσφέρει οθόνη στον χρήστη· η βιβλιοθήκη είναι δομικό στοιχείο χωρίς οθόνη — υπογράφει η δική σας εφαρμογή, μέσα στη δική σας ροή. Λειτουργεί με έξυπνη κάρτα, token ή HSM και δημιουργεί και επαληθεύει τις μορφές CAdES, XAdES και PAdES.

Το πακέτο e-Yazışma είναι το τυποποιημένο πακέτο για την επίσημη ηλεκτρονική αλληλογραφία με τους δημόσιους φορείς της Τουρκίας: το υπογεγραμμένο έγγραφο, το αρχείο μεταδεδομένων και τυχόν συνημμένα συγκεντρώνονται σε ένα πακέτο. Μεταξύ φορέων αποστέλλεται συνήθως μέσω KEP (καταχωρημένο ηλεκτρονικό ταχυδρομείο).

Ένα επίσημο πακέτο e-Yazışma είναι το αρχείο μεταδεδομένων και το υπογεγραμμένο έγγραφο συσκευασμένα μαζί. Η βιβλιοθήκη το κάνει με μία κλήση: υπογράφει το έγγραφο με CAdES ή XAdES, δημιουργεί μεταδεδομένα σύμφωνα με το σχήμα και κλείνει το πακέτο. Υποστηρίζονται οι εκδόσεις e-Yazışma 1.3 και 2.0 και το ριζικό πιστοποιητικό της KamuSM είναι ενσωματωμένο. Αν δώσετε έναν φάκελο, υπογράφει μαζικά τα έγγραφα που περιέχει.

Η βιβλιοθήκη μπαίνει στο δικό σας λογισμικό: την υπογραφή την ενεργοποιεί η δική σας ροή και η διεπαφή είναι δική σας. Η έτοιμη εφαρμογή (İmzacı) τρέχει στον υπολογιστή: ο χρήστης επιλέγει το αρχείο και το υπογράφει. Και οι δύο χρησιμοποιούν την ίδια υποδομή υπογραφής· ποια σας ταιριάζει εξαρτάται από το ποιος ξεκινά την υπογραφή — το λογισμικό σας ή ο χρήστης.

CAdES (BES, EPES, T, C, X, XL, A), XAdES (BES, T, C, X, XL, A), PAdES (B-B, B-T, B-LT, B-LTA) καθώς και ASiC-S και ASiC-E. Με μία βιβλιοθήκη φτάνετε έως το επίπεδο μακροχρόνιας αρχειοθέτησης.

Όχι. Η βιβλιοθήκη είναι αρθρωτή· για PDF αρκεί το πακέτο eSignature.PAdES. Πρότυπα, TSA και πάροχοι υλικού που δεν χρησιμοποιείτε δεν μπαίνουν καθόλου στο έργο.

Η υπογραφή δεν δημιουργείται στο πρόγραμμα περιήγησης αλλά στην πλευρά του διακομιστή της εφαρμογής web: καλείται το πακέτο eSignature.PAdES και το υπογεγραμμένο PDF επιστρέφει στον χρήστη. Καθοριστικό είναι πού βρίσκεται το κλειδί — με HSM στο cloud, HSM δικτύου ή κινητή υπογραφή ο διακομιστής έχει πρόσβαση στο κλειδί, άρα όλη η ροή γίνεται μέσω web. Αν το κλειδί βρίσκεται στην έξυπνη κάρτα του χρήστη, το πρόγραμμα περιήγησης δεν έχει πρόσβαση στην κάρτα· σε αυτή την περίπτωση η υπογραφή γίνεται στον υπολογιστή με το İmzacı.

Ναι. Η πηγή υπογραφής είναι αφαιρετική: έξυπνη κάρτα και USB token (CNG/PKCS#11), HSM δικτύου, υπηρεσίες HSM στο cloud και κινητή υπογραφή χρησιμοποιούνται με την ίδια ροή. Κάθε πάροχος είναι ανεξάρτητο πακέτο.

Ναι. Η επαλήθευση αλυσίδας πιστοποιητικών κατά RFC 5280, CRL, OCSP, Delta CRL και η επαλήθευση εκτός σύνδεσης περιλαμβάνονται στη βιβλιοθήκη· το ίδιο στοιχείο δημιουργεί και επαληθεύει την υπογραφή.

Υπάρχει. Η εφαρμογή υπολογιστή που χρησιμοποιείται χωρίς κώδικα είναι το İmzacı: υπογράφει PDF και XML με έξυπνη κάρτα, δημιουργεί πακέτα e-Yazışma και υπογράφει μαζικά ολόκληρους φακέλους.

Να προσθέσετε στο έργο το πακέτο του προτύπου που χρειάζεστε: eSignature.PAdES για υπογραφή PDF, το πακέτο XAdES για XML. Επειδή η βιβλιοθήκη χωρίζεται σε 39 πακέτα NuGet, εγκαθιστάτε μόνο ό,τι χρησιμοποιείτε· στο έργο δεν μπαίνει μία μεγάλη εξάρτηση.

Μέσω Windows CNG και PKCS#11 υποστηρίζονται συσκευές όπως AKİS, SafeNet/eToken, Gemalto/Thales, IDEMIA, Feitian, YubiKey και Nitrokey. Κάθε πάροχος είναι ξεχωριστό, ανεξάρτητο πακέτο· οδηγοί που δεν χρησιμοποιείτε δεν μπαίνουν στο έργο.

Ναι. Υποστηρίζονται τα HSM δικτύου Thales Luna, Utimaco και Entrust nShield, καθώς και AWS CloudHSM/KMS, Azure Key Vault HSM και Google Cloud KMS. Έτσι στήνεται αυτόματη υπογραφή στον διακομιστή χωρίς χρήστη με κάρτα.

Όχι· το ίδιο στοιχείο δημιουργεί και επαληθεύει την υπογραφή. Η επαλήθευση αλυσίδας πιστοποιητικών κατά RFC 5280, CRL, OCSP, Delta CRL και η επαλήθευση εκτός σύνδεσης περιλαμβάνονται στη βιβλιοθήκη.