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

# Pre-authentication Web SSO data

> **Interné okno modulu Applications**
>
> K tomuto oknu sa dostanete z modulu **Applications** pri aplikácii, ktorej typ služby je **Web** a ktorej **SSO type** je **Pre-authentication**: tlačidlo **Configure pre-authentication steps** otvorí zoznam krokov, kde podponuka tlačidla pridania ponúka pridanie kroku **data creation step**. Okno obsahuje ikonu pomocníka, ktorá otvorí stránku pomocníka modulu.

Okno **Pre-authentication Web SSO data** umožňuje správcovi definovať údaj, ktorý musí služba Mediation Controller **uložiť** v prehliadači (lokálna premenná, premenná relácie alebo súbor cookie) pred záverečnou fázou predbežného overovania aplikácie Web SSO.

## Polia formulára

| Pole | Popis |
|---|---|
| **Type** | Povinný, needitovateľný rozbaľovací zoznam. Možnosti: **Local variable** *(predvolené)*, **Session variable**, **Cookie**. Vybraná hodnota určuje zobrazenie nižšie uvedených polí špecifických pre súbory cookie. |
| **Name** | Povinné pole. Reťazec obsahujúci iba prázdne znaky sa odmietne. Identifikuje údaj. |
| **Value** | Hodnota, ktorá sa má uložiť. Predvolene môže obsahovať prvky interpretované modulom predbežného overovania: správa pod poľom pripomína, že **This field follows a special syntax. Please consult the help page for more informations.** Pozrite časť [Špeciálna syntax hodnôt](#special-syntax-of-values). |
| **Disable special syntax** | Začiarkavacie políčko. Po začiarknutí sa hodnota prevezme bez zmeny a správa o syntaxi zmizne. Položky vytvorené s touto možnosťou sa v zozname krokov zobrazujú **kurzívou**. |
| **Handle as JSON data** | Začiarkavacie políčko. Hodnota sa potom spracuje ako objekt JSON, a nie ako reťazec. |

Pole **Type** určuje, kde sa údaj uloží:

| Type | Umiestnenie |
|---|---|
| **Local variable** | Lokálna pamäť prehliadača. |
| **Session variable** | Pamäť relácie prehliadača. |
| **Cookie** | Súbor cookie nastavený v prehliadači s poliami z časti [Polia špecifické pre súbory cookie](#cookie-specific-fields). |

## Polia špecifické pre súbory cookie

Keď má pole **Type** hodnotu **Cookie**, zobrazia sa štyri ďalšie polia a okno sa zväčší:

| Pole | Popis |
|---|---|
| **Path** | Obmedzí súbor cookie na adresy URL zodpovedajúce zadanej ceste. Predvolená hodnota je `/`, vďaka ktorej je súbor cookie dostupný na každej adrese URL; ak zadaná hodnota nezačína znakom `/`, pri uložení sa doplní. |
| **Lifetime (hours)** | Celé číslo. Dátum vypršania platnosti sa vypočíta pri spustení SSO pripočítaním tejto doby životnosti k aktuálnemu času. ⚠ **Nulová alebo záporná hodnota spôsobí okamžité vypršanie platnosti súboru cookie**. Ak pole zostane prázdne, neodošle sa žiadny dátum vypršania platnosti a súbor cookie sa stane súborom cookie relácie. |
| **Secured cookie** | Začiarkavacie políčko. Súbor cookie sa potom dá použiť iba vtedy, keď je pripojenie k webovej lokalite zabezpečené (HTTPS). |
| **SameSite** | Needitovateľný rozbaľovací zoznam: **Strict**, **Lax** *(predvolené)* alebo **None**. Určuje, ako sa súbor cookie správa pri požiadavkách prichádzajúcich z inej webovej lokality. |

## Špeciálna syntax hodnôt

Pole **Value** prijíma substitučné reťazce, ktoré sa nahradia pri spustení SSO. Rovnaká syntax platí pre parametre, hlavičky a telá [pre-authentication requests](https://docs.cyberelements.io/bastion/4.6/sk/Usage/AdminConsoleReference/SsoPreAuthRequest/).

| Substitúcia | Účinok |
|---|---|
| `%user%` | Prihlasovacie meno, ktoré sa má použiť na SSO. |
| `%password%` | Heslo, ktoré sa má použiť na SSO. |
| `%base64([...])%` | Zakóduje obsah zátvoriek v base64. |
| `%lowercase([...])%` | Prevedie obsah na malé písmená. |
| `%uppercase([...])%` | Prevedie obsah na veľké písmená. |
| `%trim([...])%` | Odstráni z obsahu úvodné a koncové prázdne znaky. |
| `%uriencoded([...])%` | Nahradí nezvyčajné špeciálne znaky ich kódovaním UTF-8 na použitie v adrese URL. |

K dispozícii sú aj šifrovacie funkcie:

| Funkcia | Očakávané parametre |
|---|---|
| `%sha256([...])%` | Údaje na hašovanie (SHA-256). |
| `%md5([...])%` | Údaje na hašovanie (MD5). |
| `%hmacmd5([...])%` | Dva parametre: údaje na zašifrovanie a potom šifrovací kľúč. |
| `%rsa([...])%` | Dva parametre: verejný kľúč a potom údaje na zašifrovanie. |
| `%rsaoaep([...])%` | Dva parametre: verejný kľúč vo formáte PEM a potom reťazec na zašifrovanie. |
| `%reqresult([...])%` | Poradové číslo požiadavky, ktorej výsledok sa má znova použiť, a voliteľne názov kľúča, ktorý sa má vybrať, keď tento výsledok obsahuje viacero parametrov. |

> **Dve konvencie zápisu**
>
> Parametre funkcie sa oddeľujú reťazcom **`%,%`**. Ak chcete zadať doslovný znak percenta, napíšte **`\%`**.

## Uloženie

Kliknutím na **Validate** pridáte alebo aktualizujete údaj v aktuálnom kroku predbežného overovania. **Cancel** zatvorí okno bez uloženia.
