# Ψηφιακή Υπογραφή: Οδηγίες εγκατάστασης
Προσοχή
Οι οδηγίες αφορούν μόνο το λειτουργικό σύστημα Microsoft Windows. Για να τις ακολουθήσετε είναι απαραίτητο να έχετε παραλάβει το πακέτο εγκατάστασης της υπηρεσίας ψηφιακής υπογραφής DigitalSignaturePack.zip.
# Εγκατάσταση λογισμικού οδηγού usb token ή smartcard
Κάνετε την εγκατάσταση των αρχείων που αρμόζει στον τύπο της ψηφιακής υπογραφής που έχετε (Classic_Client_64_User_setup.msi ή SAC-10.4.exe προς το παρόν). Στην περίπτωση που δεν γνωρίζετε ποιο client πρέπει να χρησιμοποιήσετε, συμβουλευτείτε τον προμηθευτή του usb token/smartcard.
Τα αρχεία εγκατάστασης περιέχονται στον κατάλογο client middleware. Έπειτα και το πέρας της εγκατάστασης, τοποθετείτε το token στο usb slot του υπολογιστή σας και ανοίγετε την εφαρμογή client middleware, την οποία προτέρως εγκαταστήσατε και βλέπετε αν φαίνονται μέσα τα πιστοποιητικά της υπογραφής (public certificate - private key).
# Εγκατάσταση java 8 (jre ή jdk)
- Σε περίπτωση που δεν υπάρχει εγκατεστημένη η java στον υπολογιστή σας, σε έκδοση από 8 και μετά, θα πρέπει να μεταβείτε στην ιστοσελίδα της Java (opens new window) και έπειτα να ακολουθήσετε τις σχετικές οδηγίες εγκατάστασης. Εναλλακτικά, μπορείτε να χρησιμοποιήσετε 1 από τα 2 αρχεία εγκατάστασης, τα οποία υπάρχουν στο πακέτο, στον κατάλογο java (x64 ή x86).
# Ρυθμίσεις απομακρυσμένης ψηφιακής υπογραφής
Για να μπορέσετε να ενεργοποιήσετε την απομακρυσμένη ψηφιακή υπογραφή σας απαιτείται να γίνουν τα εξής:
- Να συνδεθείτε στην εφαρμογή του Πρωτοκόλλου με τα προσωπικά στοιχεία σας
- Να επιλέξετε την σελίδα με τα Στοιχεία του Χρήστη
- Στην επιλογή (Τύπος ψηφιακής υπογραφής) επιλέγετε Απομακρυσμένη ή DocuSign
- Σε περίπτωση που επιλέξετε DocuSign θα χρειαστεί να συμπληρώσετε στο πεδίο (Ψηφιακά πιστοποιητικά του χρήστη) το Public Key της υπογραφής σας
- Συμπληρώνετε όνομα χρήστη και κωδικό ψηφιακής υπογραφής
- Συμπληρώνετε τον προσωπικό κωδικό σας στο αντίστοιχο πεδίο και πατάτε αποθήκευση
Το Public Key είναι ένα δημόσιο κλειδί το οποίο χρησιμοποιείται στην Κρυπτογράφηση δημόσιου κλειδιού και ο ρόλος του είναι η ταυτοποίηση του χρήστη που αποστέλλει το υπογεγραμμένο έγγραφο.
# Ρυθμίσεις Atlas
To Atlas χρειάζεται για την επικοινωνία της web εφαρμογής (όπως Process και Πρωτόκολλο), με το τερματικό που έχει την υπογραφή. Για να ξεκινήσει η λειτουργία του, απαιτείται να γίνουν τα εξής:
- Αφού πραγματοποιηθεί η λήψη του setup.exe (opens new window), το εκκινούμε με διπλό κλικ και του δίνουμε τα διαχειριστικά δικαιώματα που μας ζητάει.
- Στην συνέχεια ακολουθεί η εγκατάστασή του στην οποία πατάμε next σε όλα τα επόμενα παράθυρα. Αφού ολοκληρωθεί η εγκατάστασή του θα πρέπει να βλέπουμε κάτω δεξιά στα εικονίδια του συστήματος ένα καινούργιο εικονίδιο.
- Άμα επιθυμούμε τον τερματισμό της εφαρμογής κάνουμε δεξί κλικ στον εικονίδιο της εφαρμογής και επιλέγουμε Exit. Για να ξεκινήσουμε ξανά την εφαρμογή κάνουμε διπλό κλικ στην συντόμευση της εφαρμογής που έχει δημιουργηθεί στην επιφάνεια εργασίας. Προσοχή κατά την εγκατάσταση του προγράμματος όποια εφαρμογή λειτουργεί με το ίδιο port της εφαρμογής τερματίζεται αυτόματα από το σύστημα.
- Για την ενεργοποίηση της λειτουργίας της ψηφιακής υπογραφής δεν απαιτείται κάποια σχετική παραμετροποίση.
- Σε υπολογιστές οι οποίοι δεν έχουν προεγκατεστημένη Java δεν απαιτείται η εγκατάστασής της.
- Με την ολοκλήρωση της εγκατάστασης του Atla πηγαίνουμε στον φάκελο startUp του χρήστη ( C:\Users\"+username+"\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup ) και διαγράφουμε την παλιά συντόμευση ( ds.bat ). Η καινούργια συντόμευση του Άτλα δημιουργείται στην τοποθεσία ( C:\ProgramData\Microsoft\Windows\Start Menu\Programs\StartUp )
Προσοχή Σε περίπτωση που υπάρχει ήδη κάποια εγκατάσταση του Ατλα, θα πρέπει να απεγκατασταθεί ο παλιός Ατλας (από την προσθαφαίρεση προγραμμάτων των Windows), να διαγραφούν τα παλιά αρχεία τα οποία μπορεί να έχουν μείνει από την παλιά εγκατάσταση και τότε μόνο μπορεί να προχωρήσει η καινούργια εγκατάσταση.
# Ρυθμίσεις DocumentSigner
To DocumentSigner χρειάζεται για την επικοινωνία της web εφαρμογής (όπως Process και πρωτόκολλο), με το τερματικό που έχει την υπογραφή. Για να ξεκινήσει η λειτουργία του, απαιτείται να γίνουν τα εξής:
Μετακινείτε όλο το φάκελο DocumentSigner στο επιθυμητό σημείο (υπάρχει στο πακέτο) ή το αφήνετε εκεί που βρίσκεται, εφόσον η αποσυμπίεση του πακέτου έγινε εκεί που θέλατε εξαρχής.
Μέσα από τον κατάλογο DocumentSigner, ανοίγετε με επεξεργαστή κειμένου το αρχείο docsigner.properties.
Στην περίπτωση που εγκαταστήσατε το classic client, εντοπίζετε το αρχείο .../program files/gemalto classic clent/gclib.dll και το αντιγράφετε στον κατάλογο DocumentSigner. Στο docsigner.properties εντοπίζετε το property pkcs11file και το βάζετε στη θέση του αρχείου gclib.dll (όπως pkcs11file=C:\DocumentSigner\gclib.dll) και στο property pkcs11libname βάζετε GemPlusPKCS11 (pkcs11libname=GemPlusPKCS11).
Στην περίπτωση που εγκαταστήσατε το SAC, επιβεβαιώνετε οτι το αρχείο eTPKCS11.dll βρίσκεται στον κατάλογο windows\system32. Στο docsigner.properties εντοπίζετε το property pkcs11file και το βάζετε στη θέση του αρχείου eTPKCS11.dll (όπως pkcs11file=C:\Windows\System32\eTPKCS11.dll και στο property pkcs11libname βάζετε eToken (pkcs11libname=eToken).
Ανοίγετε με επεξεργαστή κειμένου το αρχείο ds.bat. Η πρώτη γραμμή περιγράφει τη θέση που βρίσκεται το αρχείο java.exe της java, το οποίο θέλετε να χρησιμοποιήσετε, όπως C:\Program Files\Java\jre1.8.0_201\bin. Η δεύτερη γραμμή περιγράφει τη θέση που βρίσκεται το DocumentSigner. Αντίστοιχα, με το πού βρίσκεται η java και ο κατάλογος σας, προσαρμόζετε τις τιμές αυτές.
# Προετοιμασία εκκίνησης υπηρεσίας σε SSL
Αποδεχόσαστε το πιστοποιητικό localhost :
- Ανοίγετε με διπλό κλικ το αρχείο localhost.crt.
- Πατάτε Install Certificate...
- Επιλέγετε local machine και πατάτε next.
- Επιλέγετε Place all certificates in the following store, πατάτε browse..., επιλέγετε Trusted Root Certification Authorities, πατάτε ok και πατάτε next.
Ρυθμίσεις docsigner.properties :
- runssl = yes
# Συνεχής λειτουργία
Ανοίγετε το αρχείο runDS.vbs, βλέπετε οτι στη δεύτερη γραμμή υπάρχει τιμή η οποία περιγράφει τη θέση του αρχείου ds.bat και την προσαρμόζετε αντίστοιχα.
Δημιουργείτε συντόμευση για το αρχείο runDS.vbs και την αποθηκεύετε στον κατάλογο startup των windows. Για να ανοίξει ο κατάλογος αυτός, κάνετε click στο Start, γραφετε run, πατάτε enter, στο παράθυρο διαλόγου που ανοίγει γράφετε shell:startup και πατάτε enter. Έτσι, κάθε φορά που θα ξεκινά ο υπολογιστής θα ξεκινά και το DocumentSigner.
Για να δοκιμάσετε άμεσα τη λειτουργία του, μπορείτε να το ξεκινήσετε μόνοι σας με click, είτε στο runDS.vbs, είτε στο shortcut που βάλατε στο startup (τρέχει παρασκηνιακά), είτε απευθείας στο ds.bat (τρέχει σε command line), στη συνέχεια ανοίγετε ένα φυλλομετρητή ιστοσελίδων (browser) και καλείτε τη διεύθυνση localhost:8585.