Pre-authentication Web SSO request¶
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 de knop + een aanvraag toevoegt. Het venster heeft een hulppictogram dat de hulppagina van de module opent.
Het venster Pre-authentication Web SSO request stelt een beheerder in staat een HTTP-aanvraag te definiëren die de Mediation Controller vóór de laatste authenticatiestap van een Web-SSO-applicatie naar de doelserver moet verzenden. Voor de laatste doorverwijzing naar de applicatieserver wordt een vereenvoudigde variant gebruikt.
Elke aanvraag wordt in de lijst met stappen geïdentificeerd door de URL, de methode en de verzendorde ervan — het is naar die orde dat de vervanging %reqresult()% verwijst die in het gedeelte Bijzondere syntaxis van de waarden is beschreven.
Belangrijkste velden¶
| Veld | Beschrijving |
|---|---|
| URL | URL waaraan automatisch het al bekende adres van de doelserver wordt voorafgegaan (het voorvoegsel wordt voor de weergave afgekapt wanneer de tekenreeks meer dan 100 tekens bevat). In de modus laatste doorverwijzing kan de URL niet worden gewijzigd. |
| Method | Verplicht. Keuzes: GET of POST (standaard). |
| Content type (MIME) | MIME-type van de tekstinhoud van de aanvraag. Standaardwaarde: application/x-www-form-urlencoded. Andere keuzes: application/json, application/xml, text/html, text/plain, text/richtext, text/tab-separated-values. Verborgen en uitgeschakeld in de modus laatste doorverwijzing. |
| Enable cache | Selectievakje, standaard aangevinkt. Verborgen en uitgeschakeld in de modus laatste doorverwijzing. |
| Login parameter | Naam van de parameter die de login moet bevatten. Alleen ingeschakeld wanneer het inhoudstype parameters aanvaardt, dat wil zeggen application/x-www-form-urlencoded. |
| Password parameter | Naam van de parameter die het wachtwoord moet bevatten. Dezelfde regels voor het inschakelen als hierboven. |
| Advanced settings | Selectievakje. Toont of verbergt de tabbladen met de geavanceerde gegevens. Wordt geforceerd wanneer het huidige inhoudstype geen eenvoudige parameters aanvaardt. |
Tabbladen van de geavanceerde instellingen¶
Wanneer Advanced settings is ingeschakeld, verschijnt er een tabbladenpaneel. De zichtbaarheid ervan hangt af van het inhoudstype en van de modus (gewone aanvraag of laatste doorverwijzing).
Zichtbaar bij het wijzigen van de laatste doorverwijzing, of wanneer het inhoudstype parameters aanvaardt (application/x-www-form-urlencoded).
Het bovenste formulier voegt een vermelding toe aan de tabel eronder, waarvan de kolommen Name en Value zijn; wanneer die leeg is, geeft ze No element to display weer. Een pictogram om te verwijderen op elke rij verwijdert de vermelding.
| Veld | Beschrijving |
|---|---|
| Name | Naam van de parameter. |
| Value | Bijbehorende waarde. 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. |
| Disable special syntax | Selectievakje: de waarde wordt dan ongewijzigd overgenomen en de melding over de syntaxis verdwijnt. Vermeldingen die op deze manier zijn toegevoegd, worden cursief weergegeven in de tabel. |
| Handle as JSON data | Selectievakje. De waarde wordt als een JSON-object behandeld. |
| Add | Voegt de vermelding in de tabel in. |
Zichtbaar wanneer niet de laatste doorverwijzing wordt gewijzigd en wanneer het inhoudstype geen eenvoudige parameters aanvaardt (bijvoorbeeld application/json).
| Veld | Beschrijving |
|---|---|
| Content | Tekstvak met meerdere regels, in realtime gesynchroniseerd. Dezelfde melding over de bijzondere syntaxis wordt weergegeven. |
| Disable special syntax | Selectievakje: de inhoud wordt dan ongewijzigd overgenomen. |
Zichtbaar wanneer niet de laatste doorverwijzing wordt gewijzigd.
Het formulier is identiek aan dat van het tabblad Parameters: Name, Value, Disable special syntax, Handle as JSON data, de knop Add, en een tabel met verwijdering per rij.
De knoppen Previous en Next wisselen tussen de zichtbare tabbladen.
Bijzondere syntaxis van de waarden¶
De velden Value (tabbladen Parameters en Headers) en het veld Content aanvaarden vervangingstekenreeksen die bij de uitvoering van het SSO worden vervangen. Dezelfde syntaxis geldt voor de pre-authentication data.
| 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 de aanvraag in de huidige stap van de pre-authenticatie toe te voegen of bij te werken. Cancel sluit het venster zonder op te slaan.
Aanpassing van de hoogte
Het venster past zijn grootte automatisch aan naargelang de modus: kort formulier wanneer Advanced settings is uitgeschakeld of in de modus voor doorverwijzing, hoog formulier wanneer het tabbladenpaneel zichtbaar is.