diff --git a/customer_portal_jwt_sso_login/README.md b/customer_portal_jwt_sso_login/README.md index 29e3ec3..726b9f3 100644 --- a/customer_portal_jwt_sso_login/README.md +++ b/customer_portal_jwt_sso_login/README.md @@ -29,8 +29,23 @@ policies across their applications on DevRev. this format for the URL: `http://support.devrev.ai//callback/sso?jwt=` -6. **Custom Redirects**: The above redirection URL will take the user to the default landing page of your customer portal. If you need custom redirection, use the `redirect_to` param. This param accepts a relative path after your slug and will redirect the user to the specified path post login. -Example: `http://support.devrev.ai//callback/sso?jwt=&redirect_to=/article/ART-1` will login the user and redirect them to `http://support.devrev.ai//article/ART-1` post login. +6. **Custom Redirects**: The above redirection URL will take the user to the default landing page of your customer portal. If you need custom redirection, use the `redirect_to` param. This param accepts a relative path after your slug and will redirect the user to the specified path post login. + Example: `http://support.devrev.ai//callback/sso?jwt=&redirect_to=/article/ART-1` will login the user and redirect them to `http://support.devrev.ai//article/ART-1` post login. + +7. **Preferred UI Locale**: To render the customer portal in a specific language for the user, use the `ui_locales` param. This param accepts a single locale tag in [BCP-47](https://www.rfc-editor.org/info/bcp47) format (e.g., `en-US`, `fr-FR`, `ja-JP`, `pt-BR`) and sets the portal's UI language for the session initiated by this SSO redirect. + + Example: `http://support.devrev.ai//callback/sso?jwt=&ui_locales=fr-FR` will log the user in and render the customer portal in French. + + `ui_locales` can be combined with `redirect_to`, for example: + `http://support.devrev.ai//callback/sso?jwt=&redirect_to=/article/ART-1&ui_locales=ja-JP` + + > **Note:** Before the portal can honor a locale passed via `ui_locales`, it must be enabled in two places: + > + > 1. **Add the language** to your portal's supported languages from **Settings → Language and Region → Portal Supported Languages**. + > + > 2. **Publish the language** from **Portal Settings**. + > + > Until both steps are completed, the locale will be ignored and the portal will fall back to the default locale configured in portal settings. The same applies to any unsupported or malformed BCP-47 tag. ## The Onetime Token 🛡️ @@ -46,4 +61,4 @@ To bolster security, the one-time token possesses the following key features: 2. **Guaranteed One-Time Exchange**: Upon redirection to the customer portal, the one-time token can be exchanged for an authenticated session on the customer portal only once. Any attempt to reuse the token will result in a denied request, and any previously authenticated sessions associated with that token may be revoked to maintain a high level of security. -With these guidelines, you can ensure the security of your customer interactions with the DevRev platform, protecting their data and maintaining a trusted environment. +With these guidelines, you can ensure the security of your customer interactions with the DevRev platform, protecting their data and maintaining a trusted environment. \ No newline at end of file