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

# Pre-authentication Web SSO request

> **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 die Schaltfläche **+** eine Anfrage hinzufügt. Das Fenster trägt ein Hilfesymbol, das die Hilfeseite des Moduls öffnet.

Das Fenster **Pre-authentication Web SSO request** ermöglicht es einem Administrator, eine **HTTP-Anfrage** zu definieren, die der Mediation Controller vor dem letzten Authentifizierungsschritt einer Web-SSO-Anwendung an den Zielserver senden muss. Für die **letzte Weiterleitung** zum Anwendungsserver wird eine vereinfachte Variante verwendet.

Jede Anfrage wird in der Liste der Schritte durch ihre **URL**, ihre **Methode** und ihre **Sendereihenfolge** identifiziert — auf diese Reihenfolge bezieht sich die in Abschnitt [Spezielle Syntax der Werte](#special-syntax-of-values) beschriebene Ersetzung `%reqresult()%`.

## Hauptfelder

| Feld | Beschreibung |
|---|---|
| **URL** | URL, der automatisch die bereits bekannte Adresse des Zielservers vorangestellt wird (das Präfix wird in der Anzeige abgeschnitten, wenn die Zeichenfolge 100 Zeichen überschreitet). Im Modus **letzte Weiterleitung** kann die URL nicht geändert werden. |
| **Method** | Pflichtfeld. Auswahlmöglichkeiten: **GET** oder **POST** *(Standard)*. |
| **Content type (MIME)** | MIME-Typ des Anfragetextkörpers. Standardwert: `application/x-www-form-urlencoded`. Weitere Auswahlmöglichkeiten: `application/json`, `application/xml`, `text/html`, `text/plain`, `text/richtext`, `text/tab-separated-values`. Im Modus **letzte Weiterleitung** ausgeblendet und deaktiviert. |
| **Enable cache** | Kontrollkästchen, standardmäßig aktiviert. Im Modus **letzte Weiterleitung** ausgeblendet und deaktiviert. |
| **Login parameter** | Name des Parameters, der das Login tragen muss. Nur aktiv, wenn der Inhaltstyp Parameter akzeptiert, also `application/x-www-form-urlencoded`. |
| **Password parameter** | Name des Parameters, der das Passwort tragen muss. Dieselben Aktivierungsregeln wie oben. |
| **Advanced settings** | Kontrollkästchen. Zeigt die Registerkarten mit den erweiterten Daten an oder blendet sie aus. Wird erzwungen, wenn der aktuelle Inhaltstyp keine einfachen Parameter akzeptiert. |

## Registerkarten der erweiterten Einstellungen

Wenn **Advanced settings** aktiviert ist, erscheint ein Registerkartenbereich. Seine Sichtbarkeit hängt vom Inhaltstyp und vom Modus ab (normale Anfrage oder letzte Weiterleitung).

**Parameters**

> Sichtbar beim Bearbeiten der **letzten Weiterleitung** oder wenn der Inhaltstyp Parameter akzeptiert (`application/x-www-form-urlencoded`).
>
> Das obere Formular fügt der darunter liegenden Tabelle einen Eintrag hinzu, deren Spalten **Name** und **Value** sind; ist sie leer, zeigt sie **No element to display** an. Ein Löschsymbol in jeder Zeile entfernt den Eintrag.
>
> | Feld | Beschreibung |
> |---|---|
> | **Name** | Name des Parameters. |
> | **Value** | Zugehöriger Wert. 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: Der Wert wird dann unverändert übernommen, und die Meldung zur Syntax verschwindet. So hinzugefügte Einträge werden in der Tabelle **kursiv** angezeigt. |
> | **Handle as JSON data** | Kontrollkästchen. Der Wert wird als JSON-Objekt behandelt. |
> | **Add** | Fügt den Eintrag in die Tabelle ein. |

**Content**

> Sichtbar, wenn nicht die letzte Weiterleitung bearbeitet wird **und** wenn der Inhaltstyp keine einfachen Parameter akzeptiert (zum Beispiel `application/json`).
>
> | Feld | Beschreibung |
> |---|---|
> | **Content** | Mehrzeiliges Textfeld, in Echtzeit synchronisiert. Es wird dieselbe Meldung zur speziellen Syntax angezeigt. |
> | **Disable special syntax** | Kontrollkästchen: Der Inhalt wird dann unverändert übernommen. |

**Headers**

> Sichtbar, wenn nicht die letzte Weiterleitung bearbeitet wird.
>
> Das Formular ist mit dem der Registerkarte **Parameters** identisch: **Name**, **Value**, **Disable special syntax**, **Handle as JSON data**, die Schaltfläche **Add** und eine Tabelle mit zeilenweisem Löschen.

Die Schaltflächen **Previous** und **Next** wechseln zwischen den sichtbaren Registerkarten.

## Spezielle Syntax der Werte

Die Felder **Value** (Registerkarten **Parameters** und **Headers**) und das Feld **Content** akzeptieren Ersetzungszeichenfolgen, die bei der Ausführung des SSO ersetzt werden. Dieselbe Syntax gilt für die [pre-authentication data](https://docs.cyberelements.io/bastion/4.6/de/Usage/AdminConsoleReference/SsoPreAuthData/).

| 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 die Anfrage im aktuellen Preauthentifizierungsschritt hinzuzufügen oder zu aktualisieren. **Cancel** schließt das Fenster ohne zu speichern.

> **Anpassung der Höhe**
>
> Das Fenster wird je nach Modus automatisch angepasst: kurzes Formular, wenn **Advanced settings** deaktiviert ist oder im Weiterleitungsmodus, hohes Formular, wenn der Registerkartenbereich sichtbar ist.
