Pre-authentication Web SSO request¶
Interní okno modulu Applications
K tomuto oknu se dostanete z modulu Applications u aplikace, jejíž typ služby je Web a jejíž SSO type je Pre-authentication: tlačítko Configure pre-authentication steps otevře seznam kroků, kde tlačítko + přidá požadavek. Okno obsahuje ikonu nápovědy, která otevře stránku nápovědy modulu.
Okno Pre-authentication Web SSO request umožňuje správci definovat požadavek HTTP, který musí služba Mediation Controller odeslat na cílový server před závěrečným krokem ověřování aplikace Web SSO. Zjednodušená varianta se používá pro konečné přesměrování na aplikační server.
Každý požadavek je v seznamu kroků identifikován svou adresou URL, svou metodou a svým pořadím odeslání — právě na toto pořadí odkazuje substituce %reqresult()% popsaná v části Zvláštní syntaxe hodnot.
Hlavní pole¶
| Pole | Popis |
|---|---|
| URL | Adresa URL, před kterou se automaticky doplní již známá adresa cílového serveru (pokud řetězec přesahuje 100 znaků, předpona se při zobrazení zkrátí). V režimu konečného přesměrování nelze adresu URL upravit. |
| Method | Povinné. Možnosti: GET nebo POST (výchozí). |
| Content type (MIME) | Typ MIME těla požadavku. Výchozí hodnota: application/x-www-form-urlencoded. Další možnosti: application/json, application/xml, text/html, text/plain, text/richtext, text/tab-separated-values. V režimu konečného přesměrování je skryté a neaktivní. |
| Enable cache | Zaškrtávací políčko, ve výchozím nastavení zaškrtnuté. V režimu konečného přesměrování je skryté a neaktivní. |
| Login parameter | Název parametru, který má nést přihlašovací jméno. Aktivní pouze tehdy, když typ obsahu přijímá parametry, tedy application/x-www-form-urlencoded. |
| Password parameter | Název parametru, který má nést heslo. Platí stejná pravidla aktivace jako výše. |
| Advanced settings | Zaškrtávací políčko. Zobrazí nebo skryje karty pokročilých dat. Je vynuceně zaškrtnuté, když aktuální typ obsahu nepřijímá jednoduché parametry. |
Karty pokročilého nastavení¶
Když je políčko Advanced settings zaškrtnuté, zobrazí se panel karet. Jeho viditelnost závisí na typu obsahu a na režimu (běžný požadavek nebo konečné přesměrování).
Viditelná při úpravě konečného přesměrování nebo když typ obsahu přijímá parametry (application/x-www-form-urlencoded).
Horní formulář přidá položku do tabulky níže, jejíž sloupce jsou Name a Value; když je prázdná, zobrazuje No element to display. Ikona odstranění na každém řádku položku odstraní.
| Pole | Popis |
|---|---|
| Name | Název parametru. |
| Value | Odpovídající hodnota. Zpráva pod polem připomíná, že This field follows a special syntax. Please consult the help page for more informations. Viz část Zvláštní syntaxe hodnot. |
| Disable special syntax | Zaškrtávací políčko: hodnota se pak použije tak, jak je, a zpráva o syntaxi zmizí. Položky přidané tímto způsobem se v tabulce zobrazují kurzívou. |
| Handle as JSON data | Zaškrtávací políčko. Hodnota se zpracovává jako objekt JSON. |
| Add | Vloží položku do tabulky. |
Viditelná, když se neupravuje konečné přesměrování, a zároveň typ obsahu nepřijímá jednoduché parametry (například application/json).
| Pole | Popis |
|---|---|
| Content | Víceřádkové textové pole synchronizované v reálném čase. Připomíná se stejná zpráva o zvláštní syntaxi. |
| Disable special syntax | Zaškrtávací políčko: obsah se pak použije tak, jak je. |
Viditelná, když se neupravuje konečné přesměrování.
Formulář je stejný jako na kartě Parameters: Name, Value, Disable special syntax, Handle as JSON data, tlačítko Add a tabulka s odstraněním po jednotlivých řádcích.
Tlačítka Previous a Next přepínají mezi viditelnými kartami.
Zvláštní syntaxe hodnot¶
Pole Value (karty Parameters a Headers) a pole Content přijímají substituční řetězce, které se nahradí při spuštění SSO. Stejná syntaxe platí pro data předběžného ověřování.
| Substituce | Účinek |
|---|---|
%user% |
Přihlašovací jméno, které se má pro SSO použít. |
%password% |
Heslo, které se má pro SSO použít. |
%base64([...])% |
Zakóduje obsah závorek v kódování base64. |
%lowercase([...])% |
Převede obsah na malá písmena. |
%uppercase([...])% |
Převede obsah na velká písmena. |
%trim([...])% |
Odstraní z obsahu úvodní a koncové prázdné znaky. |
%uriencoded([...])% |
Nahradí neobvyklé speciální znaky jejich kódováním UTF-8 pro použití v adrese URL. |
K dispozici jsou také šifrovací funkce:
| Funkce | Očekávané parametry |
|---|---|
%sha256([...])% |
Data, ze kterých se má vypočítat hash (SHA-256). |
%md5([...])% |
Data, ze kterých se má vypočítat hash (MD5). |
%hmacmd5([...])% |
Dva parametry: data k zašifrování a poté šifrovací klíč. |
%rsa([...])% |
Dva parametry: veřejný klíč a poté data k zašifrování. |
%rsaoaep([...])% |
Dva parametry: veřejný klíč ve formátu PEM a poté řetězec k zašifrování. |
%reqresult([...])% |
Pořadové číslo požadavku, jehož výsledek se má znovu použít, a volitelně název klíče, který se má vybrat, když tento výsledek obsahuje více parametrů. |
Dvě pravidla zápisu
Parametry funkcí se oddělují pomocí %,%. Chcete-li zadat znak procenta doslova, napište \%.
Uložení¶
Kliknutím na Validate přidáte nebo aktualizujete požadavek v aktuálním kroku předběžného ověřování. Cancel zavře okno bez uložení.
Přizpůsobení výšky
Okno automaticky mění velikost podle režimu: krátký formulář, když je políčko Advanced settings nezaškrtnuté nebo v režimu přesměrování, vysoký formulář, když je panel karet viditelný.