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

# Pre-authentication Web SSO data

> **Internes Fenster des Moduls Applications**
>
> Dieses Fenster wird aus dem Modul **Applications** erreicht, bei einer Anwendung, deren Diensttyp **Web** ist und deren **SSO type** **Pre-authentication** lautet: Die Schaltfläche **Configure pre-authentication steps** öffnet die Liste der Schritte, in der das Untermenü der Hinzufügen-Schaltfläche anbietet, einen **data creation step** hinzuzufügen. Das Fenster trägt ein Hilfesymbol, das die Hilfeseite des Moduls öffnet.

Das Fenster **Pre-authentication Web SSO data** ermöglicht es einem Administrator, ein Datum zu definieren, das der Mediation Controller vor der letzten Preauthentifizierungsphase einer Web-SSO-Anwendung im Browser **speichern** muss (lokale Variable, Sitzungsvariable oder Cookie).

## Formularfelder

| Feld | Beschreibung |
|---|---|
| **Type** | Pflichtfeld, nicht bearbeitbare Dropdownliste. Auswahlmöglichkeiten: **Local variable** *(Standard)*, **Session variable**, **Cookie**. Der ausgewählte Wert steuert die Anzeige der cookie-spezifischen Felder weiter unten. |
| **Name** | Pflichtfeld. Eine Zeichenfolge, die nur aus Leerzeichen besteht, wird abgewiesen. Identifiziert das Datum. |
| **Value** | Zu speichernder Wert. Standardmäßig kann er Elemente enthalten, die von der Preauthentifizierungs-Engine interpretiert werden: Eine Meldung unter dem Feld erinnert daran, dass **This field follows a special syntax. Please consult the help page for more informations.** Siehe Abschnitt [Spezielle Syntax der Werte](#special-syntax-of-values). |
| **Disable special syntax** | Kontrollkästchen. Ist es aktiviert, wird der Wert unverändert übernommen und die Meldung zur Syntax verschwindet. Mit dieser Option erstellte Einträge werden in der Liste der Schritte **kursiv** angezeigt. |
| **Handle as JSON data** | Kontrollkästchen. Der Wert wird dann als JSON-Objekt und nicht als Zeichenfolge behandelt. |

Der **Type** bestimmt, wo das Datum gespeichert wird:

| Type | Speicherort |
|---|---|
| **Local variable** | Lokaler Speicher des Browsers. |
| **Session variable** | Sitzungsspeicher des Browsers. |
| **Cookie** | Ein im Browser gesetztes Cookie, mit den Feldern aus Abschnitt [Felder speziell für Cookies](#cookie-specific-fields). |

## Felder speziell für Cookies

Wenn **Type** den Wert **Cookie** hat, erscheinen vier zusätzliche Felder und das Fenster wird größer:

| Feld | Beschreibung |
|---|---|
| **Path** | Beschränkt das Cookie auf die URLs, die dem angegebenen Pfad entsprechen. Standardwert `/`, der es auf allen URLs verfügbar macht; beim Speichern wird ein führender `/` ergänzt, wenn die Eingabe keinen enthält. |
| **Lifetime (hours)** | Ganzzahl. Das Ablaufdatum wird bei der Ausführung des SSO berechnet, indem diese Lebensdauer zur aktuellen Uhrzeit addiert wird. ⚠ Ein **Wert von null oder ein negativer Wert lässt das Cookie sofort ablaufen**. Bleibt es leer, wird kein Ablaufdatum gesendet und das Cookie wird zu einem Sitzungscookie. |
| **Secured cookie** | Kontrollkästchen. Das Cookie ist dann nur verwendbar, wenn die Verbindung zur Site gesichert ist (HTTPS). |
| **SameSite** | Nicht bearbeitbare Dropdownliste: **Strict**, **Lax** *(Standard)* oder **None**. Legt fest, wie sich das Cookie bei Anfragen von einer anderen Site verhält. |

## Spezielle Syntax der Werte

Das Feld **Value** akzeptiert Ersetzungszeichenfolgen, die bei der Ausführung des SSO ersetzt werden. Dieselbe Syntax gilt für die Parameter, Header und Textkörper der [pre-authentication requests](https://docs.cyberelements.io/bastion/4.6/de/Usage/AdminConsoleReference/SsoPreAuthRequest/).

| Ersetzung | Wirkung |
|---|---|
| `%user%` | Login, das für das SSO verwendet werden soll. |
| `%password%` | Passwort, das für das SSO verwendet werden soll. |
| `%base64([...])%` | Codiert den Inhalt der Klammern in Base64. |
| `%lowercase([...])%` | Wandelt den Inhalt in Kleinbuchstaben um. |
| `%uppercase([...])%` | Wandelt den Inhalt in Großbuchstaben um. |
| `%trim([...])%` | Entfernt führende und nachgestellte Leerzeichen aus dem Inhalt. |
| `%uriencoded([...])%` | Ersetzt seltene Sonderzeichen durch ihre UTF-8-Codierung, zur Verwendung in einer URL. |

Außerdem stehen Verschlüsselungsfunktionen zur Verfügung:

| Funktion | Erwartete Parameter |
|---|---|
| `%sha256([...])%` | Die zu hashenden Daten (SHA-256). |
| `%md5([...])%` | Die zu hashenden Daten (MD5). |
| `%hmacmd5([...])%` | Zwei Parameter: die zu verschlüsselnden Daten, dann der Verschlüsselungsschlüssel. |
| `%rsa([...])%` | Zwei Parameter: der öffentliche Schlüssel, dann die zu verschlüsselnden Daten. |
| `%rsaoaep([...])%` | Zwei Parameter: der öffentliche Schlüssel im PEM-Format, dann die zu verschlüsselnde Zeichenfolge. |
| `%reqresult([...])%` | Die Ordnungsnummer der Anfrage, deren Ergebnis wiederverwendet werden soll, und optional der Name des Schlüssels, der ausgewählt werden soll, wenn dieses Ergebnis mehrere Parameter enthält. |

> **Zwei Schreibkonventionen**
>
> Die Parameter einer Funktion werden durch **`%,%`** getrennt. Um ein wörtliches Prozentzeichen einzugeben, schreiben Sie **`\%`**.

## Speichern

Klicken Sie auf **Validate**, um das Datenelement im aktuellen Preauthentifizierungsschritt hinzuzufügen oder zu aktualisieren. **Cancel** schließt das Fenster ohne zu speichern.
