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

# Pre-authentication Web SSO data

> **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 het submenu van de knop om toe te voegen aanbiedt een **data creation step** toe te voegen. Het venster heeft een hulppictogram dat de hulppagina van de module opent.

Het venster **Pre-authentication Web SSO data** stelt een beheerder in staat een gegeven te definiëren dat de Mediation Controller in de browser moet **opslaan** (lokale variabele, sessievariabele of cookie) vóór de laatste fase van de pre-authenticatie van een Web-SSO-applicatie.

## Velden van het formulier

| Veld | Beschrijving |
|---|---|
| **Type** | Verplichte, niet-bewerkbare vervolgkeuzelijst. Keuzes: **Local variable** *(standaard)*, **Session variable**, **Cookie**. De geselecteerde waarde bepaalt de weergave van de velden die hieronder eigen zijn aan cookies. |
| **Name** | Verplicht. Een tekenreeks die alleen uit witruimte bestaat, wordt geweigerd. Identificeert het gegeven. |
| **Value** | Waarde die moet worden opgeslagen. Standaard kan die elementen bevatten die door de engine van de pre-authenticatie worden geïnterpreteerd: 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. Zodra dit is aangevinkt, wordt de waarde ongewijzigd overgenomen en verdwijnt de melding over de syntaxis. Vermeldingen die met deze optie zijn aangemaakt, worden **cursief** weergegeven in de lijst met stappen. |
| **Handle as JSON data** | Selectievakje. De waarde wordt dan als een JSON-object en niet als een tekenreeks behandeld. |

Het **Type** bepaalt waar het gegeven wordt opgeslagen:

| Type | Locatie |
|---|---|
| **Local variable** | Lokale opslag van de browser. |
| **Session variable** | Sessieopslag van de browser. |
| **Cookie** | Een cookie dat in de browser wordt geplaatst, met de velden van het gedeelte [Velden die eigen zijn aan cookies](#cookie-specific-fields). |

## Velden die eigen zijn aan cookies

Wanneer **Type** de waarde **Cookie** heeft, verschijnen er vier extra velden en wordt het venster groter:

| Veld | Beschrijving |
|---|---|
| **Path** | Beperkt het cookie tot de URL's die met het opgegeven pad overeenkomen. Standaardwaarde `/`, waardoor het op elke URL beschikbaar is; bij het opslaan wordt een `/` aan het begin toegevoegd wanneer de invoer er geen bevat. |
| **Lifetime (hours)** | Geheel getal. De vervaldatum wordt bij de uitvoering van het SSO berekend door deze levensduur bij de huidige tijd op te tellen. ⚠ Met een **waarde van nul of een negatieve waarde verloopt het cookie onmiddellijk**. Blijft het leeg, dan wordt er geen vervaldatum verzonden en wordt het cookie een sessiecookie. |
| **Secured cookie** | Selectievakje. Het cookie is dan alleen bruikbaar wanneer de verbinding met de site beveiligd is (HTTPS). |
| **SameSite** | Niet-bewerkbare vervolgkeuzelijst: **Strict**, **Lax** *(standaard)* of **None**. Bepaalt hoe het cookie zich gedraagt bij aanvragen die van een andere site komen. |

## Bijzondere syntaxis van de waarden

Het veld **Value** aanvaardt vervangingstekenreeksen die bij de uitvoering van het SSO worden vervangen. Dezelfde syntaxis geldt voor de parameters, headers en tekstinhoud van de [pre-authentication requests](https://docs.cyberelements.io/bastion/4.6/nl/Usage/AdminConsoleReference/SsoPreAuthRequest/).

| 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 het gegeven in de huidige stap van de pre-authenticatie toe te voegen of bij te werken. **Cancel** sluit het venster zonder op te slaan.
