BIG-IP Access Policy ManagerCustomization Guide
Version 11.2
Table of ContentsLegal Notices.....................................................................................................................................7Acknowledgments............................................................................................................................9
Chapter 1: Overview of Customization..............................................................11Overview: What is customization?..........................................................................................12
About the Customization tool.......................................................................................12About customization views and form factors...............................................................12
Chapter 2: Configuring Settings in Basic Customization View.......................13About Basic Customization view............................................................................................14
Customizing Basic settings..........................................................................................14
Chapter 3: Personalizing Client Appearance in Advanced View.....................19What is client personalization?...............................................................................................20Adding images with the image browser..................................................................................20Personalizing client colors, logos, and icons..........................................................................20
Previewing customization changes..............................................................................21Appearance properties for BIG-IP Edge Client............................................................21
Localizing screen appearance for BIG-IP Edge Client...........................................................22Previewing customization changes..............................................................................22Localization properties for BIG-IP Edge Client............................................................22
Chapter 4: Personalizing Access Profile Appearance Settings......................25What is access profile personalization?.................................................................................26Personalizing page appearance for common access profile settings.....................................26
Previewing customization changes..............................................................................26General page style settings for access profiles...........................................................27Font settings for access profiles..................................................................................27Page header settings for access profiles.....................................................................27Page footer settings for access profiles.......................................................................28Layout settings for access profiles...............................................................................28Image settings for access profiles...............................................................................29Form settings for access profiles.................................................................................29Form element settings for access profiles...................................................................30Advanced customization image settings.....................................................................30
Personalizing page appearance for access profile logout settings.........................................30Advanced customization image settings.....................................................................31
3
Table of Contents
Personalizing page appearance for access policy pages.......................................................31Customization settings for access policy items...........................................................31
Localizing messages for BIG-IP Edge Client.........................................................................32Previewing customization changes..............................................................................32Customization settings for BIG-IP Edge Client localization.........................................32
Chapter 5:Personalizing Webtop Appearance Settings in Advanced View.................35
What is webtop appearance personalization?........................................................................36Personalizing page appearance for webtops..........................................................................36
Webtop network connectivity status icons settings.....................................................36CSS sprite image setting.............................................................................................36Web Applications Session Timeout settings................................................................37Web Applications Hometab settings............................................................................38Full webtop settings.....................................................................................................41Full webtop popup window setting...............................................................................42Advanced customization image settings.....................................................................42
Chapter 6: Personalizing Images for Resources in Advanced View...............43What is resource image personalization?..............................................................................44Personalizing resource images..............................................................................................44
Chapter 7: Localizing Messages and Images in Advanced View....................45What is full and mobile browser localization?.........................................................................46Localizing messages for common access profile settings......................................................46Localizing layout and content of the logon page....................................................................46
Framework installation settings...................................................................................47Endpoint security settings............................................................................................48
Localizing layout and content of logout pages........................................................................50Logout component settings.........................................................................................50
Localizing error messages.....................................................................................................51General error settings..................................................................................................51AAA error settings.......................................................................................................52Installation error settings.............................................................................................53Resource error settings...............................................................................................53Dynamic configuration error settings...........................................................................55Other configuration error settings................................................................................55
Localizing logon pages...........................................................................................................55Logon page settings....................................................................................................55
Localizing decision pages......................................................................................................56General decision page settings...................................................................................56
4
Table of Contents
Advanced customization image settings.....................................................................57Localizing message box pages..............................................................................................57
Advanced customization image settings.....................................................................57Localizing ending pages.........................................................................................................58
Advanced customization image settings.....................................................................58
Chapter 8: Localizing Webtops in Advanced View............................................59What is webtop localization?..................................................................................................60Localizing webtops.................................................................................................................60
Webtop form and message settings............................................................................60BIG-IP Edge Client webtop settings............................................................................62Settings for showing and hiding information on webtops.............................................63Webtop logout and relaunch settings..........................................................................63Webtop activity section setting....................................................................................63Webtop new session settings......................................................................................64Webtop web applications session timeout settings.....................................................64Webtop hometab settings............................................................................................65Full webtop settings.....................................................................................................66Full webtop popup window settings.............................................................................67Full webtop Citrix logon form settings..........................................................................68Full webtop Citrix installer settings..............................................................................68Full webtop Citrix browser setting................................................................................69
Chapter 9: Localizing Captions for Resources in Advanced View..................71What is resource caption localization?...................................................................................72Localizing captions.................................................................................................................72
Chapter 10: Changing Customized Properties with Advanced Edit Mode.....73What is Advanced Edit Mode customization?........................................................................74
Editing files in Advanced Edit Mode............................................................................74
5
Table of Contents
6Table of Contents
Legal Notices
Publication DateThis document was published on May 7, 2012.
Publication NumberMAN-0387-01
CopyrightCopyright 2012, F5 Networks, Inc. All rights reserved.
F5 Networks, Inc. (F5) believes the information it furnishes to be accurate and reliable. However, F5 assumesno responsibility for the use of this information, nor any infringement of patents or other rights of thirdparties which may result from its use. No license is granted by implication or otherwise under any patent,copyright, or other intellectual property right of F5 except as specifically described by applicable userlicenses. F5 reserves the right to change specifications at any time without notice.
Trademarks3DNS, Access Policy Manager, Acopia, Acopia Networks, Advanced Client Authentication, AdvancedRouting, APM, Application Security Manager, ARX, AskF5, ASM, BIG-IP, Cloud Extender, CloudFucious,CMP, Data Manager, DevCentral, DevCentral [DESIGN], DNS Express, DSC, DSI, Edge Client, EdgeGateway, Edge Portal, EM, Enterprise Manager, F5, F5 [DESIGN], F5 Management Pack, F5 Networks,F5 World, Fast Application Proxy, Fast Cache, FirePass, Global Traffic Manager, GTM, IBR, IntelligentBrowser Referencing, Intelligent Compression, IPv6 Gateway, iApps, iControl, iHealth, iQuery, iRules,iRules OnDemand, iSession, IT agility. Your way., L7 Rate Shaping, LC, Link Controller, Local TrafficManager, LTM, Message Security Module, MSM, Netcelera, OneConnect, Packet Velocity, ProtocolSecurity Module, PSM, Real Traffic Policy Builder, ScaleN, SSL Acceleration, StrongBox, SuperVIP, SYNCheck, TCP Express, TDR, TMOS, Traffic Management Operating System, TrafficShield, TransparentData Reduction, VIPRION, vCMP, WA, WAN Optimization Manager, WANJet, WebAccelerator, WOM,and ZoneRunner, are trademarks or service marks of F5 Networks, Inc., in the U.S. and other countries,and may not be used without F5's express written consent.
All other product and company names herein may be trademarks of their respective owners.
PatentsThis product may be protected by U.S. Patent 7,114,180. This list is believed to be current as of May 7,2012.
Export Regulation NoticeThis product may include cryptographic software. Under the Export Administration Act, the United Statesgovernment may consider it a criminal offense to export this product from the United States.
RF Interference WarningThis is a Class A product. In a domestic environment this product may cause radio interference, in whichcase the user may be required to take adequate measures.
FCC ComplianceThis equipment has been tested and found to comply with the limits for a Class A digital device pursuantto Part 15 of FCC rules. These limits are designed to provide reasonable protection against harmfulinterference when the equipment is operated in a commercial environment. This unit generates, uses, andcan radiate radio frequency energy and, if not installed and used in accordance with the instruction manual,may cause harmful interference to radio communications. Operation of this equipment in a residential areais likely to cause harmful interference, in which case the user, at his own expense, will be required to takewhatever measures may be required to correct the interference.
Any modifications to this device, unless expressly approved by the manufacturer, can void the user's authorityto operate this equipment under part 15 of the FCC rules.
Canadian Regulatory ComplianceThis Class A digital apparatus complies with Canadian ICES-003.
Standards ComplianceThis product conforms to the IEC, European Union, ANSI/UL and Canadian CSA standards applicable toInformation Technology products at the time of manufacture.
8
Legal Notices
Acknowledgments
This product includes software developed by Bill Paul.
This product includes software developed by Jonathan Stone.
This product includes software developed by Manuel Bouyer.
This product includes software developed by Paul Richards.
This product includes software developed by the NetBSD Foundation, Inc. and its contributors.
This product includes software developed by the Politecnico di Torino, and its contributors.
This product includes software developed by the Swedish Institute of Computer Science and its contributors.
This product includes software developed by the University of California, Berkeley and its contributors.
This product includes software developed by the Computer Systems Engineering Group at the LawrenceBerkeley Laboratory.
This product includes software developed by Christopher G. Demetriou for the NetBSD Project.This product includes software developed by Adam Glass.
This product includes software developed by Christian E. Hopps.
This product includes software developed by Dean Huxley.
This product includes software developed by John Kohl.
This product includes software developed by Paul Kranenburg.
This product includes software developed by Terrence R. Lambert.
This product includes software developed by Philip A. Nelson.
This product includes software developed by Herb Peyerl.
This product includes software developed by Jochen Pohl for the NetBSD Project.This product includes software developed by Chris Provenzano.
This product includes software developed by Theo de Raadt.
This product includes software developed by David Muir Sharnoff.
This product includes software developed by SigmaSoft, Th. Lockert.
This product includes software developed for the NetBSD Project by Jason R. Thorpe.This product includes software developed by Jason R. Thorpe for And Communications, http://www.and.com.
This product includes software developed for the NetBSD Project by Frank Van der Linden.This product includes software developed for the NetBSD Project by John M. Vinopal.This product includes software developed by Christos Zoulas.
This product includes software developed by the University of Vermont and State Agricultural College andGarrett A. Wollman.
This product includes software developed by Balazs Scheidler ([email protected]), which is protected underthe GNU Public License.
This product includes software developed by Niels Mueller ([email protected]), which is protected underthe GNU Public License.
In the following statement, This software refers to the Mitsumi CD-ROM driver: This software was developedby Holger Veit and Brian Moore for use with 386BSD and similar operating systems. Similar operatingsystems includes mainly non-profit oriented systems for research and education, including but not restrictedto NetBSD, FreeBSD, Mach (by CMU).This product includes software developed by the Apache Group for use in the Apache HTTP server project(http://www.apache.org/).This product includes software licensed from Richard H. Porter under the GNU Library General PublicLicense ( 1998, Red Hat Software), www.gnu.org/copyleft/lgpl.html.This product includes the standard version of Perl software licensed under the Perl Artistic License ( 1997,1998 Tom Christiansen and Nathan Torkington). All rights reserved. You may find the most current standardversion of Perl at http://www.perl.com.
This product includes software developed by Jared Minch.
This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit(http://www.openssl.org/).This product includes cryptographic software written by Eric Young ([email protected]).This product contains software based on oprofile, which is protected under the GNU Public License.
This product includes RRDtool software developed by Tobi Oetiker (http://www.rrdtool.com/index.html)and licensed under the GNU General Public License.
This product contains software licensed from Dr. Brian Gladman under the GNU General Public License(GPL).This product includes software developed by the Apache Software Foundation (http://www.apache.org/).This product includes Hypersonic SQL.This product contains software developed by the Regents of the University of California, Sun Microsystems,Inc., Scriptics Corporation, and others.
This product includes software developed by the Internet Software Consortium.
This product includes software developed by Nominum, Inc. (http://www.nominum.com).This product contains software developed by Broadcom Corporation, which is protected under the GNUPublic License.
This product contains software developed by MaxMind LLC, and is protected under the GNU Lesser GeneralPublic License, as published by the Free Software Foundation.
10
Acknowledgments
Chapter1Overview of CustomizationTopics:
Overview: What is customization?
Overview: What is customization?Customization allows you to provide users with a personalized experience for access policy screens, windows,and errors. Using the Customization tool, you can apply your organization's brand images and colors, changemessages and errors for local languages, and change the layout of user pages and screens.
About the Customization tool
The Customization tool is an application that you start from the BIG-IP admin console. With theCustomization tool, you can personalize screen messages and prompts, change screen layouts, colors, andimages, and customize error and other messages to specific languages for policies and profiles used onBIG-IP Access Policy Manager.
Starting the Customization tool
Start the Customization tool to personalize and localize page layout, colors, images, and messages for theBIG-IP Edge Client, browser pages, and mobile device screens.
On the Main tab, click Access Policy > Customization.The Customization tool appears, in Basic Customization view.
You can use the Customization tool inside the BIG-IP admin console, or click Popout to open it in a separatebrowser window.
After you personalize settings, remember to click the Save icon to apply your changes.
About customization views and form factors
The Customization tool provides two views:
Basic Customization (Quick Start): This is the default customization view. Use this to configure basiclook and feel for pages, and common text labels and captions for resources on the webtop.
Advanced Customization (Advanced): This is the advanced customization view that provides a treestructure for configuration elements, and more detailed methods to configure and customize objects.
The Advanced Customization view provides two form factors, which you can use to customize differentaccess policy features.
Full/Mobile browser: Use this mode to configure pages that are viewed in a web browser or on a mobiledevice.
BIG-IP Edge Client: Use this mode to configure the appearance and messages that appear in the BIG-IPEdge Client for a platform or device.
In addition, for each form factor you can choose to customize Branding or Localization by selecting thetab at the top of the Form Factor column.
Branding: Customization controls the look of the user interface, such as fonts, images, colors, andgeneral layout.
Localization: Customization provides personalization for the text and messages that appear for eachlanguage specified in an access profile.
12
Overview of Customization
Chapter2Configuring Settings in Basic Customization ViewTopics:
About Basic Customization view
About Basic Customization viewYou can use the Basic Customization view to configure common settings for access profile web pages, andthe webtop captions, descriptions, and images for any item that appears on a full webtop. In addition, youcan customize webtop font size and link colors.
With this view, you can customize:
Common Page Styles - Specifies settings for the logon form display, header image, and alignment ofitems.
Webtop items - Specifies settings for the display of resources (app tunnels, remote desktops, networkaccess tunnels, webtop links, and portal access resources) on the full webtop.
Common webtop settings - Specifies display settings that apply to all resources on the full webtop. Webtop links - Specifies display settings that apply to all resources on the full webtop.
Customizing Basic settings
Start Basic customization to configure custom settings for access profiles and items that appear on the fullwebtop. Basic customization provides a starting point that you can later refine through the AdvancedCustomization view.
1. From the Main tab, click Access Policy > Customization > Quick Start.The Basic Customization view opens.
2. In the left column of the page, select the category of items to customize.For example, select Network Access to customize the appearance of a network access resource item onthe full webtop.
3. On the right-side of the page, from the list, select the specific item for which you want to customizesettings.The customizable settings for the item are displayed.
4. Configure settings for the resource item or access profile.Click Preview to display your settings without saving your changes.
After you customize settings, click Save to save the new customization settings. To return to the originalsettings and discard your changes, click Revert.
Common page style settingsYou can customize the following common page style settings for an access profile with the Basic view inthe Customization tool. Select Common Page Styles to view these settings.
DescriptionValueName
The access profile for which you want to change basicsettings.
An access profile alreadydefined on the system
Access Profile
This specifies the language for which you arechanging customization settings. Select All languages
A language already specified inthe access profile on the system
Language
to apply the same customization changes to alllanguages in the access profile.
14
Configuring Settings in Basic Customization View
DescriptionValueName
The margin between the left edge of the form and theleft edge of the browser window, on form-basedpages.
A numeric pixel value, or apercentage (for example, 10pxor 5%)
Form Left Margin
The margin between the top edge of the form and thebottom edge of the header image, on form-basedpages.
A numeric pixel value or apercentage, (for example, 10px)
Form Top Margin
The height of the form, on form-based pages. Anyvalue less than the full height of the browser increases
A numeric pixel value or apercentage, (for example,500px or 50%)
Form Height
the space at the bottom of the form, as the top marginis set by the Form Top Margin value.
Indicates the color behind form-based pages.A color, selected from a colorchooser.
Form BackgroundColor
Specifies the footer message that appears at thebottom of access policy web pages.
A text string.Footer Text
Indicates the size for the footer message at the bottomof access policy web pages.
Font size in pixels (for example10px.
Footer Font Size
Sets the alignment of the page within the web browserwindow.
Left, center, or rightPage Alignment
The width of any access policy web pages inside theweb browser frame.
Pixel or percentage value (forexample 90%)
Page Width
The header logo appears, by default, at the upper-leftcorner of the defined HTML page. Typically this is
An imageHeader Logo
a square, transparent image file. Acceptable formatsfor transparency are GIF and PNG. The page headerarea expands to the height of this image.
App tunnel basic settingsYou can customize the following settings for an app tunnel on the full webtop, with the Basic view in theCustomization tool. Select App Tunnel to view these settings.
DescriptionValueName
The app tunnel for which you want to change basicsettings.
An app tunnel alreadydefined on the system
App Tunnel
This specifies the language for which you are changingcustomization settings. Select All languages to apply the
A language already specifiedon the system
Language
same customization changes to all languages in the accessprofile.
The text under the icon for the app tunnel, on a fullwebtop.
A text stringCaption
The description text for the app tunnel, on a full webtop.A text stringDescription
The image acts as an icon on the full webtop to representthe app tunnel. Select an image from the list, or clickUpload New Image to add a new image.
An image or iconImage
15
BIG-IP Access Policy Manager Customization Guide
Network access basic settingsYou can customize the following settings for a network access resource on the full webtop, with the Basicview in the Customization tool. Select Network Access to view these settings.
DescriptionValueName
The network access resource for which you want to changebasic settings.
A network access resourcealready defined on thesystem
Network Access
This specifies the language for which you are changingcustomization settings. Select All languages to apply the
A language already specifiedon the system
Language
same customization changes to all languages in the accessprofile.
The text under the icon for the network access resource,on a full webtop.
A text stringCaption
The description text for the network access resource, ona full webtop.
A text stringDescription
The image acts as an icon on the full webtop to representthe network access resource. Select an image from thelist, or click Upload New Image to add a new image.
An image or iconImage
Remote desktop basic settingsYou can customize the following settings for a remote desktop on the full webtop, with the Basic view inthe Customization tool. Select Remote Desktop to view these settings.
DescriptionValueName
The remote desktop for which you want to change basicsettings.
A remote desktop alreadydefined on the system
Network Access
This specifies the language for which you are changingcustomization settings. Select All languages to apply the
A language already specifiedon the system
Language
same customization changes to all languages in the accessprofile.
The text under the icon for the remote desktop, on a fullwebtop.
A text stringCaption
The description text for the remote desktop, on a fullwebtop.
A text stringDescription
The image acts as an icon on the full webtop to representthe remote desktop. Select an image from the list, or clickUpload New Image to add a new image.
An image or iconImage
Common webtop settingsYou can customize the following shared settings for full webtops, with the Basic view in the Customizationtool. Select Common Webtop Settings to view these settings.
16
Configuring Settings in Basic Customization View
DescriptionValueName
The webtop for which you want to change basicsettings.
A webtop already defined on thesystem
Webtop
This specifies the language for which you arechanging customization settings. Select All languages
A language already specified onthe system
Language
to apply the same customization changes to alllanguages in the access profile.
The font size used for text on the full webtop.A pixel value, (for example14px)
Font size
Indicates the color for links on the webtop.A color, selected from a colorchooser
Link color
The image appears on the full webtop. Select an imagefrom the list, or click Upload New Image to add anew image.
An image or iconImage
Webtop link basic settingsYou can customize the following settings for a webtop link on the full webtop, with the Basic view in theCustomization tool. Select Portal Access to view these settings.
DescriptionValueName
The webtop link for which you want to change basicsettings.
A webtop link alreadydefined on the system
Webtop link
This specifies the language for which you are changingcustomization settings. Select All languages to apply the
A language already specifiedon the system
Language
same customization changes to all languages in the accessprofile.
The text under the icon for the webtop link, on a fullwebtop.
A text stringCaption
The description text for the webtop link, on a full webtop.A text stringDescription
The image acts as an icon on the full webtop to representthe webtop link. Select an image from the list, or clickUpload New Image to add a new image.
An image or iconImage
Portal access resource basic settingsYou can customize the following settings for a portal access resource on the full webtop, with the Basicview in the Customization tool. Select Portal Access to view these settings.
DescriptionValueName
The portal access resource for which you want to changebasic settings.
A portal access resourcealready defined on thesystem
Portal Access
This specifies the language for which you are changingcustomization settings. Select All languages to apply the
A language already specifiedon the system
Language
17
BIG-IP Access Policy Manager Customization Guide
DescriptionValueName
same customization changes to all languages in the accessprofile.
The text under the icon for the portal access resource, ona full webtop.
A text stringCaption
The description text for the portal access resource, on afull webtop.
A text stringDescription
The image acts as an icon on the full webtop to representthe portal access resource. Select an image from the list,or click Upload New Image to add a new image.
An image or iconImage
18
Configuring Settings in Basic Customization View
Chapter3Personalizing Client Appearance in Advanced ViewTopics:
What is client personalization? Adding images with the image browser Personalizing client colors, logos, and icons Localizing screen appearance for BIG-IP
Edge Client
What is client personalization?To personalize client pages, you use BIG-IP Edge Client customization. You can change the brandingand localization of the BIG-IP Edge Client on client PCs and devices.
Adding images with the image browserYou can add images to Access Policy Manager with the image browser. You can then select and use theseimages by means of settings within 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. On the top pane of the Customization tool, click Image Browser.The image browser opens in a new window.
4. Select the image filter method from the Filter Messages list.
Select Default Images to view the included default Access Policy Manager images. Select User Uploaded Images to view the custom uploaded images.
5. Add and remove images.
To add an image, click Add Image, select the image, and click Open. To remove an image, select the image in the image browser, and click Delete Image.
Personalizing client colors, logos, and iconsIn a connectivity profile, you can customize the appearance of the BIG-IP Edge Clientand the web client.The settings you specify are saved with the connectivity profile, and applied when users download the clientpackage.
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 BIG-IP Edge Client.
4. Under Form Factor: BIG-IP Edge Client, select the Branding tab.5. Expand the folders in the Customization tool navigation pane to select the BIG-IP Edge Client in
Customization Settings > Connectivity Profiles > name_of_connectivity_profile > BIG-IP Edge Client.6. Customize the settings for BIG-IP Edge Client branding.7. After you customize settings, click the Save icon at the top of the Customization tool.
20
Personalizing Client Appearance in Advanced View
Previewing customization changes
You must have customized an element with the Customization tool to see a preview of your changes.
After you customize and save an element with the Customization tool, you can preview the changes youhave made in the Preview window. The Preview window opens a separate browser window, and shows alive update of changes as you save them.
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. At the top of the Customization tool, click the Preview button.4. Navigate to a page to view customizations. For example, to navigate to a login page and view the results
of access profile branding customization, in the Preview window, expand Customization Settings >Access Profiles > access_profile_name > Access Policy > Logon Pages > logon_page_name.
The Preview window shows the results of any customization changes.
Appearance properties for BIG-IP Edge ClientYou can customize the following appearance settings for BIG-IP Edge Client with the Customizationtool.
DescriptionValueName
Indicates the color that the banner for theBIG-IP Edge Client uses. Note that the BannerText Color should be legible over this color.
A hex color code, for example, #123ABC.When you click the color value, two colorchoosers appear. One allows you to select acolor from 40 common color blocks, and the
BannerColor
other allows you to select any HTML colorfrom a more sophisticated color wheel. Youcan also type the color value in as text.
Indicates the color in which the banner textappears. This color appears over the BannerColor and should be readable on it.
A hex color code, for example, #123ABC.When you click the color value, two colorchoosers appear. One allows you to select acolor from 40 common color blocks, and the
BannerText Color
other allows you to select any HTML colorfrom a more sophisticated color wheel. Youcan also type the color value in as text.
This logo appears in the BIG-IP Edge Clientas the company logo. The generic logo is an
A 48 x 48 PNG, JPG, or GIF icon.Logo
F5 logo. To change the logo, click the logopopout button, then click Replace. Select animage file to replace the logo file. Note thatyou can add files to the Customization tool inthe image browser.
Select the setting that will appear in the systemtray to show connection activity and status.
The F5 tray logo set or the generic icon set.Tray IconSet
You can choose the F5 icon set (red ball), ora Generic icon set.
21
BIG-IP Access Policy Manager Customization Guide
Localizing screen appearance for BIG-IP Edge ClientConfigure localization for BIG-IP Edge Client to change the messages and text in the BIG-IP Edge Clientapplication.
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 BIG-IP Edge Client.
4. Under Form Factor: BIG-IP Edge Client select the Localization tab.5. Expand the folders in the Customization tool navigation pane to select the BIG-IP Edge Client in
Customization Settings > Connectivity Profiles > name_of_connectivity_profile > BIG-IP Edge Client.6. At the top right-side of the customization settings pane, select the Language for which to customize
localization messages for the BIG-IP Edge Client.7. Customize the settings for BIG-IP Edge Client localization.8. After you customize settings, click the Save icon at the top of the Customization tool.
Previewing customization changes
You must have customized an element with the Customization tool to see a preview of your changes.
After you customize and save an element with the Customization tool, you can preview the changes youhave made in the Preview window. The Preview window opens a separate browser window, and shows alive update of changes as you save them.
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. At the top of the Customization tool, click the Preview button.4. Navigate to a page to view customizations. For example, to navigate to a login page and view the results
of access profile branding customization, in the Preview window, expand Customization Settings >Access Profiles > access_profile_name > Access Policy > Logon Pages > logon_page_name.
The Preview window shows the results of any customization changes.
Localization properties for BIG-IP Edge ClientYou can customize the following settings for BIG-IP Edge Client customization with the Customizationtool.
DescriptionValueName
The text that appears as a link in the About area of the BIG-IPEdge Client.
A URLAbout link
22
Personalizing Client Appearance in Advanced View
DescriptionValueName
Text, typically copyright info or some other identifyinginformation, that appears in the About area of the BIG-IP EdgeClient.
TextAbout text
The application name, which appears in the status bar of theapplication.
TextApplication Name
23
BIG-IP Access Policy Manager Customization Guide
24
Personalizing Client Appearance in Advanced View
Chapter4Personalizing Access Profile Appearance SettingsTopics:
What is access profile personalization? Personalizing page appearance for common
access profile settings Personalizing page appearance for access
profile logout settings Personalizing page appearance for access
policy pages Localizing messages for BIG-IP Edge Client
What is access profile personalization?With full and mobile browser customization, you can change the appearance, text, and messages of all pagesthat a browser views, either from the BIG-IP Edge Client by directly logging in through a web browser,or on a mobile device. Some settings that are specific to the BIG-IP Edge Client software are customizedseparately in the BIG-IP Edge Client customization view.
Personalizing page appearance for common access profile settingsPersonalize access profile login pages to change the front image and advanced customization images forthe login page in a specific 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. Under Form Factor: Full/Mobile Browser, select the Branding tab.5. Expand the folders in the Customization tool to customize settings. Navigate to Customization Settings
> Access Profiles > access_profile_name > Common to configure common settings.6. Customize the settings for each individual element by clicking on the element and changing the displayed
settings.7. After you customize settings, click the Save icon at the top of the Customization tool.
The access policy login page reflects your changes.
Previewing customization changes
You must have customized an element with the Customization tool to see a preview of your changes.
After you customize and save an element with the Customization tool, you can preview the changes youhave made in the Preview window. The Preview window opens a separate browser window, and shows alive update of changes as you save them.
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. At the top of the Customization tool, click the Preview button.4. Navigate to a page to view customizations. For example, to navigate to a login page and view the results
of access profile branding customization, in the Preview window, expand Customization Settings >Access Profiles > access_profile_name > Access Policy > Logon Pages > logon_page_name.
The Preview window shows the results of any customization changes.
26
Personalizing Access Profile Appearance Settings
General page style settings for access profilesYou can customize the following settings for general page style with the Customization tool.
DescriptionValueName
Indicates the general HTML pagealignment for all pages displayed by theaccess profile.
Left, center, or right.Page alignment
Indicates the color for the general pagebackground for all pages displayed by theaccess profile.
A hex color code, for example, #123ABC.When you click the color value, two colorchoosers appear. One allows you to selecta color from 40 common color blocks, and
Pagebackgroundcolor
the other allows you to select any HTMLcolor from a more sophisticated color wheel.You can also type the color value in as text.
Specifies the width of the content on allHTML pages displayed by the access
A specific pixel value, for example 800px,or a percentage, for example 80%.
Page width (pxor %)
profile, as an absolute pixel value or as apercentage of the entire browser screen.
Font settings for access profilesYou can customize the following settings for general page style with the Customization tool.
DescriptionValueName
Specifies the base font used by pagesdisplayed by the access profile.
Font names or font-family names,space-separated, for exampleCalibri, Tahoma, Verdana,Arial, Helvetica, Sans-Serif.
Font family(comma-separated)
Indicates the pixel size for heading itemson pages displayed by the access profile.
A pixel value, for example 18px.Headline font size (px)
Indicates the pixel size for text items onpages displayed by the access profile.
A pixel value, for example 14px.Text font size (px)
Page header settings for access profilesYou can customize the following settings for the page header style with the Customization tool.
DescriptionValueName
Specifies the icon image displayed in thebrowser when the page is disconnected.
An image icon 48 x 48 pixels or smaller.Disconnect icon
Indicates the background color for HTMLheader elements for the web pages servedto web and mobile clients.
A hex color code, for example, #123ABC.When you click the color value, two colorchoosers appear. One allows you to selecta color from 40 common color blocks, and
Header backgroundcolor
27
BIG-IP Access Policy Manager Customization Guide
DescriptionValueName
the other allows you to select any HTMLcolor from a more sophisticated colorwheel. You can also type the color valuein as text.
The header image for web pages. Toreplace this image, type the relative path,
An image name. This is a larger image upto 80 x 80 pixels, for display on webpages.
Header left image(Full Size)
or click the preview icon to the right ofthe filename, and click Replace.
The header image for mobile device pages.To replace this image, type the relative
An image name. This is a smaller imageup to 32 x 32 pixels, for display on mobiledevices.
Header left image(Mobile DevicesSize) path, or click the preview icon to the right
of the filename, and click Replace.
Page footer settings for access profilesYou can customize the following settings for the page footer style with the Customization tool.
DescriptionValueName
Specifies the font size for text in web pagefooters.
A font size, in pixels, for example12px.
Footer font size (px)
Layout settings for access profilesYou can customize the following settings for page layouts with the Customization tool.
DescriptionValueName
Specifies the width of the login pageform in pixels or as a percentage ofthe frame.
Width, in pixels or percentage, of the mainlogin page form, for example 240px, or 50%.
Form cell width(px or %)
Specifies the width of the login pageimage area in pixels or as apercentage of the frame.
Width, in pixels or percentage, of the mainlogin page image cell width, for example240px, or 50%.
Image cell width(px or %)
Indicates the background color forthe login page main frame.
A hex color code, for example, #123ABC.When you click the color value, two colorchoosers appear. One allows you to select a
Main tablebackground color
color from 40 common color blocks, and theother allows you to select any HTML colorfrom a more sophisticated color wheel. Youcan also type the color value in as text.
Indicates the placement of the loginpage form on the main access policypage.
Form left, form center, or form right.Page layout
28
Personalizing Access Profile Appearance Settings
Image settings for access profilesYou can customize the following settings for the main page image with the Customization tool.
DescriptionValueName
Specifies the width of the login pageform in pixels or as a percentage of theframe.
Width, in pixels or percentage, of themain login page form, for example240px, or 50%.
Default image
Specifies the left margin of the loginpage image.
Left side margin, in pixels, of the mainlogin page image, for example 24px.
Image left margin (px)
Specifies the right margin of the loginpage image.
Right side margin, in pixels, of the mainlogin page image, for example 24px.
Image right margin(px)
Specifies the top margin of the loginpage image.
Top-edge margin, in pixels, of the mainlogin page image, for example 24px.
Image top margin (px)
Specifies the alignment of the imagewithin the side frame.
Center, left, or right.Side image alignment
Form settings for access profilesYou can customize the following settings for the login form with the Customization tool.
DescriptionValueName
Specifies the alignment of theform within the form frame.
Center, left, or right.Form alignment
Indicates the background colorfor the login page form.
A hex color code, for example, #123ABC. Whenyou click the color value, two color choosersappear. One allows you to select a color from
Form backgroundcolor
40 common color blocks, and the other allowsyou to select any HTML color from a moresophisticated color wheel. You can also typethe color value in as text.
Specifies the height of the loginform in the login frame.
Height value in pixels, as a percentage of theframe, or auto, for example 240px, 40%, orauto.
Form height (px, %,or auto)
Specifies the left margin of thelogin form.
Left margin, in pixels, of the main login pageform, for example 24px.
Form left margin(px)
Specifies the right margin of thelogin form.
Right margin, in pixels, of the main login pageform, for example 24px.
Form right margin(px)
Specifies the top margin of thelogin form.
Top margin, in pixels, of the main login pageform, for example 24px.
Form top margin(px)
Specifies the login form widthwithin the login frame.
Form width in pixels or as a percentage of theform frame, for example 250px or 50%.
Form width (px or%)
29
BIG-IP Access Policy Manager Customization Guide
Form element settings for access profilesYou can customize the following settings for the appearance of elements in the login form with theCustomization tool.
DescriptionValueName
Specifies how fields align in the login form.Center, left, or right.Field alignment
Specifies the width of fields in the login form, asa percentage of the total size of the login form.
A percentage value, forexample 67%.
Field width (%)
Specifies the alignment of header elements in thelogin form.
Left, center, or right.Header alignment
Specifies the alignment of form field labels in thelogin form.
Left, center, or right.Label alignment
Specifies whether login form field labels areabove or to the left of their respective fields.
Left or above.Label position
Specifies the width of field labels in the loginform.
A percentage value, forexample 67%.
Label width (%)
Advanced customization image settingsYou set advanced customization images to make images you add through the image browser available toyour advanced customization pages.
The Advanced Customization Images properties pages allow you to set advanced customization imagesfrom the image browser to associate with advanced customization image names. You can then use the imagename 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, clickthe button next to the current (or default) image name, and select Replace.
Personalizing page appearance for access profile logout settingsPersonalize access profile logout settings to add advanced customization image support to logout pages inthe access profile.
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. Under Form Factor: Full/Mobile Browser, select the Branding tab.5. Expand the folders in the Customization tool to customize settings. Navigate to Customization Settings
> Access Profiles > access_profile_name > Logout to configure logout settings.6. Customize the settings for advanced customization images.
30
Personalizing Access Profile Appearance Settings
7. After you customize settings, click the Save icon at the top of the Customization tool.
The access policy advanced customization page reflects your changes.
Advanced customization image settingsYou set advanced customization images to make images you add through the image browser available toyour advanced customization pages.
The Advanced Customization Images properties pages allow you to set advanced customization imagesfrom the image browser to associate with advanced customization image names. You can then use the imagename 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, clickthe button next to the current (or default) image name, and select Replace.
Personalizing page appearance for access policy pagesPersonalize access policy pages to change advanced customization images for the login page in a specificaccess policy, and to add advanced customization images for other access policy pages.
1. On the Main tab, click Access Policy > Customization.The Customization tool appears, in Basic Customization view.
2. In Advanced Customization view, from the Form Factor menu at the top of the Customization tool,select Full/Mobile Browser.
3. Under Form Factor: Full/Mobile Browser, select the Branding tab.4. Expand the folders in the Customization tool to customize settings. Navigate to Customization Settings
> Access Profiles > access_profile_name > Access Policy, and select the folder of the item to customize.5. Customize the settings for each individual element by clicking on the element and changing the displayed
settings.6. After you customize settings, click the Save icon at the top of the Customization tool.
The access policy pages reflect your changes.
Customization settings for access policy itemsYou can personalize the following settings for pages exposed to the user in an access policy.
DescriptionValueName
The image that appears in the image frame of the login page for anaccess policy.
ImageGeneral > Frontimage
Each Advanced Customization Images properties page allows you toset advanced customization images from the image browser to associate
ImagesAdvancedCustomizationImages with advanced customization image names. Each access policy item
has a page for advanced customization images. You can use theseimage names to add an image to a page using advanced customization.To select an image from the image browser to associate with an imagefor advanced customization, click the button next to the current (ordefault) image name, and select Replace.
31
BIG-IP Access Policy Manager Customization Guide
Localizing messages for BIG-IP Edge ClientConfigure localization for BIG-IP Edge Client to change the messages and text in the BIG-IP Edge Clientapplication.
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 BIG-IP Edge Client.
4. Expand the folders in the Customization tool navigation pane to select the BIG-IP Edge Client inCustomization Settings > Connectivity Profiles > name_of_connectivity_profile > BIG-IP Edge Client.
5. At the top right-side of the customization settings pane, select the Language for which to customizelocalization messages for the BIG-IP Edge Client.
6. Customize the settings for BIG-IP Edge Client localization.7. After you customize settings, click the Save icon at the top of the Customization tool.
Previewing customization changes
You must have customized an element with the Customization tool to see a preview of your changes.
After you customize and save an element with the Customization tool, you can preview the changes youhave made in the Preview window. The Preview window opens a separate browser window, and shows alive update of changes as you save them.
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. At the top of the Customization tool, click the Preview button.4. Navigate to a page to view customizations. For example, to navigate to a login page and view the results
of access profile branding customization, in the Preview window, expand Customization Settings >Access Profiles > access_profile_name > Access Policy > Logon Pages > logon_page_name.
The Preview window shows the results of any customization changes.
Customization settings for BIG-IP Edge Client localizationYou can customize the following settings for BIG-IP Edge Client customization with the Customizationtool.
DescriptionValueName
The text that appears as a link in the about area of the BIG-IPEdge Client.
A URLAbout link
32
Personalizing Access Profile Appearance Settings
DescriptionValueName
Text, typically copyright info or some other identifyinginformation, that appears in the about area of the BIG-IP EdgeClient.
TextAbout text
The application name, which appears in the status bar of theapplication.
TextApplication Name
33
BIG-IP Access Policy Manager Customization Guide
34
Personalizing Access Profile Appearance Settings
Chapter5Personalizing Webtop Appearance Settings in AdvancedView
Topics:
What is webtop appearance personalization? Personalizing page appearance for webtops
What is webtop appearance personalization?You can customize the appearance of a webtop, including the layout of the webtop screen, images, andcolors associated with the webtop.
Personalizing page appearance for webtopsPersonalize webtop appearance settings to change the appearance and layout of specific webtops.
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. Under Form Factor: Full/Mobile Browser select the Branding tab.5. Expand the folders in the Customization tool to customize settings.6. Navigate to Customization Settings > Webtops > webtop_name.7. Customize the settings for each individual element by clicking on the element and changing the displayed
settings.8. After you customize settings, click the Save icon at the top of the Customization tool.
The webtop pages display your changes.
Webtop network connectivity status icons settingsYou can customize the following icons for connectivity status on the webtop.
DescriptionValueName
Specifies the image for the connected status lighton the webtop.
16x16px imageConnected icon
Specifies the image for the disconnected status lighton the webtop.
16x16px imageDisconnected icon
Specifies the image that displays while the client isconnecting.
32x32px imageWaiting icon
CSS sprite image settingYou can specify the portal access connection CSS sprites image with this setting.
36
Personalizing Webtop Appearance Settings in Advanced View
DescriptionValueName
Specifies the image to use for sprites to constructthe webtop windows.
An image fileCSS Sprites image
Web Applications Session Timeout settingsPortal access timeouts cause special behavior on the portal access webtop screen. When the session reachesthe session timeout guard time, BIG-IPAccess Policy Manager displays a session timeout warning, anddims the screen behind the warning. Depending on the type of timeout, the user sees different choices. Youcan use the following options to customize and configure session timeout options.
DescriptionValueName
Specifies the color of the background thatappears behind the session timeout
A hex color code, for example,#123ABC. When you click the
'Inactivity Timeout'background color
warning pop-up screen, when the timeoutoccurs because the session is inactive.
color value, two color choosersappear. One allows you to select acolor from 40 common colorblocks, and the other allows youto select any HTML color from amore sophisticated color wheel.You can also type the color valuein as text.
Specifies the color of the background thatappears behind the session timeout
A hex color code, for example,#123ABC. When you click the
'Maximum SessionTimeout' backgroundcolor warning pop-up screen, when the timeout
occurs because the session has reachedthe maximum timeout.
color value, two color choosersappear. One allows you to select acolor from 40 common colorblocks, and the other allows youto select any HTML color from amore sophisticated color wheel.You can also type the color valuein as text.
Indicates the page background color forthe timeout dialog box presented by
A hex color code, for example,#123ABC. When you click the
Dialog background color
session inactivity timeouts or maximumsession timeouts.
color value, two color choosersappear. One allows you to select acolor from 40 common colorblocks, and the other allows youto select any HTML color from amore sophisticated color wheel.You can also type the color valuein as text.
Specifies the width, in pixels, of thetimeout dialog.
Number (px)Dialog x-size in pixels
Specifies the height, in pixels, of thetimeout dialog.
Number (px)Dialog y-size in pixels
37
BIG-IP Access Policy Manager Customization Guide
DescriptionValueName
Specifies the opacity of the backgroundthat appears behind the session timeoutwarning pop-up screen.
Number (1-100)Dimmed opacitypercentage
Specifies the number of seconds beforetimeout that the session timeout warningpop-up screen appears.
Number (seconds)Guard time
Specifies the offset from the left and topmargin of the CSS Sprites image for the
Coordinates in px (-left, -top)Position of buttonsBackground image
button background image that appearswhen the mouse hover.
(hover) in CSS Spritesimage
Specifies the offset from the left and topmargin of the CSS Sprites image for thebutton background image.
Coordinates in px (-left, -top)Position of buttonsBackground image inCSS Sprites image
Specifies the offset from the left and topmargin of the CSS Sprites image for thebackground hover image.
Coordinates in px (-left, -top)Position of headerBackground image inCSS Sprites image
Specifies the offset from the left and topmargin of the CSS Sprites image for theleft-side mouse hover image.
Coordinates in px (-left, -top)Position of Left Sidepartimage (hover) in CSSSprites image
Specifies the offset from the left and topmargin of the CSS Sprites image for theleft-side image.
Coordinates in px (-left, -top)Position of Left Sidepartimage in CSS Spritesimage
Specifies the offset from the left and topmargin of the CSS Sprites image for thelogout image.
Coordinates in px (-left, -top)Position of Logout imagein CSS Sprites image
Specifies the offset from the left and topmargin of the CSS Sprites image for theright-side hover image.
Coordinates in px (-left, -top)Position of Right Sidepartimage (hover) in CSSSprites image
Specifies the offset from the left and topmargin of the CSS Sprites image for theright-side image.
Coordinates in px (-left, -top)Position of Right Sidepartimage in CSS Spritesimage
Specifies the offset from the left and topmargin of the CSS Sprites image for thewarning image.
Coordinates in px (-left, -top)Position of Warningimage in CSS Spritesimage
Web Applications Hometab settingsPortal access connections include an optional hometab, which provides buttons and links for working withportal access and a URL bar. You can customize and configure the hometab with the following options.
DescriptionValueName
Specifies the color of the background thatappears behind the data entry fields onthe hometab.
A hex color code, for example,#123ABC. When you click the colorvalue, two color choosers appear.One allows you to select a color
Data entry backgroundcolor
38
Personalizing Webtop Appearance Settings in Advanced View
DescriptionValueName
from 40 common color blocks, andthe other allows you to select anyHTML color from a moresophisticated color wheel. You canalso type the color value in as text.
Specifies the color of the borders for thedata entry area.
A hex color code, for example,#123ABC. When you click the colorvalue, two color choosers appear.
Data entry left and rightborder color
One allows you to select a colorfrom 40 common color blocks, andthe other allows you to select anyHTML color from a moresophisticated color wheel. You canalso type the color value in as text.
Specifies the text color for data entryfields.
A hex color code, for example,#123ABC. When you click the colorvalue, two color choosers appear.
Data entry text color
One allows you to select a colorfrom 40 common color blocks, andthe other allows you to select anyHTML color from a moresophisticated color wheel. You canalso type the color value in as text.
Specifies the font size on the hometab.pixel value (for example, 14px)Font size (px)Specifies the link text color on thehometab.
A hex color code, for example,#123ABC. When you click the colorvalue, two color choosers appear.
Link color
One allows you to select a colorfrom 40 common color blocks, andthe other allows you to select anyHTML color from a moresophisticated color wheel. You canalso type the color value in as text.
Specifies the color for links when themouse hovers over them.
A hex color code, for example,#123ABC. When you click the colorvalue, two color choosers appear.
Link color (hover)
One allows you to select a colorfrom 40 common color blocks, andthe other allows you to select anyHTML color from a moresophisticated color wheel. You canalso type the color value in as text.
Specifies the offset from the left and topmargin of the CSS Sprites image for the
coordinates in px (-left, -top)Position of Backgroundimage (hover) in CSSSprites image background image that appears when the
mouse hovers.
39
BIG-IP Access Policy Manager Customization Guide
DescriptionValueName
Specifies the offset from the left and topmargin of the CSS Sprites image for thebackground image.
coordinates in px (-left, -top)Position of Backgroundimage in CSS Spritesimage
Specifies the offset from the left and topmargin of the CSS Sprites image for thedivider image.
coordinates in px (-left, -top)Position of divider imagein CSS Sprites image
Specifies the offset from the left and topmargin of the CSS Sprites image for theHome image.
coordinates in px (-left, -top)Position of home imagein CSS Sprites image
Specifies the offset from the left and topmargin of the CSS Sprites image for theleft side image.
coordinates in px (-left, -top)Position of Left Sidepartimage in CSS Spritesimage
Specifies the offset from the left and topmargin of the CSS Sprites image for thelogout image.
coordinates in px (-left, -top)Position of Logout imagein CSS Sprites image
Specifies the offset from the left and topmargin of the CSS Sprites image for the
coordinates in px (-left, -top)Position ofOpen-In-New-Window
"open in new window" image, when themouse hovers over it.
image (hover) in CSSSprites image
Specifies the offset from the left and topmargin of the CSS Sprites image for the"open in new window" image.
coordinates in px (-left, -top)Position ofOpen-In-New-Windowimage in CSS Spritesimage
Specifies the offset from the left and topmargin of the CSS Sprites image for the
coordinates in px (-left, -top)Position of Reducedtoolbar image (hover) inCSS Sprites image minimized toolbar image, when the
mouse hovers over it.
Specifies the offset from the left and topmargin of the CSS Sprites image for theminimized toolbar image.
coordinates in px (-left, -top)Position of Reducedtoolbar image in CSSSprites image
Specifies the offset from the left and topmargin of the CSS Sprites image for theright side image.
coordinates in px (-left, -top)Position of RightSidepart image in CSSSprites image
Specifies the offset from the left and topmargin of the CSS Sprites image for the
coordinates in px (-left, -top)Position of Shrink image(hover) in CSS Spritesimage shrink image, when the mouse hovers
over it.
Specifies the offset from the left and topmargin of the CSS Sprites image for theshrink image.
coordinates in px (-left, -top)Position of Shrink imagein CSS Sprites image
Specifies the offset from the left and topmargin of the CSS Sprites image for thewarning image.
coordinates in px (-left, -top)Position of Transparentbackground image inCSS Sprites image
40
Personalizing Webtop Appearance Settings in Advanced View
DescriptionValueName
Specifies the offset from the left and topmargin of the CSS Sprites image for thetransparent side image.
coordinates in px (-left, -top)Position of Transparentsidepart image in CSSSprites image
This is a comma-separated list of all theelements displayed on the hometab. The
comma-separated listSet of elements to bedisplayed
hometab is arranged in the order in whichyou specify these elements. Elements canbe used more than once. The defaultspecification isshrink,divider,home,url,logout.
You can specify the following elementsfor the home tab:
Specifies the hometab shrinkelement.
shrink
Specifies a hometab fieldseparator element.
divider
Specifies the hometab URLbox element.
url
Specifies the home link andtext element.
home
Specifies the logout link andimage element.
logout
Full webtop settingsYou can configure the appearance of the full webtop with these settings.
DescriptionValueName
Specifies the image for the header message icon on the full webtop. Tochange the image, click the image popout button at the right of the field,
ImageHeader messageicon
then click Replace. Select an image file to replace the image file. Notethat you can add files to the Customization tool in the image browser.
Specifies the image that a webtop user can click to open the webtop onlinehelp. To change the image, click the image popout button at the right of
ImageHelp window logo
the field, then click Replace. Select an image file to replace the imagefile. Note that you can add files to the Customization tool in the imagebrowser.
Specifies the image that a user clicks to go to a site from the webtoptoolbar. To change the image, click the image popout button at the right
ImageToolbar - go icon
of the field, then click Replace. Select an image file to replace the imagefile. Note that you can add files to the Customization tool in the imagebrowser.
Specifies the image that a user clicks to open the help from the webtoptoolbar. To change the image, click the image popout button at the right
ImageToolbar - helpicon
41
BIG-IP Access Policy Manager Customization Guide
DescriptionValueName
of the field, then click Replace. Select an image file to replace the imagefile. Note that you can add files to the Customization tool in the imagebrowser.
Full webtop popup window settingYou can add the company logo to the full webtop with this setting.
DescriptionValueName
Specifies the image for the company logo on the full webtop. To changethe image, click the image popout button at the right of the field, then
ImageCompany logo
click Replace. Select an image file to replace the image file. Note thatyou can add files to the Customization tool in the image browser.
Advanced customization image settingsYou set advanced customization images to make images you add through the image browser available toyour advanced customization pages.
The Advanced Customization Images properties pages allow you to set advanced customization imagesfrom the image browser to associate with advanced customization image names. You can then use the imagename 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, clickthe button next to the current (or default) image name, and select Replace.
42
Personalizing Webtop Appearance Settings in Advanced View
Chapter6Personalizing Images for Resources in Advanced ViewTopics:
What is resource image personalization? Personalizing resource images
What is resource image personalization?With image personalization, you can change the image displayed for a resource on the webtop.
Personalizing resource imagesPersonalize webtop resource images to provide customized icons on the full webtop for resources.
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. Click the Branding tab.5. Select the resource type folder for App Tunnels, Network Access, Remote Desktops, Portal Access,
or Webtop Links.6. Select the resource name.7. At the top right of the customization settings pane, select the Language for which to customize the
caption and description for full and mobile browsers.8. In the Image area, click the icon at the right of the field to show the current icon, then click Replace
and select a new image.9. After you customize settings, click the Save icon at the top of the Customization tool.
44
Personalizing Images for Resources in Advanced View
Chapter7Localizing Messages and Images in Advanced ViewTopics:
What is full and mobile browser localization? Localizing messages for common access
profile settings Localizing layout and content of the logon
page Localizing layout and content of logout pages Localizing error messages Localizing logon pages Localizing decision pages Localizing message box pages Localizing ending pages
What is full and mobile browser localization?With localization, you can change the text and messages for web browsers and mobile clients for anylanguage defined in an access profile. The Customization tool provides a tree view that you can use tonavigate through the hierarchy of access profile items, in order to localize messages.
Localizing messages for common access profile settingsLocalize common access profile pages to configure headers, footers, and standard warnings and text messagesfor 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 footersettings, 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 customizelocalization 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.
DescriptionOptions
Specifies the warning when JavaScript is not enabled in thebrowser.
JavaScript disabled warning
Specifies the link text to start a new session.New session link
Specifies the text that appears before the new session link.New session text
9. After you customize settings, click the Save icon at the top of the Customization tool.
Localizing layout and content of the logon pageCustomize the layout and content of components that appear on the logon page when the access policy isstarting by customizing the framework pages.
Note: Use an HTML editor to edit the HTML code for the framework installation. The code appearsunformatted and without line breaks in the Customization tool.
46
Localizing Messages and Images in Advanced View
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 customizelocalization 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 settingsYou can customize the following settings for general page style with the Customization tool.
DescriptionValueName
Specifies the page text and links that prompt a user to installa new ActiveX browser component. This screen appears forWindows Internet Explorer users only.
FormattedHTML text
ActiveX install optionsscreen
Specifies the page text and links displayed when the user'sbrowser does not currently allow software installation. This
FormattedHTML text
Allow browser plugininstall screen
page contains information about how to enable softwareinstallation, and links to continue to install plug-ins or tocontinue without installing the browser plug-ins.
Specifies the page text and links displayed when the user'sbrowser does not currently allow software installation. This
FormattedHTML text
Allow browser plugininstall screen (Linux)
page contains information about how to enable softwareinstallation, and links for continuing to install plug-ins or tocontinue without installing the browser plug-ins. This screenappears for Linux operating systems and browsers.
Specifies the page text and links that prompt a user to installa new browser plug-in component. This screen provides
FormattedHTML text
Browser plugin installwith manual installoptions screen manual download and installation options. This screen appears
for most operating systems and browsers.
Specifies the page text and links that prompt a user to installa new browser plug-in component. This screen provides
FormattedHTML text
Browser plug-in installwith manual installoptions screen (Linux) manual download and installation options. This screen appears
for Linux operating systems and browsers.
Specifies the page text and links that appear when theinstallation of software with a Java applet fails. This page
FormattedHTML text
Java applet installfailure screen
allows the user options to restart the session, download andmanually install the software, or continue without installingsoftware. This page appears only on non-Windows systems.
Specifies the text that appears on a page with a Java appletto install a new browser plugin. This page appears only on
FormattedHTML text
Java applet installscreen
non-Windows systems. Java applet install started screen on
47
BIG-IP Access Policy Manager Customization Guide
DescriptionValueName
Safari browser specifies the page text and links that appearwhen the Java applet is installing software. This page appearsonly on Macintosh systems with the Safari web browser.
Specifies the page text and links that appear when the Javaapplet is installing software. This page appears only onnon-Windows systems.
FormattedHTML text
Java applet installstarted screen
Endpoint security settingsYou can customize the following settings for endpoint security messages that appear in web browsers andon mobile devices with the Customization tool.
DescriptionValueName
Specifies the message displayed while the antivirus checkaction is checking the system.
TextAntivirus check message
Specifies the message displayed when the cache and sessioncontrol ActiveX control is loading and the user may beprompted to allow cache and session control installation.
TextCache and session controlActiveX loading message
Specifies the text displayed when the client requiresActiveX to start the cache and session control plug-in, andActiveX is not available or enabled.
TextCache and session controlActiveX missing message
Specifies the link text that the user clicks to continue whenthe cache and session control plug-in cannot load.
TextCache and session controlcontinue link
Specifies the message displayed when a popup blocker isenabled. The message includes information on how to allow
TextCache and session controlblocked popup message
popups from the BIG-IP device. Note: We recommendthat you use an HTML editor to edit the HTML code forthis box. The code appears unformatted and without linebreaks in the box.
Specifies the message displayed when the cache and sessioncontrol plug-in fails to start. The message includes
TextCache and session controlfailure message
information on possible causes. Note: We recommend thatyou use an HTML editor to edit the HTML code for thisbox. The code appears unformatted and without line breaksin the box.
Specifies the text displayed while the cache and sessioncontrol plug-in starts. Note: We recommend that you use
TextCache and session controlloading message
an HTML editor to edit the HTML code for this box. Thecode appears unformatted and without line breaks in thebox.
Specifies the message displayed when the system ischecking the client for an unspecified action.
TextChecking client message
Specifies the link text that the user clicks to continue afteropening a new browser window.
TextContinue link
48
Localizing Messages and Images in Advanced View
DescriptionValueName
Specifies the messages displayed when client-side securitychecks fail. You can specify link text to cancel and link text
TextContinue without endpointinspection message
to continue. The continue link allows the client to continueon the fallback branch.
Specifies the message displayed while the client isdownloading software components.
TextDownloading message(appended to other messages)
Specifies the message displayed while the file check actionis checking the system.
TextFile check message
Specifies the message displayed while the firewall checkaction is checking the system.
TextFirewall check message
Specifies the message displayed while the client is installingsoftware.
TextInstalling message (appendedto other messages)
Specifies the message displayed when the client is collectingmachine info for the machine info check.
TextMachine check info message
Specifies the message displayed when browser settingshave changed, and the user must open a new browserwindow to continue.
TextNew browser window requiredmessage
Specifies the message displayed while the process checkaction is checking the system.
TextProcess check message
Specifies the link text that the user clicks to hide the virtualkeyboard.
TextVirtual keyboard hide keyboardlink
Specifies the label for the virtual keyboard.TextVirtual keyboard label
Specifies the message displayed while the Windows grouppolicy action is configuring the system.
TextWindows Group Policy actionmessage
Specifies the message displayed while the Windowsinformation check action is checking the system.
TextWindows Info check message
Specifies the message displayed while the Windowsmachine certificate check action is checking the system.
TextWindows machine certificatecheck message
Specifies the message displayed while the ProtectedWorkspace action is starting the protected workspace.
TextWindows Protected Workspaceaction message
Specifies the link text specified that the user can click tocontinue without starting protected workspace.
TextWindows Protected Workspacecontinue link
Specifies the message displayed when the protectedworkspace starts, and the system requires some time todisplay the protected workspace.
TextWindows Protected Workspacecontinuing: extended message
Specifies the message displayed on the client whenprotected workspace resumes the logon procedure afterstarting.
TextWindows Protected Workspacelogon: short message
Specifies the message displayed when protected workspacehas successfully started,
TextWindows Protected Workspacestarted: close browser message
Specifies the message displayed while the registry checkaction is checking the system.
TextWindows Registry checkmessage
49
BIG-IP Access Policy Manager Customization Guide
Localizing layout and content of logout pagesCustomize the layout and content of components that appear on logout pages when the access policy oruser ends a session.
1. On the Main tab, click Ac