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

# Pre-authentication Web SSO data

> **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 submeniul butonului de adăugare oferă posibilitatea de a adăuga un **data creation step**. Fereastra are o pictogramă de ajutor care deschide pagina de ajutor a modulului.

Fereastra **Pre-authentication Web SSO data** permite unui administrator să definească un element de date pe care Mediation Controller trebuie să îl **stocheze** în browser (variabilă locală, variabilă de sesiune sau cookie) înainte de faza finală de preautentificare a unei aplicații Web SSO.

## Câmpurile formularului

| Câmp | Descriere |
|---|---|
| **Type** | Obligatoriu, listă derulantă needitabilă. Opțiuni: **Local variable** *(implicit)*, **Session variable**, **Cookie**. Valoarea selectată determină afișarea câmpurilor specifice cookie-urilor, de mai jos. |
| **Name** | Obligatoriu. Un șir compus numai din spații este respins. Identifică datele. |
| **Value** | Valoarea care trebuie stocată. În mod implicit, ea poate conține elemente interpretate de motorul de preautentificare: 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. Odată bifată, valoarea este preluată așa cum este, iar mesajul privind sintaxa dispare. Intrările create cu această opțiune sunt afișate **în cursive** în lista de etape. |
| **Handle as JSON data** | Casetă de selectare. Valoarea este atunci tratată ca un obiect JSON, și nu ca un șir. |

**Type** determină locul în care sunt stocate datele:

| Type | Locație |
|---|---|
| **Local variable** | Stocarea locală a browserului. |
| **Session variable** | Stocarea de sesiune a browserului. |
| **Cookie** | Un cookie stabilit în browser, cu câmpurile din secțiunea [Câmpuri specifice cookie-urilor](#cookie-specific-fields). |

## Câmpuri specifice cookie-urilor

Când **Type** are valoarea **Cookie**, apar patru câmpuri suplimentare și fereastra se mărește:

| Câmp | Descriere |
|---|---|
| **Path** | Restrânge cookie-ul la URL-urile care corespund căii indicate. Valoare implicită `/`, ceea ce îl face disponibil pe toate URL-urile; la salvare se adaugă un `/` inițial dacă datele introduse nu îl conțin. |
| **Lifetime (hours)** | Număr întreg. Data expirării se calculează la executarea SSO, adăugând această durată la ora curentă. ⚠ O **valoare nulă sau negativă face ca cookie-ul să expire imediat**. Dacă este lăsat gol, nu este trimisă nicio dată de expirare și cookie-ul devine un cookie de sesiune. |
| **Secured cookie** | Casetă de selectare. Cookie-ul poate fi atunci utilizat numai când conexiunea cu site-ul este securizată (HTTPS). |
| **SameSite** | Listă derulantă needitabilă: **Strict**, **Lax** *(implicit)* sau **None**. Definește modul în care se comportă cookie-ul cu solicitările provenite de la un alt site. |

## Sintaxa specială a valorilor

Câmpul **Value** acceptă șiruri de substituție, înlocuite la executarea SSO. Aceeași sintaxă se aplică parametrilor, antetelor și corpurilor [pre-authentication requests](https://docs.cyberelements.io/bastion/4.6/ro/Usage/AdminConsoleReference/SsoPreAuthRequest/).

| 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 datele în etapa de preautentificare curentă. **Cancel** închide fereastra fără a salva.
