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

# Pre-authentication Web SSO request

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

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

Всяка заявка се идентифицира в списъка със стъпки чрез своя **URL адрес**, своя **метод** и своя **ред на изпращане** — именно към този ред препраща заместването `%reqresult()%`, описано в частта [Специален синтаксис на стойностите](#special-syntax-of-values).

## Основни полета

| Поле | Описание |
|---|---|
| **URL** | URL адрес, към който автоматично се добавя като префикс вече известният адрес на целевия сървър (при показване префиксът се съкращава, когато низът надвишава 100 знака). В режим на **окончателно пренасочване** URL адресът не може да се редактира. |
| **Method** | Задължително. Възможности: **GET** или **POST** *(по подразбиране)*. |
| **Content type (MIME)** | MIME тип на тялото на заявката. Стойност по подразбиране: `application/x-www-form-urlencoded`. Други възможности: `application/json`, `application/xml`, `text/html`, `text/plain`, `text/richtext`, `text/tab-separated-values`. Скрито и деактивирано в режим на **окончателно пренасочване**. |
| **Enable cache** | Квадратче за отметка, отметнато по подразбиране. Скрито и деактивирано в режим на **окончателно пренасочване**. |
| **Login parameter** | Име на параметъра, който трябва да съдържа името за влизане. Активно е само когато типът на съдържанието приема параметри, т.е. `application/x-www-form-urlencoded`. |
| **Password parameter** | Име на параметъра, който трябва да съдържа паролата. Същите правила за активиране като по-горе. |
| **Advanced settings** | Квадратче за отметка. Показва или скрива разделите с разширени данни. Принудително е отметнато, когато текущият тип на съдържанието не приема прости параметри. |

## Раздели на разширените настройки

Когато **Advanced settings** е отметнато, се появява панел с раздели. Видимостта му зависи от типа на съдържанието и от режима (обикновена заявка или окончателно пренасочване).

**Parameters**

> Видим, когато се редактира **окончателното пренасочване** или когато типът на съдържанието приема параметри (`application/x-www-form-urlencoded`).
>
> Горният формуляр добавя запис в таблицата по-долу, чиито колони са **Name** и **Value**; когато е празна, тя показва **No element to display**. Иконата за изтриване на всеки ред премахва записа.
>
> | Поле | Описание |
> |---|---|
> | **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 обект. |
> | **Add** | Вмъква записа в таблицата. |

**Content**

> Видим, когато не се редактира окончателното пренасочване **и** когато типът на съдържанието не приема прости параметри (например `application/json`).
>
> | Поле | Описание |
> |---|---|
> | **Content** | Многоредово текстово поле, синхронизирано в реално време. Напомня се същото съобщение за специалния синтаксис. |
> | **Disable special syntax** | Квадратче за отметка: тогава съдържанието се приема както е. |

**Headers**

> Видим, когато не се редактира окончателното пренасочване.
>
> Формулярът е идентичен с този в раздела **Parameters**: **Name**, **Value**, **Disable special syntax**, **Handle as JSON data**, бутонът **Add** и таблица с изтриване по редове.

Бутоните **Previous** и **Next** преминават между видимите раздели.

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

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

| Заместване | Ефект |
|---|---|
| `%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** затваря прозореца без записване.

> **Адаптиране на височината**
>
> Прозорецът автоматично променя размера си в зависимост от режима: къс формуляр, когато **Advanced settings** не е отметнато или в режим на пренасочване, висок формуляр, когато панелът с раздели е видим.
