Skip to main content

Citrix ADC SAML integration

Multi-Factor Authentication (MFA) is an extra layer of security used when logging into websites or apps. Individuals are authenticated through more than one required security and validation procedure that only you know or have access to.

Citrix™ ADC (formerly Netscaler) is an application delivery and load balancing solution that gives a high-quality user experience of web services and cloud-native applications, wherever hosted. Arculix by SecureAuth, as a Citrix Ready Partner, offers a simple method for adding MFA to Citrix ADC via its SAML solution.

Prerequisites

  • Arculix account with a configured Identity Provider and LDAP Agent.

    For more information, see the Arculix LDAP Agent deployment guide.

  • User account with administrative privileges for Arculix.

  • User account with administrative privileges for Citrix ADC.

Arculix SAML configuration as an Identity Provider (IdP)

In this section, you'll add an application for Citrix ADC and set the SAML configuration settings. This will be the Identity Provider (IdP) side of the configuration.

  1. Log in to Arculix with an administrative account and go to Applications.

  2. Click Create New Application.

    Create new application
  3. In the New Application form, on the General tab, set the following configurations:

    Name

    Set the name of the application. This is the name to display for push notifications, in the Admin panel, Application portal, and audit logs.

    For example, Citrix ADC.

    Type

    Set to SAML Service Provider.

    Out of Band Methods

    Select the allowed methods end users can choose to approve MFA requests.

    For example, Arculix Mobile app (push notifications), SMS, or Security Key.

    Message for MFA Requests

    (Optional) Type a message displayed to end users when sending an MFA request via push notification, SMS, or email.

    arculix_new_app_citrixadc.png
  4. Select the SAML Service Provider Configuration tab, and set the following configurations:

    Issuer or Entity ID

    Enter the Issuer/EntityID of your Citrix ADC instance.

    For example, CitrixADC.example.com.

    Log in URL

    Enter the URL used by your users to access the Citrix ADC.

    For example, https://ADC.example.com.

    Metadata URL

    Enter the URL containing metadata about your Citrix ADC instance.

    For example, https://adc.example.com/metadata/samlsp/SAML-Arculix.

    NameID Format

    Set to Email Address.

    Name Identifier

    Set to Email.

    arculix_citrixadc_saml_settings.png
  5. Save your changes.

Citrix ADC configuration

In this section, you'll configure Citrix ADC as a service provider (SP).

  1. Download the SAML metadata and certificate for your organization from Arculix.

    Metadata download: https://sso.arculix.com/<myorganization>/saml/download/metadata

    View metadata: https://sso.arculix.com/<myorganization>/saml/metadata

    Certificate download: https://sso.arculix.com/<myorganization>/saml/download/cert

  2. Log in to your Citrix ADC with an administrative account.

  3. Go to Traffic Management > SSL > SSL Certificate.

    citrix_adc-s_ssl_cert.png
  4. Upload the X.509 certificate file downloaded from Arculix in Step 1.

    citrix_adc-s_install_cert.png
  5. Connect to Citrix ADC via SSH and run the following command:

    add authentication samlaction {NAME} -samlIDPCertName {IDP Certificate Name} -samlSigningCertName {Signing Certificate Name} -samlredirectUrl {Redirect URL} 
    

    For example:

    add authentication samlaction SAML-Arculix -samlIDPCertName SAML-Arculix -samlSigningCertName lab.arculix-com.pfx_CERT_KEY -samlredirectUrl https://saml.arculix.com/saml/auth
    
  6. In Cirtrix ADC, select the Configuration tab.

  7. Select Citrix Gateway from the menu, then select Policies > Authentication> SAML.

    citrix_adc-s_saml_servers.png
  8. Select the Policies tab and click Add. Then, fill the items like the following image and click OK.

    citrix_adc-s_config_policy.png
  9. Go to the Citrix Gateway > Virtual Servers and select the virtual server you want to add SAML authentication to. Click Edit.

    citrix_adc-s_virtual_servers.png
  10. Go to Basic Authentication and choose SAML as a Primary policy.

    citrix_adc-s_saml_policy.png
  11. Click Continue.

  12. Select the SAML policy created earlier and click Bind.

    citrix_adc-s_policy_type.png

Test your application integration

  1. Go to your Citrix Gateway Virtual Server link you got from the previous section.

  2. You will be redirected to the Arculix SSO page.

    Application login page with email
  3. After successful authentication, select your preferred MFA method to approve access to Citrix ADC.

    Select an authenticator
  4. Finally, you will be redirected to your Citrix ADC landing page.

    citrix_adc-s_landing.png

Support

If you have questions or need assistance, contact SecureAuth Support.

Sales

Want to learn more about our MFA solutions? Contact our Professional Services for a demo today.

Disclaimer

All product names, trademarks, and registered trademarks are the property of their respective owners.

All company, product, and service names used in this document are for identification purposes only. The use of these names, trademarks, and brands do not constitute an endorsement by the SecureAuth Corporation.

Citrix, ADC, and ‘ADC’ are either registered trademarks or trademarks of Citrix and/or one or more of its subsidiaries in the United States and/or other countries.

Microsoft and Active Directory are either registered trademarks or trademarks of Microsoft and/or one or more of its subsidiaries in the United States and/or other countries.