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

# Pre-authentication Web SSO request

> **Intern venster van de module Applications**
>
> Dit venster wordt bereikt vanuit de module **Applications**, bij een applicatie waarvan het servicetype **Web** is en waarvan het **SSO type** **Pre-authentication** is: de knop **Configure pre-authentication steps** opent de lijst met stappen, waar de knop **+** een aanvraag toevoegt. Het venster heeft een hulppictogram dat de hulppagina van de module opent.

Het venster **Pre-authentication Web SSO request** stelt een beheerder in staat een **HTTP-aanvraag** te definiëren die de Mediation Controller vóór de laatste authenticatiestap van een Web-SSO-applicatie naar de doelserver moet verzenden. Voor de **laatste doorverwijzing** naar de applicatieserver wordt een vereenvoudigde variant gebruikt.

Elke aanvraag wordt in de lijst met stappen geïdentificeerd door de **URL**, de **methode** en de **verzendorde** ervan — het is naar die orde dat de vervanging `%reqresult()%` verwijst die in het gedeelte [Bijzondere syntaxis van de waarden](#special-syntax-of-values) is beschreven.

## Belangrijkste velden

| Veld | Beschrijving |
|---|---|
| **URL** | URL waaraan automatisch het al bekende adres van de doelserver wordt voorafgegaan (het voorvoegsel wordt voor de weergave afgekapt wanneer de tekenreeks meer dan 100 tekens bevat). In de modus **laatste doorverwijzing** kan de URL niet worden gewijzigd. |
| **Method** | Verplicht. Keuzes: **GET** of **POST** *(standaard)*. |
| **Content type (MIME)** | MIME-type van de tekstinhoud van de aanvraag. Standaardwaarde: `application/x-www-form-urlencoded`. Andere keuzes: `application/json`, `application/xml`, `text/html`, `text/plain`, `text/richtext`, `text/tab-separated-values`. Verborgen en uitgeschakeld in de modus **laatste doorverwijzing**. |
| **Enable cache** | Selectievakje, standaard aangevinkt. Verborgen en uitgeschakeld in de modus **laatste doorverwijzing**. |
| **Login parameter** | Naam van de parameter die de login moet bevatten. Alleen ingeschakeld wanneer het inhoudstype parameters aanvaardt, dat wil zeggen `application/x-www-form-urlencoded`. |
| **Password parameter** | Naam van de parameter die het wachtwoord moet bevatten. Dezelfde regels voor het inschakelen als hierboven. |
| **Advanced settings** | Selectievakje. Toont of verbergt de tabbladen met de geavanceerde gegevens. Wordt geforceerd wanneer het huidige inhoudstype geen eenvoudige parameters aanvaardt. |

## Tabbladen van de geavanceerde instellingen

Wanneer **Advanced settings** is ingeschakeld, verschijnt er een tabbladenpaneel. De zichtbaarheid ervan hangt af van het inhoudstype en van de modus (gewone aanvraag of laatste doorverwijzing).

**Parameters**

> Zichtbaar bij het wijzigen van de **laatste doorverwijzing**, of wanneer het inhoudstype parameters aanvaardt (`application/x-www-form-urlencoded`).
>
> Het bovenste formulier voegt een vermelding toe aan de tabel eronder, waarvan de kolommen **Name** en **Value** zijn; wanneer die leeg is, geeft ze **No element to display** weer. Een pictogram om te verwijderen op elke rij verwijdert de vermelding.
>
> | Veld | Beschrijving |
> |---|---|
> | **Name** | Naam van de parameter. |
> | **Value** | Bijbehorende waarde. Een melding onder het veld herinnert eraan dat **This field follows a special syntax. Please consult the help page for more informations.** Zie het gedeelte [Bijzondere syntaxis van de waarden](#special-syntax-of-values). |
> | **Disable special syntax** | Selectievakje: de waarde wordt dan ongewijzigd overgenomen en de melding over de syntaxis verdwijnt. Vermeldingen die op deze manier zijn toegevoegd, worden **cursief** weergegeven in de tabel. |
> | **Handle as JSON data** | Selectievakje. De waarde wordt als een JSON-object behandeld. |
> | **Add** | Voegt de vermelding in de tabel in. |

**Content**

> Zichtbaar wanneer niet de laatste doorverwijzing wordt gewijzigd **en** wanneer het inhoudstype geen eenvoudige parameters aanvaardt (bijvoorbeeld `application/json`).
>
> | Veld | Beschrijving |
> |---|---|
> | **Content** | Tekstvak met meerdere regels, in realtime gesynchroniseerd. Dezelfde melding over de bijzondere syntaxis wordt weergegeven. |
> | **Disable special syntax** | Selectievakje: de inhoud wordt dan ongewijzigd overgenomen. |

**Headers**

> Zichtbaar wanneer niet de laatste doorverwijzing wordt gewijzigd.
>
> Het formulier is identiek aan dat van het tabblad **Parameters**: **Name**, **Value**, **Disable special syntax**, **Handle as JSON data**, de knop **Add**, en een tabel met verwijdering per rij.

De knoppen **Previous** en **Next** wisselen tussen de zichtbare tabbladen.

## Bijzondere syntaxis van de waarden

De velden **Value** (tabbladen **Parameters** en **Headers**) en het veld **Content** aanvaarden vervangingstekenreeksen die bij de uitvoering van het SSO worden vervangen. Dezelfde syntaxis geldt voor de [pre-authentication data](https://docs.cyberelements.io/bastion/4.6/nl/Usage/AdminConsoleReference/SsoPreAuthData/).

| Vervanging | Effect |
|---|---|
| `%user%` | Login die voor het SSO moet worden gebruikt. |
| `%password%` | Wachtwoord dat voor het SSO moet worden gebruikt. |
| `%base64([...])%` | Codeert de inhoud van de haakjes in base 64. |
| `%lowercase([...])%` | Zet de inhoud om in kleine letters. |
| `%uppercase([...])%` | Zet de inhoud om in hoofdletters. |
| `%trim([...])%` | Verwijdert witruimte aan het begin en het einde van de inhoud. |
| `%uriencoded([...])%` | Vervangt ongebruikelijke speciale tekens door hun UTF-8-codering, voor gebruik in een URL. |

Er zijn ook versleutelingsfuncties beschikbaar:

| Functie | Verwachte parameters |
|---|---|
| `%sha256([...])%` | De gegevens die moeten worden gehasht (SHA-256). |
| `%md5([...])%` | De gegevens die moeten worden gehasht (MD5). |
| `%hmacmd5([...])%` | Twee parameters: de gegevens die moeten worden versleuteld, dan de versleutelingssleutel. |
| `%rsa([...])%` | Twee parameters: de openbare sleutel, dan de gegevens die moeten worden versleuteld. |
| `%rsaoaep([...])%` | Twee parameters: de openbare sleutel in PEM-indeling, dan de tekenreeks die moet worden versleuteld. |
| `%reqresult([...])%` | Het rangnummer van de aanvraag waarvan het resultaat opnieuw moet worden gebruikt en, optioneel, de naam van de sleutel die moet worden gekozen wanneer dat resultaat meerdere parameters bevat. |

> **Twee schrijfwijzen**
>
> De parameters van een functie worden gescheiden door **`%,%`**. Schrijf **`\%`** om een letterlijk procentteken in te voeren.

## Opslaan

Klik op **Validate** om de aanvraag in de huidige stap van de pre-authenticatie toe te voegen of bij te werken. **Cancel** sluit het venster zonder op te slaan.

> **Aanpassing van de hoogte**
>
> Het venster past zijn grootte automatisch aan naargelang de modus: kort formulier wanneer **Advanced settings** is uitgeschakeld of in de modus voor doorverwijzing, hoog formulier wanneer het tabbladenpaneel zichtbaar is.
