[KB3483] How do I configure my Citrix® NetScaler device for use with ESET Secure Authentication?



This article describes how to configure a Citrix® NetScaler device to authenticate users against an ESA Server. Before proceeding, verify that you've installed the RADIUS Server component of ESET Secure Authentication and can access the RADIUS service that allows external systems to authenticate users.

Before your Citrix® NetScaler device can use the ESA Server to authenticate users via RADIUS, it must be set up as a RADIUS client on the ESA Server. Next, your server running the ESA RADIUS service must be setup as a RADIUS Server on the Citrix® NetScaler device. Once these configurations have been specified, you can start logging into your Citrix® NetScaler device using ESA OTPs.


This integration guide utilizes Client does not validate user name and password Client type for this particular VPN appliance. If you wish to utilize other Client type, refer to generic description of Client types and verify with the vendor if the VPN appliance supports it.


Step I - RADIUS client configuration

To allow the Citrix® NetScaler device to communicate with your ESA Server, you must configure the Citrix® NetScaler device as a RADIUS client on your ESA Server:

  1. Log in to ESA Web Console.
  2. Navigate to Components > RADIUS and locate the hostname of the server running the ESA RADIUS service.
  3. Click the hostname, then click Create New Radius Client.
  4. In the Basic Settings section:
    1. Give the RADIUS client a memorable name for easy reference.
    2. Configure the IP Address and Shared Secret for the Client so that they correspond to the configuration of your VPN appliance. The IP address is the internal IP address of your appliance. If your appliance communicates via IPv6, use that IP address along with the related scope ID (interface ID).
    3. The shared secret is the RADIUS shared secret for the external authenticator that you will configure on your appliance.
  5. In the Authentication section apply the settings shown in Figure 1-1 below.

Configuring your RADIUS client

  • To prevent locking any existing, non-2FA enabled AD users out of your VPN we recommend that you allow Non-2FA users during the transitioning phase. It is also recommended that you limit VPN access to a security group in the Users section.
  • Make sure that the check box next to Mobile Application OTPs is selected.

Figure 1-1

ESA has now been configured to communicate with the Citrix® NetScaler device. You must now configure the Citrix® NetScaler device to communicate with the ESA Server.


Step II - Configuring your Citrix® NetScaler device

Follow the steps below:

  1. Login to your Citrix® NetScaler administrative interface.
  2. Expand Access GatewayVirtual Servers, select your existing Access Gateway Virtual Server and click Open.
  3. In the Configure Access Gateway Virtual Server window, navigate to the Authentication tab.
  4. In the Authentication Policies section, select Primary and click Insert Policy.
  5. In the Configure Authentication Policy window, type a name for your policy (for example, ESA Authentication)
  6. Select General from the first drop-down menu and true from the second drop-down menu under Named Expressions
  7. Click Add ExpressionNew (next to Server) and set the following parameters to the values shown below:
    1. Name: ESA RADIUS
    2. IP Address: The IP Address of your ESA RADIUS Server
    3. Secret Key: As entered in Figure 1-1
    4. Confirm Secret Key: As above
    5. Password Encoding: PAP
  8. Click OK
  9. Click OK
  10. Click OK
  11. Click Save


Step III - Testing the connection

To test the newly configured connection:

  1. Navigate to the URL that you normally use for SSL VPN logins with your Citrix® NetScaler appliance.
  2. Enter the credentials of your test user. Make sure that you are using a user with Mobile Application 2FA using ESA enabled. When prompted for a password, append the OTP generated by the Mobile Application to your AD password. For example, if the user has an AD password of Esa123 and an OTP of 999111, you should type Esa123999111.



If you are unable to authenticate via the ESA RADIUS server, ensure you have performed the following steps:

  1. Run a smoke test against your RADIUS server, as per the “Verifying ESA RADIUS Functionality” document.
  2. If no faults were fixed and you are still unable to connect, revert to an existing sign-in configuration (that does not use 2FA) and verify that you are able to connect
  3. If you are still able to connect using the old settings, restore the new settings and verify that there is no firewall blocking UDP 1812 between your VPN device and your RADIUS server
  4. If you are still unable to connect, contact ESET technical support.