Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

hiddentrue

...

Answer

A relay state is basically just a token to select a redirect target after successful authentication (i.e., after the SAML/consume URL is called).

The name of the relay state is arbitrary and can be anything (it should contain only letters, no whitespaces).

If a relay state is not found or none is declared, it uses the default target which is:

/classic/priceFxWeb.html?triggerLogin=true&username=USERNAME&partition=PARTITION

So you could set up states like:

localeDE : /classic/priceFxWeb.html?locale=de&triggerLogin=true&username=USERNAME&partition=PARTITION

localeEN: /classic/priceFxWeb.html?locale=en&triggerLogin=true&username=USERNAME&partition=PARTITION

Now you need to add the state name into the login process. Here it depends where it starts.

If you start off the sign-on URL, you just append it to the URL:

..../saml/signon?RelayState=localeDE

If it is IdP triggered, the IdP configuration needs to have that “RelayState=localeDE” in its consume URL.

Info

See also How to Set language and Locale via URL.