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

# Pre-authentication Web SSO request

> **Internt vindu i Applications-modulen**
>
> Dette vinduet nås fra modulen **Applications**, på en applikasjon der tjenestetypen er **Web** og der **SSO type** er **Pre-authentication**: knappen **Configure pre-authentication steps** åpner listen over trinn, der knappen **+** legger til en forespørsel. Vinduet har et hjelpeikon som åpner hjelpesiden for modulen.

Vinduet **Pre-authentication Web SSO request** gjør det mulig for en administrator å definere en **HTTP-forespørsel** som Mediation Controller må sende til målserveren før det siste autentiseringstrinnet i en Web SSO-applikasjon. En forenklet variant brukes til den **siste videresendingen** til applikasjonsserveren.

Hver forespørsel identifiseres i listen over trinn ved sin **URL**, sin **metode** og sin **sendingsrekkefølge** — det er denne rekkefølgen erstatningen `%reqresult()%` som er beskrevet i avsnittet [Spesiell syntaks for verdier](#special-syntax-of-values), viser til.

## Hovedfelt

| Felt | Beskrivelse |
|---|---|
| **URL** | URL som automatisk får adressen til målserveren som allerede er kjent, som prefiks (prefikset avkortes i visningen når strengen overstiger 100 tegn). I modusen **siste videresending** kan URL-en ikke redigeres. |
| **Method** | Obligatorisk. Valg: **GET** eller **POST** *(standard)*. |
| **Content type (MIME)** | MIME-typen til meldingsteksten i forespørselen. Standardverdi: `application/x-www-form-urlencoded`. Andre valg: `application/json`, `application/xml`, `text/html`, `text/plain`, `text/richtext`, `text/tab-separated-values`. Skjult og deaktivert i modusen **siste videresending**. |
| **Enable cache** | Avmerkingsboks, avmerket som standard. Skjult og deaktivert i modusen **siste videresending**. |
| **Login parameter** | Navnet på parameteren som må inneholde påloggingen. Bare aktivt når innholdstypen godtar parametere, det vil si `application/x-www-form-urlencoded`. |
| **Password parameter** | Navnet på parameteren som må inneholde passordet. Samme regler for aktivering som ovenfor. |
| **Advanced settings** | Avmerkingsboks. Viser eller skjuler fanene med de avanserte dataene. Slås på med tvang når den gjeldende innholdstypen ikke godtar enkle parametere. |

## Faner for avanserte innstillinger

Når **Advanced settings** er slått på, vises et faneområde. Synligheten avhenger av innholdstypen og av modusen (vanlig forespørsel eller siste videresending).

**Parameters**

> Synlig når den **siste videresendingen** redigeres, eller når innholdstypen godtar parametere (`application/x-www-form-urlencoded`).
>
> Skjemaet øverst legger en oppføring til tabellen under, med kolonnene **Name** og **Value**; når den er tom, viser den **No element to display**. Et sletteikon på hver rad fjerner oppføringen.
>
> | Felt | Beskrivelse |
> |---|---|
> | **Name** | Navnet på parameteren. |
> | **Value** | Tilhørende verdi. En melding under feltet minner om at **This field follows a special syntax. Please consult the help page for more informations.** Se avsnittet [Spesiell syntaks for verdier](#special-syntax-of-values). |
> | **Disable special syntax** | Avmerkingsboks: verdien tas da som den er, og meldingen om syntaksen forsvinner. Oppføringer som legges til på denne måten, vises **i kursiv** i tabellen. |
> | **Handle as JSON data** | Avmerkingsboks. Verdien behandles som et JSON-objekt. |
> | **Add** | Setter oppføringen inn i tabellen. |

**Content**

> Synlig når det ikke er den siste videresendingen som redigeres, **og** når innholdstypen ikke godtar enkle parametere (`application/json`, for eksempel).
>
> | Felt | Beskrivelse |
> |---|---|
> | **Content** | Tekstfelt over flere linjer, synkronisert i sanntid. Den samme meldingen om spesiell syntaks vises. |
> | **Disable special syntax** | Avmerkingsboks: innholdet tas da som det er. |

**Headers**

> Synlig når det ikke er den siste videresendingen som redigeres.
>
> Skjemaet er identisk med det i fanen **Parameters**: **Name**, **Value**, **Disable special syntax**, **Handle as JSON data**, knappen **Add**, og en tabell med sletting per rad.

Knappene **Previous** og **Next** flytter mellom de synlige fanene.

## Spesiell syntaks for verdier

Feltene **Value** (fanene **Parameters** og **Headers**) og feltet **Content** godtar erstatningsstrenger som byttes ut når SSO kjøres. Den samme syntaksen gjelder for [pre-authentication data](https://docs.cyberelements.io/bastion/4.6/no/Usage/AdminConsoleReference/SsoPreAuthData/).

| Erstatning | Virkning |
|---|---|
| `%user%` | Påloggingen som skal brukes til SSO. |
| `%password%` | Passordet som skal brukes til SSO. |
| `%base64([...])%` | Koder innholdet i parentesene i base 64. |
| `%lowercase([...])%` | Gjør innholdet om til små bokstaver. |
| `%uppercase([...])%` | Gjør innholdet om til store bokstaver. |
| `%trim([...])%` | Fjerner mellomrom foran og etter innholdet. |
| `%uriencoded([...])%` | Erstatter uvanlige spesialtegn med UTF-8-kodingen deres, for bruk i en URL. |

Krypteringsfunksjoner er også tilgjengelige:

| Funksjon | Forventede parametere |
|---|---|
| `%sha256([...])%` | Dataene som skal hashes (SHA-256). |
| `%md5([...])%` | Dataene som skal hashes (MD5). |
| `%hmacmd5([...])%` | To parametere: dataene som skal krypteres, deretter krypteringsnøkkelen. |
| `%rsa([...])%` | To parametere: den offentlige nøkkelen, deretter dataene som skal krypteres. |
| `%rsaoaep([...])%` | To parametere: den offentlige nøkkelen i PEM-format, deretter strengen som skal krypteres. |
| `%reqresult([...])%` | Rekkefølgenummeret til forespørselen som resultatet skal gjenbrukes fra, og eventuelt navnet på nøkkelen som skal velges når dette resultatet inneholder flere parametere. |

> **To skrivekonvensjoner**
>
> Parametrene til en funksjon skilles med **`%,%`**. For å skrive inn et bokstavelig prosenttegn skriver du **`\%`**.

## Lagring

Klikk på **Validate** for å legge til eller oppdatere forespørselen i det gjeldende forhåndsautentiseringstrinnet. **Cancel** lukker vinduet uten å lagre.

> **Tilpasning av høyden**
>
> Vinduet endrer størrelse automatisk avhengig av modusen: kort skjema når **Advanced settings** er slått av eller i videresendingsmodus, høyt skjema når faneområdet er synlig.
