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

# Pre-authentication Web SSO request

> **Mooduli Applications siseaken**
>
> Sellesse aknasse pääseb moodulist **Applications** rakenduse puhul, mille teenusetüüp on **Web** ja mille **SSO type** on **Pre-authentication**: nupp **Configure pre-authentication steps** avab etappide loendi, kus nupp **+** lisab taotluse. Aknas on spikriikoon, mis avab mooduli spikrilehe.

Aknas **Pre-authentication Web SSO request** saab administraator määratleda **HTTP-taotluse**, mille Mediation Controller server peab saatma sihtserverile enne Web SSO rakenduse viimast autentimisetappi. Rakendusserverisse suunava **lõpliku ümbersuunamise** jaoks kasutatakse lihtsustatud varianti.

Iga taotlus on etappide loendis tuvastatav oma **URL-i**, **meetodi** ja **saatmisjärjekorra** järgi — just sellele järjekorrale viitab asendus `%reqresult()%`, mida on kirjeldatud peatükis [Väärtuste erisüntaks](#special-syntax-of-values).

## Põhiväljad

| Väli | Kirjeldus |
|---|---|
| **URL** | URL, mille ette lisatakse automaatselt juba teadaolev sihtserveri aadress (kui string ületab 100 märki, kärbitakse eesliidet kuvamisel). **Lõpliku ümbersuunamise** režiimis ei saa URL-i muuta. |
| **Method** | Kohustuslik. Valikud: **GET** või **POST** *(vaikimisi)*. |
| **Content type (MIME)** | Taotluse keha MIME-tüüp. Vaikeväärtus: `application/x-www-form-urlencoded`. Muud valikud: `application/json`, `application/xml`, `text/html`, `text/plain`, `text/richtext`, `text/tab-separated-values`. **Lõpliku ümbersuunamise** režiimis peidetud ja välja lülitatud. |
| **Enable cache** | Märkeruut, vaikimisi märgitud. **Lõpliku ümbersuunamise** režiimis peidetud ja välja lülitatud. |
| **Login parameter** | Selle parameetri nimi, mis peab kandma kasutajanime. Sisse lülitatud ainult siis, kui sisutüüp aktsepteerib parameetreid, st `application/x-www-form-urlencoded`. |
| **Password parameter** | Selle parameetri nimi, mis peab kandma parooli. Sisselülitamise reeglid on samad mis eespool. |
| **Advanced settings** | Märkeruut. Kuvab või peidab täpsemate andmete vahekaardid. Sunnitult sisse lülitatud, kui praegune sisutüüp ei aktsepteeri lihtsaid parameetreid. |

## Täpsemate sätete vahekaardid

Kui **Advanced settings** on sisse lülitatud, kuvatakse vahekaartide paneel. Selle nähtavus oleneb sisutüübist ja režiimist (tavaline taotlus või lõplik ümbersuunamine).

**Parameters**

> Nähtav **lõpliku ümbersuunamise** muutmisel või siis, kui sisutüüp aktsepteerib parameetreid (`application/x-www-form-urlencoded`).
>
> Ülemine vorm lisab kirje allolevasse tabelisse, mille veerud on **Name** ja **Value**; tühjana kuvatakse selles **No element to display**. Iga rea kustutamisikoon eemaldab kirje.
>
> | Väli | Kirjeldus |
> |---|---|
> | **Name** | Parameetri nimi. |
> | **Value** | Vastav väärtus. Välja all olev teade tuletab meelde, et **This field follows a special syntax. Please consult the help page for more informations.** Vt peatükk [Väärtuste erisüntaks](#special-syntax-of-values). |
> | **Disable special syntax** | Märkeruut: väärtus võetakse siis muutmata kujul ja süntaksiteade kaob. Nii lisatud kirjed kuvatakse tabelis **kaldkirjas**. |
> | **Handle as JSON data** | Märkeruut. Väärtust käsitletakse JSON-objektina. |
> | **Add** | Lisab kirje tabelisse. |

**Content**

> Nähtav siis, kui ei muudeta lõplikku ümbersuunamist, **ja** kui sisutüüp ei aktsepteeri lihtsaid parameetreid (näiteks `application/json`).
>
> | Väli | Kirjeldus |
> |---|---|
> | **Content** | Mitmerealine tekstiala, mida sünkroonitakse reaalajas. Kuvatakse sama erisüntaksi teade. |
> | **Disable special syntax** | Märkeruut: sisu võetakse siis muutmata kujul. |

**Headers**

> Nähtav siis, kui ei muudeta lõplikku ümbersuunamist.
>
> Vorm on identne vahekaardiga **Parameters**: **Name**, **Value**, **Disable special syntax**, **Handle as JSON data**, nupp **Add** ja tabel, kus saab ridu ükshaaval kustutada.

Nupud **Previous** ja **Next** viivad nähtavate vahekaartide vahel.

## Väärtuste erisüntaks

Väljad **Value** (vahekaardid **Parameters** ja **Headers**) ning väli **Content** aktsepteerivad asendusstringe, mis asendatakse SSO käivitamisel. Sama süntaks kehtib andmete [pre-authentication data](https://docs.cyberelements.io/bastion/4.6/et/Usage/AdminConsoleReference/SsoPreAuthData/) kohta.

| Asendus | Toime |
|---|---|
| `%user%` | SSO jaoks kasutatav kasutajanimi. |
| `%password%` | SSO jaoks kasutatav parool. |
| `%base64([...])%` | Kodeerib sulgude sisu base64-vormingusse. |
| `%lowercase([...])%` | Teisendab sisu väiketähtedeks. |
| `%uppercase([...])%` | Teisendab sisu suurtähtedeks. |
| `%trim([...])%` | Eemaldab sisu algusest ja lõpust tühimärgid. |
| `%uriencoded([...])%` | Asendab harvaesinevad erimärgid nende UTF-8-kodeeringuga, et neid saaks URL-is kasutada. |

Saadaval on ka krüptimisfunktsioonid:

| Funktsioon | Oodatavad parameetrid |
|---|---|
| `%sha256([...])%` | Räsitavad andmed (SHA-256). |
| `%md5([...])%` | Räsitavad andmed (MD5). |
| `%hmacmd5([...])%` | Kaks parameetrit: krüptitavad andmed, seejärel krüptimisvõti. |
| `%rsa([...])%` | Kaks parameetrit: avalik võti, seejärel krüptitavad andmed. |
| `%rsaoaep([...])%` | Kaks parameetrit: PEM-vormingus avalik võti, seejärel krüptitav string. |
| `%reqresult([...])%` | Selle taotluse järjenumber, mille tulemust tuleb uuesti kasutada, ja soovi korral võtme nimi, mis valitakse, kui see tulemus sisaldab mitut parameetrit. |

> **Kaks kirjutusreeglit**
>
> Funktsiooni parameetrid eraldatakse märgiga **`%,%`**. Literaalse protsendimärgi sisestamiseks kirjutage **`\%`**.

## Salvestamine

Taotluse lisamiseks praegusesse eelautentimise etappi või selle värskendamiseks klõpsake nuppu **Validate**. **Cancel** sulgeb akna salvestamata.

> **Kõrguse kohandumine**
>
> Akna suurus muutub automaatselt olenevalt režiimist: lühike vorm, kui **Advanced settings** on välja lülitatud või kui kasutusel on ümbersuunamisrežiim, kõrge vorm, kui vahekaartide paneel on nähtav.
