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

# Pre-authentication Web SSO data

> **Vidinis modulio Applications langas**
>
> Šis langas pasiekiamas iš modulio **Applications**, kai taikomosios programos paslaugos tipas yra **Web**, o **SSO type** – **Pre-authentication**: mygtukas **Configure pre-authentication steps** atidaro žingsnių sąrašą, kuriame pridėjimo mygtuko submeniu siūlo pridėti **data creation step**. Lange yra žinyno piktograma, atidaranti modulio žinyno puslapį.

Langas **Pre-authentication Web SSO data** leidžia administratoriui apibrėžti duomenų elementą, kurį Mediation Controller turi **išsaugoti** naršyklėje (vietinis kintamasis, seanso kintamasis arba slapukas) prieš paskutinį Web SSO taikomosios programos išankstinio autentifikavimo etapą.

## Formos laukai

| Laukas | Aprašas |
|---|---|
| **Type** | Privalomas neredaguojamas išplečiamasis sąrašas. Galimos reikšmės: **Local variable** *(numatytoji)*, **Session variable**, **Cookie**. Pasirinkta reikšmė lemia, ar rodomi toliau esantys slapukams skirti laukai. |
| **Name** | Privalomas. Eilutė, sudaryta tik iš tarpų, atmetama. Identifikuoja duomenis. |
| **Value** | Išsaugotina reikšmė. Pagal numatytuosius parametrus joje gali būti elementų, kuriuos interpretuoja išankstinio autentifikavimo modulis: po lauku rodomas pranešimas primena, kad **This field follows a special syntax. Please consult the help page for more informations.** Žr. skyrių [Specialioji reikšmių sintaksė](#special-syntax-of-values). |
| **Disable special syntax** | Žymės langelis. Jį pažymėjus, reikšmė naudojama tokia, kokia yra, o pranešimas apie sintaksę išnyksta. Su šia parinktimi sukurti elementai žingsnių sąraše rodomi **kursyvu**. |
| **Handle as JSON data** | Žymės langelis. Tada reikšmė apdorojama kaip JSON objektas, o ne kaip eilutė. |

Laukas **Type** nustato, kur išsaugomi duomenys:

| Type | Vieta |
|---|---|
| **Local variable** | Naršyklės vietinė saugojimo vieta. |
| **Session variable** | Naršyklės seanso saugojimo vieta. |
| **Cookie** | Naršyklėje nustatomas slapukas su skyriuje [Slapukams skirti laukai](#cookie-specific-fields) aprašytais laukais. |

## Slapukams skirti laukai

Kai **Type** yra **Cookie**, atsiranda keturi papildomi laukai, o langas padidėja:

| Laukas | Aprašas |
|---|---|
| **Path** | Apriboja slapuką URL adresais, atitinkančiais nurodytą kelią. Numatytoji reikšmė `/`, dėl kurios jis pasiekiamas visuose URL adresuose; jei įvestis neprasideda `/`, išsaugant jis pridedamas pradžioje. |
| **Lifetime (hours)** | Sveikasis skaičius. Galiojimo pabaigos data apskaičiuojama vykdant SSO, prie dabartinio laiko pridedant šią gyvavimo trukmę. ⚠ **Nulinė arba neigiama reikšmė iš karto panaikina slapuko galiojimą**. Jei laukas paliekamas tuščias, galiojimo pabaigos data nesiunčiama, o slapukas tampa seanso slapuku. |
| **Secured cookie** | Žymės langelis. Tada slapuką galima naudoti tik tada, kai ryšys su svetaine yra apsaugotas (HTTPS). |
| **SameSite** | Neredaguojamas išplečiamasis sąrašas: **Strict**, **Lax** *(numatytoji)* arba **None**. Apibrėžia, kaip slapukas elgiasi su užklausomis iš kitos svetainės. |

## Specialioji reikšmių sintaksė

Lauke **Value** galima naudoti pakeitimo eilutes, kurios pakeičiamos vykdant SSO. Ta pati sintaksė taikoma [pre-authentication requests](https://docs.cyberelements.io/bastion/4.6/lt/Usage/AdminConsoleReference/SsoPreAuthRequest/) parametrams, antraštėms ir turiniui.

| Pakeitimas | Poveikis |
|---|---|
| `%user%` | SSO naudotinas prisijungimo vardas. |
| `%password%` | SSO naudotinas slaptažodis. |
| `%base64([...])%` | Užkoduoja skliaustuose esantį turinį base 64 koduote. |
| `%lowercase([...])%` | Paverčia turinį mažosiomis raidėmis. |
| `%uppercase([...])%` | Paverčia turinį didžiosiomis raidėmis. |
| `%trim([...])%` | Pašalina turinio pradžioje ir pabaigoje esančius tarpus. |
| `%uriencoded([...])%` | Pakeičia retus specialiuosius simbolius jų UTF-8 koduote, kad juos būtų galima naudoti URL adrese. |

Taip pat galima naudoti šifravimo funkcijas:

| Funkcija | Laukiami parametrai |
|---|---|
| `%sha256([...])%` | Duomenys, kurių maiša apskaičiuojama (SHA-256). |
| `%md5([...])%` | Duomenys, kurių maiša apskaičiuojama (MD5). |
| `%hmacmd5([...])%` | Du parametrai: šifruotini duomenys, tada šifravimo raktas. |
| `%rsa([...])%` | Du parametrai: viešasis raktas, tada šifruotini duomenys. |
| `%rsaoaep([...])%` | Du parametrai: PEM formato viešasis raktas, tada šifruotina eilutė. |
| `%reqresult([...])%` | Užklausos, kurios rezultatą reikia naudoti pakartotinai, eilės numeris ir, pasirinktinai, rakto, kurį reikia paimti, kai tame rezultate yra keli parametrai, pavadinimas. |

> **Dvi rašymo taisyklės**
>
> Funkcijos parametrai atskiriami **`%,%`**. Norėdami įvesti tiesioginį procento ženklą, rašykite **`\%`**.

## Išsaugojimas

Spustelėkite **Validate**, kad pridėtumėte arba atnaujintumėte duomenis dabartiniame išankstinio autentifikavimo žingsnyje. **Cancel** uždaro langą neišsaugodamas.
