Manual Chapter : Localizing Messages and Images in Advanced View

Applies To:

Show Versions Show Versions

BIG-IP APM

  • 11.5.10, 11.5.9, 11.5.8, 11.5.7, 11.5.6, 11.5.5, 11.5.4, 11.5.3, 11.5.2, 11.5.1
Manual Chapter

What is full and mobile browser localization?

With localization, you can change the text and messages for web browsers and mobile clients for any language defined in an access profile. The Customization tool provides a tree view that you can use to navigate through the hierarchy of access profile items, in order to localize messages.

Localizing messages for common access profile settings

Localize common access profile pages to configure headers, footers, and standard warnings and text messages for a specific language.
  1. On the Main tab, click Access Policy > Customization. The Customization tool appears, in Basic Customization view.
  2. From the View list, select Advanced Customization. The Customization tool switches to Advanced (tree) view.
  3. In Advanced Customization view, from the Form Factor menu at the top of the Customization tool, select Full/Mobile Browser.
  4. Expand the folders in the Customization tool navigation pane to select page header settings, page footer settings, and other settings: Customization Settings > Access Profiles > name_of_access_profile > Common.
  5. At the top right-side of the customization settings pane, select the Language for which to customize localization messages for full and mobile browsers.
  6. Click Page Header Settings to provide a customized disconnection message.
  7. Click Page Footer Settings to provide a customized footer for access profile pages.
  8. Click Other Settings to configure the following settings.
    Option Description
    JavaScript disabled warning Specifies the warning when JavaScript is not enabled in the browser.
    New session link Specifies the link text to start a new session.
    New session text Specifies the text that appears before the new session link.
  9. After you customize settings, click the Save icon at the top of the Customization tool.

Localizing layout and content of the logon page

Customize the layout and content of components that appear on the logon page when the access policy is starting by customizing the framework pages.

Note: Use an HTML editor to edit the HTML code for the framework installation. The code appears unformatted and without line breaks in the Customization tool.
  1. On the Main tab, click Access Policy > Customization. The Customization tool appears, in Basic Customization view.
  2. From the View list, select Advanced Customization. The Customization tool switches to Advanced (tree) view.
  3. In Advanced Customization view, from the Form Factor menu at the top of the Customization tool, select Full/Mobile Browser.
  4. Expand the folders in the Customization tool navigation pane to select the framework installation item: Customization Settings > Access Profiles > name_of_access_profile > Framework Installation.
  5. At the top right of the customization settings pane, select the Language for which to customize localization messages for full and mobile browsers.
  6. Customize the settings for the logon page elements.
  7. After you customize settings, click the Save icon at the top of the Customization tool.

Framework installation settings

You can customize the following settings for general page style with the Customization tool.

Name Value Description
ActiveX install options screen Formatted HTML text Specifies the page text and links that prompt a user to install a new ActiveX browser component. This screen appears for Windows Internet Explorer users only.
Allow browser plugin install screen Formatted HTML text Specifies the page text and links displayed when the user's browser does not currently allow software installation. This page contains information about how to enable software installation, and links to continue to install plug-ins or to continue without installing the browser plug-ins.
Allow browser plugin install screen (Linux) Formatted HTML text Specifies the page text and links displayed when the user's browser does not currently allow software installation. This page contains information about how to enable software installation, and links for continuing to install plug-ins or to continue without installing the browser plug-ins. This screen appears for Linux operating systems and browsers.
Browser plugin install with manual install options screen Formatted HTML text Specifies the page text and links that prompt a user to install a new browser plug-in component. This screen provides manual download and installation options. This screen appears for most operating systems and browsers.
Browser plug-in install with manual install options screen (Linux) Formatted HTML text Specifies the page text and links that prompt a user to install a new browser plug-in component. This screen provides manual download and installation options. This screen appears for Linux operating systems and browsers.
Java applet install failure screen Formatted HTML text Specifies the page text and links that appear when the installation of software with a Java applet fails. This page allows the user options to restart the session, download and manually install the software, or continue without installing software. This page appears only on non-Windows systems.
Java applet install screen Formatted HTML text Specifies the text that appears on a page with a Java applet to install a new browser plugin. This page appears only on non-Windows systems. Java applet install started screen on Safari browser specifies the page text and links that appear when the Java applet is installing software. This page appears only on Macintosh systems with the Safari web browser.
Java applet install started screen Formatted HTML text Specifies the page text and links that appear when the Java applet is installing software. This page appears only on non-Windows systems.

Endpoint security settings

You can customize the following settings for endpoint security messages that appear in web browsers and on mobile devices with the Customization tool.

Name Value Description
Antivirus check message Text Specifies the message displayed while the antivirus check action is checking the system.
Cache and session control ActiveX loading message Text Specifies the message displayed when the cache and session control ActiveX control is loading and the user may be prompted to allow cache and session control installation.
Cache and session control ActiveX missing message Text Specifies the text displayed when the client requires ActiveX to start the cache and session control plug-in, and ActiveX is not available or enabled.
Cache and session control continue link Text Specifies the link text that the user clicks to continue when the cache and session control plug-in cannot load.
Cache and session control blocked popup message Text Specifies the message displayed when a popup blocker is enabled. The message includes information on how to allow popups from the BIG-IP device. Note: We recommend that you use an HTML editor to edit the HTML code for this box. The code appears unformatted and without line breaks in the box.
Cache and session control failure message Text Specifies the message displayed when the cache and session control plug-in fails to start. The message includes information on possible causes. Note: We recommend that you use an HTML editor to edit the HTML code for this box. The code appears unformatted and without line breaks in the box.
Cache and session control loading message Text Specifies the text displayed while the cache and session control plug-in starts. Note: We recommend that you use an HTML editor to edit the HTML code for this box. The code appears unformatted and without line breaks in the box.
Checking client message Text Specifies the message displayed when the system is checking the client for an unspecified action.
Continue link Text Specifies the link text that the user clicks to continue after opening a new browser window.
Continue without endpoint inspection message Text Specifies the messages displayed when client-side security checks fail. You can specify link text to cancel and link text to continue. The continue link allows the client to continue on the fallback branch.
Downloading message (appended to other messages) Text Specifies the message displayed while the client is downloading software components.
File check message Text Specifies the message displayed while the file check action is checking the system.
Firewall check message Text Specifies the message displayed while the firewall check action is checking the system.
Installing message (appended to other messages) Text Specifies the message displayed while the client is installing software.
Machine check info message Text Specifies the message displayed when the client is collecting machine info for the machine info check.
New browser window required message Text Specifies the message displayed when browser settings have changed, and the user must open a new browser window to continue.
Process check message Text Specifies the message displayed while the process check action is checking the system.
Virtual keyboard hide keyboard link Text Specifies the link text that the user clicks to hide the virtual keyboard.
Virtual keyboard label Text Specifies the label for the virtual keyboard.
Windows Group Policy action message Text Specifies the message displayed while the Windows group policy action is configuring the system.
Windows Info check message Text Specifies the message displayed while the Windows information check action is checking the system.
Windows machine certificate check message Text Specifies the message displayed while the Windows machine certificate check action is checking the system.
Windows Protected Workspace action message Text Specifies the message displayed while the Protected Workspace action is starting the protected workspace.
Windows Protected Workspace continue link Text Specifies the link text specified that the user can click to continue without starting protected workspace.
Windows Protected Workspace continuing: extended message Text Specifies the message displayed when the protected workspace starts, and the system requires some time to display the protected workspace.
Windows Protected Workspace logon: short message Text Specifies the message displayed on the client when protected workspace resumes the logon procedure after starting.
Windows Protected Workspace started: close browser message Text Specifies the message displayed when protected workspace has successfully started,
Windows Registry check message Text Specifies the message displayed while the registry check action is checking the system.

Localizing layout and content of logout pages

Customize the layout and content of components that appear on logout pages when the access policy or user ends a session.

  1. On the Main tab, click Access Policy > Customization. The Customization tool appears, in Basic Customization view.
  2. From the View list, select Advanced Customization. The Customization tool switches to Advanced (tree) view.
  3. In Advanced Customization view, from the Form Factor menu at the top of the Customization tool, select Full/Mobile Browser.
  4. Expand the folders in the Customization tool navigation pane to select the framework installation item: Customization Settings > Access Profiles > name_of_access_profile > Logout > General.
  5. At the top right of the customization settings pane, select the Language for which to customize localization messages for full and mobile browsers.
  6. Customize the settings for the logout elements.
  7. After you customize settings, click the Save icon at the top of the Customization tool.

Logout component settings

You can customize the following settings for logout messages that appear in web browsers and on mobile devices with the Customization tool.

Name Value Description
Access not found page reject message Text Specifies the message displayed when the access policy cannot be completed correctly.
Access not found page title Text Specifies the title for the page displayed when the access policy cannot be completed correctly.
ACL denied page reject message Text Specifies the message displayed when the user attempts to access a page to which access is specifically denied by an access control list.
ACL denied page return link message Text Specifies the link text on the ACL Denied page that the user can click to return to the previous page.
ACL denied page title Text Specifies the title text on the ACL Denied page.
Error message Text Provides a more specific error message that follows the error title, which indicates that a problem may have occurred during access policy evaluation.
Error title Text Specifies text that indicates that the session could not start.
New session link Text Specifies the text label for the hypertext link to start a new session, such as click here. This link follows the New session text.
New session text Text Specifies text that precedes the link a user clicks to start a new session.
Session expired message Text Specifies the message that appears when the user session expires due to inactivity.
Session ID title Text Specifies the text that precedes the session number when an error occurs.
Success message Text Specifies the text displayed when the user logs out successfully.
Success title Text Specifies the text displayed when a session is finished.
Thank you message Text Specifies a thank you message displayed for network access users after logout.

Localizing error messages

Customize the error messages that appear when the client or browser encounters errors while processing the login page or running access policy sessions.

  1. On the Main tab, click Access Policy > Customization. The Customization tool appears, in Basic Customization view.
  2. From the View list, select Advanced Customization. The Customization tool switches to Advanced (tree) view.
  3. In Advanced Customization view, from the Form Factor menu at the top of the Customization tool, select Full/Mobile Browser.
  4. Expand the folders in the Customization tool navigation pane to select the framework installation item: Customization Settings > Access Profiles > name_of_access_profile > Error Messages > error_message_category.
  5. At the top right-side of the customization settings pane, select the Language for which to customize error messages for full and mobile browsers.
  6. Customize the settings for the error messages.
  7. After you customize settings, click the Save icon at the top of the Customization tool.

General error settings

You can customize the following settings for general error messages that appear in web browsers and on mobile devices with the Customization tool.

Name Value Description
Access denied by ACL Text Specifies the error displayed when an ACL entry denies access.
Client IP address changed Text Specifies the error displayed if the client IP address changes while the session is in progress.
Invalid Network Access resource Text Specifies the error displayed when the access profile cannot find a valid Network Access resource.
Invalid Session ID Text Specifies the error displayed when the Session ID is not correct. This may occur because the session has timed out.
Request error Text Specifies the error displayed when there is a malformed request or there is another problem with a request.
Server in maintenance mode Text Specifies the error displayed when a session cannot start because the server is performing maintenance.
Session ID is not found Text Specifies the error displayed when cookies are disabled, and this causes the session ID to be unavailable in the request.
Stateful failover couldn’t be supported Text Specifies the error displayed when the access policy has changed and due to failover issues, the admin must log in again.
System is not licensed Text Specifies the error displayed when a session cannot start because the system is not licensed.
Terminated Session Text Specifies the error displayed when the session is terminated by the server.
Unsupported User-Agent Text Specifies the error displayed when the browser user agent is not supported in the policy.
User limit reached Text Specifies the error displayed when the resource cannot be assigned because the limit on the number of sessions has been reached.

AAA error settings

You can customize the following settings for AAA error messages that appear in web browsers and on mobile devices with the Customization tool.

Name Value Description
AD domain password change failure Text Specifies the text displayed when the attempt to change the Active Directory password failed.
AD domain password change failure with extended error Text Specifies the text displayed when the attempt to change the Active Directory password failed, and includes the error message from the Active Directory component.
AD domain password expired Text Specifies the text displayed when the Active Directory domain password has expired.
AD domain password expired with extended error Text Specifies the text displayed when the Active Directory password has expired, and includes the error message from the Active Directory component.
Incorrect AD username or password with extended error Text Specifies the text displayed when the Active Directory user name or password is incorrect, and includes the error message from the Active Directory component.
Incorrect LDAP username or password with extended error Text Specifies the text displayed when the LDAP user name or password is incorrect, and includes the error message from the LDAP component.
Incorrect OAM username or password with extended error Text Specifies the text displayed when the OAM user name or password is incorrect, and includes the error message from the OAM component.
Incorrect RADIUS username or password with extended error Text Specifies the text displayed when the RADIUS user name or password is incorrect, and includes the error message from the RADIUS component.
Incorrect username or password Text Specifies the text displayed when the user name or password is incorrect.
OAM authentication error Text Specifies the text displayed when there is an OAM authentication error.
OAM authorization error Text Specifies the text displayed when there is an OAM authorization error.
OAM internal error Text Specifies the text displayed when there is an invalid setup for the OAM server.
OAM SDK initialization error Text Specifies the text displayed when there is an OAM error related to the F5 webgate and OAM SDK.
RADIUS challenge failure Text Specifies the text displayed when a RADIUS challenge fails.
RADIUS challenge failure with extended error Text Specifies the text displayed when a RADIUS challenge fails, and includes the error message from the RADIUS component.
SecurID logon failure with retry Text Specifies the text displayed when the RSA SecurID logon or password is incorrect.
SecurID logon failure with retry with extended error Text Specifies the text displayed when the RSA SecurID logon or password is incorrect, and includes the error message from the SecurID component.

Installation error settings

You can customize the following settings for installation error messages that appear in web browsers and on mobile devices with the Customization tool.

Name Value Description
ActiveX is not allowed or unsupported Text Specifies the error displayed when the access policy attempts to load an ActiveX control in Microsoft Internet Explorer and ActiveX is not enabled.
Installation failure Text Specifies the error displayed when installation of a browser component fails.

Resource error settings

You can customize the following settings for resource error messages that appear in web browsers and on mobile devices with the Customization tool.

Name Value Description
ACL does not exist Text Specifies the error text displayed when the assigned ACL does not exist.
Inconsistent host replacement string Text Specifies the error text displayed when portal access resources configured in Minimal Patching mode contain inconsistent host replace strings.
Incorrect resource assigned (Network Access) Text Specifies the error text displayed when a resource assign action is configured to assign a portal access webtop with a network access resource. Webtop and resource types must match.
Incorrect resource assigned (Portal Access) Text Specifies the error text displayed when a resource assign action is configured to assign a network access webtop with a portal access resource.
Invalid Dynamic ACL Assignment Text Specifies the error text displayed when the dynamic ACL is incorrectly assigned or configured.
Invalid host for App Tunnel resource Text Specifies the error text displayed when a host that the app tunnel attempts to start a connection to does not respond correctly.
Invalid host for Remote Desktop resource Text Specifies the error text displayed when the host that a remote desktop resource attempts to start a connection to does not respond correctly.
Invalid Portal Access start URI Text Specifies the error text displayed when the portal access webtop has an invalid start URI.
Invalid Static ACL assignment Text Specifies the error text displayed when a static ACL is not configured correctly.
Missing Network Access resource Text Specifies the error text displayed when a network access webtop is configured with no network access resource. Webtop and resource types must match.
More than one Network Access resource Text Specifies the error text displayed when more than one network access resource is assigned to an access policy branch.
Network Access and Portal Access resources assigned Text Specifies the error text displayed when both network access and portal accesss resources are assigned to an access policy branch.
Portal Access resources have inconsistent patching methods Text Specifies the error text displayed when multiple portal accesss are assigned to an access policy branch, with different patching methods. All portal access resources assigned to an access policy branch must use the same patching method.
Resource does not exist Text Specifies the error text displayed when the assigned resource does not exist.
Webtop does not exist Text Specifies the error text displayed when the assigned webtop does not exist.
Webtop required Text Specifies the error text displayed when a webtop is required, but not assigned.

Dynamic configuration error settings

You can customize the following settings for dynamic configuration error messages that appear in web browsers and on mobile devices with the Customization tool.

Name Value Description
Invalid Dynamic ACL entries Text Specifies the text displayed when a dynamic ACL contains invalid entries.

Other configuration error settings

You can customize the following settings for other errors that appear in web browsers and on mobile devices with the Customization tool.

Name Value Description
Unknown error Text Specifies the text displayed when an unknown error occurs.

Localizing logon pages

Customize the messages that appear for a specific logon page or HTTP 401 response page in an access policy.

  1. On the Main tab, click Access Policy > Customization. The Customization tool appears, in Basic Customization view.
  2. From the View list, select Advanced Customization. The Customization tool switches to Advanced (tree) view.
  3. In Advanced Customization view, from the Form Factor menu at the top of the Customization tool, select Full/Mobile Browser.
  4. Expand the folders in the Customization tool navigation pane to select the logon page: Customization Settings > Access Profiles > name_of_access_profile > Access Policy > Logon Pages.
  5. Select the folder for the logon page or HTTP 401 response action.
  6. Select the General settings.
  7. At the top right of the customization settings pane, select the Language for which to customize logon pages.
  8. Customize the settings for the logon pages.
  9. After you customize settings, click the Save icon at the top of the Customization tool.

Logon page settings

You can customize the following settings for logon pages that appear in web browsers and on mobile devices with the Customization tool.

Name Value Description
Form Header Text Text Specifies the text that appears at the top of the logon box.
HTTP 401 Response Text Specifies the text displayed when an HTTP 401 authentication error occurs.
Logon Button Text Specifies the text that appears on the logon button, which a user clicks to post the defined logon agents.
Logon Page Input Field # (1-5) Text These fields specify the text that is displayed on the logon page for each of the logon page agents, defined in the Logon Page Agent screen area.
New Password Prompt Text Specifies the prompt displayed when a new Active Directory password is requested.
Password and Password Verification do not Match Text Specifies the prompt displayed to confirm the new password when a new Active Directory password is requested.
Save Password Checkbox Text Specifies the text that appears adjacent to the check box that allows users to save their passwords in the logon form. This field is used only in the secure access client, and not in the web client.
Verify Password Prompt Text Specifies the prompt displayed to confirm the new password when a new Active Directory password is requested.

Localizing decision pages

Customize the messages that appear for decision pages.

  1. On the Main tab, click Access Policy > Customization. The Customization tool appears, in Basic Customization view.
  2. From the View list, select Advanced Customization. The Customization tool switches to Advanced (tree) view.
  3. In Advanced Customization view, from the Form Factor menu at the top of the Customization tool, select Full/Mobile Browser.
  4. Expand the folders in the Customization tool navigation pane to select the decision page: Customization Settings > Access Profiles > name_of_access_profile > Access Policy > Decision Pages.
  5. Select the folder for the decision box page.
  6. Select the General or Advanced Customization Images settings.
  7. At the top right of the customization settings pane, select the Language for which to customize decision pages.
  8. Customize the settings for the decision pages.
  9. After you customize settings, click the Save icon at the top of the Customization tool.

General decision page settings

You can customize the following settings for decision pages that appear in web browsers and on mobile devices with the Customization tool.

Name Value Description
Field 1 Image Image Specifies the image that appears in the first option field on the decision page. Click the icon at the right of the field to view the image. Click Replace to change the image.
Field 2 Image Image Specifies the image that appears in the second option field on the decision page. Click the icon at the right of the field to view the image. Click Replace to change the image.

Advanced customization image settings

You set advanced customization images to make images you add through the image browser available to your advanced customization pages.

The Advanced Customization Images properties pages allow you to set advanced customization images from the image browser to associate with advanced customization image names. You can then use the image name to add an image to an advanced customization page.

To select an image from the image browser to associate with an image for advanced customization, click the button next to the current (or default) image name, and select Replace.

Localizing message box pages

Customize the message boxes that appear for message box pages.

  1. On the Main tab, click Access Policy > Customization. The Customization tool appears, in Basic Customization view.
  2. From the View list, select Advanced Customization. The Customization tool switches to Advanced (tree) view.
  3. In Advanced Customization view, from the Form Factor menu at the top of the Customization tool, select Full/Mobile Browser.
  4. Expand the folders in the Customization tool navigation pane to select the message box page: Customization Settings > Access Profiles > name_of_access_profile > Access Policy > Message Pages.
  5. Select the folder for the message box page.
  6. Select Advanced Customization Images settings.
  7. At the top right of the customization settings pane, select the Language for which to customize message pages.
  8. Customize the settings for the message box pages.
  9. After you customize settings, click the Save icon at the top of the Customization tool.

Advanced customization image settings

You set advanced customization images to make images you add through the image browser available to your advanced customization pages.

The Advanced Customization Images properties pages allow you to set advanced customization images from the image browser to associate with advanced customization image names. You can then use the image name to add an image to an advanced customization page.

To select an image from the image browser to associate with an image for advanced customization, click the button next to the current (or default) image name, and select Replace.

Localizing ending pages

Customize the ending pages that appear in access policies.

  1. On the Main tab, click Access Policy > Customization. The Customization tool appears, in Basic Customization view.
  2. From the View list, select Advanced Customization. The Customization tool switches to Advanced (tree) view.
  3. In Advanced Customization view, from the Form Factor menu at the top of the Customization tool, select Full/Mobile Browser.
  4. Expand the folders in the Customization tool navigation pane to select the ending: Customization Settings > Access Profiles > name_of_access_profile > Access Policy > Ending Pages.
  5. Select the folder for the message box page.
  6. Select Advanced Customization Images settings.
  7. At the top right of the customization settings pane, select the Language for which to customize ending pages.
  8. Customize the settings for the ending pages.
  9. After you customize settings, click the Save icon at the top of the Customization tool.

Advanced customization image settings

You set advanced customization images to make images you add through the image browser available to your advanced customization pages.

The Advanced Customization Images properties pages allow you to set advanced customization images from the image browser to associate with advanced customization image names. You can then use the image name to add an image to an advanced customization page.

To select an image from the image browser to associate with an image for advanced customization, click the button next to the current (or default) image name, and select Replace.