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. Вижте частта Специален синтаксис на стойностите. |
| Disable special syntax | Квадратче за отметка. Когато е отметнато, стойността се приема както е и съобщението за синтаксиса изчезва. Записите, създадени с тази опция, се показват в курсив в списъка със стъпки. |
| Handle as JSON data | Квадратче за отметка. Тогава стойността се обработва като JSON обект, а не като низ. |
Полето Type определя къде се съхраняват данните:
| Type | Местоположение |
|---|---|
| Local variable | Локалното място за съхранение на браузъра. |
| Session variable | Мястото за съхранение на сесията в браузъра. |
| Cookie | Бисквитка, зададена в браузъра, с полетата от частта Полета, специфични за бисквитката. |
Полета, специфични за бисквитката¶
Когато Type е Cookie, се появяват четири допълнителни полета и прозорецът се разширява:
| Поле | Описание |
|---|---|
| Path | Ограничава бисквитката до URL адресите, които съответстват на зададения път. Стойност по подразбиране /, която я прави достъпна за всеки URL адрес; при записване се добавя начален /, ако въведената стойност не съдържа такъв. |
| Lifetime (hours) | Цяло число. Датата на изтичане се изчислява при изпълнението на SSO, като този срок на валидност се добавя към текущия час. ⚠ Нулева или отрицателна стойност води до незабавно изтичане на бисквитката. Ако полето е празно, не се изпраща дата на изтичане и бисквитката става бисквитка за сесията. |
| Secured cookie | Квадратче за отметка. Тогава бисквитката може да се използва само когато връзката с уебсайта е защитена (HTTPS). |
| SameSite | Падащ списък, който не може да се редактира: Strict, Lax (по подразбиране) или None. Определя поведението на бисквитката при заявки, идващи от друг уебсайт. |
Специален синтаксис на стойностите¶
Полето Value приема низове за заместване, които се заместват при изпълнението на SSO. Същият синтаксис се прилага за параметрите, заглавките и телата на pre-authentication requests.
| Заместване | Ефект |
|---|---|
%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 затваря прозореца без записване.