Pre-authentication Web SSO request¶
Mooduli Applications siseaken
Sellesse aknasse pääseb moodulist Applications rakenduse puhul, mille teenusetüüp on Web ja mille SSO type on Pre-authentication: nupp Configure pre-authentication steps avab etappide loendi, kus nupp + lisab taotluse. Aknas on spikriikoon, mis avab mooduli spikrilehe.
Aknas Pre-authentication Web SSO request saab administraator määratleda HTTP-taotluse, mille Mediation Controller server peab saatma sihtserverile enne Web SSO rakenduse viimast autentimisetappi. Rakendusserverisse suunava lõpliku ümbersuunamise jaoks kasutatakse lihtsustatud varianti.
Iga taotlus on etappide loendis tuvastatav oma URL-i, meetodi ja saatmisjärjekorra järgi — just sellele järjekorrale viitab asendus %reqresult()%, mida on kirjeldatud peatükis Väärtuste erisüntaks.
Põhiväljad¶
| Väli | Kirjeldus |
|---|---|
| URL | URL, mille ette lisatakse automaatselt juba teadaolev sihtserveri aadress (kui string ületab 100 märki, kärbitakse eesliidet kuvamisel). Lõpliku ümbersuunamise režiimis ei saa URL-i muuta. |
| Method | Kohustuslik. Valikud: GET või POST (vaikimisi). |
| Content type (MIME) | Taotluse keha MIME-tüüp. Vaikeväärtus: application/x-www-form-urlencoded. Muud valikud: application/json, application/xml, text/html, text/plain, text/richtext, text/tab-separated-values. Lõpliku ümbersuunamise režiimis peidetud ja välja lülitatud. |
| Enable cache | Märkeruut, vaikimisi märgitud. Lõpliku ümbersuunamise režiimis peidetud ja välja lülitatud. |
| Login parameter | Selle parameetri nimi, mis peab kandma kasutajanime. Sisse lülitatud ainult siis, kui sisutüüp aktsepteerib parameetreid, st application/x-www-form-urlencoded. |
| Password parameter | Selle parameetri nimi, mis peab kandma parooli. Sisselülitamise reeglid on samad mis eespool. |
| Advanced settings | Märkeruut. Kuvab või peidab täpsemate andmete vahekaardid. Sunnitult sisse lülitatud, kui praegune sisutüüp ei aktsepteeri lihtsaid parameetreid. |
Täpsemate sätete vahekaardid¶
Kui Advanced settings on sisse lülitatud, kuvatakse vahekaartide paneel. Selle nähtavus oleneb sisutüübist ja režiimist (tavaline taotlus või lõplik ümbersuunamine).
Nähtav lõpliku ümbersuunamise muutmisel või siis, kui sisutüüp aktsepteerib parameetreid (application/x-www-form-urlencoded).
Ülemine vorm lisab kirje allolevasse tabelisse, mille veerud on Name ja Value; tühjana kuvatakse selles No element to display. Iga rea kustutamisikoon eemaldab kirje.
| Väli | Kirjeldus |
|---|---|
| Name | Parameetri nimi. |
| Value | Vastav väärtus. Välja all olev teade tuletab meelde, et This field follows a special syntax. Please consult the help page for more informations. Vt peatükk Väärtuste erisüntaks. |
| Disable special syntax | Märkeruut: väärtus võetakse siis muutmata kujul ja süntaksiteade kaob. Nii lisatud kirjed kuvatakse tabelis kaldkirjas. |
| Handle as JSON data | Märkeruut. Väärtust käsitletakse JSON-objektina. |
| Add | Lisab kirje tabelisse. |
Nähtav siis, kui ei muudeta lõplikku ümbersuunamist, ja kui sisutüüp ei aktsepteeri lihtsaid parameetreid (näiteks application/json).
| Väli | Kirjeldus |
|---|---|
| Content | Mitmerealine tekstiala, mida sünkroonitakse reaalajas. Kuvatakse sama erisüntaksi teade. |
| Disable special syntax | Märkeruut: sisu võetakse siis muutmata kujul. |
Nähtav siis, kui ei muudeta lõplikku ümbersuunamist.
Vorm on identne vahekaardiga Parameters: Name, Value, Disable special syntax, Handle as JSON data, nupp Add ja tabel, kus saab ridu ükshaaval kustutada.
Nupud Previous ja Next viivad nähtavate vahekaartide vahel.
Väärtuste erisüntaks¶
Väljad Value (vahekaardid Parameters ja Headers) ning väli Content aktsepteerivad asendusstringe, mis asendatakse SSO käivitamisel. Sama süntaks kehtib andmete pre-authentication data kohta.
| Asendus | Toime |
|---|---|
%user% |
SSO jaoks kasutatav kasutajanimi. |
%password% |
SSO jaoks kasutatav parool. |
%base64([...])% |
Kodeerib sulgude sisu base64-vormingusse. |
%lowercase([...])% |
Teisendab sisu väiketähtedeks. |
%uppercase([...])% |
Teisendab sisu suurtähtedeks. |
%trim([...])% |
Eemaldab sisu algusest ja lõpust tühimärgid. |
%uriencoded([...])% |
Asendab harvaesinevad erimärgid nende UTF-8-kodeeringuga, et neid saaks URL-is kasutada. |
Saadaval on ka krüptimisfunktsioonid:
| Funktsioon | Oodatavad parameetrid |
|---|---|
%sha256([...])% |
Räsitavad andmed (SHA-256). |
%md5([...])% |
Räsitavad andmed (MD5). |
%hmacmd5([...])% |
Kaks parameetrit: krüptitavad andmed, seejärel krüptimisvõti. |
%rsa([...])% |
Kaks parameetrit: avalik võti, seejärel krüptitavad andmed. |
%rsaoaep([...])% |
Kaks parameetrit: PEM-vormingus avalik võti, seejärel krüptitav string. |
%reqresult([...])% |
Selle taotluse järjenumber, mille tulemust tuleb uuesti kasutada, ja soovi korral võtme nimi, mis valitakse, kui see tulemus sisaldab mitut parameetrit. |
Kaks kirjutusreeglit
Funktsiooni parameetrid eraldatakse märgiga %,%. Literaalse protsendimärgi sisestamiseks kirjutage \%.
Salvestamine¶
Taotluse lisamiseks praegusesse eelautentimise etappi või selle värskendamiseks klõpsake nuppu Validate. Cancel sulgeb akna salvestamata.
Kõrguse kohandumine
Akna suurus muutub automaatselt olenevalt režiimist: lühike vorm, kui Advanced settings on välja lülitatud või kui kasutusel on ümbersuunamisrežiim, kõrge vorm, kui vahekaartide paneel on nähtav.