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

# Pre-authentication Web SSO request

> **Interni prozor modula Applications**
>
> Ovaj se prozor otvara iz modula **Applications**, za aplikaciju čija je vrsta usluge **Web**, a **SSO type** **Pre-authentication**: gumb **Configure pre-authentication steps** otvara popis koraka, u kojem gumb **+** dodaje zahtjev. Prozor sadrži ikonu pomoći koja otvara stranicu pomoći modula.

Prozor **Pre-authentication Web SSO request** omogućuje administratoru da definira **HTTP zahtjev** koji Mediation Controller mora poslati ciljnom poslužitelju prije završnog koraka provjere autentičnosti aplikacije Web SSO. Pojednostavljena varijanta koristi se za **završno preusmjeravanje** na poslužitelj aplikacije.

Svaki se zahtjev na popisu koraka identificira svojom **URL adresom**, svojom **metodom** i svojim **redoslijedom slanja** — na taj se redoslijed odnosi zamjena `%reqresult()%` opisana u poglavlju [Posebna sintaksa vrijednosti](#special-syntax-of-values).

## Glavna polja

| Polje | Opis |
|---|---|
| **URL** | URL adresa kojoj se automatski dodaje prefiks s već poznatom adresom ciljnog poslužitelja (prefiks se pri prikazu skraćuje kada niz premašuje 100 znakova). U načinu **završnog preusmjeravanja** URL adresa ne može se uređivati. |
| **Method** | Obavezno. Mogućnosti: **GET** ili **POST** *(zadano)*. |
| **Content type (MIME)** | MIME vrsta tijela zahtjeva. Zadana vrijednost: `application/x-www-form-urlencoded`. Ostale mogućnosti: `application/json`, `application/xml`, `text/html`, `text/plain`, `text/richtext`, `text/tab-separated-values`. Skriveno i onemogućeno u načinu **završnog preusmjeravanja**. |
| **Enable cache** | Potvrdni okvir, označen prema zadanim postavkama. Skriveno i onemogućeno u načinu **završnog preusmjeravanja**. |
| **Login parameter** | Naziv parametra koji mora sadržavati korisničko ime. Omogućeno samo kada vrsta sadržaja prihvaća parametre, odnosno `application/x-www-form-urlencoded`. |
| **Password parameter** | Naziv parametra koji mora sadržavati lozinku. Vrijede ista pravila omogućivanja kao gore. |
| **Advanced settings** | Potvrdni okvir. Prikazuje ili skriva kartice naprednih podataka. Prisilno uključeno kada trenutačna vrsta sadržaja ne prihvaća jednostavne parametre. |

## Kartice naprednih postavki

Kada je **Advanced settings** uključeno, pojavljuje se ploča s karticama. Njezina vidljivost ovisi o vrsti sadržaja i o načinu (običan zahtjev ili završno preusmjeravanje).

**Parameters**

> Vidljivo pri uređivanju **završnog preusmjeravanja** ili kada vrsta sadržaja prihvaća parametre (`application/x-www-form-urlencoded`).
>
> Gornji obrazac dodaje unos u tablicu ispod, čiji su stupci **Name** i **Value**; kada je prazna, prikazuje **No element to display**. Ikona za brisanje u svakom retku uklanja unos.
>
> | Polje | Opis |
> |---|---|
> | **Name** | Naziv parametra. |
> | **Value** | Pripadajuća vrijednost. Poruka ispod polja podsjeća da **This field follows a special syntax. Please consult the help page for more informations.** Pogledajte poglavlje [Posebna sintaksa vrijednosti](#special-syntax-of-values). |
> | **Disable special syntax** | Potvrdni okvir: vrijednost se tada uzima onakva kakva jest, a poruka o sintaksi nestaje. Unosi dodani na taj način prikazuju se u tablici **kurzivom**. |
> | **Handle as JSON data** | Potvrdni okvir. Vrijednost se tretira kao JSON objekt. |
> | **Add** | Umeće unos u tablicu. |

**Content**

> Vidljivo kada se ne uređuje završno preusmjeravanje **i** kada vrsta sadržaja ne prihvaća jednostavne parametre (na primjer `application/json`).
>
> | Polje | Opis |
> |---|---|
> | **Content** | Višeretčano tekstno područje, sinkronizirano u stvarnom vremenu. Ponavlja se ista poruka o posebnoj sintaksi. |
> | **Disable special syntax** | Potvrdni okvir: sadržaj se tada uzima onakav kakav jest. |

**Headers**

> Vidljivo kada se ne uređuje završno preusmjeravanje.
>
> Obrazac je identičan onome na kartici **Parameters**: **Name**, **Value**, **Disable special syntax**, **Handle as JSON data**, gumb **Add** i tablica s brisanjem po retku.

Gumbi **Previous** i **Next** prebacuju između vidljivih kartica.

## Posebna sintaksa vrijednosti

Polja **Value** (kartice **Parameters** i **Headers**) i polje **Content** prihvaćaju nizove zamjene koji se zamjenjuju kada se SSO izvodi. Ista sintaksa vrijedi za [pre-authentication data](https://docs.cyberelements.io/bastion/4.6/hr/Usage/AdminConsoleReference/SsoPreAuthData/).

| Zamjena | Učinak |
|---|---|
| `%user%` | Korisničko ime koje treba koristiti za SSO. |
| `%password%` | Lozinka koju treba koristiti za SSO. |
| `%base64([...])%` | Kodira sadržaj zagrada u base64. |
| `%lowercase([...])%` | Pretvara sadržaj u mala slova. |
| `%uppercase([...])%` | Pretvara sadržaj u velika slova. |
| `%trim([...])%` | Uklanja početne i završne razmake iz sadržaja. |
| `%uriencoded([...])%` | Zamjenjuje neuobičajene posebne znakove njihovim kodiranjem UTF-8, za upotrebu u URL adresi. |

Dostupne su i funkcije šifriranja:

| Funkcija | Očekivani parametri |
|---|---|
| `%sha256([...])%` | Podaci za izračun sažetka (SHA-256). |
| `%md5([...])%` | Podaci za izračun sažetka (MD5). |
| `%hmacmd5([...])%` | Dva parametra: podaci koje treba šifrirati, zatim ključ za šifriranje. |
| `%rsa([...])%` | Dva parametra: javni ključ, zatim podaci koje treba šifrirati. |
| `%rsaoaep([...])%` | Dva parametra: javni ključ u formatu PEM, zatim niz koji treba šifrirati. |
| `%reqresult([...])%` | Redni broj zahtjeva čiji se rezultat mora ponovno upotrijebiti i, po želji, naziv ključa koji treba odabrati kada taj rezultat sadrži više parametara. |

> **Dvije konvencije pisanja**
>
> Parametri funkcije odvajaju se pomoću **`%,%`**. Da biste unijeli doslovni znak postotka, napišite **`\%`**.

## Spremanje

Kliknite **Validate** kako biste dodali ili ažurirali zahtjev u trenutačnom koraku prethodne provjere autentičnosti. **Cancel** zatvara prozor bez spremanja.

> **Prilagodba visine**
>
> Veličina prozora automatski se prilagođava ovisno o načinu: kratki obrazac kada je **Advanced settings** isključeno ili u načinu preusmjeravanja, visoki obrazac kada je ploča s karticama vidljiva.
