Pre-authentication Web SSO data

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 podnabídka tlačítka pro přidání nabízí přidání položky data creation step. Okno obsahuje ikonu nápovědy, která otevře stránku nápovědy modulu.

Okno Pre-authentication Web SSO data umožňuje správci definovat údaj, který musí služba Mediation Controller uložit v prohlížeči (místní proměnná, proměnná relace nebo soubor cookie) před závěrečnou fází předběžného ověřování aplikace Web SSO.

Pole formuláře

Pole	Popis
Type	Povinný, neupravitelný rozevírací seznam. Možnosti: Local variable (výchozí), Session variable, Cookie. Vybraná hodnota určuje, zda se zobrazí níže uvedená pole specifická pro soubory cookie.
Name	Povinné. Řetězec tvořený pouze prázdnými znaky je odmítnut. Identifikuje údaj.
Value	Hodnota, která se má uložit. Ve výchozím nastavení může obsahovat prvky, které interpretuje modul předběžného ověřování: 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. Po zaškrtnutí se hodnota použije tak, jak je, a zpráva o syntaxi zmizí. Položky vytvořené s touto možností se v seznamu kroků zobrazují kurzívou.
Handle as JSON data	Zaškrtávací políčko. Hodnota se pak zpracovává jako objekt JSON, nikoli jako řetězec.

Pole Type určuje, kam se údaj uloží:

Typ	Umístění
Local variable	Místní úložiště prohlížeče.
Session variable	Úložiště relace prohlížeče.
Cookie	Soubor cookie nastavený v prohlížeči, s poli z části Pole specifická pro soubory cookie.

Pole specifická pro soubory cookie

Když má pole Type hodnotu Cookie, zobrazí se čtyři další pole a okno se zvětší:

Pole	Popis
Path	Omezí soubor cookie na adresy URL odpovídající zadané cestě. Výchozí hodnota /, díky níž je soubor cookie dostupný pro každou adresu URL; pokud zadaná hodnota úvodní / neobsahuje, při uložení se doplní.
Lifetime (hours)	Celé číslo. Datum vypršení platnosti se vypočítá při spuštění SSO přičtením této doby platnosti k aktuálnímu času. ⚠ Nulová nebo záporná hodnota způsobí okamžité vypršení platnosti souboru cookie. Pokud pole zůstane prázdné, žádné datum vypršení platnosti se neodešle a soubor cookie se stane relačním souborem cookie.
Secured cookie	Zaškrtávací políčko. Soubor cookie lze pak použít, pouze když je připojení k webu zabezpečené (HTTPS).
SameSite	Neupravitelný rozevírací seznam: Strict, Lax (výchozí) nebo None. Určuje, jak se soubor cookie chová u požadavků přicházejících z jiného webu.

Zvláštní syntaxe hodnot

Pole Value přijímá substituční řetězce, které se nahradí při spuštění SSO. Stejná syntaxe platí pro parametry, hlavičky a těla požadavků 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 údaj v aktuálním kroku předběžného ověřování. Cancel zavře okno bez uložení.