Citrix Gateway

Configure DTLS VPN virtual server using SSL VPN virtual server

You can now configure a DTLS VPN virtual server for a Citrix ADC appliance using the same IP and port number of a configured SSL VPN virtual server. Configuring DTLS VPN virtual servers enables you to bind the advanced DTLS ciphers and certificates to the DTLS traffic for an enhanced security. From release 13.0 build 47.x, DTLS 1.2 protocol is supported in addition to the earlier supported DTLS 1.0 protocol.

Note: By default, the DTLS functionality is set to ON for the existing SSL VPN virtual server. Disable the functionality for the server before creating the DTLS VPN virtual server.

Points to note

  • Before you configure a DTLS VPN virtual server on a Citrix ADC appliance, you must have configured an SSL VPN virtual server on the appliance.

  • The DTLS VPN virtual server uses the IP address and the port number of the configured SSL VPN virtual server.

  • By default, the DTLS functionality is set to ON for the existing SSL VPN virtual server. Disable the DTLS functionality for the server before creating the DTLS VPN virtual server.

  • SSL policy and SSL profile are not supported on a DTLS VPN virtual server. Also, the binding of VPN virtual server policy is not supported.

  • The following features are not supported for the DTLS VPN virtual server:
    • Unified Gateway with CS virtual server
    • UDP MUX
    • PCOIP
  • The following command related to the statistics for the DTLS VPN virtual server is not supported, stat vpn vserver.

Configure DTLS VPN virtual server

To configure a DTLS VPN virtual server by using the Citrix ADC GUI

  1. On the Configuration tab, navigate to Citrix Gateway > Virtual Servers.
  2. On the Citrix Gateway Virtual Servers page, select the existing SSL VPN virtual server and click Edit.
  3. On the VPN Virtual Server page, click the edit icon and clear the DTLS check box and click OK.

    Clear the DTLS check box

  4. Click the back arrow icon on the VPN Virtual Server to navigate to the Citrix Gateway Virtual Servers page and click Add.

    Virtual servers page

  5. Under Basic Settings, enter the values for the following fields and Click OK.

    • Name - A name for the DTLS VPN virtual server
    • Protocol - Select DTLS from the drop-down list menu
    • IP Address – Enter SSL VPN virtual server IP address
    • Port – Enter SSL VPN virtual server port number.

    Add a virtual server

  6. On the VPN Virtual Servers page, click the arrow under Certificates to select the required cert key. You can use an existing SSL cert key or create one. Click the radio button next to the desired certificate key and click Select.

    Select a certificate key

  7. Click Bind on the Server Certificate Binding page.

    Bind a certificate key

  8. To use DTLS 1.2, enable the same. On the VPN Virtual Servers page, click edit icon under SSL Parameters. Enable DTLS 1.2 check box and click OK.

    Enable DTLS 1.2

    DTLS VPN virtual server configuration is now complete.

To configure a DTLS VPN virtual server by using the command line interface, at the command prompt, type the following sets of commands:

set vpn vserver <ssl vpnvserver name> -dtls off
add vpn vserver <dtls vpnvserver name> dtls <ssl vpn vserver IP> <ssl vpn vserver port>
bind ssl vservser <dtls vpnvserver name> -certkeyName <existing ssl cert key or newly created cert key>

DTLS 1.0 works as usual, to use DTLS 1.2, type the following command:

set ssl vserver < dtls vpnvserver name > -dtls12 ENABLED

Example

set vpn vserver vpnvserver  -dtls off
add vpn vserver vpnvserver_dtls dtls 10.108.45.220 443
bind ssl vservser vpnvserver_dtls -certkeyName sslcertkey
set ssl vserver vpnvserver_dtls -dtls12 ENABLED

The list of supported DTLS VPN virtual server parameters are as follows:

  • Ipaddress
  • Port
  • State
  • Double hop
  • downstateflush
  • Comment
  • Appflowlog
  • Icmpvsrresponse

To configure a DTLS virtual server using the XA/XD wizard

  1. On the XA/XD setup wizard, select StoreFront and click Continue.

    XA/XD setup wizard

  2. On the Citrix Gateway Settings page, enable Configure a DTLS Listener for this VPN VServer check box and click Continue.

    Citrix Gateway Settings page

  3. Notice that the DTLS Listener is now configured. Click Choose File to select server certificate and click Continue.

    Select server certificate

  4. Specify certificate file and Key file name and click Continue.

    Specify certificate file and Key file name

  5. Under the StoreFront section, provide the values for the required parameters as follows and click Continue.

    StoreFront section

  6. Provide the values for the required parameters as follows and click Test Connection.

    Test Connection

  7. Ensure that the server is reachable, provide Time out value and Server Logon Name Attribute, and click Continue.

    Specify configuration values

  8. Finally, click Done to complete the configuration.

    Configuration complete

Configure DTLS VPN virtual server using SSL VPN virtual server