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

# Pre-authentication Web SSO request

> **Moduļa Applications iekšējais logs**
>
> Šis logs ir pieejams modulī **Applications** lietojumprogrammai, kuras pakalpojuma tips ir **Web** un kuras **SSO type** ir **Pre-authentication**: poga **Configure pre-authentication steps** atver soļu sarakstu, kurā poga **+** pievieno pieprasījumu. Logā ir palīdzības ikona, kas atver moduļa palīdzības lapu.

Logs **Pre-authentication Web SSO request** ļauj administratoram definēt **HTTP pieprasījumu**, kas komponentam Mediation Controller ir jānosūta mērķa serverim pirms Web SSO lietojumprogrammas pēdējā autentifikācijas soļa. Vienkāršots variants tiek izmantots **galīgajai novirzīšanai** uz lietojumprogrammas serveri.

Katrs pieprasījums soļu sarakstā tiek identificēts pēc tā **URL**, tā **metodes** un tā **sūtīšanas secības** — tieši uz šo secību attiecas aizstāšana `%reqresult()%`, kas aprakstīta nodaļā [Vērtību īpašā sintakse](#special-syntax-of-values).

## Galvenie lauki

| Lauks | Apraksts |
|---|---|
| **URL** | URL, kura sākumā automātiski tiek pievienota jau zināmā mērķa servera adrese (attēlojumā prefikss tiek saīsināts, ja virkne pārsniedz 100 rakstzīmes). **Galīgās novirzīšanas** režīmā URL nevar rediģēt. |
| **Method** | Obligāts. Iespējas: **GET** vai **POST** *(noklusējums)*. |
| **Content type (MIME)** | Pieprasījuma pamatteksta MIME tips. Noklusējuma vērtība: `application/x-www-form-urlencoded`. Citas iespējas: `application/json`, `application/xml`, `text/html`, `text/plain`, `text/richtext`, `text/tab-separated-values`. **Galīgās novirzīšanas** režīmā paslēpts un atspējots. |
| **Enable cache** | Izvēles rūtiņa, pēc noklusējuma atzīmēta. **Galīgās novirzīšanas** režīmā paslēpta un atspējota. |
| **Login parameter** | Tā parametra nosaukums, kurā jānodod pieteikšanās vārds. Iespējots tikai tad, ja satura tips pieņem parametrus, t.i., `application/x-www-form-urlencoded`. |
| **Password parameter** | Tā parametra nosaukums, kurā jānodod parole. Tie paši iespējošanas nosacījumi kā iepriekš. |
| **Advanced settings** | Izvēles rūtiņa. Parāda vai paslēpj papildu datu cilnes. Tiek ieslēgta piespiedu kārtā, ja pašreizējais satura tips nepieņem vienkāršus parametrus. |

## Papildu iestatījumu cilnes

Kad **Advanced settings** ir ieslēgts, parādās ciļņu panelis. Tā redzamība ir atkarīga no satura tipa un režīma (parasts pieprasījums vai galīgā novirzīšana).

**Parameters**

> Redzama, rediģējot **galīgo novirzīšanu** vai ja satura tips pieņem parametrus (`application/x-www-form-urlencoded`).
>
> Augšējā veidlapa pievieno ierakstu zemāk esošajai tabulai, kuras kolonnas ir **Name** un **Value**; ja tabula ir tukša, tajā ir rakstīts **No element to display**. Dzēšanas ikona katrā rindā noņem ierakstu.
>
> | Lauks | Apraksts |
> |---|---|
> | **Name** | Parametra nosaukums. |
> | **Value** | Atbilstošā vērtība. Ziņojums zem lauka atgādina, ka **This field follows a special syntax. Please consult the help page for more informations.** Skatiet nodaļu [Vērtību īpašā sintakse](#special-syntax-of-values). |
> | **Disable special syntax** | Izvēles rūtiņa: vērtība tad tiek izmantota tieši tāda, kāda tā ir, un ziņojums par sintaksi pazūd. Šādi pievienotie ieraksti tabulā tiek rādīti **slīprakstā**. |
> | **Handle as JSON data** | Izvēles rūtiņa. Vērtība tiek apstrādāta kā JSON objekts. |
> | **Add** | Ievieto ierakstu tabulā. |

**Content**

> Redzama, ja netiek rediģēta galīgā novirzīšana, **un** ja satura tips nepieņem vienkāršus parametrus (piemēram, `application/json`).
>
> | Lauks | Apraksts |
> |---|---|
> | **Content** | Vairākrindu teksta apgabals, kas tiek sinhronizēts reāllaikā. Tiek atgādināts tas pats ziņojums par īpašo sintaksi. |
> | **Disable special syntax** | Izvēles rūtiņa: saturs tad tiek izmantots tieši tāds, kāds tas ir. |

**Headers**

> Redzama, ja netiek rediģēta galīgā novirzīšana.
>
> Veidlapa ir identiska cilnes **Parameters** veidlapai: **Name**, **Value**, **Disable special syntax**, **Handle as JSON data**, poga **Add** un tabula, kurā katru rindu var dzēst.

Pogas **Previous** un **Next** ļauj pārvietoties starp redzamajām cilnēm.

## Vērtību īpašā sintakse

Lauki **Value** (cilnēs **Parameters** un **Headers**) un lauks **Content** pieņem aizstāšanas virknes, kas tiek aizstātas SSO izpildes laikā. Tā pati sintakse attiecas uz [pre-authentication data](https://docs.cyberelements.io/bastion/4.6/lv/Usage/AdminConsoleReference/SsoPreAuthData/).

| Aizstāšana | Efekts |
|---|---|
| `%user%` | SSO izmantojamais pieteikšanās vārds. |
| `%password%` | SSO izmantojamā parole. |
| `%base64([...])%` | Kodē iekavās esošo saturu base 64 kodējumā. |
| `%lowercase([...])%` | Pārvērš saturu mazajos burtos. |
| `%uppercase([...])%` | Pārvērš saturu lielajos burtos. |
| `%trim([...])%` | Noņem atstarpes satura sākumā un beigās. |
| `%uriencoded([...])%` | Aizstāj retas speciālās rakstzīmes ar to UTF-8 kodējumu, lai saturu varētu izmantot vietrādī URL. |

Ir pieejamas arī šifrēšanas funkcijas:

| Funkcija | Paredzētie parametri |
|---|---|
| `%sha256([...])%` | Dati, kuriem jāaprēķina jaucējvērtība (SHA-256). |
| `%md5([...])%` | Dati, kuriem jāaprēķina jaucējvērtība (MD5). |
| `%hmacmd5([...])%` | Divi parametri: šifrējamie dati, pēc tam šifrēšanas atslēga. |
| `%rsa([...])%` | Divi parametri: publiskā atslēga, pēc tam šifrējamie dati. |
| `%rsaoaep([...])%` | Divi parametri: publiskā atslēga PEM formātā, pēc tam šifrējamā virkne. |
| `%reqresult([...])%` | Tā pieprasījuma kārtas numurs, kura rezultāts ir jāizmanto atkārtoti, un pēc izvēles tās atslēgas nosaukums, kas jāizvēlas, ja šajā rezultātā ir vairāki parametri. |

> **Divas rakstības konvencijas**
>
> Funkcijas parametri tiek atdalīti ar **`%,%`**. Lai ievadītu burtisku procentu zīmi, rakstiet **`\%`**.

## Saglabāšana

Noklikšķiniet uz **Validate**, lai pievienotu vai atjauninātu pieprasījumu pašreizējā priekšautentifikācijas solī. Poga **Cancel** aizver logu, nesaglabājot izmaiņas.

> **Augstuma pielāgošana**
>
> Logs automātiski maina izmēru atkarībā no režīma: īsa veidlapa, ja **Advanced settings** ir izslēgts vai ir novirzīšanas režīms, augsta veidlapa, ja ir redzams ciļņu panelis.
