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



Tento článok momentálne nie je k dispozícii v slovenčine.

autentifikácia autorizácia dvojfaktorová


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.

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. Launch the ESA Management Console (found under Administrative Tools).
  2. Navigate to RADIUS Servers and locate the hostname of the server running the ESA RADIUS service.
  3. Right-click the hostname and select Add Client from the context menu.
  4. Configure a RADIUS client (see Figure 1-1).
  5. Click on OK - you will be prompted to restart the RADIUS Service, do so from the Services control panel.

Configuring your RADIUS client

  • To prevent locking any existing, non-2FA enabled AD users out of your VPN we recommend that you allow Active Directory passwords without OTPs during the transitioning phase. It is also recommended that you limit VPN access to a security group (for example VPNusers).
  • Make sure that the check box next to Mobile Application 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 you VPN device and your RADIUS server
  4. If you are still unable to connect, contact ESET Customer Care.

Kontaktujte nás

02/322 44 444 (pracovné dni 8:00-18:30)