13.7.5 Customizing the Messages for Clients

You can customize the error messages, method message and prompt message specific to any authentication method that is displayed on endpoints such as Windows, Linux PAM, and Mac OS Clients.

To customize the message for clients, perform the following steps:

  1. Copy the aucore.custom.zip custom localization file from one of the following path based on the Client:

    • Windows: C:\Program Files\NetIQ\Windows Client\locale\

    • Linux PAM: /opt/pam_aucore/locale/

    • Mac OS X: Library/Security/SecurityAgentPlugins/aucore_login.bundle/Contents/Resources/aucore/locale

  2. Navigate to Policies > Custom Messages in the Administration portal.

  3. Click Choose file and select the custom localization file.

  4. Click Upload.

    NOTE:You can find the messages specific to the Clients with the prefix client. in the Key.

  5. Search a specific message using the Message filter or find the preferred message manually.

    For example, specify client.method.smartcard.waiting_for_card to search the prompt message displayed for the Card method on all clients.

  6. Click Edit next to the preferred message. You can also double-click on the message to edit the content.

  7. Specify the message in the preferred language.

  8. (Conditional) If you want to change the font size, color, and font family of custom message, insert the message within the HTML tag:

    <font size="3" color="red" face="Arial"><b>Message to Display</b></font>

    For example, to customize the font size, font color and bold the Caps lock message in English language on all clients, search the key client.method.password.caps_lock and specify the following HTML tag in English:

    <font size="5" color="blue" face="Arial"><b>Caps Lock in ON!</b></font>

    NOTE:The supported HTML tags to customize messages are as follows:

    • <font size="x" color="text_color" face="font-family"> </font>: To set the font size, color and font-family.

    • <b> </b>: To make the text bold.

    • <i> </i>: To make the text italic.

    NOTE:When you customize the font size of the message that gets displayed on Advanced Authentication Clients, for some of the font size, the message might be invisible or not readable.

  9. Click Save.

NOTE:The customized messages reflect on the respective Clients after an approximate delay of one hour. However, after the first online log in to the Client, users can view the customized messages.

For example, consider Thomas, an administrator wants to customize the default method message (Enter one-time password) of the TOTP method that for all clients. Thomas must first search the key client.method.totp.password and modify the default message to Specify the OTP that is displayed on Token or App in the text box corresponding to English language.

When Mark, an end user tries to authenticate to Linux PAM Client using the TOTP method, the customized method message is displayed.