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

# Pre-authentication Web SSO data

> **Вътрешен прозорец на модула Applications**
>
> Този прозорец се отваря от модула **Applications** за приложение, чийто тип услуга е **Web** и чийто **SSO type** е **Pre-authentication**: бутонът **Configure pre-authentication steps** отваря списъка със стъпки, където подменюто на бутона за добавяне предлага да се добави **data creation step**. Прозорецът има икона за помощ, която отваря страницата с помощ за модула.

Прозорецът **Pre-authentication Web SSO data** позволява на администратора да дефинира данни, които компонентът Mediation Controller трябва да **съхрани** в браузъра (локална променлива, променлива на сесията или бисквитка) преди последната фаза на предварителното удостоверяване на Web SSO приложение.

## Полета на формуляра

| Поле | Описание |
|---|---|
| **Type** | Задължителен падащ списък, който не може да се редактира. Възможности: **Local variable** *(по подразбиране)*, **Session variable**, **Cookie**. Избраната стойност определя дали се показват специфичните за бисквитката полета по-долу. |
| **Name** | Задължително. Низ, съдържащ само интервали, се отхвърля. Идентифицира данните. |
| **Value** | Стойност за съхраняване. По подразбиране тя може да съдържа елементи, които се интерпретират от механизма за предварително удостоверяване: съобщение под полето напомня, че **This field follows a special syntax. Please consult the help page for more informations.** Вижте частта [Специален синтаксис на стойностите](#special-syntax-of-values). |
| **Disable special syntax** | Квадратче за отметка. Когато е отметнато, стойността се приема както е и съобщението за синтаксиса изчезва. Записите, създадени с тази опция, се показват **в курсив** в списъка със стъпки. |
| **Handle as JSON data** | Квадратче за отметка. Тогава стойността се обработва като JSON обект, а не като низ. |

Полето **Type** определя къде се съхраняват данните:

| Type | Местоположение |
|---|---|
| **Local variable** | Локалното място за съхранение на браузъра. |
| **Session variable** | Мястото за съхранение на сесията в браузъра. |
| **Cookie** | Бисквитка, зададена в браузъра, с полетата от частта [Полета, специфични за бисквитката](#cookie-specific-fields). |

## Полета, специфични за бисквитката

Когато **Type** е **Cookie**, се появяват четири допълнителни полета и прозорецът се разширява:

| Поле | Описание |
|---|---|
| **Path** | Ограничава бисквитката до URL адресите, които съответстват на зададения път. Стойност по подразбиране `/`, която я прави достъпна за всеки URL адрес; при записване се добавя начален `/`, ако въведената стойност не съдържа такъв. |
| **Lifetime (hours)** | Цяло число. Датата на изтичане се изчислява при изпълнението на SSO, като този срок на валидност се добавя към текущия час. ⚠ **Нулева или отрицателна стойност води до незабавно изтичане на бисквитката**. Ако полето е празно, не се изпраща дата на изтичане и бисквитката става бисквитка за сесията. |
| **Secured cookie** | Квадратче за отметка. Тогава бисквитката може да се използва само когато връзката с уебсайта е защитена (HTTPS). |
| **SameSite** | Падащ списък, който не може да се редактира: **Strict**, **Lax** *(по подразбиране)* или **None**. Определя поведението на бисквитката при заявки, идващи от друг уебсайт. |

## Специален синтаксис на стойностите

Полето **Value** приема низове за заместване, които се заместват при изпълнението на SSO. Същият синтаксис се прилага за параметрите, заглавките и телата на [pre-authentication requests](https://docs.cyberelements.io/bastion/4.6/bg/Usage/AdminConsoleReference/SsoPreAuthRequest/).

| Заместване | Ефект |
|---|---|
| `%user%` | Името за влизане, което да се използва за SSO. |
| `%password%` | Паролата, която да се използва за SSO. |
| `%base64([...])%` | Кодира съдържанието на скобите в base64. |
| `%lowercase([...])%` | Преобразува съдържанието в малки букви. |
| `%uppercase([...])%` | Преобразува съдържанието в главни букви. |
| `%trim([...])%` | Премахва началните и крайните интервали от съдържанието. |
| `%uriencoded([...])%` | Заменя необичайните специални знаци с тяхното UTF-8 кодиране за използване в URL адрес. |

Налични са и функции за шифроване:

| Функция | Очаквани параметри |
|---|---|
| `%sha256([...])%` | Данните за хеширане (SHA-256). |
| `%md5([...])%` | Данните за хеширане (MD5). |
| `%hmacmd5([...])%` | Два параметъра: данните за шифроване, след това ключът за шифроване. |
| `%rsa([...])%` | Два параметъра: публичният ключ, след това данните за шифроване. |
| `%rsaoaep([...])%` | Два параметъра: публичният ключ във формат PEM, след това низът за шифроване. |
| `%reqresult([...])%` | Поредният номер на заявката, чийто резултат трябва да се използва повторно, и по избор името на ключа, който да се вземе, когато този резултат съдържа няколко параметъра. |

> **Две конвенции за писане**
>
> Параметрите на функциите се разделят с **`%,%`**. За да въведете буквален знак за процент, напишете **`\%`**.

## Записване

Щракнете върху **Validate**, за да добавите или актуализирате данните в текущата стъпка на предварителното удостоверяване. **Cancel** затваря прозореца без записване.
