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

# Pre-authentication Web SSO request

> **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 tlačidlo **+** pridá požiadavku. Okno obsahuje ikonu pomocníka, ktorá otvorí stránku pomocníka modulu.

Okno **Pre-authentication Web SSO request** umožňuje správcovi definovať **požiadavku HTTP**, ktorú musí služba Mediation Controller odoslať na cieľový server pred záverečným krokom overovania aplikácie Web SSO. Zjednodušený variant sa používa na **záverečné presmerovanie** na aplikačný server.

Každá požiadavka je v zozname krokov identifikovaná svojou **adresou URL**, svojou **metódou** a svojím **poradím odoslania** — práve na toto poradie odkazuje substitúcia `%reqresult()%` opísaná v časti [Špeciálna syntax hodnôt](#special-syntax-of-values).

## Hlavné polia

| Pole | Popis |
|---|---|
| **URL** | Adresa URL, pred ktorú sa automaticky pridá už známa adresa cieľového servera (predpona sa pri zobrazení skráti, keď reťazec presiahne 100 znakov). V režime **záverečného presmerovania** adresu URL nemožno upraviť. |
| **Method** | Povinné pole. Možnosti: **GET** alebo **POST** *(predvolené)*. |
| **Content type (MIME)** | Typ MIME tela požiadavky. Predvolená hodnota: `application/x-www-form-urlencoded`. Ďalšie možnosti: `application/json`, `application/xml`, `text/html`, `text/plain`, `text/richtext`, `text/tab-separated-values`. Skryté a zakázané v režime **záverečného presmerovania**. |
| **Enable cache** | Začiarkavacie políčko, predvolene začiarknuté. Skryté a zakázané v režime **záverečného presmerovania**. |
| **Login parameter** | Názov parametra, ktorý musí obsahovať prihlasovacie meno. Povolené iba vtedy, keď typ obsahu prijíma parametre, teda `application/x-www-form-urlencoded`. |
| **Password parameter** | Názov parametra, ktorý musí obsahovať heslo. Povolené za rovnakých podmienok ako vyššie. |
| **Advanced settings** | Začiarkavacie políčko. Zobrazí alebo skryje karty rozšírených údajov. Je vynútene začiarknuté, keď aktuálny typ obsahu neprijíma jednoduché parametre. |

## Karty rozšírených nastavení

Keď je políčko **Advanced settings** začiarknuté, zobrazí sa panel kariet. Jeho viditeľnosť závisí od typu obsahu a od režimu (bežná požiadavka alebo záverečné presmerovanie).

**Parameters**

> Viditeľná pri úprave **záverečného presmerovania** alebo keď typ obsahu prijíma parametre (`application/x-www-form-urlencoded`).
>
> Horný formulár pridá položku do tabuľky nižšie, ktorej stĺpce sú **Name** a **Value**; keď je prázdna, zobrazuje **No element to display**. Ikona odstránenia v každom riadku položku odstráni.
>
> | Pole | Popis |
> |---|---|
> | **Name** | Názov parametra. |
> | **Value** | Príslušná hodnota. 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: hodnota sa potom prevezme bez zmeny a správa o syntaxi zmizne. Položky pridané týmto spôsobom sa v tabuľke zobrazujú **kurzívou**. |
> | **Handle as JSON data** | Začiarkavacie políčko. Hodnota sa spracuje ako objekt JSON. |
> | **Add** | Vloží položku do tabuľky. |

**Content**

> Viditeľná, keď sa neupravuje záverečné presmerovanie, **a** keď typ obsahu neprijíma jednoduché parametre (napríklad `application/json`).
>
> | Pole | Popis |
> |---|---|
> | **Content** | Viacriadkové textové pole synchronizované v reálnom čase. Pripomína sa rovnaká správa o špeciálnej syntaxi. |
> | **Disable special syntax** | Začiarkavacie políčko: obsah sa potom prevezme bez zmeny. |

**Headers**

> Viditeľná, keď sa neupravuje záverečné presmerovanie.
>
> Formulár je rovnaký ako na karte **Parameters**: **Name**, **Value**, **Disable special syntax**, **Handle as JSON data**, tlačidlo **Add** a tabuľka s odstraňovaním po riadkoch.

Tlačidlá **Previous** a **Next** prechádzajú medzi viditeľnými kartami.

## Špeciálna syntax hodnôt

Polia **Value** (karty **Parameters** a **Headers**) a pole **Content** prijímajú substitučné reťazce, ktoré sa nahradia pri spustení SSO. Rovnaká syntax platí pre [pre-authentication data](https://docs.cyberelements.io/bastion/4.6/sk/Usage/AdminConsoleReference/SsoPreAuthData/).

| 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 požiadavku v aktuálnom kroku predbežného overovania. **Cancel** zatvorí okno bez uloženia.

> **Prispôsobenie výšky**
>
> Okno automaticky mení veľkosť podľa režimu: krátky formulár, keď je políčko **Advanced settings** nezačiarknuté alebo v režime presmerovania, vysoký formulár, keď je panel kariet viditeľný.
