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
Take a copy of the Resources.properties file, rename it with the required locale suffix as follows:
Ex: For British English:
For French (Standard):
Refer Web browser language identification codes for more information on required locale suffixes.
- Update values while keeping the keys as follows,
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
-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.
Configuring Localization for Recovery Endpoints
Similarly, you can enable localization for accountrecoveryendpoint by applying the same above steps 1 through 7 in the previous section starting with the following location.