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

# Pre-authentication Web SSO data

> **Mooduli Applications siseaken**
>
> Sellesse aknasse pääseb moodulist **Applications** rakenduse puhul, mille teenusetüüp on **Web** ja mille **SSO type** on **Pre-authentication**: nupp **Configure pre-authentication steps** avab etappide loendi, kus lisamisnupu alammenüü pakub võimalust lisada **data creation step**. Aknas on spikriikoon, mis avab mooduli spikrilehe.

Aknas **Pre-authentication Web SSO data** saab administraator määratleda andmeüksuse, mille Mediation Controller server peab brauserisse **salvestama** (kohalik muutuja, seansimuutuja või küpsis) enne Web SSO rakenduse viimast eelautentimise etappi.

## Vormi väljad

| Väli | Kirjeldus |
|---|---|
| **Type** | Kohustuslik, mittemuudetav ripploend. Valikud: **Local variable** *(vaikimisi)*, **Session variable**, **Cookie**. Valitud väärtusest oleneb, kas allpool olevad küpsisepõhised väljad kuvatakse. |
| **Name** | Kohustuslik. Ainult tühikutest koosnev string lükatakse tagasi. Tuvastab andmeüksuse. |
| **Value** | Salvestatav väärtus. Vaikimisi võib see sisaldada elemente, mida eelautentimismootor tõlgendab: välja all olev teade tuletab meelde, et **This field follows a special syntax. Please consult the help page for more informations.** Vt peatükk [Väärtuste erisüntaks](#special-syntax-of-values). |
| **Disable special syntax** | Märkeruut. Kui see on märgitud, võetakse väärtus muutmata kujul ja süntaksiteade kaob. Selle suvandiga loodud kirjed kuvatakse etappide loendis **kaldkirjas**. |
| **Handle as JSON data** | Märkeruut. Väärtust käsitletakse siis JSON-objektina, mitte stringina. |

**Type** määrab, kuhu andmed salvestatakse:

| Type | Asukoht |
|---|---|
| **Local variable** | Brauseri kohalik salvestusruum. |
| **Session variable** | Brauseri seansisalvestusruum. |
| **Cookie** | Brauserisse seatud küpsis, millel on peatüki [Küpsisepõhised väljad](#cookie-specific-fields) väljad. |

## Küpsisepõhised väljad

Kui **Type** on **Cookie**, kuvatakse neli lisavälja ja aken suureneb:

| Väli | Kirjeldus |
|---|---|
| **Path** | Piirab küpsise URL-idega, mis vastavad antud teele. Vaikeväärtus `/`, mis teeb selle kättesaadavaks igal URL-il; kui sisestuse alguses pole märki `/`, lisatakse see salvestamisel. |
| **Lifetime (hours)** | Täisarv. Aegumiskuupäev arvutatakse SSO käivitamisel, liites selle eluea praegusele kellaajale. ⚠ **Null- või negatiivne väärtus paneb küpsise kohe aeguma**. Kui väli jäetakse tühjaks, aegumiskuupäeva ei saadeta ja küpsisest saab seansiküpsis. |
| **Secured cookie** | Märkeruut. Küpsist saab siis kasutada ainult siis, kui ühendus veebisaidiga on turvatud (HTTPS). |
| **SameSite** | Mittemuudetav ripploend: **Strict**, **Lax** *(vaikimisi)* või **None**. Määratleb, kuidas küpsis käitub teiselt saidilt tulevate taotluste korral. |

## Väärtuste erisüntaks

Väli **Value** aktsepteerib asendusstringe, mis asendatakse SSO käivitamisel. Sama süntaks kehtib taotluste [pre-authentication requests](https://docs.cyberelements.io/bastion/4.6/et/Usage/AdminConsoleReference/SsoPreAuthRequest/) parameetritele, päistele ja kehadele.

| Asendus | Toime |
|---|---|
| `%user%` | SSO jaoks kasutatav kasutajanimi. |
| `%password%` | SSO jaoks kasutatav parool. |
| `%base64([...])%` | Kodeerib sulgude sisu base64-vormingusse. |
| `%lowercase([...])%` | Teisendab sisu väiketähtedeks. |
| `%uppercase([...])%` | Teisendab sisu suurtähtedeks. |
| `%trim([...])%` | Eemaldab sisu algusest ja lõpust tühimärgid. |
| `%uriencoded([...])%` | Asendab harvaesinevad erimärgid nende UTF-8-kodeeringuga, et neid saaks URL-is kasutada. |

Saadaval on ka krüptimisfunktsioonid:

| Funktsioon | Oodatavad parameetrid |
|---|---|
| `%sha256([...])%` | Räsitavad andmed (SHA-256). |
| `%md5([...])%` | Räsitavad andmed (MD5). |
| `%hmacmd5([...])%` | Kaks parameetrit: krüptitavad andmed, seejärel krüptimisvõti. |
| `%rsa([...])%` | Kaks parameetrit: avalik võti, seejärel krüptitavad andmed. |
| `%rsaoaep([...])%` | Kaks parameetrit: PEM-vormingus avalik võti, seejärel krüptitav string. |
| `%reqresult([...])%` | Selle taotluse järjenumber, mille tulemust tuleb uuesti kasutada, ja soovi korral võtme nimi, mis valitakse, kui see tulemus sisaldab mitut parameetrit. |

> **Kaks kirjutusreeglit**
>
> Funktsiooni parameetrid eraldatakse märgiga **`%,%`**. Literaalse protsendimärgi sisestamiseks kirjutage **`\%`**.

## Salvestamine

Andmete lisamiseks praegusesse eelautentimise etappi või nende värskendamiseks klõpsake nuppu **Validate**. **Cancel** sulgeb akna salvestamata.
