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

# Pre-authentication Web SSO request

> **Fereastră internă a modulului Applications**
>
> Această fereastră se deschide din modulul **Applications**, pe o aplicație al cărei tip de serviciu este **Web** și al cărei **SSO type** este **Pre-authentication**: butonul **Configure pre-authentication steps** deschide lista de etape, unde butonul **+** adaugă o solicitare. Fereastra are o pictogramă de ajutor care deschide pagina de ajutor a modulului.

Fereastra **Pre-authentication Web SSO request** permite unui administrator să definească o **solicitare HTTP** pe care Mediation Controller trebuie să o trimită serverului țintă înainte de etapa finală de autentificare a unei aplicații Web SSO. Pentru **redirecționarea finală** către serverul aplicației este utilizată o variantă simplificată.

Fiecare solicitare este identificată în lista de etape prin **URL**-ul său, **metoda** sa și **ordinea sa de trimitere** — la această ordine se referă substituția `%reqresult()%` descrisă în secțiunea [Sintaxa specială a valorilor](#special-syntax-of-values).

## Câmpuri principale

| Câmp | Descriere |
|---|---|
| **URL** | URL prefixată automat cu adresa deja cunoscută a serverului țintă (prefixul este trunchiat la afișare când șirul depășește 100 de caractere). În modul **redirecționare finală**, URL-ul nu poate fi modificat. |
| **Method** | Obligatoriu. Opțiuni: **GET** sau **POST** *(implicit)*. |
| **Content type (MIME)** | Tipul MIME al corpului solicitării. Valoare implicită: `application/x-www-form-urlencoded`. Alte opțiuni: `application/json`, `application/xml`, `text/html`, `text/plain`, `text/richtext`, `text/tab-separated-values`. Ascuns și dezactivat în modul **redirecționare finală**. |
| **Enable cache** | Casetă de selectare, bifată în mod implicit. Ascunsă și dezactivată în modul **redirecționare finală**. |
| **Login parameter** | Numele parametrului care trebuie să conțină loginul. Este activat numai când tipul de conținut acceptă parametri, adică `application/x-www-form-urlencoded`. |
| **Password parameter** | Numele parametrului care trebuie să conțină parola. Aceleași reguli de activare ca mai sus. |
| **Advanced settings** | Casetă de selectare. Afișează sau ascunde taburile de date avansate. Este forțată la activat când tipul de conținut curent nu acceptă parametri simpli. |

## Taburile de setări avansate

Când **Advanced settings** este activat, apare un panou de taburi. Vizibilitatea sa depinde de tipul de conținut și de mod (solicitare obișnuită sau redirecționare finală).

**Parameters**

> Vizibil la modificarea **redirecționării finale** sau când tipul de conținut acceptă parametri (`application/x-www-form-urlencoded`).
>
> Formularul superior adaugă o intrare în tabelul de dedesubt, ale cărui coloane sunt **Name** și **Value**; când este gol, indică **No element to display**. O pictogramă de ștergere pe fiecare rând elimină intrarea.
>
> | Câmp | Descriere |
> |---|---|
> | **Name** | Numele parametrului. |
> | **Value** | Valoarea corespunzătoare. Un mesaj situat sub câmp amintește că **This field follows a special syntax. Please consult the help page for more informations.** Consultați secțiunea [Sintaxa specială a valorilor](#special-syntax-of-values). |
> | **Disable special syntax** | Casetă de selectare: valoarea este atunci preluată așa cum este, iar mesajul privind sintaxa dispare. Intrările adăugate astfel sunt afișate **în cursive** în tabel. |
> | **Handle as JSON data** | Casetă de selectare. Valoarea este tratată ca un obiect JSON. |
> | **Add** | Inserează intrarea în tabel. |

**Content**

> Vizibil când nu se modifică redirecționarea finală **și** când tipul de conținut nu acceptă parametri simpli (`application/json`, de exemplu).
>
> | Câmp | Descriere |
> |---|---|
> | **Content** | Zonă de text pe mai multe rânduri, sincronizată în timp real. Este amintit același mesaj privind sintaxa specială. |
> | **Disable special syntax** | Casetă de selectare: conținutul este atunci preluat așa cum este. |

**Headers**

> Vizibil când nu se modifică redirecționarea finală.
>
> Formularul este identic cu cel al tabului **Parameters**: **Name**, **Value**, **Disable special syntax**, **Handle as JSON data**, butonul **Add** și un tabel cu ștergere pe fiecare rând.

Butoanele **Previous** și **Next** permit deplasarea între taburile vizibile.

## Sintaxa specială a valorilor

Câmpurile **Value** (taburile **Parameters** și **Headers**) și câmpul **Content** acceptă șiruri de substituție, înlocuite la executarea SSO. Aceeași sintaxă se aplică [pre-authentication data](https://docs.cyberelements.io/bastion/4.6/ro/Usage/AdminConsoleReference/SsoPreAuthData/).

| Substituție | Efect |
|---|---|
| `%user%` | Loginul care trebuie utilizat pentru SSO. |
| `%password%` | Parola care trebuie utilizată pentru SSO. |
| `%base64([...])%` | Codifică în baza 64 conținutul dintre paranteze drepte. |
| `%lowercase([...])%` | Transformă conținutul în minuscule. |
| `%uppercase([...])%` | Transformă conținutul în majuscule. |
| `%trim([...])%` | Elimină spațiile de la începutul și de la sfârșitul conținutului. |
| `%uriencoded([...])%` | Înlocuiește caracterele speciale mai puțin obișnuite cu codificarea lor UTF-8, pentru utilizarea într-o URL. |

Sunt disponibile de asemenea funcții de criptare:

| Funcție | Parametri așteptați |
|---|---|
| `%sha256([...])%` | Datele care trebuie criptate (SHA-256). |
| `%md5([...])%` | Datele care trebuie criptate (MD5). |
| `%hmacmd5([...])%` | Doi parametri: datele care trebuie criptate, apoi cheia de criptare. |
| `%rsa([...])%` | Doi parametri: cheia publică, apoi datele care trebuie criptate. |
| `%rsaoaep([...])%` | Doi parametri: cheia publică în format PEM, apoi șirul care trebuie criptat. |
| `%reqresult([...])%` | Numărul de ordine al solicitării al cărei rezultat trebuie reutilizat și, opțional, numele cheii care trebuie preluată atunci când acel rezultat conține mai mulți parametri. |

> **Două convenții de scriere**
>
> Parametrii unei funcții se separă prin **`%,%`**. Pentru a introduce un semn de procent literal, scrieți **`\%`**.

## Salvarea

Faceți clic pe **Validate** pentru a adăuga sau a actualiza solicitarea în etapa de preautentificare curentă. **Cancel** închide fereastra fără a salva.

> **Adaptarea înălțimii**
>
> Fereastra se redimensionează automat în funcție de mod: formular scurt când **Advanced settings** este dezactivat sau în modul de redirecționare, formular înalt când panoul de taburi este vizibil.
