QuestionPad Visual Elements Frame Design and Element Positioning

10-14 Oracle Fusion Middleware Developers Guide for Oracle Adaptive Access Manager The following methods can be used to get commonly used AuthentiPads: ■ BharosaClientImpl.getInstance.getFullKeyPad... ■ BharosaClientImpl.getInstance.getAlphaNumericKeyPad... ■ BharosaClientImpl.getInstance.getTextPad... ■ BharosaClientImpl.getInstance.getQuestionPad... ■ BharosaClientImpl.getInstance.getPinPad... Each method takes the same set of parameters:

10.6.3 Setting Properties After Getting Authentipad Object

You need to set timestamp, timezone and display only property to the authentipad object that was obtained. The following table shows fields that may need to be set on the AuthentiPad once it is created: Table 10–9 Authentipad: Method Parameters Parameter Description String padName Identifier of the AuthentiPad, used in the HTML as the base name of input fields and JavaScript variables. String frameFile Image path to use for the frame. String backgroundFile Image path to use for the background image. If using OAAM assignment APIs, OAAM stores the users assigned image in the VCryptAuthUser object: String authUser.getSecurityPreferences.getimagePath VCryptLocalizedString captionText A localized string to display as the caption on the AuthentiPad ■ VCryptLocalizedStringString, VCryptLocale ■ VCryptLocalizedStringString, Locale ■ VCryptLocalizedStringString boolean isADACompliant Flag to designate if the AuthentiPad should be rendered with extra text and links for screen readers. boolean hasJS Flag to designate if the user has JavaScript enabled. boolean hasImages Flag to designate if the user has images enabled. Table 10–10 Authentipad: Setting Additional Fields Parameter Description authentiPad.setTimeStampDate timeStamp Sets the timestamp to display on the pad. authentiPad.setTimeZoneTimeZone timeZone Sets the timezone to display on the pad. authentiPad.setDisplayOnlyboolean displayOnly Flag to designate if the pad should be rendered without interactive fields and links. Commonly used to during image registration. authentiPad.setQuestionTextVCryptLocalizedString questionText Used to display question on a QuestionPad. 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.