Gateway

Configure session policies and profiles for Citrix Endpoint Management and StoreFront

January 8, 2024

Contributed by:

To allow connections through NetScaler Gateway from the different versions of the Citrix Workspace app and by using Secure Hub, you need to create session policies and profiles for Endpoint Management and StoreFront with specific rules to enable the connections to work. You can create separate session policies and profiles for the following:

Citrix Secure Access client
Citrix Workspace app for Android
Citrix Workspace app for BlackBerry 10 1.0
Citrix Workspace app for BlackBerry 2.2
Citrix Workspace app for Chromebook
Citrix Workspace app for HTML5
Citrix Workspace app for iOS
Citrix Workspace app for Linux
Citrix Workspace app for Mac
Citrix Workspace app for Playbook 1.0
Citrix Workspace app for Windows 8/RT
Citrix Workspace app for Web
Secure Hub

When you configure the expression for Secure Hub, Citrix Workspace app for Windows, Citrix Workspace app for Mac, or Citrix Workspace app for Web, the User-Agent header always starts with CitrixCitrix Workspace app. More recent versions of the Citrix Workspace app that recognize the native protocols in Citrix Endpoint Management also include a header called X-Citrix-Gateway. When you create a rule, you can use AND (&&) or OR (\|\|) to specify the condition for the two configured expressions.

Important: We recommend that you run the Quick Configuration wizard to configure the required policies for connections to Endpoint Management and StoreFront from NetScaler Gateway. The following sections provide information about configuring the policies manually.

Configure virtual servers

If Endpoint Management is part of your deployment, you need to create two virtual servers:

The first virtual server is for users who connect by using Secure Hub. After user authentication occurs, this virtual server communicates directly with Endpoint Management.
The second virtual server is users who connect by using Citrix Workspace app for Web, Citrix Workspace app for Windows, or Citrix Workspace app for Mac. Citrix Workspace app communicates directly with StoreFront, instead of the Endpoint Management, after NetScaler Gateway authenticates users.

On each NetScaler Gateway virtual server, you must install a server certificate that has a unique fully qualified domain name.

Configure session policies

You configure session policies for Endpoint Management and StoreFront deployments. You can use the same policy expressions for both deployments, however the session profile settings are slightly different. The session policy expressions that you configure depend on the version of the Citrix Workspace app and the Citrix Secure Access client you are using.

Some versions of the Citrix Workspace app do not fully support the StoreFront services protocols that allow direct connections through NetScaler Gateway to stores in StoreFront. The earlier Citrix Workspace app versions that do not support these protocols include:

Citrix Workspace app for Windows 3.0 and earlier versions
Citrix Workspace app for Mac 11.4 and earlier versions
Citrix Workspace app for Android 3.0 and earlier versions
Citrix Workspace app for iOS 5.5 and earlier version

The following table shows the policy expression to configure based on the version of Citrix Workspace app and the Citrix Secure Access client you are using:


Citrix Workspace app version does not support StoreFront services protocols	`HTTP.REQ.HEADER("User-Agent").CONTAINS("CitrixReceiver") && HTTP.REQ.HEADER("X-Citrix-Gateway").EXISTS.NOT`
Citrix Secure Hub or Citrix Workspace app version supports StoreFront services protocols	`HTTP.REQ.HEADER("User-Agent").CONTAINS("CitrixReceiver") && HTTP.REQ.HEADER("X-Citrix-Gateway").EXISTS`
Citrix Secure Access client for Windows; Citrix Secure Access client for Mac	`HTTP.REQ.HEADER("User-Agent").CONTAINS("CitrixReceiver").NOT`
Citrix Workspace app for the Web	`HTTP.REQ.HEADER("User-Agent").CONTAINS ("CitrixReceiver").NOT`
Citrix Workspace app for Windows 8/RT	`HTTP.REQ.HEADER("User-Agent").CONTAINS("CitrixReceiver") && HTTP.REQ.HEADER("User-Agent").CONTAINS("WindowsRT")`

When you configure the policy expression for Citrix Workspace app versions, you can distinguish between the Citrix Workspace app type in the policy expression.


Citrix Workspace app for Android	`HTTP.REQ.HEADER("User-Agent").CONTAINS("CitrixReceiver") && HTTP.REQ.HEADER("User-Agent").CONTAINS("Android")`
Citrix Workspace app for BlackBerry 2.2	`HTTP.REQ.HEADER("User-Agent").CONTAINS("CitrixReceiver") && HTTP.REQ.HEADER("User-Agent").CONTAINS("Blackberry")`
Citrix Workspace app for Chromebook	`HTTP.REQ.HEADER("User-Agent").CONTAINS("CitrixReceiver") && HTTP.REQ.HEADER("User-Agent").CONTAINS("Chromebook")`
Citrix Workspace app for HTML5	`HTTP.REQ.HEADER("User-Agent").CONTAINS("CitrixReceiver") && HTTP.REQ.HEADER("User-Agent").CONTAINS("HTML5")`
Citrix Workspace app for iOS	`HTTP.REQ.HEADER("User-Agent").CONTAINS("CitrixReceiver") && HTTP.REQ.HEADER("User-Agent").CONTAINS("iOS")`
Citrix Workspace app for Linux	`HTTP.REQ.HEADER("User-Agent").CONTAINS("CitrixReceiver") && HTTP.REQ.HEADER("User-Agent").CONTAINS("Linux")`
Citrix Workspace app for Mac	`HTTP.REQ.HEADER("User-Agent").CONTAINS("CitrixReceiver") && HTTP.REQ.HEADER("User-Agent").CONTAINS("MacOSX")`
Citrix Workspace app for Playbook 1.0	`HTTP.REQ.HEADER("User-Agent").CONTAINS("CitrixReceiver") && HTTP.REQ.HEADER("User-Agent").CONTAINS("Playbook")`
Citrix Workspace app for Windows 8/RT. 1.3	`HTTP.REQ.HEADER("User-Agent").CONTAINS("CitrixReceiver") && HTTP.REQ.HEADER("User-Agent").CONTAINS("Win8")`
Citrix Workspace app for Windows	`HTTP.REQ.HEADER("User-Agent").CONTAINS("CitrixReceiver") && HTTP.REQ.HEADER("User-Agent").CONTAINS("Windows")`
Citrix Workspace app for Windows Phone 8	`HTTP.REQ.HEADER("User-Agent").CONTAINS("CitrixReceiver") && HTTP.REQ.HEADER("User-Agent").CONTAINS("WindowsPhone")`
Citrix Secure Hub	`HTTP.REQ.HEADER("User-Agent").CONTAINS("CitrixReceiver") && HTTP.REQ.HEADER("User-Agent").CONTAINS("Windows")`

If you configure a session policy that supports StoreFront services protocols and the Citrix Workspace app for iOS, the expression might look like the following:

HTTP.REQ.HEADER("User-Agent").CONTAINS("CitrixReceiver") && HTTP.REQ.HEADER("X-Citrix-Gateway").EXISTS && HTTP.REQ.HEADER("User-Agent").CONTAINS("iOS)

To configure expressions in session policies

When you configure the expression for a session policy, use the following guidelines. You can use this procedure for Endpoint Management and StoreFront deployments.

Go to NetScaler Gateway > Policies > Session.
In the details pane, click Add. Note: To modify a session policy, in the details pane, select the policy and then click Edit.
In the Create NetScaler Gateway Session Policies and Profiles, select the Session Policies tab and then click Add.
In the Create NetScaler Gateway Session Policy page, enter a name for the policy.
In Profile, select an existing profile or click Add and create a new profile.
Add an expression.
1. Click Advanced Policy and then click Expression Editor.
2. In Expression Editor, select the following in sequence. HTTP > REQ > HEADER and then type the parameter, such as **CitrixReceiver**.
Repeat the steps to configure the additional rules.
When you finish adding the rules, click Create and then click Close.

Configure session profiles

When you configure session profiles for use with a session policy, you need to configure parameters that are specific for the type of connection the profile supports.

If the StoreFront IP address is a public IP address and if you disable split tunneling in the session profile, SSO functionality is internally disabled on NetScaler Gateway. Users receive an access denied error message when they attempt to log on to StoreFront. Enable split tunneling to allow SSO from a public IP address.

When you finish configuring the policy and profile, you then bind the session policy to the virtual server. You also need to assign a priority number for each session policy.

The session profiles that you configure have different settings for Endpoint Management and StoreFront. For more information, see the topics for Endpoint Management and StoreFront later in this section.

The official version of this content is in English. Some of the Cloud Software Group documentation content is machine translated for your convenience only. Cloud Software Group has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Cloud Software Group product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Cloud Software Group, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Cloud Software Group will not be held responsible for any damage or issues that may arise from using machine-translated content.

Was this helpful

Configure session policies and profiles for Citrix Endpoint Management and StoreFront

January 8, 2024

Contributed by:

January 8, 2024

Contributed by:

Configure session policies and profiles for Citrix Endpoint Management and StoreFront

Configure virtual servers

Configure session policies

To configure expressions in session policies

Configure session profiles

In this article