PinPad Visual Elements Frame Design and Element Positioning

Using Virtual Authentication Devices 10-13 bharosa.authentipad.keypad.capslock.capsshiftimg=kp_v2_first_caps.jpg

10.5.7 Customization Steps

The process is as follows: 1. Add virtual authentication device related properties and 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. 2. Add key image files to temp-folderWEB-INFclassesbharosa_ propertiespad_skins. 3. Add Frame Image Files: temp-folderWEB-INFclassesbharosa_ propertiespad_bg. 4. Create OAAM Extensions Shared Library using bharosa_server.properties. 5. Deploy the custom OAAM Extensions Shared Library into both the OAAM Managed Servers OAAM Admin and OAAM Server. a. Re-Jar the war using the command: jar -cvfm oracle.oaam.extensions.war temp-folderMETA-INFMANIFEST.MF -C temp-folder

b. Re-deploy the updated oracle.oaam.extensions.war as a shared library

with targets as oaam_server and oaam_admin.

6. Restart OAAM Servers and validate your changes by accessing application.

10.6 Displaying Virtual Authentication Devices

This section describes the flow to render virtual authentication devices. It contains the following topics: ■ Setting Up Before Calling the getpad type Method ■ Getting the AuthentiPads ■ Setting Properties After Getting Authentipad Object ■ Displaying Virtual Authentication Devices

10.6.1 Setting Up Before Calling the getpad type Method

In order to get the bgFile, you need to obtain it from the user by performing: String bgFile = String authUser.getSecurityPreferences.getimagePath;

10.6.2 Getting the AuthentiPads

The main API that handles authentipad generation is BharosaClientImpl.getInstance.getpad type. Note: Make sure original MANIFEST.MF remains same as that contains shared library information. 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.