> Source: https://docs.cyberelements.io/bastion/4.6/el/Usage/AdminConsoleReference/SsoPreAuthData/

# Pre-authentication Web SSO data

> **Εσωτερικό παράθυρο της λειτουργικής μονάδας Applications**
>
> Η πρόσβαση σε αυτό το παράθυρο γίνεται από τη λειτουργική μονάδα **Applications**, σε μια εφαρμογή της οποίας ο τύπος υπηρεσίας είναι **Web** και το **SSO type** είναι **Pre-authentication**: το κουμπί **Configure pre-authentication steps** ανοίγει τη λίστα των βημάτων, όπου το υπομενού του κουμπιού προσθήκης προσφέρει την προσθήκη ενός **data creation step**. Το παράθυρο διαθέτει ένα εικονίδιο βοήθειας που ανοίγει τη σελίδα βοήθειας της λειτουργικής μονάδας.

Το παράθυρο **Pre-authentication Web SSO data** επιτρέπει σε έναν διαχειριστή να ορίσει ένα δεδομένο που η υπηρεσία Mediation Controller πρέπει να **αποθηκεύσει** στο πρόγραμμα περιήγησης (τοπική μεταβλητή, μεταβλητή περιόδου λειτουργίας ή cookie) πριν από την τελική φάση προέλεγχου ταυτότητας μιας εφαρμογής Web SSO.

## Πεδία φόρμας

| Πεδίο | Περιγραφή |
|---|---|
| **Type** | Υποχρεωτική, μη επεξεργάσιμη αναπτυσσόμενη λίστα. Επιλογές: **Local variable** *(προεπιλογή)*, **Session variable**, **Cookie**. Η επιλεγμένη τιμή καθορίζει την εμφάνιση των πεδίων που αφορούν ειδικά τα cookie, παρακάτω. |
| **Name** | Υποχρεωτικό. Μια συμβολοσειρά που αποτελείται μόνο από κενά διαστήματα απορρίπτεται. Προσδιορίζει το δεδομένο. |
| **Value** | Τιμή προς αποθήκευση. Από προεπιλογή, μπορεί να περιέχει στοιχεία που ερμηνεύονται από τον μηχανισμό προέλεγχου ταυτότητας: ένα μήνυμα κάτω από το πεδίο υπενθυμίζει ότι **This field follows a special syntax. Please consult the help page for more informations.** Ανατρέξτε στο κεφάλαιο [Ειδική σύνταξη τιμών](#special-syntax-of-values). |
| **Disable special syntax** | Πλαίσιο ελέγχου. Όταν επιλεγεί, η τιμή λαμβάνεται ως έχει και το μήνυμα σύνταξης εξαφανίζεται. Οι καταχωρίσεις που δημιουργούνται με αυτή την επιλογή εμφανίζονται **με πλάγια γράμματα** στη λίστα των βημάτων. |
| **Handle as JSON data** | Πλαίσιο ελέγχου. Η τιμή αντιμετωπίζεται τότε ως αντικείμενο JSON και όχι ως συμβολοσειρά. |

Το πεδίο **Type** καθορίζει πού αποθηκεύεται το δεδομένο:

| Type | Θέση αποθήκευσης |
|---|---|
| **Local variable** | Τοπικός χώρος αποθήκευσης του προγράμματος περιήγησης. |
| **Session variable** | Χώρος αποθήκευσης περιόδου λειτουργίας του προγράμματος περιήγησης. |
| **Cookie** | Ένα cookie που ορίζεται στο πρόγραμμα περιήγησης, με τα πεδία του κεφαλαίου [Πεδία ειδικά για cookie](#cookie-specific-fields). |

## Πεδία ειδικά για cookie

Όταν το πεδίο **Type** έχει την τιμή **Cookie**, εμφανίζονται τέσσερα επιπλέον πεδία και το παράθυρο μεγαλώνει:

| Πεδίο | Περιγραφή |
|---|---|
| **Path** | Περιορίζει το cookie στις διευθύνσεις URL που αντιστοιχούν στη δεδομένη διαδρομή. Προεπιλεγμένη τιμή `/`, η οποία το καθιστά διαθέσιμο σε κάθε διεύθυνση URL· κατά την αποθήκευση προστίθεται ένα αρχικό `/` όταν η καταχώριση δεν το περιέχει. |
| **Lifetime (hours)** | Ακέραιος αριθμός. Η ημερομηνία λήξης υπολογίζεται κατά την εκτέλεση του SSO, προσθέτοντας αυτή τη διάρκεια ζωής στην τρέχουσα ώρα. ⚠ Μια **μηδενική ή αρνητική τιμή κάνει το cookie να λήξει αμέσως**. Εάν μείνει κενό, δεν αποστέλλεται ημερομηνία λήξης και το cookie γίνεται cookie περιόδου λειτουργίας. |
| **Secured cookie** | Πλαίσιο ελέγχου. Το cookie μπορεί τότε να χρησιμοποιηθεί μόνο όταν η σύνδεση με την τοποθεσία web είναι ασφαλής (HTTPS). |
| **SameSite** | Μη επεξεργάσιμη αναπτυσσόμενη λίστα: **Strict**, **Lax** *(προεπιλογή)* ή **None**. Καθορίζει τη συμπεριφορά του cookie σε αιτήματα που προέρχονται από άλλη τοποθεσία web. |

## Ειδική σύνταξη τιμών

Το πεδίο **Value** δέχεται συμβολοσειρές αντικατάστασης, οι οποίες αντικαθίστανται κατά την εκτέλεση του SSO. Η ίδια σύνταξη ισχύει για τις παραμέτρους, τις κεφαλίδες και τα σώματα των αιτημάτων προέλεγχου ταυτότητας ([pre-authentication requests](https://docs.cyberelements.io/bastion/4.6/el/Usage/AdminConsoleReference/SsoPreAuthRequest/)).

| Αντικατάσταση | Αποτέλεσμα |
|---|---|
| `%user%` | Όνομα σύνδεσης που θα χρησιμοποιηθεί για το SSO. |
| `%password%` | Κωδικός πρόσβασης που θα χρησιμοποιηθεί για το SSO. |
| `%base64([...])%` | Κωδικοποιεί το περιεχόμενο των αγκυλών σε base 64. |
| `%lowercase([...])%` | Μετατρέπει το περιεχόμενο σε πεζά. |
| `%uppercase([...])%` | Μετατρέπει το περιεχόμενο σε κεφαλαία. |
| `%trim([...])%` | Καταργεί τα αρχικά και τελικά κενά διαστήματα από το περιεχόμενο. |
| `%uriencoded([...])%` | Αντικαθιστά τους ασυνήθιστους ειδικούς χαρακτήρες με την κωδικοποίησή τους σε UTF-8, για χρήση σε διεύθυνση URL. |

Διατίθενται επίσης συναρτήσεις κρυπτογράφησης:

| Συνάρτηση | Αναμενόμενες παράμετροι |
|---|---|
| `%sha256([...])%` | Τα δεδομένα προς κατακερματισμό (SHA-256). |
| `%md5([...])%` | Τα δεδομένα προς κατακερματισμό (MD5). |
| `%hmacmd5([...])%` | Δύο παράμετροι: τα δεδομένα προς κρυπτογράφηση και, στη συνέχεια, το κλειδί κρυπτογράφησης. |
| `%rsa([...])%` | Δύο παράμετροι: το δημόσιο κλειδί και, στη συνέχεια, τα δεδομένα προς κρυπτογράφηση. |
| `%rsaoaep([...])%` | Δύο παράμετροι: το δημόσιο κλειδί σε μορφή PEM και, στη συνέχεια, η συμβολοσειρά προς κρυπτογράφηση. |
| `%reqresult([...])%` | Ο αύξων αριθμός του αιτήματος του οποίου το αποτέλεσμα πρέπει να επαναχρησιμοποιηθεί και, προαιρετικά, το όνομα του κλειδιού που θα επιλεγεί όταν αυτό το αποτέλεσμα περιέχει πολλές παραμέτρους. |

> **Δύο κανόνες γραφής**
>
> Οι παράμετροι των συναρτήσεων διαχωρίζονται με **`%,%`**. Για να εισαγάγετε ένα κυριολεκτικό σύμβολο ποσοστού, γράψτε **`\%`**.

## Αποθήκευση

Κάντε κλικ στο **Validate** για να προσθέσετε ή να ενημερώσετε το δεδομένο στο τρέχον βήμα προέλεγχου ταυτότητας. Το **Cancel** κλείνει το παράθυρο χωρίς αποθήκευση.
