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

# Pre-authentication Web SSO request

> **Notranje okno modula Applications**
>
> To okno odprete iz modula **Applications** pri aplikaciji, katere vrsta storitve je **Web** in katere **SSO type** je **Pre-authentication**: gumb **Configure pre-authentication steps** odpre seznam korakov, kjer gumb **+** doda zahtevo. Okno vsebuje ikono pomoči, ki odpre stran pomoči modula.

Okno **Pre-authentication Web SSO request** skrbniku omogoča, da določi **zahtevo HTTP**, ki jo mora storitev Mediation Controller poslati ciljnemu strežniku pred končnim korakom preverjanja pristnosti aplikacije Web SSO. Poenostavljena različica se uporablja za **končno preusmeritev** na aplikacijski strežnik.

Vsaka zahteva je na seznamu korakov prepoznana po naslovu **URL**, **metodi** in **vrstnem redu pošiljanja** — na ta vrstni red se sklicuje zamenjava `%reqresult()%`, opisana v poglavju [Posebna sintaksa vrednosti](#special-syntax-of-values).

## Glavna polja

| Polje | Opis |
|---|---|
| **URL** | Naslov URL, ki mu je samodejno dodana predpona z že znanim naslovom ciljnega strežnika (predpona je pri prikazu skrajšana, kadar niz presega 100 znakov). V načinu **končne preusmeritve** naslova URL ni mogoče urejati. |
| **Method** | Obvezno. Možnosti: **GET** ali **POST** *(privzeto)*. |
| **Content type (MIME)** | Vrsta MIME telesa zahteve. Privzeta vrednost: `application/x-www-form-urlencoded`. Druge možnosti: `application/json`, `application/xml`, `text/html`, `text/plain`, `text/richtext`, `text/tab-separated-values`. Skrito in onemogočeno v načinu **končne preusmeritve**. |
| **Enable cache** | Potrditveno polje, privzeto označeno. Skrito in onemogočeno v načinu **končne preusmeritve**. |
| **Login parameter** | Ime parametra, ki mora vsebovati prijavno ime. Omogočeno le, kadar vrsta vsebine sprejema parametre, torej `application/x-www-form-urlencoded`. |
| **Password parameter** | Ime parametra, ki mora vsebovati geslo. Enaka pravila omogočanja kot zgoraj. |
| **Advanced settings** | Potrditveno polje. Prikaže ali skrije zavihke z naprednimi podatki. Prisilno vklopljeno, kadar trenutna vrsta vsebine ne sprejema preprostih parametrov. |

## Zavihki naprednih nastavitev

Kadar je **Advanced settings** vklopljeno, se prikaže plošča z zavihki. Njena vidnost je odvisna od vrste vsebine in od načina (navadna zahteva ali končna preusmeritev).

**Parameters**

> Viden pri urejanju **končne preusmeritve** ali kadar vrsta vsebine sprejema parametre (`application/x-www-form-urlencoded`).
>
> Zgornji obrazec doda vnos v spodnjo tabelo, katere stolpca sta **Name** in **Value**; kadar je prazna, prikazuje **No element to display**. Ikona za brisanje v vsaki vrstici odstrani vnos.
>
> | Polje | Opis |
> |---|---|
> | **Name** | Ime parametra. |
> | **Value** | Ustrezna vrednost. Sporočilo pod poljem opozarja, da **This field follows a special syntax. Please consult the help page for more informations.** Glejte poglavje [Posebna sintaksa vrednosti](#special-syntax-of-values). |
> | **Disable special syntax** | Potrditveno polje: vrednost se nato prevzame takšna, kot je, sporočilo o sintaksi pa izgine. Vnosi, dodani na ta način, so v tabeli prikazani **ležeče**. |
> | **Handle as JSON data** | Potrditveno polje. Vrednost se obravnava kot objekt JSON. |
> | **Add** | Vstavi vnos v tabelo. |

**Content**

> Viden, kadar se ne ureja končna preusmeritev, **in** kadar vrsta vsebine ne sprejema preprostih parametrov (na primer `application/json`).
>
> | Polje | Opis |
> |---|---|
> | **Content** | Večvrstično besedilno polje, sinhronizirano v realnem času. Prikazano je enako sporočilo o posebni sintaksi. |
> | **Disable special syntax** | Potrditveno polje: vsebina se nato prevzame takšna, kot je. |

**Headers**

> Viden, kadar se ne ureja končna preusmeritev.
>
> Obrazec je enak kot na zavihku **Parameters**: **Name**, **Value**, **Disable special syntax**, **Handle as JSON data**, gumb **Add** in tabela z brisanjem po vrsticah.

Gumba **Previous** in **Next** omogočata premikanje med vidnimi zavihki.

## Posebna sintaksa vrednosti

Polja **Value** (zavihka **Parameters** in **Headers**) in polje **Content** sprejemajo nadomestne nize, ki se zamenjajo ob izvajanju SSO. Enaka sintaksa velja za [pre-authentication data](https://docs.cyberelements.io/bastion/4.6/sl/Usage/AdminConsoleReference/SsoPreAuthData/).

| Zamenjava | Učinek |
|---|---|
| `%user%` | Prijavno ime za SSO. |
| `%password%` | Geslo za SSO. |
| `%base64([...])%` | Kodira vsebino oklepajev v base64. |
| `%lowercase([...])%` | Pretvori vsebino v male črke. |
| `%uppercase([...])%` | Pretvori vsebino v velike črke. |
| `%trim([...])%` | Odstrani začetne in končne presledke iz vsebine. |
| `%uriencoded([...])%` | Zamenja neobičajne posebne znake z njihovim kodiranjem UTF-8 za uporabo v naslovu URL. |

Na voljo so tudi funkcije šifriranja:

| Funkcija | Pričakovani parametri |
|---|---|
| `%sha256([...])%` | Podatki za zgoščevanje (SHA-256). |
| `%md5([...])%` | Podatki za zgoščevanje (MD5). |
| `%hmacmd5([...])%` | Dva parametra: podatki za šifriranje, nato šifrirni ključ. |
| `%rsa([...])%` | Dva parametra: javni ključ, nato podatki za šifriranje. |
| `%rsaoaep([...])%` | Dva parametra: javni ključ v obliki PEM, nato niz za šifriranje. |
| `%reqresult([...])%` | Zaporedna številka zahteve, katere rezultat je treba znova uporabiti, in po želji ime ključa, ki ga je treba izbrati, kadar ta rezultat vsebuje več parametrov. |

> **Dve konvenciji zapisa**
>
> Parametre funkcij ločite z **`%,%`**. Če želite vnesti dobesedni znak za odstotek, napišite **`\%`**.

## Shranjevanje

Kliknite **Validate**, da dodate ali posodobite zahtevo v trenutnem koraku predhodnega preverjanja pristnosti. **Cancel** zapre okno brez shranjevanja.

> **Prilagajanje višine**
>
> Okno samodejno spremeni velikost glede na način: kratek obrazec, kadar je **Advanced settings** izklopljeno ali v načinu preusmeritve, visok obrazec, kadar je plošča z zavihki vidna.
