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

# Pre-authentication Web SSO request

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

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

Κάθε αίτημα προσδιορίζεται στη λίστα των βημάτων από τη **διεύθυνση URL**, τη **μέθοδο** και τη **σειρά αποστολής** του — σε αυτή τη σειρά αναφέρεται η αντικατάσταση `%reqresult()%` που περιγράφεται στο κεφάλαιο [Ειδική σύνταξη τιμών](#special-syntax-of-values).

## Κύρια πεδία

| Πεδίο | Περιγραφή |
|---|---|
| **URL** | Διεύθυνση URL στην οποία προτάσσεται αυτόματα η ήδη γνωστή διεύθυνση του διακομιστή προορισμού (το πρόθεμα περικόπτεται στην εμφάνιση όταν η συμβολοσειρά υπερβαίνει τους 100 χαρακτήρες). Στη λειτουργία **τελικής ανακατεύθυνσης**, η διεύθυνση URL δεν μπορεί να τροποποιηθεί. |
| **Method** | Υποχρεωτικό. Επιλογές: **GET** ή **POST** *(προεπιλογή)*. |
| **Content type (MIME)** | Τύπος MIME του σώματος του αιτήματος. Προεπιλεγμένη τιμή: `application/x-www-form-urlencoded`. Άλλες επιλογές: `application/json`, `application/xml`, `text/html`, `text/plain`, `text/richtext`, `text/tab-separated-values`. Κρυφό και απενεργοποιημένο στη λειτουργία **τελικής ανακατεύθυνσης**. |
| **Enable cache** | Πλαίσιο ελέγχου, επιλεγμένο από προεπιλογή. Κρυφό και απενεργοποιημένο στη λειτουργία **τελικής ανακατεύθυνσης**. |
| **Login parameter** | Όνομα της παραμέτρου που πρέπει να μεταφέρει το όνομα σύνδεσης. Ενεργό μόνο όταν ο τύπος περιεχομένου δέχεται παραμέτρους, δηλαδή `application/x-www-form-urlencoded`. |
| **Password parameter** | Όνομα της παραμέτρου που πρέπει να μεταφέρει τον κωδικό πρόσβασης. Ισχύουν οι ίδιοι κανόνες ενεργοποίησης με παραπάνω. |
| **Advanced settings** | Πλαίσιο ελέγχου. Εμφανίζει ή αποκρύπτει τις καρτέλες των σύνθετων δεδομένων. Ενεργοποιείται υποχρεωτικά όταν ο τρέχων τύπος περιεχομένου δεν δέχεται απλές παραμέτρους. |

## Καρτέλες σύνθετων ρυθμίσεων

Όταν το **Advanced settings** είναι ενεργοποιημένο, εμφανίζεται ένας πίνακας καρτελών. Η ορατότητά του εξαρτάται από τον τύπο περιεχομένου και από τη λειτουργία (κανονικό αίτημα ή τελική ανακατεύθυνση).

**Parameters**

> Ορατή κατά την επεξεργασία της **τελικής ανακατεύθυνσης** ή όταν ο τύπος περιεχομένου δέχεται παραμέτρους (`application/x-www-form-urlencoded`).
>
> Η επάνω φόρμα προσθέτει μια καταχώριση στο πλέγμα από κάτω, του οποίου οι στήλες είναι **Name** και **Value**· όταν είναι κενό, εμφανίζει **No element to display**. Ένα εικονίδιο διαγραφής σε κάθε γραμμή καταργεί την καταχώριση.
>
> | Πεδίο | Περιγραφή |
> |---|---|
> | **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. |
> | **Add** | Εισάγει την καταχώριση στο πλέγμα. |

**Content**

> Ορατή όταν δεν γίνεται επεξεργασία της τελικής ανακατεύθυνσης **και** όταν ο τύπος περιεχομένου δεν δέχεται απλές παραμέτρους (για παράδειγμα, `application/json`).
>
> | Πεδίο | Περιγραφή |
> |---|---|
> | **Content** | Περιοχή κειμένου πολλών γραμμών, συγχρονισμένη σε πραγματικό χρόνο. Εμφανίζεται το ίδιο μήνυμα για την ειδική σύνταξη. |
> | **Disable special syntax** | Πλαίσιο ελέγχου: το περιεχόμενο λαμβάνεται τότε ως έχει. |

**Headers**

> Ορατή όταν δεν γίνεται επεξεργασία της τελικής ανακατεύθυνσης.
>
> Η φόρμα είναι πανομοιότυπη με εκείνη της καρτέλας **Parameters**: **Name**, **Value**, **Disable special syntax**, **Handle as JSON data**, το κουμπί **Add** και ένα πλέγμα με διαγραφή ανά γραμμή.

Τα κουμπιά **Previous** και **Next** μεταβαίνουν μεταξύ των ορατών καρτελών.

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

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

| Αντικατάσταση | Αποτέλεσμα |
|---|---|
| `%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** κλείνει το παράθυρο χωρίς αποθήκευση.

> **Προσαρμογή ύψους**
>
> Το μέγεθος του παραθύρου προσαρμόζεται αυτόματα ανάλογα με τη λειτουργία: σύντομη φόρμα όταν το **Advanced settings** είναι απενεργοποιημένο ή στη λειτουργία ανακατεύθυνσης, ψηλή φόρμα όταν ο πίνακας καρτελών είναι ορατός.
