Localization Support in Identity Server
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:
- Navigate toÂ
<IS_HOME>/repository/deployment/server/webapps/authenticationendpoint/WEB-INF/classes/org/wso2/carbon/identity/application/authentication/endpoint/i18n/
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.
- Update values while keeping the keys as follows,
Ex:Âlogin=<Value in the required locale>
- Save the file.
- Go to the browser setting and add the language you configured above.
- Restart the server.
To try out, do the following:Â
- Open up a browser.
- 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:
- Get the message "oauthErrorMsg" from URL and do URLDecodeÂ
- Base64 Encode the message "oauthErrorMsg"
- 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.