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

# Pre-authentication Web SSO request

> **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 a gcuireann an cnaipe **+** iarratas leis. Tá deilbhín cabhrach ar an bhfuinneog a osclaíonn leathanach cabhrach an mhodúil.

Ligeann an fhuinneog **Pre-authentication Web SSO request** do riarthóir **iarratas HTTP** a shainiú nach mór don tseirbhís Mediation Controller a sheoladh chuig an bhfreastalaí sprice roimh chéim dheiridh an fhíordheimhnithe d'fheidhmchlár Web SSO. Úsáidtear leagan simplithe don **atreorú deiridh** chuig freastalaí an fheidhmchláir.

Aithnítear gach iarratas i liosta na gcéimeanna de réir a **URL**, a **mhodha** agus a **oird seolta** — is chuig an ord sin a thagraíonn an t-ionadú `%reqresult()%` a ndéantar cur síos air sa chaibidil [Comhréir speisialta na luachanna](#special-syntax-of-values).

## Príomhréimsí

| Réimse | Cur síos |
|---|---|
| **URL** | URL a gcuirtear seoladh an fhreastalaí sprice, atá ar eolas cheana, roimhe go huathoibríoch (teasctar an réimír le taispeáint nuair a sháraíonn an teaghrán 100 carachtar). I mód an **atreoraithe deiridh**, ní féidir an URL a chur in eagar. |
| **Method** | Éigeantach. Roghanna: **GET** nó **POST** *(réamhshocrú)*. |
| **Content type (MIME)** | An cineál MIME atá ag corp an iarratais. Luach réamhshocraithe: `application/x-www-form-urlencoded`. Roghanna eile: `application/json`, `application/xml`, `text/html`, `text/plain`, `text/richtext`, `text/tab-separated-values`. I bhfolach agus díchumasaithe i mód an **atreoraithe deiridh**. |
| **Enable cache** | Ticbhosca, ticeáilte de réir réamhshocraithe. I bhfolach agus díchumasaithe i mód an **atreoraithe deiridh**. |
| **Login parameter** | Ainm an pharaiméadair a chaithfidh an t-ainm logála isteach a iompar. Ní bhíonn sé cumasaithe ach nuair a ghlacann an cineál ábhair le paraiméadair, is é sin `application/x-www-form-urlencoded`. |
| **Password parameter** | Ainm an pharaiméadair a chaithfidh an pasfhocal a iompar. Na rialacha cumasaithe céanna agus thuas. |
| **Advanced settings** | Ticbhosca. Taispeánann nó folaíonn sé na cluaisíní sonraí ardleibhéil. Cuirtear ar siúl go héigeantach é nuair nach nglacann an cineál ábhair reatha le paraiméadair shimplí. |

## Cluaisíní na socruithe ardleibhéil

Nuair atá **Advanced settings** ar siúl, feictear painéal cluaisíní. Braitheann a infheictheacht ar an gcineál ábhair agus ar an mód (iarratas rialta nó atreorú deiridh).

**Parameters**

> Infheicthe le linn eagarthóireacht an **atreoraithe deiridh**, nó nuair a ghlacann an cineál ábhair le paraiméadair (`application/x-www-form-urlencoded`).
>
> Cuireann an fhoirm uachtarach iontráil leis an ngreille thíos, arb iad **Name** agus **Value** a colúin; nuair atá sí folamh, taispeánann sí **No element to display**. Baineann deilbhín scriosta ar gach ró an iontráil.
>
> | Réimse | Cur síos |
> |---|---|
> | **Name** | Ainm an pharaiméadair. |
> | **Value** | An luach comhfhreagrach. 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: glactar leis an luach mar atá ansin, agus imíonn an teachtaireacht chomhréire. Taispeántar iontrálacha a cuireadh leis ar an mbealach seo **i gcló iodálach** sa ghreille. |
> | **Handle as JSON data** | Ticbhosca. Láimhseáiltear an luach mar réad JSON. |
> | **Add** | Cuireann sé an iontráil isteach sa ghreille. |

**Content**

> Infheicthe nuair nach bhfuil an t-atreorú deiridh á chur in eagar **agus** nuair nach nglacann an cineál ábhair le paraiméadair shimplí (`application/json`, mar shampla).
>
> | Réimse | Cur síos |
> |---|---|
> | **Content** | Limistéar téacs illíne, sioncronaithe i bhfíor-am. Meabhraítear an teachtaireacht chéanna faoin gcomhréir speisialta. |
> | **Disable special syntax** | Ticbhosca: glactar leis an ábhar mar atá ansin. |

**Headers**

> Infheicthe nuair nach bhfuil an t-atreorú deiridh á chur in eagar.
>
> Tá an fhoirm comhionann leis an gcluaisín **Parameters**: **Name**, **Value**, **Disable special syntax**, **Handle as JSON data**, an cnaipe **Add**, agus greille le scriosadh in aghaidh an ró.

Bogann na cnaipí **Previous** agus **Next** idir na cluaisíní infheicthe.

## Comhréir speisialta na luachanna

Glacann na réimsí **Value** (cluaisíní **Parameters** agus **Headers**) agus an réimse **Content** le teaghráin ionadaíochta, a athsholáthraítear nuair a ritheann an SSO. Baineann an chomhréir chéanna leis na sonraí sa leathanach [pre-authentication data](https://docs.cyberelements.io/bastion/4.6/ga/Usage/AdminConsoleReference/SsoPreAuthData/).

| 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 t-iarratas a chur leis nó a nuashonrú sa chéim réamhfhíordheimhnithe reatha. Dúnann **Cancel** an fhuinneog gan sábháil.

> **Oiriúnú an airde**
>
> Athraíonn an fhuinneog a méid go huathoibríoch de réir an mhóid: foirm ghearr nuair atá **Advanced settings** múchta nó i mód atreoraithe, foirm ard nuair atá an painéal cluaisíní le feiceáil.
