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.
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).
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. |
| 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. |
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. |
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.
| 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.