Customizing During Installation

To customize the Oracle Universal Authenticator client application during installation, you must create a customization zip file that contains the logo, and properties you want to customize. This zip file will then be passed to the installer in Installing the Client Application.

Before performing customization, administrators should be aware of the following:
  • You can customize any combination of properties you require from Customizable Items.
  • It not customized, all the default values for fields, labels, text, and error messages, will be displayed in the language used by the Microsoft Windows desktop. If you choose to customize, you can create any number of themes for different languages, but the values for the properties you customize must be written in the language required, as customized text will not be translated automatically. For information on languages supported, see Customizable Items.
  • If customizing the logo, it must be bitmap format only (BMP), and have dimensions of 192x192. No other formats or dimensions are supported. Before using the BMP file it is advisable to open it in Microsoft Paint and save the file so it is in the correct format.
To create the customization zip file, perform the following steps:
  1. Create a working directory %CUSTOM_WORKDIR% and navigate to it.
  2. If you want to customize the logo:
    1. Create a %CUSTOM_WORKDIR%\logo directory.
    2. Copy the bitmap file for your logo into the %CUSTOM_WORKDIR%\logo directory, and rename the bitmap file to OUAlogo.bmp.
  3. If you want to customize any other items outlined in Customizable Items, create a themes_<locale>.properties file inside the %CUSTOM_WORKDIR% directory.
    The following shows an example themes_en_US.properties with all properties customized:
    CPFT_TILE_IMAGE = Login with Example Company Username
CPFT_EDIT_TEXT_DEFAULT = Example Company Username
CPFT_PASSWORD_TEXT = Example Company Password
CPFT_SMALL_TEXT = Choose a factor to login:
CPFT_COMMAND_LINK_LOGIN_WITH_PASSWORD = Login with your password
CPFT_COMMAND_LINK_NOT_USER = Click if Not
CPFT_COMMAND_LINK_FORGOT_PASSWORD = Forgot your password?
CPFT_COMMAND_LINK_CHANGE_PASSWORD = Change your password?
CPFT_COMMAND_LINK_SIGN_IN_OPTION = Login with another factor
OUACP_ERR_MSG_0000 = Example Company Universal Authenticator
OUACP_ERR_MSG_0001 = Incorrect Microsoft Windows Credentials, please try again.
OUACP_ERR_MSG_0002 = User access is denied. Please contact your administrator.
OUACP_ERR_MSG_0004 = Did not receive approval from device. Please retry.
OUACP_ERR_MSG_0006 = Password validation failed. Please retry.
OUACP_ERR_MSG_0007 = The system is currently offline. Enter your password to proceed. Not all features will be available. To restore all features, please logout and login again when system is online.
OUACP_ERR_MSG_0008 = The device for this user is blocked. Please contact your administrator.
OUACP_ERR_MSG_0009 = Device is blocked for all users. Please contact your administrator.

    Note:

    Any property you do not customize will use the default value outlined in Customizable Items.
  4. Create any other themes_<locale>.properties for each language you require. The following shows a themes_fr.properties with all properties customized:
    CPFT_TILE_IMAGE = Se connecter avec Example Company Nom d'utilisateur
CPFT_EDIT_TEXT_DEFAULT = Example Company Nom d'utilisateur
CPFT_PASSWORD_TEXT = Example Company Mot de passe
CPFT_SMALL_TEXT = Choisissez un facteur pour vous connecter:
CPFT_COMMAND_LINK_LOGIN_WITH_PASSWORD = Connectez-vous avec votre mot de passe
CPFT_COMMAND_LINK_NOT_USER = Cliquez si non
CPFT_COMMAND_LINK_FORGOT_PASSWORD = Mot de passe oublié?
CPFT_COMMAND_LINK_CHANGE_PASSWORD = Changer votre mot de passe ?
CPFT_COMMAND_LINK_SIGN_IN_OPTION = Se connecter avec un autre facteur
OUACP_ERR_MSG_0000 = Example Company Authentificateur universel
OUACP_ERR_MSG_0001 = Informations d'identification Microsoft Windows incorrectes, veuillez réessayer.
OUACP_ERR_MSG_0002 = L'accès utilisateur est refusé. Veuillez contacter votre administrateur.
OUACP_ERR_MSG_0004 = L'appareil n'a pas approuvé. Veuillez réessayer.
OUACP_ERR_MSG_0006 = Échec de la validation du mot de passe. Veuillez réessayer.
OUACP_ERR_MSG_0007 = Le système est actuellement hors ligne. Saisissez votre mot de passe pour continuer. Certaines fonctionnalités ne seront pas disponibles. Pour restaurer toutes les fonctionnalités, veuillez vous déconnecter et vous reconnecter une fois le système en ligne.
OUACP_ERR_MSG_0008 = L'appareil de cet utilisateur est bloqué. Veuillez contacter votre administrateur.
OUACP_ERR_MSG_0009 = L'appareil est bloqué pour tous les utilisateurs. Veuillez contacter votre administrateur.
  5. Once you have added the themes_<locale>.properties files you require, the directory structure will look similar to the following:
    C:\OUACustomization>dir /s /b /o
C:\OUACustomization\logo
C:\OUACustomization\themes_de.properties
C:\OUACustomization\themes_en_US.properties
C:\OUACustomization\themes_es.properties
C:\OUACustomization\themes_fr.properties
C:\OUACustomization\logo\OUAlogo.bmp
  6. Create a ouacustomization.zip file that contains the contents of the %CUSTOM_WORKDIR% directory.

    Note:

    Do not zip the %CUSTOM_WORKDIR% itself, only zip the contents (the logo directory and themes_<locale>.properties files).
  7. Install the Oracle Universal Authenticator client application using the ouacustomization.zip file. See, Installing the Client Application.