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

# Pre-authentication Web SSO data

> **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 hozzáadás gomb almenüje felkínálja egy **data creation step** hozzáadását. Az ablakon egy súgóikon található, amely megnyitja a modul súgóoldalát.

A **Pre-authentication Web SSO data** ablakban a rendszergazda megadhat egy adatot, amelyet a Mediation Controller szolgáltatásnak a böngészőben kell **tárolnia** (helyi változóként, munkamenet-változóként vagy cookie-ként) egy webes SSO-alkalmazás utolsó előhitelesítési fázisa előtt.

## Az űrlap mezői

| Mező | Leírás |
|---|---|
| **Type** | Kötelező, nem szerkeszthető legördülő lista. Lehetőségek: **Local variable** *(alapértelmezett)*, **Session variable**, **Cookie**. A kiválasztott érték határozza meg, hogy megjelennek-e az alábbi, cookie-kra vonatkozó mezők. |
| **Name** | Kötelező. A csak szóközökből álló karakterláncot a rendszer elutasítja. Az adatot azonosítja. |
| **Value** | A tárolandó érték. Alapértelmezés szerint az előhitelesítési motor által értelmezett elemeket is tartalmazhat: 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. Bejelölése után a rendszer az értéket változatlanul veszi át, és a szintaxisra vonatkozó üzenet eltűnik. Az ezzel a beállítással létrehozott bejegyzések **dőlt betűvel** jelennek meg a lépések listájában. |
| **Handle as JSON data** | Jelölőnégyzet. Ekkor a rendszer az értéket karakterlánc helyett JSON-objektumként kezeli. |

A **Type** határozza meg, hol tárolódik az adat:

| Type | Tárolási hely |
|---|---|
| **Local variable** | A böngésző helyi tárhelye. |
| **Session variable** | A böngésző munkamenet-tárhelye. |
| **Cookie** | A böngészőben beállított cookie, a [Cookie-kra vonatkozó mezők](#cookie-specific-fields) című fejezetben ismertetett mezőkkel. |

## Cookie-kra vonatkozó mezők

Ha a **Type** értéke **Cookie**, négy további mező jelenik meg, és az ablak megnő:

| Mező | Leírás |
|---|---|
| **Path** | A cookie-t a megadott elérési útnak megfelelő URL-címekre korlátozza. Alapértelmezett érték: `/`, amely minden URL-címen elérhetővé teszi; ha a megadott érték nem `/` karakterrel kezdődik, a rendszer mentéskor kiegészíti vele. |
| **Lifetime (hours)** | Egész szám. A lejárati dátumot a rendszer az SSO futtatásakor számítja ki úgy, hogy ezt az élettartamot hozzáadja az aktuális időponthoz. ⚠ **Nulla vagy negatív érték esetén a cookie azonnal lejár**. Ha üresen marad, a rendszer nem küld lejárati dátumot, és a cookie munkamenet-cookie lesz. |
| **Secured cookie** | Jelölőnégyzet. Ekkor a cookie csak akkor használható, ha a webhellyel létesített kapcsolat biztonságos (HTTPS). |
| **SameSite** | Nem szerkeszthető legördülő lista: **Strict**, **Lax** *(alapértelmezett)* vagy **None**. Meghatározza, hogyan viselkedik a cookie a más webhelyről érkező kérések esetén. |

## Értékek speciális szintaxisa

A **Value** mező helyettesítő karakterláncokat fogad el, amelyeket a rendszer az SSO futtatásakor behelyettesít. Ugyanez a szintaxis érvényes a [pre-authentication requests](https://docs.cyberelements.io/bastion/4.6/hu/Usage/AdminConsoleReference/SsoPreAuthRequest/) ablakban megadott kérések paramétereire, fejléceire és törzsére 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 az adat 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.
