Manual Chapter :
Adding Hosted Content to Access Policy Manager
Applies To:
Show VersionsBIG-IP APM
- 17.1.0, 17.0.0, 16.1.5, 16.1.4, 16.1.3, 16.1.2, 16.1.1, 16.1.0, 16.0.1, 16.0.0, 15.1.10, 15.1.9, 15.1.8, 15.1.7, 15.1.6, 15.1.5, 15.1.4, 15.1.3, 15.1.2, 15.1.1, 15.1.0, 15.0.1, 15.0.0, 14.1.5, 14.1.4, 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
Adding Hosted Content to Access Policy Manager
Editing Hosted Content with Access Policy Manager
Editing hosted files on Access Policy Manager
You can upload custom files to BIG-IP Access Policy Manager to provide resources directly to users.
You might need to edit files after you upload them to Access Policy Manager, such as to rename a file or change the file MIME type. You can make these changes using the hosted content settings.
Replace a hosted file
You can upload a new version of a file to hosted content, to replace the current file on Access Policy Manager.
- On the Main tab, click.The Manage Files screen opens.
- At bottom left of the screen, click the right-side arrow on theEditbutton to selectUpload New Versionfrom the list.TheUpload New File Versionpopup screen opens.
- For theSelect Filesetting, click theBrowsebutton and select the file to upload.TheSelect FileandFile Namefields are populated with the file name.
- If the MIME type for the file is incorrect or must be changed, from theMime Typelist, select the MIME type for the file.
- From theSecure Levelmenu, select the access level for the file.policyThe file is available only to users who have successfully completed an access policy, with anAllowending result. You might use this to display an HTML file that only a verified user can see.publicThe file is available to anyone. You might use this to allow access to an installation package that a user needs to start an access session.sessionThe file is available only to users with an active access policy session. You might use this to allow a user with an active session access to a required logon component.
- ClickOK.The file changes are saved, and the screen returns to the hosted content list.
View the hosted content list to verify your changes to the file.
Move or rename a hosted content file
You can rename or move a hosted content file on Access Policy Manager.
- On the Main tab, click.The Manage Files screen opens.
- At bottom left of the screen, click the right-side arrow on theEditbutton to selectRename/Move Filefrom the list.TheRename/Move File Propertiespopup screen opens.
- In theNew File Namefield, type a new name for the file.
- In theNew File Destination Folder, specify a new destination folder for the file.
- ClickOK.The file changes are saved, and the screen returns to the hosted content list.
Edit hosted content file properties
You can edit the permissions and MIME type for hosted content files on Access Policy Manager.
- On the Main tab, click.The Manage Files screen opens.
- At bottom left of the screen, click the right-side arrow on theEditbutton to selectEdit File Propertiesfrom the list.TheEdit File Propertiespopup screen opens.
- If the MIME type for the file is incorrect or must be changed, from theMime Typelist, select the MIME type for the file.
- From theSecure Levelmenu, select the access level for the file.policyThe file is available only to users who have successfully completed an access policy, with anAllowending result. You might use this to display an HTML file that only a verified user can see.publicThe file is available to anyone. You might use this to allow access to an installation package that a user needs to start an access session.sessionThe file is available only to users with an active access policy session. You might use this to allow a user with an active session access to a required logon component.
- ClickOK.The file changes are saved, and the screen returns to the hosted content list.
Delete a hosted file
You can delete one or more files from the hosted content on Access Policy Manager.
- On the Main tab, click.The Manage Files screen opens.
- Select one or more files to delete. To select all files, select the check box at the top of the list, next to the Name column.
- ClickDelete, and in theDelete Filepopup screen that opens, clickYes.
About uploading custom files to Access Policy Manager
You can upload custom files to BIG-IP Access Policy Manager (APM) to provide resources directly to users.
For example, you can upload BIG-IP Edge Client installers, antivirus or firewall update packages, or Citrix receiver files for your users to download. You can upload custom images, web pages, Java archives, JavaScript files, CSS files, archive files, and many other types of files as well.
Optionally, you can compress and upload multiple files as a single ZIP archive file. When you upload an archive file, you can choose to either upload the compressed file, or upload and extract the compressed file.
- Upload Only
- Select this option to upload an archived file that must remain in archive format. For example, you can upload a ZIP file for a user to download, containing a package of documents, or an application and related files. Some applications also use archived files; for example, you will upload a JAR file without extracting it.
- Upload and Extract
- Select this option to upload an archived file and extract it to the specified location. The folder hierarchy of the extracted file is preserved when you use this action. Select this option when you are uploading a collection of files that must be separated on the server for use by the end user; for example, to upload a web application that includes top-level HTML files, and subdirectories containing scripts, images, CSS, and other files.
Understanding hosted content
Hosted content is any type of file you would like to serve from Access Policy Manager (APM) to access policy users. Hosted content can include executable files, scripts, text, HTML, CSS files, and image files. You can serve hosted content from a webtop link, or from a portal access link.
Accessing hosted content
To access hosted content, a user must belong to an access profile that is associated with the hosted content. After content is uploaded to Access Policy Manager (APM), the entire hosted content library must be associated with one or more access profiles. These access profiles alone can view the content.
In addition, each file uploaded to the hosted content repository is assigned a permission level that determines the users who can access that content.
Permissions for hosted content
A permission level is assigned to each file in the hosted content repository, as described here.
Permission level | Description |
---|---|
policy | The file is available only to users who have successfully completed an access policy, with an Allow ending result, and an access profile associated with the hosted content repository. You can assign this to display an HTML file that only a verified user can see. |
public | The file is available to anyone with an access profile associated with the hosted content repository. You can assign this to allow access to an installation package that a user needs to start an access session. |
session | The file is available only to users with an active access policy session and an access profile associated with the hosted content repository. You can assign this to allow a user with an active session access to a required logon component. |
Uploading files to Access Policy Manager
Before you upload multiple files to Access Policy Manager, you can compress and combine the files into a ZIP archive file. Then, you can upload and extract the files in one step.
You can upload files to Access Policy Manager to provide content for public viewing, to provide pages and content to Portal Access connections, or to provide customized webtop links.
- On the Main tab, click.The Manage Files screen opens.
- Click theUploadbutton.The Create New File popup screen opens.
- For theSelect Filesetting, click theBrowsebutton and select the file to upload.
- To upload each file separately, select the first file, then repeat this step for all remaining files.
- To upload all files at once from a compressed file, select the compressed file.
TheSelect FileandFile Namefields are populated with the file name. - If you are uploading a compressed file that you want to extract, from theFile Actionlist, selectUpload and Extract.
- ClickOK.The file appears 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.