Applies To:

Show Versions Show Versions

Archived Manual Chapter: Using Advanced Customization
Manual Chapter
Table of Contents   |   << Previous Chapter   |   Next Chapter >>

This article has been archived, and is no longer maintained.

BIG-IP® Secure Access Manager provides a few generic end-user web pages such as logon and logoff pages. You can localize and customize these pages using the standard customization feature available in the Configuration utility. For example, you can customize or replace all text messages and images on these pages with your own defined messages. However, you cannot modify the page style and page framework using this feature, and you cannot add images to these pages. To overcome this limitation of normal customization, you can use the advanced customization feature to provide a set of your own customized pages, which can then seamlessly serve requests to the Secure Access Manager.
The purpose of this appendix is to provide examples and procedures of how you can maximize this feature through the command line interface. When you complete the tasks, you will have a working version of the functionality used in the scenario.
Important: Although flexible, this feature is intended for advanced users.
Therefore, you should carefully study the template files before using advanced customization.
For this example, you should already have configured an access policy on your system. For more information on how to create an access policy, refer to Chapter 5, Creating Access Profiles and Access Policies.
Running the advCustHelp utility to generate instructions for advanced customization.
After you have an access policy configured, the Secure Access Manager default pages are ready to serve requests using the instructions generated by the advCustHelp utility. Using the instructions, you can provide your own pages for an existing profile through advanced customization.
1.
At the UNIX command prompt, type /user/bin/advCustHelp <profile_access_name>.
2.
Use a profile that you have created.
The advCustHelp utility generates the instructions shown in Figure D.1.
The instruction file shown in Figure D.1 lists all the file names used to leverage the advanced customization feature. Additionally, it provides instructions on where to include the images, and how to link to these images in the web page.
Figure D.1 Instructions file generated by the advCustHelp utility

[root@bigip6401mgmt:Active] config # advCustHelp myProfile
Profile Name : myProfile The list of advanced customization files are /config/customization/advanced/logout/myProfile_logout/logout_en.inc /config/customization/advanced/logout/myProfile_logout/logout_ja.inc /config/customization/advanced/logout/myProfile_logout/logout_zh-cn.inc /config/customization/advanced/logout/myProfile_logout/logout_zh-tw.inc /config/customization/advanced/header/myProfile_header/header_en.inc /config/customization/advanced/header/myProfile_header/header_ja.inc /config/customization/advanced/header/myProfile_header/header_zh-cn.inc /config/customization/advanced/header/myProfile_header/header_zh-tw.inc /config/customization/advanced/footer/myProfile_footer/footer_en.inc /config/customization/advanced/footer/myProfile_footer/footer_ja.inc /config/customization/advanced/footer/myProfile_footer/footer_zh-cn.inc /config/customization/advanced/footer/myProfile_footer/footer_zh-tw.inc /config/customization/advanced/logon/myProfile_act_logon_page_ag/logon_en.inc /config/customization/advanced/logon/myProfile_act_logon_page_ag/logon_ja.inc /config/customization/advanced/logon/myProfile_act_logon_page_ag/logon_zh-cn.inc /config/customization/advanced/logon/myProfile_act_logon_page_ag/logon_zh-tw.inc /config/customization/advanced/logout/myProfile_end_denied_ag/logout_en.inc /config/customization/advanced/logout/myProfile_end_denied_ag/logout_ja.inc /config/customization/advanced/logout/myProfile_end_denied_ag/logout_zh-cn.inc /config/customization/advanced/logout/myProfile_end_denied_ag/logout_zh-tw.inc
1.
Save the required images to the following location: /config/customization/advanced/images/myProfile.
The name of the image must be in this format: [0-9][0-9].(gif|ping|jpg|jpeg|]
2.
From the advanced customization files, ensure that the image links appear like this: /public/advanced/images/myProfiles/image[0-9][0-9]. For example, image00.jpg.
You will be using a series of existing templates to create your custom pages. These templates are actual copies of the generic pages used by Secure Access Manager. We recommend that you leverage these existing templates to create your own pages.
1.
At the UNIX command prompt, type:
cd /config/customization/advanced/header/myProfile_header and press Enter.
2.
At the UNIX command prompt, type ls.
The following header pages are available: tmp_header.inc tmp_header_en.inc tmp_header_ja.inc tmp_header_zh-cn.inc tmp_header_zh-tw.inc.
The sample header page (available in different languages) includes two images: logo and banner.You can replace these images with your own images.
1.
At the UNIX command prompt, create the following directory by typing mkdir/config/customization/advanced/images/myProfile.
3.
At the UNIX command prompt, type: /config/customization/advanced/header/myProfile_header
For the purpose of this example, we are using English as the language of choice, so make sure you use the tmp_header_en.inc template. The HTML code that you display should be properly formatted for easier readability, as shown in Figure D.3.
<td><img border="0" src='/public/images/my/flogo.png'><!--[if IE 6]><img border="0" src="/public/images/my/tr.gif" class="pngfix" style="filter:progid:DXImageTransform.Microsoft.AlphaImageLoade
<td valign="middle" align="right"><img border="0" src='/public/images/my/fbanner.png'><!--[if IE 6]><img src="/public/images/my/tr.gif" border="0" class="pngfix" style="filter:progid:DXImageTra
4.
Copy the template tmp_header_en.inc to header_en.inc.
You can now use any text editor, such as vi, to modify the content of the file.
5.
After you have edited the file, the system should display code. The page is now ready to be used. You need to notify the Secure Access Manager system that the new page is ready, and you need to clear the old pages from the cache.
class="pngfix" style="filter:progid:DXImageTransform.Microsoft.AlphaImageLoader(src='/public/images/my/flogo.png',siz
<td valign="middle" align="center"><img border="0" src='/public/advanced/images/myProfile/image00.jpg'><!--[if IE
6]><img src="/public/images/my/tr.gif" border="0" class="pngfix" style="filter:progid:DXImageTransform.Microsoft.Alpha
<td valign="middle" align="right"><img border="0" src='/public/images/my/fbanner.png'><!--[if IE 6]><img src="/pub
lic/images/my/tr.gif" border="0" class="pngfix" style="filter:progid:DXImageTransform.Microsoft.AlphaImageLoader(src='
Once you have gone through the previous steps, you must activate your configuration so that the new pages display correctly.
1.
At the UNIX command prompt, type % b customization group myProfile_header action update.
2.
At the UNIX command prompt, type % b profile access myProfile generation action increment, or from the Configuration utility, you can click activate access policy from the profile you created.
The system displays the modified header page shown in Figure D.5.
Table of Contents   |   << Previous Chapter   |   Next Chapter >>

Was this resource helpful in solving your issue?




NOTE: Please do not provide personal information.



Incorrect answer. Please try again: Please enter the words to the right: Please enter the numbers you hear:

Additional Comments (optional)