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

# Pre-authentication Web SSO request

> **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 tlačítko **+** přidá požadavek. Okno obsahuje ikonu nápovědy, která otevře stránku nápovědy modulu.

Okno **Pre-authentication Web SSO request** umožňuje správci definovat **požadavek HTTP**, který musí služba Mediation Controller odeslat na cílový server před závěrečným krokem ověřování aplikace Web SSO. Zjednodušená varianta se používá pro **konečné přesměrování** na aplikační server.

Každý požadavek je v seznamu kroků identifikován svou **adresou URL**, svou **metodou** a svým **pořadím odeslání** — právě na toto pořadí odkazuje substituce `%reqresult()%` popsaná v části [Zvláštní syntaxe hodnot](#special-syntax-of-values).

## Hlavní pole

| Pole | Popis |
|---|---|
| **URL** | Adresa URL, před kterou se automaticky doplní již známá adresa cílového serveru (pokud řetězec přesahuje 100 znaků, předpona se při zobrazení zkrátí). V režimu **konečného přesměrování** nelze adresu URL upravit. |
| **Method** | Povinné. Možnosti: **GET** nebo **POST** *(výchozí)*. |
| **Content type (MIME)** | Typ MIME těla požadavku. Výchozí hodnota: `application/x-www-form-urlencoded`. Další možnosti: `application/json`, `application/xml`, `text/html`, `text/plain`, `text/richtext`, `text/tab-separated-values`. V režimu **konečného přesměrování** je skryté a neaktivní. |
| **Enable cache** | Zaškrtávací políčko, ve výchozím nastavení zaškrtnuté. V režimu **konečného přesměrování** je skryté a neaktivní. |
| **Login parameter** | Název parametru, který má nést přihlašovací jméno. Aktivní pouze tehdy, když typ obsahu přijímá parametry, tedy `application/x-www-form-urlencoded`. |
| **Password parameter** | Název parametru, který má nést heslo. Platí stejná pravidla aktivace jako výše. |
| **Advanced settings** | Zaškrtávací políčko. Zobrazí nebo skryje karty pokročilých dat. Je vynuceně zaškrtnuté, když aktuální typ obsahu nepřijímá jednoduché parametry. |

## Karty pokročilého nastavení

Když je políčko **Advanced settings** zaškrtnuté, zobrazí se panel karet. Jeho viditelnost závisí na typu obsahu a na režimu (běžný požadavek nebo konečné přesměrování).

**Parameters**

> Viditelná při úpravě **konečného přesměrování** nebo když typ obsahu přijímá parametry (`application/x-www-form-urlencoded`).
>
> Horní formulář přidá položku do tabulky níže, jejíž sloupce jsou **Name** a **Value**; když je prázdná, zobrazuje **No element to display**. Ikona odstranění na každém řádku položku odstraní.
>
> | Pole | Popis |
> |---|---|
> | **Name** | Název parametru. |
> | **Value** | Odpovídající hodnota. 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: hodnota se pak použije tak, jak je, a zpráva o syntaxi zmizí. Položky přidané tímto způsobem se v tabulce zobrazují **kurzívou**. |
> | **Handle as JSON data** | Zaškrtávací políčko. Hodnota se zpracovává jako objekt JSON. |
> | **Add** | Vloží položku do tabulky. |

**Content**

> Viditelná, když se neupravuje konečné přesměrování, **a** zároveň typ obsahu nepřijímá jednoduché parametry (například `application/json`).
>
> | Pole | Popis |
> |---|---|
> | **Content** | Víceřádkové textové pole synchronizované v reálném čase. Připomíná se stejná zpráva o zvláštní syntaxi. |
> | **Disable special syntax** | Zaškrtávací políčko: obsah se pak použije tak, jak je. |

**Headers**

> Viditelná, když se neupravuje konečné přesměrování.
>
> Formulář je stejný jako na kartě **Parameters**: **Name**, **Value**, **Disable special syntax**, **Handle as JSON data**, tlačítko **Add** a tabulka s odstraněním po jednotlivých řádcích.

Tlačítka **Previous** a **Next** přepínají mezi viditelnými kartami.

## Zvláštní syntaxe hodnot

Pole **Value** (karty **Parameters** a **Headers**) a pole **Content** přijímají substituční řetězce, které se nahradí při spuštění SSO. Stejná syntaxe platí pro [data předběžného ověřování](https://docs.cyberelements.io/bastion/4.6/cs/Usage/AdminConsoleReference/SsoPreAuthData/).

| 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 požadavek v aktuálním kroku předběžného ověřování. **Cancel** zavře okno bez uložení.

> **Přizpůsobení výšky**
>
> Okno automaticky mění velikost podle režimu: krátký formulář, když je políčko **Advanced settings** nezaškrtnuté nebo v režimu přesměrování, vysoký formulář, když je panel karet viditelný.
