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

# Pre-authentication Web SSO data

> **Interní okno modulu Applications**
>
> K tomuto oknu se dostanete z modulu **Applications** u aplikace, jejíž typ služby je **Web** a jejíž **SSO type** je **Pre-authentication**: tlačítko **Configure pre-authentication steps** otevře seznam kroků, kde podnabídka tlačítka pro přidání nabízí přidání položky **data creation step**. Okno obsahuje ikonu nápovědy, která otevře stránku nápovědy modulu.

Okno **Pre-authentication Web SSO data** umožňuje správci definovat údaj, který musí služba Mediation Controller **uložit** v prohlížeči (místní proměnná, proměnná relace nebo soubor cookie) před závěrečnou fází předběžného ověřování aplikace Web SSO.

## Pole formuláře

| Pole | Popis |
|---|---|
| **Type** | Povinný, neupravitelný rozevírací seznam. Možnosti: **Local variable** *(výchozí)*, **Session variable**, **Cookie**. Vybraná hodnota určuje, zda se zobrazí níže uvedená pole specifická pro soubory cookie. |
| **Name** | Povinné. Řetězec tvořený pouze prázdnými znaky je odmítnut. Identifikuje údaj. |
| **Value** | Hodnota, která se má uložit. Ve výchozím nastavení může obsahovat prvky, které interpretuje modul předběžného ověřování: zpráva pod polem připomíná, že **This field follows a special syntax. Please consult the help page for more informations.** Viz část [Zvláštní syntaxe hodnot](#special-syntax-of-values). |
| **Disable special syntax** | Zaškrtávací políčko. Po zaškrtnutí se hodnota použije tak, jak je, a zpráva o syntaxi zmizí. Položky vytvořené s touto možností se v seznamu kroků zobrazují **kurzívou**. |
| **Handle as JSON data** | Zaškrtávací políčko. Hodnota se pak zpracovává jako objekt JSON, nikoli jako řetězec. |

Pole **Type** určuje, kam se údaj uloží:

| Typ | Umístění |
|---|---|
| **Local variable** | Místní úložiště prohlížeče. |
| **Session variable** | Úložiště relace prohlížeče. |
| **Cookie** | Soubor cookie nastavený v prohlížeči, s poli z části [Pole specifická pro soubory cookie](#cookie-specific-fields). |

## Pole specifická pro soubory cookie

Když má pole **Type** hodnotu **Cookie**, zobrazí se čtyři další pole a okno se zvětší:

| Pole | Popis |
|---|---|
| **Path** | Omezí soubor cookie na adresy URL odpovídající zadané cestě. Výchozí hodnota `/`, díky níž je soubor cookie dostupný pro každou adresu URL; pokud zadaná hodnota úvodní `/` neobsahuje, při uložení se doplní. |
| **Lifetime (hours)** | Celé číslo. Datum vypršení platnosti se vypočítá při spuštění SSO přičtením této doby platnosti k aktuálnímu času. ⚠ **Nulová nebo záporná hodnota způsobí okamžité vypršení platnosti souboru cookie**. Pokud pole zůstane prázdné, žádné datum vypršení platnosti se neodešle a soubor cookie se stane relačním souborem cookie. |
| **Secured cookie** | Zaškrtávací políčko. Soubor cookie lze pak použít, pouze když je připojení k webu zabezpečené (HTTPS). |
| **SameSite** | Neupravitelný rozevírací seznam: **Strict**, **Lax** *(výchozí)* nebo **None**. Určuje, jak se soubor cookie chová u požadavků přicházejících z jiného webu. |

## Zvláštní syntaxe hodnot

Pole **Value** přijímá substituční řetězce, které se nahradí při spuštění SSO. Stejná syntaxe platí pro parametry, hlavičky a těla [požadavků předběžného ověřování](https://docs.cyberelements.io/bastion/4.6/cs/Usage/AdminConsoleReference/SsoPreAuthRequest/).

| Substituce | Účinek |
|---|---|
| `%user%` | Přihlašovací jméno, které se má pro SSO použít. |
| `%password%` | Heslo, které se má pro SSO použít. |
| `%base64([...])%` | Zakóduje obsah závorek v kódování base64. |
| `%lowercase([...])%` | Převede obsah na malá písmena. |
| `%uppercase([...])%` | Převede obsah na velká písmena. |
| `%trim([...])%` | Odstraní z obsahu úvodní a koncové prázdné znaky. |
| `%uriencoded([...])%` | Nahradí neobvyklé speciální znaky jejich kódováním UTF-8 pro použití v adrese URL. |

K dispozici jsou také šifrovací funkce:

| Funkce | Očekávané parametry |
|---|---|
| `%sha256([...])%` | Data, ze kterých se má vypočítat hash (SHA-256). |
| `%md5([...])%` | Data, ze kterých se má vypočítat hash (MD5). |
| `%hmacmd5([...])%` | Dva parametry: data k zašifrování a poté šifrovací klíč. |
| `%rsa([...])%` | Dva parametry: veřejný klíč a poté data k zašifrování. |
| `%rsaoaep([...])%` | Dva parametry: veřejný klíč ve formátu PEM a poté řetězec k zašifrování. |
| `%reqresult([...])%` | Pořadové číslo požadavku, jehož výsledek se má znovu použít, a volitelně název klíče, který se má vybrat, když tento výsledek obsahuje více parametrů. |

> **Dvě pravidla zápisu**
>
> Parametry funkcí se oddělují pomocí **`%,%`**. Chcete-li zadat znak procenta doslova, napište **`\%`**.

## Uložení

Kliknutím na **Validate** přidáte nebo aktualizujete údaj v aktuálním kroku předběžného ověřování. **Cancel** zavře okno bez uložení.
