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()%, описано в частта Специален синтаксис на стойностите.
Основни полета¶
| Поле | Описание |
|---|---|
| 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 е отметнато, се появява панел с раздели. Видимостта му зависи от типа на съдържанието и от режима (обикновена заявка или окончателно пренасочване).
Видим, когато се редактира окончателното пренасочване или когато типът на съдържанието приема параметри (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. Вижте частта Специален синтаксис на стойностите. |
| Disable special syntax | Квадратче за отметка: тогава стойността се приема както е и съобщението за синтаксиса изчезва. Записите, добавени по този начин, се показват в курсив в таблицата. |
| Handle as JSON data | Квадратче за отметка. Стойността се обработва като JSON обект. |
| Add | Вмъква записа в таблицата. |
Видим, когато не се редактира окончателното пренасочване и когато типът на съдържанието не приема прости параметри (например application/json).
| Поле | Описание |
|---|---|
| Content | Многоредово текстово поле, синхронизирано в реално време. Напомня се същото съобщение за специалния синтаксис. |
| Disable special syntax | Квадратче за отметка: тогава съдържанието се приема както е. |
Видим, когато не се редактира окончателното пренасочване.
Формулярът е идентичен с този в раздела Parameters: Name, Value, Disable special syntax, Handle as JSON data, бутонът Add и таблица с изтриване по редове.
Бутоните Previous и Next преминават между видимите раздели.
Специален синтаксис на стойностите¶
Полетата Value (разделите Parameters и Headers) и полето Content приемат низове за заместване, които се заместват при изпълнението на SSO. Същият синтаксис се прилага за pre-authentication data.
| Заместване | Ефект |
|---|---|
%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 не е отметнато или в режим на пренасочване, висок формуляр, когато панелът с раздели е видим.