Manual Chapter :
Hosting Files with Portal Access on Access Policy Manager
Applies To:
Show VersionsBIG-IP APM
- 15.0.1, 15.0.0, 14.1.3, 14.1.2, 14.1.0, 14.0.1, 14.0.0, 13.1.5, 13.1.4, 13.1.3, 13.1.1, 13.1.0
Hosting Files with Portal Access on Access Policy Manager
About using hosted files with a Portal Access resource
You can use hosted content that you have uploaded to the BIG-IP®
Access Policy Manager® to provide the resource and resource items for a
Portal Access resource.
When you use hosted content for a Portal Access resource, the link on the webtop for the portal
access resource opens a file hosted on the system, instead of a URI. You configure the main
Portal Access resource as this linked file. You then configure this file, and all related and
required files, as resource items of this file.
In this example, a simple web page consisting of an HTML file, a CSS file, a JavaScript file,
and an image are uploaded to a directory in the hosted content repository. The files are then
specified as a Portal Access resource and resource items.
File |
Location |
Description |
---|---|---|
index.html |
/index.html
|
The main web page that displays when the link is clicked. This is the Portal Access
Resource. |
styles.css |
/styles.css
|
The CSS file for the page index.html. |
test_image.jpg |
/test_image.jpg
|
An image that is referenced on the page index.html. |
script.js |
/js/script.js
|
A JavaScript file that is referenced from the page index.html. |
In this example, hosted content is uploaded as a single
ZIP
file,
test.zip
, then extracted to the location /test
on the
server. Uploading files to Access Policy Manager for Portal Access
You upload files to Access Policy Manager to provide content for a
Portal Access webtop link.
Before you upload multiple files to Access Policy
Manager, you can combine the files in a ZIP archive format. Then, you can upload and extract
the files in one step. In this example, four files are uploaded as a single ZIP archive,
called
test.zip
.- On the Main tab, click.The Manage Files screen opens.
- Click theUploadbutton.The Create New File popup screen opens.
- UnderSelect File, click theBrowsebutton. Browse and selecttest.zip.TheSelect FileandFile Namefields are populated with the file name.
- In theFile Destination Folderfield, specify the folder path/testin which to place the file.
- From theFile Actionlist, selectUpload and Extract.
- Click theOKbutton.The files appears in the hosted content list, in the folder specified. Any files in subfolders in the archive file also appear in subfolders in the hosted content list.
You must associate any access profiles that will access hosted content with the hosted
content repository.
Associating hosted
content with access profiles
A user can access hosted content that is
associated with that user's access profile. Each access profile that requires hosted
content access must be associated with the entire hosted content repository.
- On the Main tab, click.The Manage Files screen opens.
- On theUploadbutton, click the right-side arrow to selectManage Accessfrom the list.The Access Settings popup screen opens.
- Select the access profiles to associate with hosted content, then clickOK.A user must belong to an associated access profile to access hosted content.
View the hosted content list, and verify that the
access policy association was successful.
Creating a portal access configuration with hosted content
- On the Main tab, click.The Portal Access List screen opens.
- Click theCreatebutton.The New Resource screen opens.
- Type the name and an optional description.
- From theACL Orderlist, specify the placement for the resource.OptionDescriptionLastSelect this option to place the new portal access resource last in the ACL list.AfterSelect this option to select, from the list of configured ACLs, the ACL that this portal access resource should follow in sequence.SpecifySelect this option to specify an order number, for example,0or631for the ACL.
- FromConfiguration, selectBasicorAdvanced.TheAdvancedoption provides additional settings so you can configure a proxy host and port.
- For theMatch Case for Pathssetting, selectYesto specify that portal access matches alphabetic case when matching paths in the portal access resource.
- From thePatching Typelist, select the patching type for the web application.For both full and minimal patching types, you can select or clear patching methods specific to your selection.
- If you selectedMinimal Patchingand theHost Patchingoption, type a host search string, or multiple host search strings separated with spaces, and the host replace string, which must be the Access Policy Manager virtual server IP address or fully qualified domain name.
- Select thePublish on Webtopcheck box.
- From theLink Typelist, selectHosted Content.
- From theHosted Filelist, selectpublic/share/test/index.html.This is the filename for this example scenario only. Please select the correct file for your own configuration.
- In the Customization Settings for English area, in theCaptionfield, type a caption.The caption appears on the full webtop, and is required. This field is required even if you do not select thePublish on webtopoption.
- Optionally, in theDetailed Descriptionfield type a description for the web application.
- In theImagefield, specify an icon for the web application link. Click theView/Hidelink to show the current icon.
- If your application is behind a proxy server, to specify a proxy host and port, you must selectAdvancedfor the configuration to display additional fields, and type the proxy host and proxy port.
- Click theCreatebutton.The Portal Access resource is saved, and the Portal Access Resource screen now shows aResource Itemsarea.
This completes the portal access resource configuration.
Specify all hosted content files used by this example (all files in the
/test
folder) as resource items.Creating a portal access resource item for hosted content
You create a portal access resource item in order for hosted content to add a file that is part
of a portal access hosted content resource. For example, you might add image files, CSS files, or
scripts that are required by the web page or application. You typically use resource items to refine the
behavior for web application directories; for example, you might specify
No
Compression
and a Cache All
caching policy for the images for a
portal access resource. You must add (separately) each hosted file used by the portal
access resource, and the resource file itself, as resource items.
- On the Main tab, click.The Portal Access List screen opens.
- Click the name of a portal access resource.The Portal Access Properties screen for that resource opens.
- In the Resource Items area, click theAddbutton.A New Resource Item screen for that resource opens.
- Select that the resource item type isHosted Content.
- From theHosted Filelist, select the file to specify as a resource item.For purposes of this example, specifypublic/share/test/index.html,public/share/test/test_image.jpg,public/share/test/style.css, andpublic/share/test/js/script.js.
- Configure the properties for the resource item.
- To add headers, selectAdvancednext to New Resource Item.
- To configureSession Update,Session Timeout, andHome Tab, selectAdvancednext to Resource Item Properties.
- ClickFinished.This creates the portal access resource item.