Product Documentation

Configuring NetScaler Gateway for File Type Association

Before you configure file type association on NetScaler Gateway, configure a Web Interface site to work with file type association. After you create and configure the Web Interface, you need to create settings on NetScaler Gateway. The steps include:

  • Creating a new virtual server or using an existing one. For more information about creating a virtual server, see Creating Virtual Servers.
  • Creating a new session policy and profile that has the Web Interface configured.
  • Binding the session policy to the virtual server.
  • Creating a traffic policy.

After you create the session policy and bind it to the virtual server, create the traffic policy and also bind it to the virtual server.

When you configure a traffic policy for file type association, you create an expression to define the file extensions. For example, you want to enable file type association for Microsoft Word and Microsoft Excel. An example expression is:

REQ.HTTP.URL == /\*.doc || REQ.HTTP.URL == /\*.xls

To create a session policy and profile for file type association

  1. In the configuration utility, click the Configuration tab and then in the navigation pane, expand NetScaler Gateway > Policies and then click Session.
  2. In the details pane, on the Policies tab, click Add.
  3. In Name, type a name for the policy.
  4. Next to Request Profile, click New.
  5. In Name, type a name for the profile.
  6. On the Published Applications tab, configure the following settings:
    1. Next to Web Interface Address, click Override Global and then type the Web address of the Web Interface.
    2. Next to Web Interface Portal Mode, click Override Global and then select either Normal or Compact.
    3. Next to Single Sign-on Domain, click Override Global, type the name of the domain in which the user accounts reside and then click Create.
  7. In the Create Session Policy dialog box, next to Named Expression, select True value, click Add Expression, click Create and then click Close.

To create a traffic profile for file type association

  1. In the configuration utility, on the Configuration tab, in the navigation pane, expand NetScaler Gateway Policies and then click Traffic.
  2. In the details pane, click the Profiles tab and then click Add.
  3. In Name, type a name for the profile.
  4. In File Type Association, select ON, click Create and then click Close.

To configure file type association in a traffic policy

  1. In the configuration utility, on the Configuration tab, in the navigation pane, expand NetScaler Gateway Policies and then click Traffic.
  2. In the details pane, on the Policies tab, click Add.
  3. In Name, type a name for the policy.
  4. In Request Profile, select a profile.
  5. In the Create Traffic Policy dialog box, under Expressions, select Advanced Free-Form and then click Add.
  6. In the Add Expression dialog box, do the following:
    1. In Expression Type, click General.
    2. In Flow Type, select REQ.
    3. In Protocol, select HTTP.
    4. In Qualifier, select URL.
    5. In Operator, select = =.
    6. In Value, type /*.FileExtensionType, where .FileExtensionType is the file type, such as .doc or .xls and then click OK.
  7. In the Create Traffic Policy dialog box, under Expressions, next to Advanced Free-Form, click OR.
  8. Repeat Steps 4, 5 and 6 for each file extension you want to include, click Create and then click Close.