Pre-authentication Web SSO request

Internt vindu i Applications-modulen

Dette vinduet nås fra modulen Applications, på en applikasjon der tjenestetypen er Web og der SSO type er Pre-authentication: knappen Configure pre-authentication steps åpner listen over trinn, der knappen + legger til en forespørsel. Vinduet har et hjelpeikon som åpner hjelpesiden for modulen.

Vinduet Pre-authentication Web SSO request gjør det mulig for en administrator å definere en HTTP-forespørsel som Mediation Controller må sende til målserveren før det siste autentiseringstrinnet i en Web SSO-applikasjon. En forenklet variant brukes til den siste videresendingen til applikasjonsserveren.

Hver forespørsel identifiseres i listen over trinn ved sin URL, sin metode og sin sendingsrekkefølge — det er denne rekkefølgen erstatningen %reqresult()% som er beskrevet i avsnittet Spesiell syntaks for verdier, viser til.

Hovedfelt

Felt	Beskrivelse
URL	URL som automatisk får adressen til målserveren som allerede er kjent, som prefiks (prefikset avkortes i visningen når strengen overstiger 100 tegn). I modusen siste videresending kan URL-en ikke redigeres.
Method	Obligatorisk. Valg: GET eller POST (standard).
Content type (MIME)	MIME-typen til meldingsteksten i forespørselen. Standardverdi: application/x-www-form-urlencoded. Andre valg: application/json, application/xml, text/html, text/plain, text/richtext, text/tab-separated-values. Skjult og deaktivert i modusen siste videresending.
Enable cache	Avmerkingsboks, avmerket som standard. Skjult og deaktivert i modusen siste videresending.
Login parameter	Navnet på parameteren som må inneholde påloggingen. Bare aktivt når innholdstypen godtar parametere, det vil si application/x-www-form-urlencoded.
Password parameter	Navnet på parameteren som må inneholde passordet. Samme regler for aktivering som ovenfor.
Advanced settings	Avmerkingsboks. Viser eller skjuler fanene med de avanserte dataene. Slås på med tvang når den gjeldende innholdstypen ikke godtar enkle parametere.

Faner for avanserte innstillinger

Når Advanced settings er slått på, vises et faneområde. Synligheten avhenger av innholdstypen og av modusen (vanlig forespørsel eller siste videresending).

ParametersContentHeaders

Synlig når den siste videresendingen redigeres, eller når innholdstypen godtar parametere (application/x-www-form-urlencoded).

Skjemaet øverst legger en oppføring til tabellen under, med kolonnene Name og Value; når den er tom, viser den No element to display. Et sletteikon på hver rad fjerner oppføringen.

Felt	Beskrivelse
Name	Navnet på parameteren.
Value	Tilhørende verdi. En melding under feltet minner om at This field follows a special syntax. Please consult the help page for more informations. Se avsnittet Spesiell syntaks for verdier.
Disable special syntax	Avmerkingsboks: verdien tas da som den er, og meldingen om syntaksen forsvinner. Oppføringer som legges til på denne måten, vises i kursiv i tabellen.
Handle as JSON data	Avmerkingsboks. Verdien behandles som et JSON-objekt.
Add	Setter oppføringen inn i tabellen.

Synlig når det ikke er den siste videresendingen som redigeres, og når innholdstypen ikke godtar enkle parametere (application/json, for eksempel).

Felt	Beskrivelse
Content	Tekstfelt over flere linjer, synkronisert i sanntid. Den samme meldingen om spesiell syntaks vises.
Disable special syntax	Avmerkingsboks: innholdet tas da som det er.

Synlig når det ikke er den siste videresendingen som redigeres.

Skjemaet er identisk med det i fanen Parameters: Name, Value, Disable special syntax, Handle as JSON data, knappen Add, og en tabell med sletting per rad.

Knappene Previous og Next flytter mellom de synlige fanene.

Spesiell syntaks for verdier

Feltene Value (fanene Parameters og Headers) og feltet Content godtar erstatningsstrenger som byttes ut når SSO kjøres. Den samme syntaksen gjelder for pre-authentication data.

Erstatning	Virkning
%user%	Påloggingen som skal brukes til SSO.
%password%	Passordet som skal brukes til SSO.
%base64([...])%	Koder innholdet i parentesene i base 64.
%lowercase([...])%	Gjør innholdet om til små bokstaver.
%uppercase([...])%	Gjør innholdet om til store bokstaver.
%trim([...])%	Fjerner mellomrom foran og etter innholdet.
%uriencoded([...])%	Erstatter uvanlige spesialtegn med UTF-8-kodingen deres, for bruk i en URL.

Krypteringsfunksjoner er også tilgjengelige:

Funksjon	Forventede parametere
%sha256([...])%	Dataene som skal hashes (SHA-256).
%md5([...])%	Dataene som skal hashes (MD5).
%hmacmd5([...])%	To parametere: dataene som skal krypteres, deretter krypteringsnøkkelen.
%rsa([...])%	To parametere: den offentlige nøkkelen, deretter dataene som skal krypteres.
%rsaoaep([...])%	To parametere: den offentlige nøkkelen i PEM-format, deretter strengen som skal krypteres.
%reqresult([...])%	Rekkefølgenummeret til forespørselen som resultatet skal gjenbrukes fra, og eventuelt navnet på nøkkelen som skal velges når dette resultatet inneholder flere parametere.

To skrivekonvensjoner

Parametrene til en funksjon skilles med %,%. For å skrive inn et bokstavelig prosenttegn skriver du \%.

Lagring

Klikk på Validate for å legge til eller oppdatere forespørselen i det gjeldende forhåndsautentiseringstrinnet. Cancel lukker vinduet uten å lagre.

Tilpasning av høyden

Vinduet endrer størrelse automatisk avhengig av modusen: kort skjema når Advanced settings er slått av eller i videresendingsmodus, høyt skjema når faneområdet er synlig.