EAM Customization Guide -...
-
Upload
nguyennguyet -
Category
Documents
-
view
214 -
download
0
Transcript of EAM Customization Guide -...
EAM 9.0.2
Customization Guide
Copyright 2017 One Identity LLC.
ALL RIGHTS RESERVED.This guide contains proprietary information protected by copyright. The software described in this guide is furnished under a software license or nondisclosure agreement. This software may be used or copied only in accordance with the terms of the applicable agreement. No part of this guide may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying and recording for any purpose other than the purchaser’s personal use without the written permission of One Identity LLC .The information in this document is provided in connection with One Identity products. No license, express or implied, by estoppel or otherwise, to any intellectual property right is granted by this document or in connection with the sale of One Identity LLC products. EXCEPT AS SET FORTH IN THE TERMS AND CONDITIONS AS SPECIFIED IN THE LICENSE AGREEMENT FOR THIS PRODUCT, ONE IDENTITY ASSUMES NO LIABILITY WHATSOEVER AND DISCLAIMS ANY EXPRESS, IMPLIED OR STATUTORY WARRANTY RELATING TO ITS PRODUCTS INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. IN NO EVENT SHALL ONE IDENTITY BE LIABLE FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL, PUNITIVE, SPECIAL OR INCIDENTAL DAMAGES (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF PROFITS, BUSINESS INTERRUPTION OR LOSS OF INFORMATION) ARISING OUT OF THE USE OR INABILITY TO USE THIS DOCUMENT, EVEN IF ONE IDENTITY HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. One Identity make no representations or warranties with respect to the accuracy or completeness of the contents of this document and reserves the right to make changes to specifications and product descriptions at any time without notice. One Identity do not make any commitment to update the information contained in this document.If you have any questions regarding your potential use of this material, contact:One Identity LLC.Attn: LEGAL Dept4 Polaris WayAliso Viejo, CA 92656Refer to our Web site (http://www.OneIdentity.com) for regional and international office information.
PatentsOne Identity is proud of our advanced technology. Patents and pending patents may apply to this product. For the most current information about applicable patents for this product, please visit our website at http://www.OneIdentity.com/legal/patents.aspx.
TrademarksOne Identity and the One Identity logo are trademarks and registered trademarks of One Identity LLC. in the U.S.A. and other countries. For a complete list of One Identity trademarks, please visit our website at www.OneIdentity.com/legal. All other trademarks are the property of their respective owners.
Legend
WARNING: A WARNING icon indicates a potential for property damage, personal injury, or death.
CAUTION: A CAUTION icon indicates potential damage to hardware or loss of data if instructions are not followed.
IMPORTANT, NOTE, TIP, MOBILE, or VIDEO: An information icon indicates supporting information.
EAM Customization GuideUpdated - December 2017Version - 9.0.2
Contents
Preface 5
Customizing EAM Windows 1
Customizing EAM Bitmaps 1
Changing Banners of EAM Authentication Windows 1
Changing the Banner of the Enterprise SSO "Security Data Collect" Window 2
Customizing the Authentication Screen Tiles (Windows 7/2008 only) 3
Customizing the Banner of the Multi-User Desktop Welcome Screen 3
Customizing EAM Windows for Smart Card Authentication 4
Changing the Smart Card icon 4
Changing the Text Labels 5
Customizing SSO Windows 6
SSO Window/Interaction Types 6
’New Account’ Window 6
’Bad Account’ Window 7
’Change Password’ Window 7
Activating the Customization 8
Managing the HTML Files 9
Placing the Files 9
Naming the Files 9
Organizing the Content of the files 9
Customizing the Windows 10
Removing the "Confirm password" Field from the "New account" Window 10
Informing Users of Password Constraints in the "Change Password"Window for the "Ticket Reservation Manager" Application 11
Customizing Error Messages 12
Localizing and Naming the Message File 13
Encoding the Messages File 14
Managing a Cache 14
Customizing the Data Displayed on the Desktop (Cluster and Multi-User Desktop) 16
EAM 9.0.2 Customization Guide 3
Customizing the Question Display for the SSPR 17
Customizing the PDF Report Graphic Style 20
Customizing the EAM Portal 24
Hiding EAM Portal Features 24
Adding an Additional Security Control (Captcha) 26
About us 27
Contacting us 27
Technical support resources 27
EAM 9.0.2 Customization Guide 4
Preface
SubjectThis guide describes how to use the Primary account, Access to applications and Self Enrollment menus of the Enterprise Access Management (EAM) portal.
Audience
This guide is intended for:
l System Integrators.
l Administrators.
Required Software
EAM 9.0 evolution 2 and later versions. For more information about the versions of the required operating systems and software solutions quoted in this guide, please refer to One Identity EAM Release Notes.
Typographical Conven-tions
Bold Indicates:
l Interface objects, such as menu names, buttons, icons and labels.
l File, folder and path names.
l Keywords to which particular attention must be paid. Italics - Indicates references to other guides.
Code - Indicates portions of program codes, command lines or messages displayed in command windows.
CAPITALIZATI ON Indicates specific objects within the application (in addition to standard capitalization rules).
< > Identifies parameters to be supplied by the user.
Legend
WARNING: A WARNING icon indicates a potential for property damage, personal injury, or death.
CAUTION: A CAUTION icon indicates potential damage to hardware or loss of data if instructions are not followed.
IMPORTANT, NOTE, TIP, MOBILE, or VIDEO: An information icon indicates supporting information.
Documentation support
The information contained in this document is subject to change without notice. As our products are continuously enhanced, certain pieces of information in this guide can be incorrect. Send us your comments or suggestions regarding the documentation on the One Identity support website.
EAM 9.0.2 Customization Guide
Preface5
1
Customizing EAM Windows
Customizing EAM Bitmaps
One Identity EAM allows you to easily customize bitmaps that are displayed in EAM windows. You can change:
l The banners displayed in EAM authentication windows.
l The banner that appears when Enterprise SSO needs to collect users security data.
l The bitmaps displayed in the authentication screen tiles (Windows 7/2008 only).
l The banner that appears when the Multi-User Desktop Welcome screen is displayed in fullscreen mode.
Changing Banners of EAM Authentication Windows
1. Modify or create a bitmap file (.bmp) that fits the following requirements:
l Width: 700 px (centered on the middle 500 pixels).
l Height: 72 px.
l Name: WGLogo.bmp.
2. Copy this file in the installation directory of your EAM software module (preferably in C:\Program Files\One Identity\Enterprise SSO to modify the Enterprise SSO authentication window banner).
The new banner appears in the authentication window, as in the following example:
EAM 9.0.2 Customization Guide
Customizing EAM Windows1
Changing the Banner of the Enterprise SSO "Security Data Collect" Window
1. Modify or create a bitmap file (.bmp) that fits the following requirements:
l Width: 360 px.
l Height: 34 px.
l Name: ssobanner16M.bmp (24/32 bit colors) or ssobanner256.bmp (256 colors).
2. Copy this file in the installation directory of your Enterprise SSO software module (preferably in C:\Program Files\One Identity\Enterprise SSO).
When the Security Data Collect window appears, the new banner is displayed:
EAM 9.0.2 Customization Guide
Customizing EAM Windows2
Customizing the Authentication Screen Tiles (Windows 7/2008 only)
In the Authentication Manager installation folder (by default: C:\Program Files\One Identity\Enterprise SSO), create the following bitmaps, with the size of 96x96 pixels:
l ESSOBioCredProv.bmp: the icon displayed for the biometric tile.
l ESSOBioCredProvActive.bmp: the icon displayed when the biometric tile is selected or selectable.
l ESSOCredProv.bmp: the icon displayed in the initial authentication screen for the smart card tile when no smart card is inserted.
l ESSOCredProvActive.bmp: the icon displayed when the smart card tile is selected or selectable.
l ESSOMobileCredProv.bmp: the icon displayed for the QRentry tile.
l ESSOMobileCredProvActive.bmp: the icon displayed when the QRentry tile is selected or selectable.
l ESSOPwdCredProv.bmp: the icon displayed for the password tile.
l ESSOPwdCredProvActive.bmp: the icon displayed when the password tile is selected or selectable.
l ESSOResetSecretCredProv.bmp: the icon displayed for the SSPR tile.
l ESSORFIDCredProv.bmp: the icon displayed for the RFID tile.
l ESSORFIDCredProvActive.bmp: the icon displayed when the RFID tile is selected or selectable.
Customizing the Banner of the Multi-User Desktop Welcome Screen
NOTE: This banner appears only when the Multi-User Desktop welcome screen is displayed in fullscreen mode.
In the EAM installation folder (by default: C:\Program Files\One Identity\Enterprise SSO), create a new FUSBanner image file with the following guidelines:
l Maximum recommended size: 850 x 240 pixels.
l Supported file extension: .bmp.
EAM 9.0.2 Customization Guide
Customizing EAM Windows3
Customizing EAM Windows for Smart Card Authentication
One Identity EAM allows you to easily customize icons and text labels that are displayed in Authentication Manager and Enterprise SSO windows. This customization is only available for Smart Card authentication. You can change:
l The icons of the different states of the Smart Card displayed in EAM authentication windows.
l The text labels (Login, PIN and Log on to) displayed in EAM authentication windows.
Changing the Smart Card icon
1. Modify or create an icon file (.ico) that fits the following requirements:
l Width x height: 16 px.
l Icons and names:
l : BlankToken.ico.
l : ErrorToken.ico.
l : ReadyToken.ico.
2. Copy this file in the installation directory of your EAM software module (preferably in C:\Program Files\One Identity\Enterprise SSO).
The new smart card icon appears in the authentication window, as in the following example:
EAM 9.0.2 Customization Guide
Customizing EAM Windows4
Changing the Text Labels
1. Create the following registry keys under HKEY_LOCAL_MACHINE\SOFTWARE\Enatel\WiseGuard\FrameWork\Authentication:
Key Name Type Description
UserLabel REG_SZ Changes the value of Login.
UserLabelToken REG_SZ Changes the value of Login when the Smart Card authentication method is selected.
SecretLabel REG_SZ Changes the value of PIN.Note: the modification is enabled only for smart card authentication.
LogOnToLabel REG_SZ Changes the value of Log on to.
NOTE:These keys can be deployed by GPO.
The new labels appear in the authentication window, as in the following example:
EAM 9.0.2 Customization Guide
Customizing EAM Windows5
Customizing SSO Windows
Subject
You can change the appearance of certain Enterprise SSO windows that are displayed to users on Microsoft Windows workstations.
Description
By using the data-input capabilities of HTML and CSS, you can change the design and layout of E-SSO windows.
The windows are the ones which allow users to:
l Register a user name and a password for a managed application: new account window, see ’New Account’ Window.
l Change a user name or password that has been rejected by an application: bad account window, see ’Bad Account’ Window.
l Change the password registered for an application: change password window, see ’Change Password’ Window.
When this feature is activated, customized window definitions replace the standard window definitions for these three interactions: see Activating the Customization.
Default definitions can be created for each of the interaction types. Individualized window definitions can also be created for interactions related to particular applications.
Each customized window is defined by the contents of an HTML file on the hard disk of the user's workstation: see Managing the HTML Files.
Examples of SSO Window customization are available in Customizing the Windows.
SSO Window/Interaction Types
’New Account’ Window
Enterprise SSO opens the new account window when it detects a login window of an application for which the user has no registered account.
The window can also be opened directly by the user from the Enterprise SSO window.
EAM 9.0.2 Customization Guide
Customizing EAM Windows6
The window prompts the user to select an account, a login name and a password for the application. The login and password must match those that are already recorded in the application itself.
Enterprise SSO can set an initial value for one or more of these elements and can prevent the user from changing one or more of the values.
’Bad Account’ Window
Enterprise SSO opens the bad account window when it detects that an application has rejected a registered login or password.
The window prompts the user to register a new login and/or password for the application. These must match the values already recorded in the application.
’Change Password’ Window
Enterprise SSO opens the change password window when it detects that an application has requested a password change. This request can be triggered by one of the following actors:
EAM 9.0.2 Customization Guide
Customizing EAM Windows7
l The application itself.
l The user.
l Enterprise SSO.
The window prompts the user to register a new password for the application.
Activating the Customization
Subject
When this feature is activated, Enterprise SSO looks for definitions of supported window types in HTML files.
When, during an interaction with the user, Enterprise SSO cannot find or cannot read the appropriate file, or if the contents of the file do not meet Enterprise SSO requirements (see Organizing the Content of the files), Enterprise SSO uses the appropriate standard window instead, as if the customization feature were not activated.
Procedure
1. Place the UseHtmlSSODialogs DWORD value:
l With GPO under the HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Enatel\SSOWatch\CommonConfig Windows registry key.
l Manually under the HKEY_LOCAL_MACHINE\SOFTWARE\Enatel\SSOWatch\CommonConfig key.
2. Set the value to 1.
The customization is activated.
NOTE: To deactivate customization, set the value to 0.
EAM 9.0.2 Customization Guide
Customizing EAM Windows8
Managing the HTML Files
Placing the Files
When the customization feature is activated, Enterprise SSO tries to load window definition files from a directory on the local hard disk.
By default, Enterprise SSO tries to load files from its current working directory, i.e. the directory in which Enterprise SSO is installed. However the directory can be specified explicitly by creating a new string value, called HtmlDialogDirectory, in the Windows Registry. This value can be set under the same keys as the UseHtmlSSODialogs value: see the Procedure in Activating the Customization.
If you set this value, it must be the full path name of a directory on the workstation's local hard disk.
Naming the Files
The default file names used by Enterprise SSO for the three interactions described in SSO Window/Interaction Types are the following:
l NewAccount.html
l BadAccount.html
l ChangePassword.html
However, each time one of these interactions occurs, it occurs in the context of a particular managed application.
If a file exists and its name starts with the name of the E-SSO application object, continues with a '-' character and ends with the default file name; this file is used to define the window for the interaction. That is, if Enterprise SSO manages a user's access to an application called Supply Management, it tries to load a file called Supply Management-NewAccount.html when collecting the user name and password from the user.
If this file does not exist, Enterprise SSO tries to load a file called NewAccount.html. This means that it is possible, for example, to have two files for password-change interactions: a file called Supply Management-ChangePassword.html to be used to change passwords in the Supply Management application and the ChangePassword.html file to be used to change passwords in all other applications.
Organizing the Content of the files
The window definition files are normal HTML files that contain the information Enterprise SSO needs to display each window.
EAM 9.0.2 Customization Guide
Customizing EAM Windows9
Enterprise SSO identifies HTML elements in the document using pre-defined values of the HTML id attribute and exchanges data with the user through these elements. For each window type, certain elements must be defined while others are optional.
The files also specify the window size and title. Windows are not resizable by the user and do not have scroll bars.
For full details of these requirements, see the example window definition files which can be found in the Enterprise SSO installation directory. These define windows for a fictitious application called Example.
Customizing the Windows
Subject
The following examples illustrate the customization of SSO Windows.
Prerequisite
If the customization feature is not already activated, activate it as explained in Activating the Customization.
Restriction
If a collection window is customized, then the parameters are taken into account in a second collection window displayed after the first one.
Removing the "Confirm password" Field from the "New account" Window
Description
The SSO dialog window customization feature supports the presence and the absence of a Confirm password field.
If the field is present, Enterprise SSO checks that the user has typed the same value into the Password and Confirm password fields when validating the new account data. If it is absent, the user only has to type the password once but there is a higher chance of typing the wrong password.
Procedure
1. In the Enterprise SSO installation directory, make a copy of the Example-NewAccount.html file and name the new file NewAccount.html.
2. Open the new file with a text or HTML editor.
3. Find and delete the following HTML elements with the:
EAM 9.0.2 Customization Guide
Customizing EAM Windows10
l sso-pass-confirm id.
l Confirm password text.
4. Save the modified file.
If there are no other new account window definition files for individual applications, all new account interactions now use the new window definition file that has no Confirm password field.
Informing Users of Password Constraints in the "Change Password"Window for the "Ticket Reservation Manager" Application
Description
This informs users of Ticket Reservation Manager that passwords must contain at least three numeric characters.
Procedure
1. In the Enterprise SSO installation directory, make a copy of the Example-ChangePassword.html file and name the new file Ticket Reservation Manager-ChangePassword.html.
2. Open the new file with a text or HTML editor.
3. Find the div element containing the sso-app-name element.
4. After this element, insert a new div or p element containing the following text: The password must contain at least three numeric characters.
5. Find the CSS style rule that specifies the height property for the body element and increase the height value to accommodate the new text.
6. Save the modified file.
This new window definition is now used when the user changes the password for Ticket Reservation Manager.
EAM 9.0.2 Customization Guide
Customizing EAM Windows11
2
Customizing Error Messages
Subject
You can customize error messages thanks to a file containing these messages.
Description
The file is filled-in by the E-SSO administrator with one message per line, such as: <message number><Tab><message text>.Example: 0x82002015 <tab> this is the customized text!
However, you can associate one message with several error codes, such as:<first message number>-<last message number><Tab><message text>.
Moreover, you can write a message text on several lines in the file (this will make the file easier to build and read rather than using \n in the text message). In that case, the syntax of the first line does not change. The next lines must follow this syntax: \+<rest of the text>.
Example:0x82002001-0x8200208F Authentication error!\+--Access is denied.
For more information on error codes, refer to One Identity EAM Console - Guide de l'administrateur.
Pre-requisites
The following conditions are mandatory:
l The customized message files cannot contain message numbers that are unknown to EAM.
l The customized messages files must be encoded with ANSI characters.
l The text of the message is separated from its number by a tab character.
l Each line that does not correspond to this format is ignored.
l Each line starting with // is considered as a comment.
l The text of the message can contain \t (tabulation) and \n (carriage return) characters for the display.
EAM 9.0.2 Customization Guide
Customizing Error Messages12
NOTE: If the customized text of the message number cannot be retrieved from the file, the default message corresponding to the resource is used.
Localizing and Naming the Message File
Subject
To define the message file, you must set:
l Registry values in one of the following registry keys:
l With GPO: HKEY_LOCAL_MACHINE\\Software\\Enatel\\Wiseguard\\Framework\\Config
l Locally: HKEY_LOCAL_MACHINE\\Software\\Policies\\Enatel\\Wiseguard\\Framework\\Config
l The MessageFileUsed value to 1 to activate the customized message file.
Description
There are two cases to localize and name the message file. When you have:
l No predefined language: set the EssoMessageFilePath value containing the full pathname of the message file such as C:\folder\file.txt.
l One file per language: the message file is created by the administrator in the E-SSO installation directory. The file must be located in the folder set in one of the following registry keys:
l InstallDirectory. OR
l EssoMessage file Path
The search order of a message file is as follows (.<le> is the language extension):
1. An ESSOMessageFile.<le> file in the directory indicated by FrameWork\Config\InstallDirectory
2. The file indicated by FrameWork\Config\ESSOMessageFilePath
3. An ESSOMessageFile.<le> file in the repository indicated by FrameWork\Config\ESSOMessageFileInstallDir
4. An ESSOMessageFile.<le> file in the application’s current directory.
The <language extension> is the Windows number (two-digit hexadecimal value: 09, 0C, 01...) corresponding to the E-SSO installation language.
The following <language extension> list is supported:
l 01: Arabic
l 07: German
l 09: English
EAM 9.0.2 Customization Guide
Customizing Error Messages13
l 0A: Spanish
l 0B: Finnish
l 0C: French
l 10: Italian
l 11: Japanese
l 13: Dutch
l 19: Russian
l 1D: Swedish
Encoding the Messages File
The customized messages files must be encoded with ANSI characters. However, you can use files encoded with UTF-8 characters by setting the following registry value: FrameWork\Config\EssoMessageFileUTF8 (REG_DWORD)
The possible values you can set are:
l 0 (default): the message files contain ANSI text strings.
l 1: the message files are UTF-8 encoded.
Managing a Cache
Subject
To display an error message, E-SSO performs a sequential search until it finds the customized message associated with the provided error code. If no customized message is set, the default message is used.
Description
To speed up the search and display of an error message, you can activate the error message caching. When the message caching is activated, E-SSO:
l Loads the contents of the customized message file into the memory.
l Performs an indexed memory search to retrieve a customized message.
l Updates the memory cache when the customized message file is modified.
Procedure
To activate the message caching, set the REG_DWORD EssoMessageCacheUsed registry value to 1 under the E-SSO configuration registry keys.
EAM 9.0.2 Customization Guide
Customizing Error Messages14
EAM 9.0.2 Customization Guide
Customizing Error Messages15
3
Customizing the Data Displayed on the Desktop (Cluster and Multi-
User Desktop)
You can customize the data that appears at the foreground of the user’s desktop on workstations configured to run the Cluster feature or the Multi-User Desktop mode.
For details, see one of the following manuals:
l Cluster feature: Authentication Manager Cluster Administrator’s Guide.
l Multi-User Desktop: One Identity EAM Console - Guide de l'administrateur.
EAM 9.0.2 Customization Guide
Customizing the Data Displayed on the Desktop (Cluster and Multi-User Desktop)
16
4
Customizing the Question Display for the SSPR
Subject
You can customize the way the questions are displayed in the SSPR windows, starting from Windows 7/2008 and onwards.
Description
By default, the questions are displayed in the text fields as follows:
EAM 9.0.2 Customization Guide
Customizing the Question Display for the SSPR17
By setting a registry key, you can display the questions above the text fields as follows:
EAM 9.0.2 Customization Guide
Customizing the Question Display for the SSPR18
Procedure
1. Place the DisplayQuestionsSeparately DWORD value under one of the following registry keys:
l HKLM\SOFTWARE\Enatel\WiseGuard\AdvancedLogin l HKLM\SOFTWARE\Policies\Enatel\WiseGuard\AdvancedLogin(to configure with GPOs).
2. Set the value to 1.
The customization is activated.
EAM 9.0.2 Customization Guide
Customizing the Question Display for the SSPR19
5
Customizing the PDF Report Graphic Style
Subject
In the EAM console, you can create PDF reports (for more information, refer to the One Identity EAM Console - Guide de l'administrateur). If you want to, you can customize the layout of these reports by modifying their graphic style.
Description
You can customize the following elements:
l Logo: to integrate the logo of your enterprise to the PDF reports, copy it in the following directory:C:\Program Files\Common Files\One Identity\IAR\images\logo-company.pngThe size of the logo must be 100(W)x80(H)pixels.
l Styles:
l Chart themes: edit the C:\Program Files\Common Files\One Identity\IAR\styles\DefaultChartTheme.jrctx file.
l Colors and font sizes: edit the C:\Program Files\Common Files\One Identity\IAR\styles\DefaultStyle.jrtx file.
To modify the:
l colors of a style, enter the code corresponding to the desired color in the forecolor, backcolor or linecolor attributes.
l size of the font used by the style, enter the desired size in the fontSize attribute.
Example
<style name="base" isDefault="true" forecolor="#1577B4" fontName="DefaultFont" fontSize="10">
<box topPadding="0" leftPadding="0" bottomPadding="0" rightPadding="0"/>
</style>
EAM 9.0.2 Customization Guide
Customizing the PDF Report Graphic Style20
<style name="title" mode="Opaque" forecolor="#FFFFFF" backcolor="#1577B4" fill="Solid" hAlign="Right" vAlign="Middle" fontName="DefaultFont" fontSize="18" isBold="true">
<box topPadding="2" leftPadding="8" bottomPadding="2" rightPadding="8">
<pen lineColor="#1577B4"/>
<topPen lineColor="#1577B4"/>
<leftPen lineColor="#1577B4"/>
<bottomPen lineColor="#1577B4"/>
<rightPen lineColor="#1577B4"/>
</box>
</style>
Fonts
The font used by the different styles is referenced in each style under DefaultFont. This default font is DéjàVu Sans Serif.
The languages supported by this font are:
Afrikaans Cyrillic Frisian Maltese Turkish
Albanian Czech Galician Norwegian Welsh
Basque Danish German Polish
Belarusian_lacinka
Dutch Greek Portuguese
Bosnian English Hungarian Romanian
Breton Esperanto Icelandic Serbian
Catalan Estonian Italian Slovak
Chamorro Faroese Latvian Slovenian
Chichewa_nyanja Finnish Lithuanian Spanish
Croatian French Malagasy Swedish
If you want to change the default font or if you need to support more languages, you can change it by creating a new JAVA archive (JAR) similar to the one provided by default: DefaultFont.jar located in C:\Program Files\Common Files\One Identity\IAR\bundled-tomcat\IARBase\lib
The content of this file is as follows:
./fonts/fontsfamilyDefaultFont.xml
./jasperreports_extension.properties
./manifest.txt
EAM 9.0.2 Customization Guide
Customizing the PDF Report Graphic Style21
Place the new font in TrueType format (TTF) in the fonts directory of the archive and modify the ./fonts/fontsfamilyDefaultFont.xml file without changing the family font name.
Example
To support japanese, you can do as follows:
1. Extract the delivered JAVA archive in a temporary directory:jar xvf DefaultFont.jar
2. Download a free font supporting this language, or use one for which you have the license. In this example, a free Meiryo TrueType font was downloaded and the related TTF files we set in the extracted fonts directory of the Java archive, such as:
./fonts/Meiryo.ttf
./fonts/fontsfamilyDefaultFont.xml
./jasperreports_extension.properties
./manifest.txt
3. Edit the fontsfamilyDefaultFont.xml file as follows:
<?xml version="1.0" encoding="UTF-8"?>
<fontFamilies>
<fontFamily name="DefaultFont">
<normal><![CDATA[net/sf/jasperreports/fonts/dejavu/DejaVuSans.ttf]]> </normal>
<bold><![CDATA[net/sf/jasperreports/fonts/dejavu/DejaVuSans-Bold.ttf]]></bold>
<italic><![CDATA[net/sf/jasperreports/fonts/dejavu/DejaVuSans-Oblique.ttf]]></italic>
<boldItalic><![CDATA[net/sf/jasperreports/fonts/dejavu/DejaVuSans-BoldOblique.ttf]]></boldItalic>
<pdfEncoding><![CDATA[Identity-H]]></pdfEncoding>
<pdfEmbedded><![CDATA[true]]></pdfEmbedded>
<exportFonts>
<export key="net.sf.jasperreports.rtf"><![CDATA[Serif]]></export>
<export key="net.sf.jasperreports.xhtml"><![CDATA[Serif]]></export>
<export key="net.sf.jasperreports.html"><![CDATA[Serif]]></export>
</exportFonts>
</fontFamily>
</fontFamilies>
EAM 9.0.2 Customization Guide
Customizing the PDF Report Graphic Style22
4. Replace the DefaultFont fontFamily with the following fontFamily definition. Keep the same fontFamily name and replace the location of the TTF font faces files. If you have specific font faces for bold or italic, replace the corresponding lines, or remove them otherwise, as in the default font family above:
<fontFamily name="DefaultFont">
<normal><![CDATA[fonts/Meiryo.ttf]]></normal>
<pdfEncoding><![CDATA[Identity-H]]></pdfEncoding>
<pdfEmbedded><![CDATA[true]]></pdfEmbedded>
<exportFonts>
<export key="net.sf.jasperreports.rtf"><![CDATA[Serif]]></export>
<export key="net.sf.jasperreports.xhtml"><![CDATA[Serif]]></export>
<export key="net.sf.jasperreports.html"><![CDATA[Serif]]></export>
</exportFonts>
</fontFamily>
5. Rebuild the new JAVA archive including the new font:jar cvfm ..\DefaultFontJapanese.jar -m manifest.text fonts/* jasper*
6. Install the new DefaultFontJapanese.jar JAVA archive in C:\Program Files\Common Files\One Identity\IAR\bundled-tomcat\IARBase\lib and remove the DefaultFont.jar after saving it.
7. Restart the I&A Reporting service.
You are ready to generate your reports in japanese.
EAM 9.0.2 Customization Guide
Customizing the PDF Report Graphic Style23
6
Customizing the EAM Portal
Subject
You can customize the EAM portal by hiding some of its features or adding an additional security control (Captcha). For more information on the portal features, refer to the One Identity EAM Portal - Guide de l’utilisateur.
Hiding EAM Portal Features
Subject
You can hide some features of the portal to fit your specific needs.
Location
To hide a feature, you must set a registry value on the Web Server where the portal is installed, under the following registry keys, depending on your OS version:
l 32 bits: HKEY_LOCAL_MACHINE\SOFTWARE\Enatel\WiseGuard\FrameWork\ResetPassword
l 64 bits: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Enatel\WiseGuard\FrameWork\ResetPassword
Description
l Name: HideFeatureName
l Type: REG_DWORD
l Values:
l 0: the feature is displayed.
l 1: the feature is hidden.
Registry Keys
EAM 9.0.2 Customization Guide
Customizing the EAM Portal24
EAM Portal Section
Icon Title Registry Value
Primary account Primary Password Reset HideReset
OTP Password Reset HideResetOTP
Primary Account Unlock HideUnlock
Password Reset data collect
HideCollect
Identification Challenge HideChallenge
Access to applications
Access Delegation HideDelegation
Application Credentials HideReveal
Credentials by e-mail HideSend
Self Enrollment User Self Registration HideUserEnroll
Mobile Device Enrollment
HideQREnroll
EAM 9.0.2 Customization Guide
Customizing the EAM Portal25
Adding an Additional Security Control (Captcha)
Subject
Users can access some features of the EAM portal without having to authenticate. However, to prevent fraudulent access to these features, you can add a Captcha for the user to complete with his login name before he accesses the desired feature.
The following features are concerned:
l Primary Account section:
l Primary Password Reset.
l OTP Password Reset.
l Primary Account Unlock.
l Identification Challenge.
l Access to applications section: Credentials by e-mail.
l Self Enrollment section: User Self Registration.
Location
To activate the Captcha feature, you must set a registry value under the following registry keys, depending on your OS version:
l 32 bits: HKEY_LOCAL_MACHINE\SOFTWARE\Enatel\WiseGuard\FrameWork\ResetPassword
l 64 bits: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Enatel\WiseGuard\FrameWork\ResetPassword
Description
l Name: UseCaptcha
l Type: REG_DWORD
l Values:
l 0: Captcha is deactivated.
l 1: Captcha is activated: the user must enter his login name and the displayed Captcha for identification.
EAM 9.0.2 Customization Guide
Customizing the EAM Portal26
About us
About us
Contacting us
For sales or other inquiries, visit https://www.oneidentity.com/company/contact-us.aspx or call +1-800-306-9329.
Technical support resources
Technical support is available to One Identity customers with a valid maintenance contract and customers who have trial versions. You can access the Support Portal at https://support.oneidentity.com/.
The Support Portal provides self-help tools you can use to solve problems quickly and independently, 24 hours a day, 365 days a year. The Support Portal enables you to:
l Submit and manage a Service Request
l View Knowledge Base articles
l Sign up for product notifications
l Download software and technical documentation
l View how-to-videos
l Engage in community discussions
l Chat with support engineers online
l View services to assist you with your product
EAM 9.0.2 Customization Guide
About us27