This chapter contains the following sections:
There is no flag to turn-off localization, but there is a property that captures the locales supported by the deployment. You can use the property to enable one locale.
You would change the locale.enum.XXX.adminSupported and locale.enum.XXX.enabled properties to false for each unwanted locale.
Perform customizations to localized strings in the client resource override file:
Create client_resource_locale.properties
Add property bharosa.config.resourcebundle.clientoverride to client_resource_en.properties. The default value of this property in OAAM Server is client_resource.
By default the file to add custom localized strings to is client_resource_locale.properties.
For example, for English, the file is client_resource_en.properties.
Add customized properties to client_resource_en.properties.
Create OAAM Extension WAR file containing client_resource_en.properties inside of WEB-INF/classes directory
You can configure language defaults in the client_resource_locale.properties file using the bharosa.locale. enum property. For instructions on customizing Oracle Adaptive Access Manager, see Chapter 7, "Using the OAAM Extensions Shared Library to Customize OAAM."
An example of a bharosa.locale. enum is shown below:
bharosa.locale.enum.german=2 bharosa.locale.enum.german.name=German bharosa.locale.enum.german.description=German bharosa.locale.enum.german.language=de bharosa.locale.enum.german.country= bharosa.locale.enum.german.adminSupported=true bharosa.locale.enum.german.enabled=true
To enable the default locale:
Add and set the bharosa.local.enum.locale.enabled properties of the locales you want to support to true.
Add and set the bharosa.local.enum.locale.enabled properties of the locales you do not want to support to false.
Add and set the bharosa.default.locale property to match the bharosa.locale.enum.locale property of your locale.
Note:
The only locales supported are the ones listed in the enums.A German bank wants to set German as the default language and wants to support only German. Follow these steps to configure the client_resource_de.properties:
If the locale enum does not exist, create it:
bharosa.locale.enum.german.enabled=true
If the locale enum already exists, set it to true.
If present, set other bharosa.local.enum.locale.enabled properties to false.
bharosa.locale.enum.italian.enabled=false bharosa.locale.enum.french.enabled=false bharosa.locale.enum.portuguese_br.enabled=false bharosa.locale.enum.spanish.enabled=false bharosa.locale.enum.korean.enabled=false bharosa.locale.enum.chinese_cn.enabled=false bharosa.locale.enum.chinese_tw.enabled=false bharosa.locale.enum.japanese.enabled=false bharosa.locale.enum.arabic.enabled=false bharosa.locale.enum.czech.enabled=false bharosa.locale.enum.danish.enabled=false bharosa.locale.enum.dutch.enabled=false bharosa.locale.enum.finnish.enabled=false bharosa.locale.enum.greek.enabled=false bharosa.locale.enum.hebrew.enabled=false bharosa.locale.enum.hungarian.enabled=false bharosa.locale.enum.norwegian.enabled=false bharosa.locale.enum.polish.enabled=false bharosa.locale.enum.portuguese.enabled=false bharosa.locale.enum.romanian.enabled=false bharosa.locale.enum.russian.enabled=false bharosa.locale.enum.slovak.enabled=false bharosa.locale.enum.swedish.enabled=false bharosa.locale.enum.thai.enabled=false bharosa.locale.enum.turkish.enabled=false
Set bharosa.default.locale property to match the value of the locale enum.
Since bharosa.locale.enum.german=2, set bharosa.default.locale property to 2.
If the property does not exist, create it.
A Brazilian bank wants to set Brazilian Portuguese as the default, but wants to display all the other languages that OAAM Server had been translated to. To configure the setting:
If the locale enum does not exist, create it:
bharosa.locale.enum.pt_br.enabled=true
If the locale enum already exists, set it to true.
Set all other bharosa.local.enum.locale.enabled properties using the Properties Editor to false.
Set bharosa.default.locale property to the value of the locale enum using the Properties Editor.
If bharosa.locale.enum.pt_br=9, set bharosa.default.locale property to 9.
Set bharosa.locale.enum.locale.enabled property in client_resource_locale.properties for all the languages OAAM Server had been translated to and ensure they are set to true.
bharosa.locale.enum.german.enabled=true bharosa.locale.enum.italian.enabled=true bharosa.locale.enum.french.enabled=true bharosa.locale.enum.portuguese_br.enabled=true bharosa.locale.enum.spanish.enabled=true bharosa.locale.enum.korean.enabled=true bharosa.locale.enum.chinese_cn.enabled=true bharosa.locale.enum.chinese_tw.enabled=true bharosa.locale.enum.japanese.enabled=true bharosa.locale.enum.arabic.enabled=true bharosa.locale.enum.czech.enabled=true bharosa.locale.enum.danish.enabled=true bharosa.locale.enum.dutch.enabled=true bharosa.locale.enum.finnish.enabled=true bharosa.locale.enum.greek.enabled=true bharosa.locale.enum.hebrew.enabled=true bharosa.locale.enum.hungarian.enabled=true bharosa.locale.enum.norwegian.enabled=true bharosa.locale.enum.polish.enabled=true bharosa.locale.enum.portuguese.enabled=true bharosa.locale.enum.romanian.enabled=true bharosa.locale.enum.russian.enabled=true bharosa.locale.enum.slovak.enabled=true bharosa.locale.enum.swedish.enabled=true bharosa.locale.enum.thai.enabled=true bharosa.locale.enum.turkish.enabled=true
Set bharosa.default.locale property in client_resource_locale.properties to 9.
A French bank wants clients to see French as a default, and wants to support only French, German, English, and Italian. The French locale enum is already present in the client_resource_fr.properties file.
bharosa.locale.enum.french=5 bharosa.locale.enum.french.name=French bharosa.locale.enum.french.description=French bharosa.locale.enum.french.language=fr bharosa.locale.enum.french.country= bharosa.locale.enum.french.adminSupported=true bharosa.locale.enum.french.enabled=true
To configure the application:
In client_resource_fr.properties set bharosa.locale.enum.locale.enabled to true for German, Italian, and English.
bharosa.locale.enum.german.enabled=true bharosa.locale.enum.italian.enabled=true bharosa.locale.enum.english.enabled=true
Set all other bharosa.local.enum.locale.enabled properties to false.
Set bharosa.default.locale property to the value of the locale enum.
Since bharosa.locale.enum.french=5, set bharosa.default.locale property to 5.
A German bank wants to set English as the default language and wants to support all other languages. To do this, follow these steps for client_resource_de.properties:
If the locale enum does not exist, create it:
bharosa.locale.enum.english.enabled=true
If the locale enum already exists, set it to true.
If present, set other bharosa.local.enum.locale.enabled properties to true.
bharosa.locale.enum.italian.enabled=true bharosa.locale.enum.german.enabled=true bharosa.locale.enum.french.enabled=true bharosa.locale.enum.portuguese_br.enabled=true bharosa.locale.enum.spanish.enabled=true bharosa.locale.enum.korean.enabled=true bharosa.locale.enum.chinese_cn.enabled=true bharosa.locale.enum.chinese_tw.enabled=true bharosa.locale.enum.japanese.enabled=true bharosa.locale.enum.arabic.enabled=true bharosa.locale.enum.czech.enabled=true bharosa.locale.enum.danish.enabled=true bharosa.locale.enum.dutch.enabled=true bharosa.locale.enum.finnish.enabled=true bharosa.locale.enum.greek.enabled=true bharosa.locale.enum.hebrew.enabled=true bharosa.locale.enum.hungarian.enabled=true bharosa.locale.enum.norwegian.enabled=true bharosa.locale.enum.polish.enabled=true bharosa.locale.enum.portuguese.enabled=true bharosa.locale.enum.romanian.enabled=true bharosa.locale.enum.russian.enabled=true bharosa.locale.enum.slovak.enabled=true bharosa.locale.enum.swedish.enabled=true bharosa.locale.enum.thai.enabled=true bharosa.locale.enum.turkish.enabled=true
Set bharosa.default.locale property to match the value of the locale enum.
Since bharosa.locale.enum.english=0, set bharosa.default.locale property to 0.
If the property does not exist, create it.
Oracle Adaptive Access Manager supports the concept of "fuzzy logic." Fuzzy logic, in part, relies on preconfigured sets of word equivalents, commonly known as abbreviations.
In the English version of Oracle Adaptive Access Manager, there are several thousand English abbreviations (and equivalences).
In all other languages, it is necessary for the installer to enhance the brief abbreviation files provided. Without additions, the fuzzy logic will be not as effective.
Locale-specific abbreviation files are shipped with OAAM. These files are named bharosa_auth_abbreviation_config_locale.properties where locale is the locale string. For example, the Spanish version of the file is bharosa_auth_abbreviation_config_es.properties.
Changes cannot be made to this file. To customize abbreviations, a new file must be created with a new set of abbreviations. This file takes precedence over the original file and all abbreviations in the original file are ignored.
To localize for one locale (for example, for Japanese only), perform the following steps:
Create one file specific to the locale with the same prefix as the original locale-specific abbreviation file. For example, Abbreviations_ja.properties for Japanese.
Add the file to the OAAM Extensions Shared Library (WEB-INF/classes).
Using OAAM, set the value of property bharosa.authenticator.AbbreviationFileName to that file's absolute path, WEB-INF/classes/Abbreviations_ja.properties in the extensions folder.
If you want customize for multiple locales, perform the following steps:
Create the files specific to those locales with the same prefix as the original locale-specific abbreviation file.
For example,
/mydrive/IDM_ORACLE_HOME/oaam/conf/Abbreviations_es.properties for Spanish
/mydrive/IDM_ORACLE_HOME/oaam/conf/Abbreviations_ja.properties for Japanese
Add the file to the OAAM Extensions Shared Library (WEB-INF/classes).
Using OAAM, set the value of property bharosa.authenticator.AbbreviationFileName to that file's absolute path, WEB-INF/classes/Abbreviations.properties in the extensions folder.
The locale prefix is absent in the value of the property because the locale settings of the end user's browser determine the run-time locale.