Zum Inhalt

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 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).

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.
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.

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.

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.

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.