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

# Pre-authentication Web SSO data

> **Internt fönster i modulen Applications**
>
> Detta fönster nås från modulen **Applications**, på en applikation vars tjänstetyp är **Web** och vars **SSO type** är **Pre-authentication**: knappen **Configure pre-authentication steps** öppnar listan över steg, där undermenyn till knappen för att lägga till erbjuder att lägga till ett **data creation step**. Fönstret har en hjälpikon som öppnar modulens hjälpsida.

Fönstret **Pre-authentication Web SSO data** låter en administratör definiera en uppgift som Mediation Controller måste **lagra** i webbläsaren (lokal variabel, sessionsvariabel eller cookie) före den avslutande preautentiseringsfasen i en Web SSO-applikation.

## Formulärets fält

| Fält | Beskrivning |
|---|---|
| **Type** | Obligatorisk, icke redigerbar rullgardinsmeny. Valmöjligheter: **Local variable** *(standard)*, **Session variable**, **Cookie**. Det valda värdet styr visningen av de cookie-specifika fälten nedan. |
| **Name** | Obligatoriskt. En sträng som bara innehåller blanktecken avvisas. Identifierar uppgiften. |
| **Value** | Värde att lagra. Som standard kan det innehålla element som tolkas av preautentiseringsmotorn: ett meddelande under fältet påminner om att **This field follows a special syntax. Please consult the help page for more informations.** Se avsnittet [Speciell syntax för värden](#special-syntax-of-values). |
| **Disable special syntax** | Kryssruta. När den är markerad tas värdet som det är och syntaxmeddelandet försvinner. Poster som skapas med detta alternativ visas **i kursiv stil** i listan över steg. |
| **Handle as JSON data** | Kryssruta. Värdet behandlas då som ett JSON-objekt i stället för en sträng. |

**Type** avgör var uppgiften lagras:

| Type | Plats |
|---|---|
| **Local variable** | Webbläsarens lokala lagring. |
| **Session variable** | Webbläsarens sessionslagring. |
| **Cookie** | En cookie som sätts i webbläsaren, med fälten i avsnittet [Fält specifika för cookies](#cookie-specific-fields). |

## Fält specifika för cookies

När **Type** är **Cookie** visas fyra ytterligare fält och fönstret växer:

| Fält | Beskrivning |
|---|---|
| **Path** | Begränsar cookien till de URL:er som matchar den angivna sökvägen. Standardvärdet `/`, som gör den tillgänglig på alla URL:er; ett inledande `/` läggs till vid sparandet om inmatningen saknar ett. |
| **Lifetime (hours)** | Heltal. Utgångsdatumet beräknas när SSO körs, genom att denna livslängd läggs till den aktuella tiden. ⚠ Ett **värde som är noll eller negativt gör att cookien går ut omedelbart**. Lämnas det tomt skickas inget utgångsdatum och cookien blir en sessionscookie. |
| **Secured cookie** | Kryssruta. Cookien kan då endast användas när anslutningen till sitet är säkrad (HTTPS). |
| **SameSite** | Icke redigerbar rullgardinsmeny: **Strict**, **Lax** *(standard)* eller **None**. Definierar hur cookien beter sig vid förfrågningar som kommer från ett annat site. |

## Speciell syntax för värden

Fältet **Value** godtar ersättningssträngar som byts ut när SSO körs. Samma syntax gäller för parametrar, headers och brödtexter i [pre-authentication requests](https://docs.cyberelements.io/bastion/4.6/sv/Usage/AdminConsoleReference/SsoPreAuthRequest/).

| Ersättning | Effekt |
|---|---|
| `%user%` | Inloggningsnamn som ska användas för SSO. |
| `%password%` | Lösenord som ska användas för SSO. |
| `%base64([...])%` | Kodar innehållet i hakparenteserna i base 64. |
| `%lowercase([...])%` | Omvandlar innehållet till små bokstäver. |
| `%uppercase([...])%` | Omvandlar innehållet till stora bokstäver. |
| `%trim([...])%` | Tar bort inledande och avslutande blanktecken från innehållet. |
| `%uriencoded([...])%` | Ersätter ovanliga specialtecken med deras UTF-8-kodning, för användning i en URL. |

Krypteringsfunktioner finns också tillgängliga:

| Funktion | Förväntade parametrar |
|---|---|
| `%sha256([...])%` | Data som ska hashas (SHA-256). |
| `%md5([...])%` | Data som ska hashas (MD5). |
| `%hmacmd5([...])%` | Två parametrar: data som ska krypteras, sedan krypteringsnyckeln. |
| `%rsa([...])%` | Två parametrar: den publika nyckeln, sedan data som ska krypteras. |
| `%rsaoaep([...])%` | Två parametrar: den publika nyckeln i PEM-format, sedan strängen som ska krypteras. |
| `%reqresult([...])%` | Ordningsnumret för den förfrågan vars resultat ska återanvändas och, valfritt, namnet på den nyckel som ska väljas när det resultatet innehåller flera parametrar. |

> **Två skrivkonventioner**
>
> En funktions parametrar separeras med **`%,%`**. För att ange ett bokstavligt procenttecken, skriv **`\%`**.

## Sparande

Klicka på **Validate** för att lägga till eller uppdatera uppgiften i det aktuella preautentiseringssteget. **Cancel** stänger fönstret utan att spara.
