Pre-authentication Web SSO request

Az Applications modul belső ablaka

Ez az ablak az Applications modulból érhető el, olyan alkalmazásnál, amelynek szolgáltatástípusa Web, SSO type értéke pedig Pre-authentication: a Configure pre-authentication steps gomb megnyitja a lépések listáját, ahol a + gomb egy kérést ad hozzá. Az ablakon egy súgóikon található, amely megnyitja a modul súgóoldalát.

A Pre-authentication Web SSO request ablakban a rendszergazda megadhat egy HTTP-kérést, amelyet a Mediation Controller szolgáltatásnak el kell küldenie a célkiszolgálónak egy webes SSO-alkalmazás utolsó hitelesítési lépése előtt. Az alkalmazáskiszolgálóra történő végső átirányításhoz egy egyszerűsített változat szolgál.

A lépések listájában minden kérést az URL-címe, a metódusa és a küldési sorrendje azonosít — erre a sorrendre hivatkozik az Értékek speciális szintaxisa című fejezetben ismertetett %reqresult()% helyettesítés.

Fő mezők

Mező	Leírás
URL	URL-cím, amely elé a rendszer automatikusan beilleszti a célkiszolgáló már ismert címét (ha a karakterlánc 100 karakternél hosszabb, az előtag a megjelenítésben csonkolva látszik). Végső átirányítás módban az URL-cím nem szerkeszthető.
Method	Kötelező. Lehetőségek: GET vagy POST (alapértelmezett).
Content type (MIME)	A kéréstörzs MIME-típusa. Alapértelmezett érték: application/x-www-form-urlencoded. További lehetőségek: application/json, application/xml, text/html, text/plain, text/richtext, text/tab-separated-values. Végső átirányítás módban rejtett és inaktív.
Enable cache	Jelölőnégyzet, alapértelmezés szerint bejelölve. Végső átirányítás módban rejtett és inaktív.
Login parameter	Annak a paraméternek a neve, amelynek a bejelentkezési nevet kell tartalmaznia. Csak akkor aktív, ha a tartalomtípus elfogad paramétereket, azaz application/x-www-form-urlencoded.
Password parameter	Annak a paraméternek a neve, amelynek a jelszót kell tartalmaznia. Az aktiválás szabályai ugyanazok, mint fent.
Advanced settings	Jelölőnégyzet. Megjeleníti vagy elrejti a speciális adatok lapjait. Kötelezően be van kapcsolva, ha az aktuális tartalomtípus nem fogad el egyszerű paramétereket.

A speciális beállítások lapjai

Ha az Advanced settings be van kapcsolva, megjelenik egy lapokat tartalmazó panel. Láthatósága a tartalomtípustól és a módtól (normál kérés vagy végső átirányítás) függ.

ParametersContentHeaders

Akkor látható, ha a végső átirányítást szerkeszti, vagy ha a tartalomtípus elfogad paramétereket (application/x-www-form-urlencoded).

A felső űrlap egy bejegyzést ad hozzá az alatta lévő táblázathoz, amelynek oszlopai Name és Value; ha a táblázat üres, a No element to display felirat olvasható benne. Az egyes sorokban található törlés ikon eltávolítja a bejegyzést.

Mező	Leírás
Name	A paraméter neve.
Value	A hozzá tartozó érték. A mező alatti üzenet emlékeztet arra, hogy This field follows a special syntax. Please consult the help page for more informations. Lásd az Értékek speciális szintaxisa című fejezetet.
Disable special syntax	Jelölőnégyzet: ekkor a rendszer az értéket változatlanul veszi át, és a szintaxisra vonatkozó üzenet eltűnik. Az így hozzáadott bejegyzések dőlt betűvel jelennek meg a táblázatban.
Handle as JSON data	Jelölőnégyzet. A rendszer az értéket JSON-objektumként kezeli.
Add	Beszúrja a bejegyzést a táblázatba.

Akkor látható, ha nem a végső átirányítást szerkeszti, és a tartalomtípus nem fogad el egyszerű paramétereket (például application/json).

Mező	Leírás
Content	Többsoros szövegmező, valós idejű szinkronizálással. Ugyanaz a speciális szintaxisra vonatkozó üzenet jelenik meg.
Disable special syntax	Jelölőnégyzet: ekkor a rendszer a tartalmat változatlanul veszi át.

Akkor látható, ha nem a végső átirányítást szerkeszti.

Az űrlap megegyezik a Parameters lapéval: Name, Value, Disable special syntax, Handle as JSON data, az Add gomb, valamint egy soronként törölhető táblázat.

A Previous és a Next gombbal lehet a látható lapok között váltani.

Értékek speciális szintaxisa

A Value mezők (Parameters és Headers lap) és a Content mező helyettesítő karakterláncokat fogadnak el, amelyeket a rendszer az SSO futtatásakor behelyettesít. Ugyanez a szintaxis érvényes a pre-authentication data ablakban megadott adatokra is.

Helyettesítés	Hatás
%user%	Az SSO-hoz használandó bejelentkezési név.
%password%	Az SSO-hoz használandó jelszó.
%base64([...])%	A zárójelek tartalmát base64 kódolással kódolja.
%lowercase([...])%	Kisbetűssé alakítja a tartalmat.
%uppercase([...])%	Nagybetűssé alakítja a tartalmat.
%trim([...])%	Eltávolítja a tartalom elején és végén lévő szóközöket.
%uriencoded([...])%	URL-ben való használathoz a ritka speciális karaktereket UTF-8 kódolásukkal helyettesíti.

Titkosítási függvények is rendelkezésre állnak:

Függvény	Várt paraméterek
%sha256([...])%	A kivonatolandó adat (SHA-256).
%md5([...])%	A kivonatolandó adat (MD5).
%hmacmd5([...])%	Két paraméter: a titkosítandó adat, majd a titkosítási kulcs.
%rsa([...])%	Két paraméter: a nyilvános kulcs, majd a titkosítandó adat.
%rsaoaep([...])%	Két paraméter: a PEM-formátumú nyilvános kulcs, majd a titkosítandó karakterlánc.
%reqresult([...])%	Annak a kérésnek a sorszáma, amelynek eredményét újra fel kell használni, továbbá – ha az eredmény több paramétert tartalmaz – opcionálisan a kiválasztandó kulcs neve.

Két írási konvenció

A függvényparamétereket %,% választja el egymástól. Szó szerinti százalékjel megadásához írja be a következőt: \%.

Mentés

Kattintson a Validate gombra a kérés hozzáadásához vagy frissítéséhez az aktuális előhitelesítési lépésben. A Cancel mentés nélkül bezárja az ablakot.

Automatikus magasságigazítás

Az ablak mérete a módtól függően automatikusan változik: rövid űrlap, ha az Advanced settings ki van kapcsolva, vagy átirányítás módban; magas űrlap, ha a lapokat tartalmazó panel látható.