Pre-authentication Web SSO request¶
Fereastră internă a modulului Applications
Această fereastră se deschide din modulul Applications, pe o aplicație al cărei tip de serviciu este Web și al cărei SSO type este Pre-authentication: butonul Configure pre-authentication steps deschide lista de etape, unde butonul + adaugă o solicitare. Fereastra are o pictogramă de ajutor care deschide pagina de ajutor a modulului.
Fereastra Pre-authentication Web SSO request permite unui administrator să definească o solicitare HTTP pe care Mediation Controller trebuie să o trimită serverului țintă înainte de etapa finală de autentificare a unei aplicații Web SSO. Pentru redirecționarea finală către serverul aplicației este utilizată o variantă simplificată.
Fiecare solicitare este identificată în lista de etape prin URL-ul său, metoda sa și ordinea sa de trimitere — la această ordine se referă substituția %reqresult()% descrisă în secțiunea Sintaxa specială a valorilor.
Câmpuri principale¶
| Câmp | Descriere |
|---|---|
| URL | URL prefixată automat cu adresa deja cunoscută a serverului țintă (prefixul este trunchiat la afișare când șirul depășește 100 de caractere). În modul redirecționare finală, URL-ul nu poate fi modificat. |
| Method | Obligatoriu. Opțiuni: GET sau POST (implicit). |
| Content type (MIME) | Tipul MIME al corpului solicitării. Valoare implicită: application/x-www-form-urlencoded. Alte opțiuni: application/json, application/xml, text/html, text/plain, text/richtext, text/tab-separated-values. Ascuns și dezactivat în modul redirecționare finală. |
| Enable cache | Casetă de selectare, bifată în mod implicit. Ascunsă și dezactivată în modul redirecționare finală. |
| Login parameter | Numele parametrului care trebuie să conțină loginul. Este activat numai când tipul de conținut acceptă parametri, adică application/x-www-form-urlencoded. |
| Password parameter | Numele parametrului care trebuie să conțină parola. Aceleași reguli de activare ca mai sus. |
| Advanced settings | Casetă de selectare. Afișează sau ascunde taburile de date avansate. Este forțată la activat când tipul de conținut curent nu acceptă parametri simpli. |
Taburile de setări avansate¶
Când Advanced settings este activat, apare un panou de taburi. Vizibilitatea sa depinde de tipul de conținut și de mod (solicitare obișnuită sau redirecționare finală).
Vizibil la modificarea redirecționării finale sau când tipul de conținut acceptă parametri (application/x-www-form-urlencoded).
Formularul superior adaugă o intrare în tabelul de dedesubt, ale cărui coloane sunt Name și Value; când este gol, indică No element to display. O pictogramă de ștergere pe fiecare rând elimină intrarea.
| Câmp | Descriere |
|---|---|
| Name | Numele parametrului. |
| Value | Valoarea corespunzătoare. Un mesaj situat sub câmp amintește că This field follows a special syntax. Please consult the help page for more informations. Consultați secțiunea Sintaxa specială a valorilor. |
| Disable special syntax | Casetă de selectare: valoarea este atunci preluată așa cum este, iar mesajul privind sintaxa dispare. Intrările adăugate astfel sunt afișate în cursive în tabel. |
| Handle as JSON data | Casetă de selectare. Valoarea este tratată ca un obiect JSON. |
| Add | Inserează intrarea în tabel. |
Vizibil când nu se modifică redirecționarea finală și când tipul de conținut nu acceptă parametri simpli (application/json, de exemplu).
| Câmp | Descriere |
|---|---|
| Content | Zonă de text pe mai multe rânduri, sincronizată în timp real. Este amintit același mesaj privind sintaxa specială. |
| Disable special syntax | Casetă de selectare: conținutul este atunci preluat așa cum este. |
Vizibil când nu se modifică redirecționarea finală.
Formularul este identic cu cel al tabului Parameters: Name, Value, Disable special syntax, Handle as JSON data, butonul Add și un tabel cu ștergere pe fiecare rând.
Butoanele Previous și Next permit deplasarea între taburile vizibile.
Sintaxa specială a valorilor¶
Câmpurile Value (taburile Parameters și Headers) și câmpul Content acceptă șiruri de substituție, înlocuite la executarea SSO. Aceeași sintaxă se aplică pre-authentication data.
| Substituție | Efect |
|---|---|
%user% |
Loginul care trebuie utilizat pentru SSO. |
%password% |
Parola care trebuie utilizată pentru SSO. |
%base64([...])% |
Codifică în baza 64 conținutul dintre paranteze drepte. |
%lowercase([...])% |
Transformă conținutul în minuscule. |
%uppercase([...])% |
Transformă conținutul în majuscule. |
%trim([...])% |
Elimină spațiile de la începutul și de la sfârșitul conținutului. |
%uriencoded([...])% |
Înlocuiește caracterele speciale mai puțin obișnuite cu codificarea lor UTF-8, pentru utilizarea într-o URL. |
Sunt disponibile de asemenea funcții de criptare:
| Funcție | Parametri așteptați |
|---|---|
%sha256([...])% |
Datele care trebuie criptate (SHA-256). |
%md5([...])% |
Datele care trebuie criptate (MD5). |
%hmacmd5([...])% |
Doi parametri: datele care trebuie criptate, apoi cheia de criptare. |
%rsa([...])% |
Doi parametri: cheia publică, apoi datele care trebuie criptate. |
%rsaoaep([...])% |
Doi parametri: cheia publică în format PEM, apoi șirul care trebuie criptat. |
%reqresult([...])% |
Numărul de ordine al solicitării al cărei rezultat trebuie reutilizat și, opțional, numele cheii care trebuie preluată atunci când acel rezultat conține mai mulți parametri. |
Două convenții de scriere
Parametrii unei funcții se separă prin %,%. Pentru a introduce un semn de procent literal, scrieți \%.
Salvarea¶
Faceți clic pe Validate pentru a adăuga sau a actualiza solicitarea în etapa de preautentificare curentă. Cancel închide fereastra fără a salva.
Adaptarea înălțimii
Fereastra se redimensionează automat în funcție de mod: formular scurt când Advanced settings este dezactivat sau în modul de redirecționare, formular înalt când panoul de taburi este vizibil.