KeyPad Visual Elements Frame Design and Element Positioning

Using Virtual Authentication Devices 10-15

10.6.4 Displaying Virtual Authentication Devices

VADs are rendered in an HTML page. Any page that is to render a VAD must include the bharosa_pad.js JavaScript file. The bharosa_pad.js file is a JavaScript library for rendering VADs and handling user interaction. To get the HTML JavaScript render string to be placed into an HTML page, call authentiPad.getHTML. The output of this method, will be an HTML string containing required image maps and JavaScript constructors required to display the VAD. Once rendered, the VAD will make a request for the image to be displayed. The URL used to render the image is configured by the property: bharosa.authentipad.image.url.

10.7 Enabling Accessible Versions of Authenticators

Users who access using assistive techniques will need to use the accessible versions of the virtual authentication devices. Accessible versions of the TextPad, QuestionPad, KeyPad and PinPad are not enabled by default. If accessible versions are needed in a deployment, they can be enabled via properties. The accessible versions of the pads contain tabbing, directions and ALT text necessary for navigation via screen reader and other assistive technologies. To enable these versions, set the is ADA compliant flag to true. For native integration the property to control the pads is desertref.authentipad.isADACompliant For UIO, the property to control the pads is bharosa.uio.default.authentipad.is_ada_compliant

10.8 Localizing Virtual Authentication Device in OAAM 11g

This section contains the following topics: ■ Overview ■ Example using German Locale

10.8.1 Overview

The process is as follows: 1. Create the client_resource_locale.properties file with virtual authentication device related properties and save it in the temp-folderWEB-INFclasses folder. 2. Add the custom keyset related enum properties to bharosa_ server.properties and save it in the temp-folderWEB-INFclasses folder. Refer to the rest of the chapter for more information on defining keysets and other virtual authentication device properties. 3. Add key image files to temp-folderWEB-INFclassesbharosa_ propertiesalphapad_skins_locale. 4. Add Frame Image Files: temp-folderWEB-INFclassesbharosa_ propertiesalphapad_bg. 10-16 Oracle Fusion Middleware Developers Guide for Oracle Adaptive Access Manager 5. Create OAAM Extensions Shared Library using client_resource_ locale.properties and bharosa_server.properties. 6. Deploy the custom OAAM Extensions Shared Library into both the OAAM Managed Servers OAAM Admin and OAAM Server. 7. Test the localized keypads.

10.8.2 Example using German Locale

An example of localizing the pads in German is shown below: 1. Unzip the OAAM Extensions shared library war file into a temp directory temp-folder. 2. Create client_resource_de.properties in temp-folderWEB-INFclasses if not already present 3. Add these in client_resource_de.properties Keyset to use for German locale bharosa.authentipad.keypad.default.keyset=german Caption Coordinates for new German Pad bharosa.authentipad.keypad.caption.y = 330 bharosa.authentipad.keypad.caption.frame = false bharosa.authentipad.keypad.caption.wrap = false bharosa.authentipad.keypad.caption.width = 130 bharosa.authentipad.keypad.caption.height = 16 bharosa.authentipad.keypad.caption.font.name = Arial bharosa.authentipad.keypad.caption.font.color = 000000 bharosa.authentipad.keypad.caption.font.type= 0 bharosa.authentipad.keypad.caption.font.size = 9 Frame files to use for new German Pad bharosa.authentipad.keypad.frame.file=alphapad_bgkp_frame_O3.png bharosa.authentipad.keypad.sample.frame.file=alphapad_bgkp_frame_O3.png bharosa.uio.default.register.DeviceKeyPadFull.frame = alphapad_bgkp_frame_ O3.png bharosa.uio.default.userpreferences.DeviceKeyPadFull.frame = alphapad_bgkp_ frame_O3.png Skins directory containing German key images bharosa.authentipad.keypad.skins.dirlist=alphapad_skins_desquare Timestamp Coordinates for new German Pad bharosa.authentipad.keypad.timestamp.y = 330 bharosa.authentipad.keypad.timestamp.width = 132 bharosa.authentipad.keypad.timestamp.height = 16 bharosa.authentipad.keypad.timestamp.frame = false bharosa.authentipad.keypad.timestamp.wrap = false bharosa.authentipad.keypad.timestamp.font.name = Arial bharosa.authentipad.keypad.timestamp.font.color = ffffff bharosa.authentipad.keypad.timestamp.font.type= 0 bharosa.authentipad.keypad.timestamp.font.size = 9 4. Create bharosa_server.properties in temp-folderWEB-INFclasses if not already present. German Full Keypad Keyset