big-ip access policy manager customization guide

80
BIG-IP ® Access Policy Manager ® Customization Guide Version 11.2

Upload: luisdm80

Post on 24-Sep-2015

17 views

Category:

Documents


2 download

DESCRIPTION

Big-IP APM

TRANSCRIPT

  • 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