> Source: https://docs.cyberelements.io/bastion/4.6/hu/Usage/AdminConsoleReference/SsoPreAuthRequest/

# 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](#special-syntax-of-values) 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.

**Parameters**

> 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](#special-syntax-of-values) 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. |

**Content**

> 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. |

**Headers**

> 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](https://docs.cyberelements.io/bastion/4.6/hu/Usage/AdminConsoleReference/SsoPreAuthData/) 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ó.
