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

# Pre-authentication Web SSO data

> **Moduļa Applications iekšējais logs**
>
> Šis logs ir pieejams modulī **Applications** lietojumprogrammai, kuras pakalpojuma tips ir **Web** un kuras **SSO type** ir **Pre-authentication**: poga **Configure pre-authentication steps** atver soļu sarakstu, kurā pievienošanas pogas apakšizvēlne piedāvā pievienot **data creation step**. Logā ir palīdzības ikona, kas atver moduļa palīdzības lapu.

Logs **Pre-authentication Web SSO data** ļauj administratoram definēt datus, kas komponentam Mediation Controller ir **jāsaglabā** pārlūkprogrammā (lokālais mainīgais, sesijas mainīgais vai sīkfails) pirms Web SSO lietojumprogrammas pēdējās priekšautentifikācijas fāzes.

## Veidlapas lauki

| Lauks | Apraksts |
|---|---|
| **Type** | Obligāta, nerediģējama nolaižamā izvēlne. Iespējas: **Local variable** *(noklusējums)*, **Session variable**, **Cookie**. Atlasītā vērtība nosaka, vai tiek rādīti tālāk aprakstītie sīkfailiem raksturīgie lauki. |
| **Name** | Obligāts. Virkne, kurā ir tikai atstarpes, tiek noraidīta. Identificē datus. |
| **Value** | Saglabājamā vērtība. Pēc noklusējuma tajā var būt elementi, ko interpretē priekšautentifikācijas dzinējs: ziņojums zem lauka atgādina, ka **This field follows a special syntax. Please consult the help page for more informations.** Skatiet nodaļu [Vērtību īpašā sintakse](#special-syntax-of-values). |
| **Disable special syntax** | Izvēles rūtiņa. Kad tā ir atzīmēta, vērtība tiek izmantota tieši tāda, kāda tā ir, un ziņojums par sintaksi pazūd. Ar šo opciju izveidotie ieraksti soļu sarakstā tiek rādīti **slīprakstā**. |
| **Handle as JSON data** | Izvēles rūtiņa. Vērtība tad tiek apstrādāta kā JSON objekts, nevis kā virkne. |

Lauks **Type** nosaka, kur dati tiek glabāti:

| Type | Atrašanās vieta |
|---|---|
| **Local variable** | Pārlūkprogrammas lokālā glabātuve. |
| **Session variable** | Pārlūkprogrammas sesijas glabātuve. |
| **Cookie** | Pārlūkprogrammā iestatīts sīkfails ar nodaļā [Sīkfailiem raksturīgie lauki](#cookie-specific-fields) aprakstītajiem laukiem. |

## Sīkfailiem raksturīgie lauki

Ja lauka **Type** vērtība ir **Cookie**, parādās četri papildu lauki un logs kļūst lielāks:

| Lauks | Apraksts |
|---|---|
| **Path** | Ierobežo sīkfailu ar vietrāžiem URL, kas atbilst norādītajam ceļam. Noklusējuma vērtība ir `/`, kas padara sīkfailu pieejamu visos vietrāžos URL; ja ievadītā vērtība nesākas ar `/`, saglabājot tas tiek pievienots. |
| **Lifetime (hours)** | Vesels skaitlis. Derīguma beigu datums tiek aprēķināts SSO izpildes laikā, pašreizējam laikam pieskaitot šo darbības ilgumu. ⚠ **Nulle vai negatīva vērtība liek sīkfailam nekavējoties zaudēt derīgumu**. Ja lauks ir tukšs, derīguma beigu datums netiek nosūtīts un sīkfails kļūst par sesijas sīkfailu. |
| **Secured cookie** | Izvēles rūtiņa. Sīkfailu tad var izmantot tikai tad, ja savienojums ar vietni ir drošs (HTTPS). |
| **SameSite** | Nerediģējama nolaižamā izvēlne: **Strict**, **Lax** *(noklusējums)* vai **None**. Nosaka, kā sīkfails darbojas ar pieprasījumiem, kas nāk no citas vietnes. |

## Vērtību īpašā sintakse

Lauks **Value** pieņem aizstāšanas virknes, kas tiek aizstātas SSO izpildes laikā. Tā pati sintakse attiecas uz [pre-authentication requests](https://docs.cyberelements.io/bastion/4.6/lv/Usage/AdminConsoleReference/SsoPreAuthRequest/) parametriem, galvenēm un pamattekstiem.

| Aizstāšana | Efekts |
|---|---|
| `%user%` | SSO izmantojamais pieteikšanās vārds. |
| `%password%` | SSO izmantojamā parole. |
| `%base64([...])%` | Kodē iekavās esošo saturu base 64 kodējumā. |
| `%lowercase([...])%` | Pārvērš saturu mazajos burtos. |
| `%uppercase([...])%` | Pārvērš saturu lielajos burtos. |
| `%trim([...])%` | Noņem atstarpes satura sākumā un beigās. |
| `%uriencoded([...])%` | Aizstāj retas speciālās rakstzīmes ar to UTF-8 kodējumu, lai saturu varētu izmantot vietrādī URL. |

Ir pieejamas arī šifrēšanas funkcijas:

| Funkcija | Paredzētie parametri |
|---|---|
| `%sha256([...])%` | Dati, kuriem jāaprēķina jaucējvērtība (SHA-256). |
| `%md5([...])%` | Dati, kuriem jāaprēķina jaucējvērtība (MD5). |
| `%hmacmd5([...])%` | Divi parametri: šifrējamie dati, pēc tam šifrēšanas atslēga. |
| `%rsa([...])%` | Divi parametri: publiskā atslēga, pēc tam šifrējamie dati. |
| `%rsaoaep([...])%` | Divi parametri: publiskā atslēga PEM formātā, pēc tam šifrējamā virkne. |
| `%reqresult([...])%` | Tā pieprasījuma kārtas numurs, kura rezultāts ir jāizmanto atkārtoti, un pēc izvēles tās atslēgas nosaukums, kas jāizvēlas, ja šajā rezultātā ir vairāki parametri. |

> **Divas rakstības konvencijas**
>
> Funkcijas parametri tiek atdalīti ar **`%,%`**. Lai ievadītu burtisku procentu zīmi, rakstiet **`\%`**.

## Saglabāšana

Noklikšķiniet uz **Validate**, lai pievienotu vai atjauninātu datus pašreizējā priekšautentifikācijas solī. Poga **Cancel** aizver logu, nesaglabājot izmaiņas.
