Pre-authentication Web SSO request¶
Interné okno modulu Applications
K tomuto oknu sa dostanete z modulu Applications pri aplikácii, ktorej typ služby je Web a ktorej SSO type je Pre-authentication: tlačidlo Configure pre-authentication steps otvorí zoznam krokov, kde tlačidlo + pridá požiadavku. Okno obsahuje ikonu pomocníka, ktorá otvorí stránku pomocníka modulu.
Okno Pre-authentication Web SSO request umožňuje správcovi definovať požiadavku HTTP, ktorú musí služba Mediation Controller odoslať na cieľový server pred záverečným krokom overovania aplikácie Web SSO. Zjednodušený variant sa používa na záverečné presmerovanie na aplikačný server.
Každá požiadavka je v zozname krokov identifikovaná svojou adresou URL, svojou metódou a svojím poradím odoslania — práve na toto poradie odkazuje substitúcia %reqresult()% opísaná v časti Špeciálna syntax hodnôt.
Hlavné polia¶
| Pole | Popis |
|---|---|
| URL | Adresa URL, pred ktorú sa automaticky pridá už známa adresa cieľového servera (predpona sa pri zobrazení skráti, keď reťazec presiahne 100 znakov). V režime záverečného presmerovania adresu URL nemožno upraviť. |
| Method | Povinné pole. Možnosti: GET alebo POST (predvolené). |
| Content type (MIME) | Typ MIME tela požiadavky. Predvolená hodnota: application/x-www-form-urlencoded. Ďalšie možnosti: application/json, application/xml, text/html, text/plain, text/richtext, text/tab-separated-values. Skryté a zakázané v režime záverečného presmerovania. |
| Enable cache | Začiarkavacie políčko, predvolene začiarknuté. Skryté a zakázané v režime záverečného presmerovania. |
| Login parameter | Názov parametra, ktorý musí obsahovať prihlasovacie meno. Povolené iba vtedy, keď typ obsahu prijíma parametre, teda application/x-www-form-urlencoded. |
| Password parameter | Názov parametra, ktorý musí obsahovať heslo. Povolené za rovnakých podmienok ako vyššie. |
| Advanced settings | Začiarkavacie políčko. Zobrazí alebo skryje karty rozšírených údajov. Je vynútene začiarknuté, keď aktuálny typ obsahu neprijíma jednoduché parametre. |
Karty rozšírených nastavení¶
Keď je políčko Advanced settings začiarknuté, zobrazí sa panel kariet. Jeho viditeľnosť závisí od typu obsahu a od režimu (bežná požiadavka alebo záverečné presmerovanie).
Viditeľná pri úprave záverečného presmerovania alebo keď typ obsahu prijíma parametre (application/x-www-form-urlencoded).
Horný formulár pridá položku do tabuľky nižšie, ktorej stĺpce sú Name a Value; keď je prázdna, zobrazuje No element to display. Ikona odstránenia v každom riadku položku odstráni.
| Pole | Popis |
|---|---|
| Name | Názov parametra. |
| Value | Príslušná hodnota. Správa pod poľom pripomína, že This field follows a special syntax. Please consult the help page for more informations. Pozrite časť Špeciálna syntax hodnôt. |
| Disable special syntax | Začiarkavacie políčko: hodnota sa potom prevezme bez zmeny a správa o syntaxi zmizne. Položky pridané týmto spôsobom sa v tabuľke zobrazujú kurzívou. |
| Handle as JSON data | Začiarkavacie políčko. Hodnota sa spracuje ako objekt JSON. |
| Add | Vloží položku do tabuľky. |
Viditeľná, keď sa neupravuje záverečné presmerovanie, a keď typ obsahu neprijíma jednoduché parametre (napríklad application/json).
| Pole | Popis |
|---|---|
| Content | Viacriadkové textové pole synchronizované v reálnom čase. Pripomína sa rovnaká správa o špeciálnej syntaxi. |
| Disable special syntax | Začiarkavacie políčko: obsah sa potom prevezme bez zmeny. |
Viditeľná, keď sa neupravuje záverečné presmerovanie.
Formulár je rovnaký ako na karte Parameters: Name, Value, Disable special syntax, Handle as JSON data, tlačidlo Add a tabuľka s odstraňovaním po riadkoch.
Tlačidlá Previous a Next prechádzajú medzi viditeľnými kartami.
Špeciálna syntax hodnôt¶
Polia Value (karty Parameters a Headers) a pole Content prijímajú substitučné reťazce, ktoré sa nahradia pri spustení SSO. Rovnaká syntax platí pre pre-authentication data.
| Substitúcia | Účinok |
|---|---|
%user% |
Prihlasovacie meno, ktoré sa má použiť na SSO. |
%password% |
Heslo, ktoré sa má použiť na SSO. |
%base64([...])% |
Zakóduje obsah zátvoriek v base64. |
%lowercase([...])% |
Prevedie obsah na malé písmená. |
%uppercase([...])% |
Prevedie obsah na veľké písmená. |
%trim([...])% |
Odstráni z obsahu úvodné a koncové prázdne znaky. |
%uriencoded([...])% |
Nahradí nezvyčajné špeciálne znaky ich kódovaním UTF-8 na použitie v adrese URL. |
K dispozícii sú aj šifrovacie funkcie:
| Funkcia | Očakávané parametre |
|---|---|
%sha256([...])% |
Údaje na hašovanie (SHA-256). |
%md5([...])% |
Údaje na hašovanie (MD5). |
%hmacmd5([...])% |
Dva parametre: údaje na zašifrovanie a potom šifrovací kľúč. |
%rsa([...])% |
Dva parametre: verejný kľúč a potom údaje na zašifrovanie. |
%rsaoaep([...])% |
Dva parametre: verejný kľúč vo formáte PEM a potom reťazec na zašifrovanie. |
%reqresult([...])% |
Poradové číslo požiadavky, ktorej výsledok sa má znova použiť, a voliteľne názov kľúča, ktorý sa má vybrať, keď tento výsledok obsahuje viacero parametrov. |
Dve konvencie zápisu
Parametre funkcie sa oddeľujú reťazcom %,%. Ak chcete zadať doslovný znak percenta, napíšte \%.
Uloženie¶
Kliknutím na Validate pridáte alebo aktualizujete požiadavku v aktuálnom kroku predbežného overovania. Cancel zatvorí okno bez uloženia.
Prispôsobenie výšky
Okno automaticky mení veľkosť podľa režimu: krátky formulár, keď je políčko Advanced settings nezačiarknuté alebo v režime presmerovania, vysoký formulár, keď je panel kariet viditeľný.