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

# Pre-authentication Web SSO data

> **Fuinneog inmheánach den mhodúl Applications**
>
> Sroichtear an fhuinneog seo ón modúl **Applications**, ar fheidhmchlár arb é **Web** a chineál seirbhíse agus arb é **Pre-authentication** a **SSO type**: osclaíonn an cnaipe **Configure pre-authentication steps** liosta na gcéimeanna, áit ar féidir **data creation step** a chur leis trí fho-roghchlár an chnaipe cur leis. Tá deilbhín cabhrach ar an bhfuinneog a osclaíonn leathanach cabhrach an mhodúil.

Ligeann an fhuinneog **Pre-authentication Web SSO data** do riarthóir sonra a shainiú nach mór don tseirbhís Mediation Controller a **stóráil** sa bhrabhsálaí (athróg áitiúil, athróg seisiúin nó fianán) roimh chéim dheiridh an réamhfhíordheimhnithe d'fheidhmchlár Web SSO.

## Réimsí na foirme

| Réimse | Cur síos |
|---|---|
| **Type** | Éigeantach, liosta anuas nach féidir a chur in eagar. Roghanna: **Local variable** *(réamhshocrú)*, **Session variable**, **Cookie**. Rialaíonn an luach roghnaithe taispeáint na réimsí thíos a bhaineann go sonrach le fianáin. |
| **Name** | Éigeantach. Ní ghlactar le teaghrán nach bhfuil ann ach spás bán. Aithníonn sé an sonra. |
| **Value** | An luach le stóráil. De réir réamhshocraithe, is féidir go mbeadh eilimintí ann a léirmhíníonn inneall an réamhfhíordheimhnithe: meabhraíonn teachtaireacht faoin réimse go **This field follows a special syntax. Please consult the help page for more informations.** Féach an chaibidil [Comhréir speisialta na luachanna](#special-syntax-of-values). |
| **Disable special syntax** | Ticbhosca. Nuair atá sé ticeáilte, glactar leis an luach mar atá agus imíonn an teachtaireacht chomhréire. Taispeántar iontrálacha a cruthaíodh leis an rogha seo **i gcló iodálach** i liosta na gcéimeanna. |
| **Handle as JSON data** | Ticbhosca. Láimhseáiltear an luach ansin mar réad JSON seachas mar theaghrán. |

Socraíonn an **Type** cá stóráiltear an sonra:

| Type | Láthair |
|---|---|
| **Local variable** | Stóráil áitiúil an bhrabhsálaí. |
| **Session variable** | Stóráil seisiúin an bhrabhsálaí. |
| **Cookie** | Fianán a shocraítear ar an mbrabhsálaí, le réimsí na caibidle [Réimsí a bhaineann go sonrach le fianáin](#cookie-specific-fields). |

## Réimsí a bhaineann go sonrach le fianáin

Nuair is é **Cookie** an **Type**, feictear ceithre réimse breise agus méadaíonn an fhuinneog:

| Réimse | Cur síos |
|---|---|
| **Path** | Teorannaíonn sé an fianán do na URLanna a mheaitseálann an cosán a tugadh. Luach réamhshocraithe `/`, a fhágann ar fáil é ar gach URL; cuirtear `/` tosaigh leis tráth sábhála mura bhfuil ceann san iontráil. |
| **Lifetime (hours)** | Slánuimhir. Ríomhtar an dáta éaga nuair a ritheann an SSO, tríd an tsaolré seo a chur leis an am reatha. ⚠ **Má tá an luach nialasach nó diúltach, rachaidh an fianán in éag láithreach**. Má fhágtar folamh é, ní sheoltar aon dáta éaga agus éiríonn an fianán ina fhianán seisiúin. |
| **Secured cookie** | Ticbhosca. Ní féidir an fianán a úsáid ansin ach nuair atá an ceangal leis an suíomh slán (HTTPS). |
| **SameSite** | Liosta anuas nach féidir a chur in eagar: **Strict**, **Lax** *(réamhshocrú)* nó **None**. Sainmhíníonn sé conas a iompraíonn an fianán le hiarratais a thagann ó shuíomh eile. |

## Comhréir speisialta na luachanna

Glacann an réimse **Value** le teaghráin ionadaíochta, a athsholáthraítear nuair a ritheann an SSO. Baineann an chomhréir chéanna le paraiméadair, ceanntásca agus coirp na n-iarratas sa leathanach [pre-authentication requests](https://docs.cyberelements.io/bastion/4.6/ga/Usage/AdminConsoleReference/SsoPreAuthRequest/).

| Ionadú | Éifeacht |
|---|---|
| `%user%` | An t-ainm logála isteach le húsáid don SSO. |
| `%password%` | An pasfhocal le húsáid don SSO. |
| `%base64([...])%` | Ionchódaíonn sé ábhar na lúibíní i bhformáid base 64. |
| `%lowercase([...])%` | Athraíonn sé an t-ábhar go cás íochtair. |
| `%uppercase([...])%` | Athraíonn sé an t-ábhar go cás uachtair. |
| `%trim([...])%` | Baineann sé spás bán tosaigh agus deiridh den ábhar. |
| `%uriencoded([...])%` | Athsholáthraíonn sé carachtair speisialta neamhchoitianta lena n-ionchódú UTF-8, le húsáid in URL. |

Tá feidhmeanna criptithe ar fáil freisin:

| Feidhm | Paraiméadair a bhfuiltear ag súil leo |
|---|---|
| `%sha256([...])%` | Na sonraí le haiseáil (SHA-256). |
| `%md5([...])%` | Na sonraí le haiseáil (MD5). |
| `%hmacmd5([...])%` | Dhá pharaiméadar: na sonraí le criptiú, ansin an eochair chriptithe. |
| `%rsa([...])%` | Dhá pharaiméadar: an eochair phoiblí, ansin na sonraí le criptiú. |
| `%rsaoaep([...])%` | Dhá pharaiméadar: an eochair phoiblí i bhformáid PEM, ansin an teaghrán le criptiú. |
| `%reqresult([...])%` | Uimhir sheicheamh an iarratais a gcaithfear a thoradh a athúsáid agus, go roghnach, ainm na heochrach le roghnú nuair atá roinnt paraiméadar sa toradh sin. |

> **Dhá ghnás scríbhneoireachta**
>
> Scartar paraiméadair feidhme le **`%,%`**. Chun siombail chéatadáin litriúil a iontráil, scríobh **`\%`**.

## Sábháil

Cliceáil **Validate** chun an sonra a chur leis nó a nuashonrú sa chéim réamhfhíordheimhnithe reatha. Dúnann **Cancel** an fhuinneog gan sábháil.
