Product Documentation

Configuring Single Sign-On to the Web Interface by Using a Smart Card

If you use smart cards for user logon, you can configure single sign-on to the Web Interface. You configure settings on Citrix Gateway, and then you configure the Web Interface to accept single sign-on with a smartcard. Single sign-on is also called pass-through authentication.

Web Interface Versions 5.3 and 5.4 support single sign-on to the Web Interface using a smart card. If you enable the Web Interface on Citrix ADC feature available in NetScaler version 10, you can also use single sign-on with a smartcard. For more information about configuring this feature, see Using Smart Card Authentication for Web Interface through Citrix Gateway.

Users can be in multiple CN groups in Active Directory for single sign-on to work, as long as the user name extraction in the certificate action is SubjectAltName:PrincipalName. If you use the parameter Subject:CN, users cannot be part of multiple CN groups.

To configure Citrix Gateway for single sign-on to the Web Interface by using a smart card, you need to do the following:

  • Install a signed server certificate from a Certificate Authority (CA). For more information, see Installing the Signed Certificate on Citrix Gateway.
  • Install a root certificate on Citrix Gateway and the user device.
  • Create a virtual server as the logon point for the Web Interface. When you configure the virtual server, you must set the client certificate SSL parameter to Optional. For more information about configuring a virtual server, see Creating Virtual Servers.
  • Create a secondary virtual server in which client authentication is disabled in the SSL parameters. This configuration prevents users receiving a secondary request for their personal identification number (PIN).
  • Create a client certificate authentication policy. In the User Name Field, use the parameter SubjectAltName:PrincipalName to extract users from multiple groups. Leave the Group Name Field blank.
  • Create a session policy and profile on Citrix Gateway. Within the session profile, you enable ICA proxy and specify the Web Interface and domain that you use for single sign-on.

You can use the following procedure to create a session profile for single sign-on with a smart card.

To create a session profile for single sign-on by using a smart card

  1. In the configuration utility, on the Configuration tab, in the navigation pane, expand NetScaler Gateway Policies and then click Session.
  2. In the details pane, click the Profiles tab and then click Add.

3.On the Client Experience tab, next to Home Page, click Override Global and then clear Display Home Page.

  1. Next to Single sign-on to Web Applications, click Override Global and then click Single sign-on to Web Applications.
  2. Click the Published Applications tab.
  3. Next to ICA Proxy, click Override Global and then select ON.
  4. In Web Interface Address, click Override Global and then type the fully qualified domain name (FQDN) or the Web Interface.
  5. In Single Sign-on Domain, click Override Global and then type the domain name.

    Note: You must use the format domain and not the format domain.com.

  6. Click Create and then click Close.

After you have completed the session profile, configure the session policy and use the profile as part of the policy. You can then bind the session policy to the virtual server.

Configuring Single Sign-On to the Web Interface by Using a Smart Card