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
directory). The following steps describe how you can configure this:
- Navigate to
Take a copy of the
Resources.propertiesfile to the same location, rename it with the required locale suffix as follows:
- For British English:
- For French (Standard):
Refer Web browser language identification codes for more information on required locale suffixes.
- For British English:
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 My Account portal URL. (If you are running the server in your
localhost, the URL is:
https://localhost:9443/myaccount/). 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.
Configuring Localization for My Account and Console¶
We maintain the i18n (localization) resources for My Account and the Management Console in a separate module inside the identity-apps repository. Therefoer, the localization configurations should be applied according to the instructions in the README.md file of the same repository. For more information, check the GitHub pull request, which introduced the French language to these applications.Top