This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit https://wso2.com/documentation/.

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

This page describes how WSO2 Identity Server can be configured to support localization of its UI:

Configuring Localization for Authentication Endpoints

WSO2 Identity Server provides internationalization support for the web apps (such as authentication endpoint which is in <IS_HOME>/repository/deployment/server/webapps/ directory). The following steps describe how you can configure this:

  1. Navigate to <IS_HOME>/repository/deployment/server/webapps/authenticationendpoint/WEB-INF/classes/org/wso2/carbon/identity/application/authentication/endpoint/i18n/

  2. Take a copy of the Resources.properties file, rename it with the required locale suffix as follows: 
    Ex: For British English: Resources_en_GB.properties
          For French (Standard): Resources_fr.properties

    Refer Web browser language identification codes for more information on required locale suffixes.

  3. Update values while keeping the keys as follows,
    Ex: login=<Value in the required locale>
  4. Save the file.
  5. Go to the browser setting and add the language you configured above.
  6. Restart the server.

    To try out, do the following: 
  1. Open up a browser.
  2. Type the dashboard URL. (If you are running the server in your localhost, the URL is: https://localhost:9443/dashboard/). You will see the login screen having the contents in the configured language.

If you want to have internationalization of error messages coming from authentication-framework/oauth-framework, Follow the below steps:

First, you need to generate a key from the message itself for the i18n, properties file. following steps below:

  1. Get the message "oauthErrorMsg" from URL and do URLDecode 
  2. Base64 Encode the message "oauthErrorMsg"
  3. Replace = with _ in the base64 encoded message

Now look for a value in Resource.properties file with the relevant locale. If a match is found, define a value for the property. Otherwise use add new property entry to the relevant locale based on the Resource file, as explained above. If you don't specify a value for the key obtained after #03, the error message itself will be displayed in the UI, as default.

  • No labels