Phonetics Oracle Fusion Middleware Online Documentation Library

7-34 Oracle Fusion Middleware Administrators Guide for Oracle Adaptive Access Manager 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 customize abbreviations: 1. Create a new abbreviation file, custom_auth_abbreviation_ config.properties, and save it in the IDM_ORACLE_HOMEoaamconf directory. If the conf folder does not exist, create one. 2. Add abbreviations and equivalences to custom_auth_abbreviation_ config.properties. There are two different formats to use: Word=equivalent1 Word=equivalent2 or Word=equivalent1,equivalent2, equivalent3 For example, in English, some equivalence for James are: Jim=James,\Jamie,\Jimmy With the addition of the equivalences, if a user were to enter a response as Jim, but had originally entered James, Jim would be accepted. Another example is that St may be equivalent to Street. 3. Add the file to the OAAM Extensions Shared Library WEB-INFclasses. 4. Using the Properties Editor, change the property, bharosa.authenticator.AbbreviationFileName, to point to the complete path to the file, WEB-INFclassescustom_auth_abbreviation_ config.properties in the extensions folder. The default value for the property bharosa.authenticator.AbbreviationFileName is bharosa_auth_ abbreviation_config.properties. Create the bharosa.authenticator.AbbreviationFileName property if it does not already exist. Restarting the system is not necessary for the change to take effect. For information on using the Properties Editor, refer to Chapter 28, Using the Properties Editor. . 5. Configure the Answer Logic by following the instructions in Section 7.9, Adjusting Answer Logic. If you want to revert to the original out-of-the-box abbreviations, set bharosa.authenticator.AbbreviationFileName back to bharosa_auth_ abbreviation_config.properties. Note: Retrieval of abbreviation values is not based on the browser language; values are retrieved from the properties files. Managing Knowledge-Based Authentication 7-35

7.11 Customizing Abbreviations and Equivalences for Locales

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. If you want to localize for one locale for example, for Japanese only, perform the following steps: 1. 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. 2. Add the file to the OAAM Extensions Shared Library WEB-INFclasses. 3. Using OAAM, set the value of property bharosa.authenticator.AbbreviationFileName to that files absolute path, WEB-INFclassesAbbreviations_ja.properties in the extensions folder. If you want customize for multiple locales, perform the following steps: 1. Create the files specific to those locales with the same prefix as the original locale-specific abbreviation file. For example, mydriveIDM_ORACLE_HOMEoaamconfAbbreviations_ es.properties for Spanish mydriveIDM_ORACLE_HOMEoaamconfAbbreviations_ ja.properties for Japanese 2. Add the file to the OAAM Extensions Shared Library WEB-INFclasses. 3. Using OAAM, set the value of property bharosa.authenticator.AbbreviationFileName to that files absolute path, WEB-INFclassesAbbreviations.properties in the extensions folder. The locale prefix is absent in the value of the property because the locale settings of the end users browser determine the runtime locale.

7.12 Use Cases

This section describes example use cases for KBA.

7.12.1 Use Case: Create Challenge Question

You have been asked to develop some new challenge questions to augment the existing out-of-the-box questions. Come up with a new question. Directions: Part A: Export the existing challenge questions as a backup. Part B: Create the new question in any category you like in English. 1. Log in to OAAM Admin as an administrator.

2. In the Navigation tree, double-click Questions under KBA. The Questions Search

page is displayed.