Discussion
Pegasystems Inc.
JP
Last activity: 15 Jul 2021 15:27 EDT
How to localize SAML / OIDC logout screen
Hi,
In this post, I am sharing how to localize the labels when you log out in a SAML 2.0 or OpenID Connect authentication environment.
(1):
The logout label on browser tab should be already localized as long as you have language pack installed, but if you want to customize this message, you can override the out-of-the-box pyCaption field value "You have just left PegaRULES" in Pega-EndUserUI_ja:08-01-01 to your custom unauthenticated localization ruleset. In this example, I have created an "Unauthenticated_ja" ruleset.
* In order for your custom localization ruleset to work, you must have set up your primary Unauthenticated ruleset in advance. The name of the ruleset is arbitrary. Update "pega" BROWSER Data-Admin-Requestor to point to it.
- Requestor Type must point to your custom Unauthenticated ruleset.
- Unauthenticated access group must have access to Unauthenticated ruleset.
(2) and (3):
These English messages are hardcoded in an HTML rule "pySAMLLogOffWithoutSLO" in Pega-IntegrationEngine:08-03-01. This HTML rule is not used with regular basic authentication and this is specifically built for SAML 2.0 / OIDC authentication. You can override this rule to your Unauthenticated_ja ruleset as below. Then replace "You are logged out." in line 88 or "Click here to login" in line 95 with your preferred message / language.
Now we are able to see localized / customized labels in three places.
Hope this helps.
Thanks,