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

# Pre-authentication Web SSO request

> **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 mygtukas **+** prideda užklausą. Lange yra žinyno piktograma, atidaranti modulio žinyno puslapį.

Langas **Pre-authentication Web SSO request** leidžia administratoriui apibrėžti **HTTP užklausą**, kurią Mediation Controller turi išsiųsti tiksliniam serveriui prieš paskutinį Web SSO taikomosios programos autentifikavimo žingsnį. Supaprastintas variantas naudojamas **galutiniam peradresavimui** į taikomosios programos serverį.

Kiekviena užklausa žingsnių sąraše identifikuojama pagal **URL**, **metodą** ir **siuntimo eilės tvarką** – būtent į šią eilės tvarką nurodo skyriuje [Specialioji reikšmių sintaksė](#special-syntax-of-values) aprašytas pakeitimas `%reqresult()%`.

## Pagrindiniai laukai

| Laukas | Aprašas |
|---|---|
| **URL** | URL, prie kurio pradžios automatiškai pridedamas jau žinomas tikslinio serverio adresas (rodant priešdėlis sutrumpinamas, kai eilutė viršija 100 simbolių). Režimu **galutinis peradresavimas** URL redaguoti negalima. |
| **Method** | Privalomas. Galimos reikšmės: **GET** arba **POST** *(numatytoji)*. |
| **Content type (MIME)** | Užklausos turinio MIME tipas. Numatytoji reikšmė: `application/x-www-form-urlencoded`. Kitos galimos reikšmės: `application/json`, `application/xml`, `text/html`, `text/plain`, `text/richtext`, `text/tab-separated-values`. Režimu **galutinis peradresavimas** paslėptas ir išjungtas. |
| **Enable cache** | Žymės langelis, pagal numatytuosius parametrus pažymėtas. Režimu **galutinis peradresavimas** paslėptas ir išjungtas. |
| **Login parameter** | Parametro, kuriame turi būti perduodamas prisijungimo vardas, pavadinimas. Įjungtas, tik kai turinio tipas leidžia parametrus, t. y. `application/x-www-form-urlencoded`. |
| **Password parameter** | Parametro, kuriame turi būti perduodamas slaptažodis, pavadinimas. Galioja tos pačios įjungimo taisyklės, kaip nurodyta pirmiau. |
| **Advanced settings** | Žymės langelis. Rodo arba slepia išplėstinių duomenų skirtukus. Priverstinai įjungiamas, kai dabartinis turinio tipas neleidžia paprastų parametrų. |

## Išplėstinių parametrų skirtukai

Kai **Advanced settings** įjungtas, atsiranda skirtukų skydelis. Jo matomumas priklauso nuo turinio tipo ir režimo (įprasta užklausa arba galutinis peradresavimas).

**Parameters**

> Matomas redaguojant **galutinį peradresavimą** arba kai turinio tipas leidžia parametrus (`application/x-www-form-urlencoded`).
>
> Viršutinė forma prideda elementą į žemiau esančią lentelę, kurios stulpeliai yra **Name** ir **Value**; kai ji tuščia, joje rodoma **No element to display**. Kiekvienos eilutės naikinimo piktograma pašalina elementą.
>
> | Laukas | Aprašas |
> |---|---|
> | **Name** | Parametro pavadinimas. |
> | **Value** | Atitinkama reikšmė. 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: tada reikšmė naudojama tokia, kokia yra, o pranešimas apie sintaksę išnyksta. Taip pridėti elementai lentelėje rodomi **kursyvu**. |
> | **Handle as JSON data** | Žymės langelis. Reikšmė apdorojama kaip JSON objektas. |
> | **Add** | Įterpia elementą į lentelę. |

**Content**

> Matomas, kai neredaguojamas galutinis peradresavimas, **ir** kai turinio tipas neleidžia paprastų parametrų (pavyzdžiui, `application/json`).
>
> | Laukas | Aprašas |
> |---|---|
> | **Content** | Kelių eilučių teksto sritis, sinchronizuojama realiuoju laiku. Rodomas tas pats pranešimas apie specialiąją sintaksę. |
> | **Disable special syntax** | Žymės langelis: tada turinys naudojamas toks, koks yra. |

**Headers**

> Matomas, kai neredaguojamas galutinis peradresavimas.
>
> Forma tokia pat kaip skirtuke **Parameters**: **Name**, **Value**, **Disable special syntax**, **Handle as JSON data**, mygtukas **Add** ir lentelė, kurioje kiekvieną eilutę galima panaikinti.

Mygtukai **Previous** ir **Next** perjungia matomus skirtukus.

## Specialioji reikšmių sintaksė

Laukuose **Value** (skirtukai **Parameters** ir **Headers**) ir lauke **Content** galima naudoti pakeitimo eilutes, kurios pakeičiamos vykdant SSO. Ta pati sintaksė taikoma ir [pre-authentication data](https://docs.cyberelements.io/bastion/4.6/lt/Usage/AdminConsoleReference/SsoPreAuthData/).

| 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 užklausą dabartiniame išankstinio autentifikavimo žingsnyje. **Cancel** uždaro langą neišsaugodamas.

> **Aukščio pritaikymas**
>
> Lango dydis automatiškai keičiamas pagal režimą: trumpa forma, kai **Advanced settings** išjungtas arba veikia peradresavimo režimas, aukšta forma, kai matomas skirtukų skydelis.
