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

# Pre-authentication Web SSO request

> **Tieqa interna tal-modulu Applications**
>
> Din it-tieqa tintlaħaq mill-modulu **Applications**, fuq applikazzjoni li t-tip ta’ servizz tagħha huwa **Web** u li għandha l-qasam **SSO type** issettjat għal **Pre-authentication**: il-buttuna **Configure pre-authentication steps** tiftaħ il-lista tal-passi, fejn il-buttuna **+** iżżid talba. It-tieqa għandha ikona tal-għajnuna li tiftaħ il-paġna tal-għajnuna tal-modulu.

It-tieqa **Pre-authentication Web SSO request** tħalli lil amministratur jiddefinixxi **talba HTTP** li s-servizz Mediation Controller irid jibgħat lis-server fil-mira qabel il-pass finali tal-awtentikazzjoni ta’ applikazzjoni Web SSO. Varjant simplifikat jintuża għar-**ridirezzjoni finali** lejn is-server tal-applikazzjoni.

Kull talba hija identifikata fil-lista tal-passi permezz tal-**URL**, tal-**metodu** u tal-**ordni tal-bgħit** tagħha — huwa għal din l-ordni li tirreferi s-sostituzzjoni `%reqresult()%` deskritta fil-kapitolu [Sintassi speċjali tal-valuri](#special-syntax-of-values).

## Oqsma prinċipali

| Qasam | Deskrizzjoni |
|---|---|
| **URL** | URL li jiġi ppreċedut awtomatikament mill-indirizz diġà magħruf tas-server fil-mira (il-prefiss jitqassar fil-wiri meta l-istring jaqbeż il-100 karattru). Fil-modalità **ridirezzjoni finali**, l-URL ma jistax jiġi editjat. |
| **Method** | Obbligatorju. Għażliet: **GET** jew **POST** *(default)*. |
| **Content type (MIME)** | It-tip MIME tal-korp tat-talba. Valur default: `application/x-www-form-urlencoded`. Għażliet oħra: `application/json`, `application/xml`, `text/html`, `text/plain`, `text/richtext`, `text/tab-separated-values`. Moħbi u diżattivat fil-modalità **ridirezzjoni finali**. |
| **Enable cache** | Kaxxa ta’ selezzjoni, immarkata b’mod default. Moħbija u diżattivata fil-modalità **ridirezzjoni finali**. |
| **Login parameter** | L-isem tal-parametru li għandu jkun fih il-login. Attivat biss meta t-tip ta’ kontenut jaċċetta parametri, jiġifieri `application/x-www-form-urlencoded`. |
| **Password parameter** | L-isem tal-parametru li għandu jkun fih il-password. L-istess regoli ta’ attivazzjoni bħal hawn fuq. |
| **Advanced settings** | Kaxxa ta’ selezzjoni. Turi jew taħbi t-tabs tad-data avvanzata. Tiġi attivata b’mod furzat meta t-tip ta’ kontenut attwali ma jaċċettax parametri sempliċi. |

## Tabs tas-settings avvanzati

Meta **Advanced settings** ikun attivat, jidher pannell ta’ tabs. Il-viżibbiltà tiegħu tiddependi mit-tip ta’ kontenut u mill-modalità (talba normali jew ridirezzjoni finali).

**Parameters**

> Viżibbli meta tkun qed teditja r-**ridirezzjoni finali**, jew meta t-tip ta’ kontenut jaċċetta parametri (`application/x-www-form-urlencoded`).
>
> Il-formola ta’ fuq iżżid entrata fil-grilja ta’ taħt, li l-kolonni tagħha huma **Name** u **Value**; meta tkun vojta turi **No element to display**. Ikona tat-tħassir fuq kull ringiela tneħħi l-entrata.
>
> | Qasam | Deskrizzjoni |
> |---|---|
> | **Name** | L-isem tal-parametru. |
> | **Value** | Il-valur korrispondenti. Messaġġ taħt il-qasam ifakkar li **This field follows a special syntax. Please consult the help page for more informations.** Ara l-kapitolu [Sintassi speċjali tal-valuri](#special-syntax-of-values). |
> | **Disable special syntax** | Kaxxa ta’ selezzjoni: il-valur imbagħad jittieħed kif inhu, u l-messaġġ dwar is-sintassi jisparixxi. L-entrati miżjuda b’dan il-mod jintwerew **bil-korsiv** fil-grilja. |
> | **Handle as JSON data** | Kaxxa ta’ selezzjoni. Il-valur jiġi ttrattat bħala oġġett JSON. |
> | **Add** | Idaħħal l-entrata fil-grilja. |

**Content**

> Viżibbli meta ma tkunx qed teditja r-ridirezzjoni finali **u** meta t-tip ta’ kontenut ma jaċċettax parametri sempliċi (`application/json`, pereżempju).
>
> | Qasam | Deskrizzjoni |
> |---|---|
> | **Content** | Żona ta’ test b’diversi linji, sinkronizzata f’ħin reali. Jidher l-istess messaġġ dwar is-sintassi speċjali. |
> | **Disable special syntax** | Kaxxa ta’ selezzjoni: il-kontenut imbagħad jittieħed kif inhu. |

**Headers**

> Viżibbli meta ma tkunx qed teditja r-ridirezzjoni finali.
>
> Il-formola hija identika għal dik tat-tab **Parameters**: **Name**, **Value**, **Disable special syntax**, **Handle as JSON data**, il-buttuna **Add**, u grilja bit-tħassir għal kull ringiela.

Il-buttuni **Previous** u **Next** iċaqilqu bejn it-tabs viżibbli.

## Sintassi speċjali tal-valuri

L-oqsma **Value** (it-tabs **Parameters** u **Headers**) u l-qasam **Content** jaċċettaw strings ta’ sostituzzjoni, li jiġu sostitwiti meta jitħaddem l-SSO. L-istess sintassi tapplika għad-data deskritta f’[pre-authentication data](https://docs.cyberelements.io/bastion/4.6/mt/Usage/AdminConsoleReference/SsoPreAuthData/).

| Sostituzzjoni | Effett |
|---|---|
| `%user%` | Il-login li għandu jintuża għall-SSO. |
| `%password%` | Il-password li għandha tintuża għall-SSO. |
| `%base64([...])%` | Jikkodifika l-kontenut tal-parentesi kwadri f’base 64. |
| `%lowercase([...])%` | Jikkonverti l-kontenut f’ittri żgħar. |
| `%uppercase([...])%` | Jikkonverti l-kontenut f’ittri kbar. |
| `%trim([...])%` | Ineħħi l-ispazji fil-bidu u fit-tmiem tal-kontenut. |
| `%uriencoded([...])%` | Jissostitwixxi l-karattri speċjali mhux komuni bil-kodifika UTF-8 tagħhom, għall-użu f’URL. |

Huma disponibbli wkoll funzjonijiet ta’ kriptaġġ:

| Funzjoni | Parametri mistennija |
|---|---|
| `%sha256([...])%` | Id-data li minnha jiġi kkalkulat il-hash (SHA-256). |
| `%md5([...])%` | Id-data li minnha jiġi kkalkulat il-hash (MD5). |
| `%hmacmd5([...])%` | Żewġ parametri: id-data li għandha tiġi kriptata, imbagħad iċ-ċavetta tal-kriptaġġ. |
| `%rsa([...])%` | Żewġ parametri: iċ-ċavetta pubblika, imbagħad id-data li għandha tiġi kriptata. |
| `%rsaoaep([...])%` | Żewġ parametri: iċ-ċavetta pubblika f’format PEM, imbagħad l-istring li għandu jiġi kriptat. |
| `%reqresult([...])%` | In-numru tas-sekwenza tat-talba li r-riżultat tagħha għandu jerġa’ jintuża u, b’mod fakultattiv, l-isem taċ-ċavetta li għandha tittieħed meta dak ir-riżultat ikun fih diversi parametri. |

> **Żewġ konvenzjonijiet tal-kitba**
>
> Il-parametri tal-funzjonijiet huma separati permezz ta’ **`%,%`**. Biex iddaħħal sinjal tal-perċentwal letterali, ikteb **`\%`**.

## Issejvjar

Ikklikkja **Validate** biex iżżid jew taġġorna t-talba fil-pass attwali tal-pre-awtentikazzjoni. **Cancel** jagħlaq it-tieqa mingħajr ma jissejvja.

> **Adattament tal-għoli**
>
> It-tieqa tibdel id-daqs tagħha awtomatikament skont il-modalità: formola qasira meta **Advanced settings** ikun diżattivat jew fil-modalità ta’ ridirezzjoni, formola twila meta l-pannell tat-tabs ikun viżibbli.
