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

# Pre-authentication Web SSO data

> **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 is-sottomenu tal-buttuna taż-żieda joffri li jiżdied **data creation step**. It-tieqa għandha ikona tal-għajnuna li tiftaħ il-paġna tal-għajnuna tal-modulu.

It-tieqa **Pre-authentication Web SSO data** tħalli lil amministratur jiddefinixxi data li s-servizz Mediation Controller irid **jaħżen** fil-browser (varjabbli lokali, varjabbli tas-sessjoni jew cookie) qabel il-fażi finali tal-pre-awtentikazzjoni ta’ applikazzjoni Web SSO.

## Oqsma tal-formola

| Qasam | Deskrizzjoni |
|---|---|
| **Type** | Obbligatorju, lista drop-down mhux editjabbli. Għażliet: **Local variable** *(default)*, **Session variable**, **Cookie**. Il-valur magħżul jiddetermina l-wiri tal-oqsma speċifiċi għall-cookies hawn taħt. |
| **Name** | Obbligatorju. Valur magħmul biss minn spazji jiġi rifjutat. Jidentifika d-data. |
| **Value** | Il-valur li għandu jinħażen. B’mod default jista’ jkun fih elementi interpretati mill-magna tal-pre-awtentikazzjoni: 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. Ladarba tiġi mmarkata, il-valur jittieħed kif inhu u l-messaġġ dwar is-sintassi jisparixxi. L-entrati maħluqa b’din l-għażla jintwerew **bil-korsiv** fil-lista tal-passi. |
| **Handle as JSON data** | Kaxxa ta’ selezzjoni. Il-valur imbagħad jiġi ttrattat bħala oġġett JSON minflok string. |

Il-qasam **Type** jiddetermina fejn tinħażen id-data:

| Type | Post |
|---|---|
| **Local variable** | Il-ħażna lokali tal-browser. |
| **Session variable** | Il-ħażna tas-sessjoni tal-browser. |
| **Cookie** | Cookie issettjat fil-browser, bl-oqsma tal-kapitolu [Oqsma speċifiċi għall-cookies](#cookie-specific-fields). |

## Oqsma speċifiċi għall-cookies

Meta **Type** ikun **Cookie**, jidhru erba’ oqsma addizzjonali u t-tieqa tikber:

| Qasam | Deskrizzjoni |
|---|---|
| **Path** | Jillimita l-cookie għall-URLs li jaqblu mal-mogħdija mogħtija. Valur default `/`, li jagħmlu disponibbli fuq kull URL; mal-issejvjar jiżdied `/` fil-bidu meta l-valur imdaħħal ma jkunx fih wieħed. |
| **Lifetime (hours)** | Numru sħiħ. Id-data tal-iskadenza tiġi kkalkulata meta jitħaddem l-SSO, billi dan it-tul ta’ żmien jiżdied mal-ħin attwali. ⚠ **Valur żero jew negattiv iġiegħel lill-cookie jiskadi minnufih**. Jekk jitħalla vojt, ma tintbagħat l-ebda data tal-iskadenza u l-cookie jsir cookie tas-sessjoni. |
| **Secured cookie** | Kaxxa ta’ selezzjoni. Il-cookie imbagħad ikun jista’ jintuża biss meta l-konnessjoni mas-sit tkun sigura (HTTPS). |
| **SameSite** | Lista drop-down mhux editjabbli: **Strict**, **Lax** *(default)* jew **None**. Tiddefinixxi kif iġib ruħu l-cookie mat-talbiet li ġejjin minn sit ieħor. |

## Sintassi speċjali tal-valuri

Il-qasam **Value** jaċċetta strings ta’ sostituzzjoni, li jiġu sostitwiti meta jitħaddem l-SSO. L-istess sintassi tapplika għall-parametri, għall-intestaturi u għall-korpi tat-talbiet deskritti f’[pre-authentication requests](https://docs.cyberelements.io/bastion/4.6/mt/Usage/AdminConsoleReference/SsoPreAuthRequest/).

| 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 d-data fil-pass attwali tal-pre-awtentikazzjoni. **Cancel** jagħlaq it-tieqa mingħajr ma jissejvja.
