Citrix ADC connector
With a Citrix ADC connector, you can use DigiCert® Trust Lifecycle Manager to discover and manage certificates on a Citrix ADC (NetScaler) network appliance. The connector uses an on-premises DigiCert sensor within your network to help securely manage the Citrix appliance.
When you add the connector, Trust Lifecycle Manager discovers existing certificates on the Citrix appliance and adds them to your centralized inventory. From there, you can manage and automate certificate lifecycles on the appliance to ensure it always has valid certificates installed.
Supported Citrix appliances
Trust Lifecycle Manager supports certificate discovery and automation for load balancing, content switching, AAA authentication, and Citrix Gateway virtual servers on the following Citrix appliance versions.
Before you begin
To configure the Citrix connector in Trust Lifecycle Manager, you need:
The management IP address and management port for the Citrix appliance.
The web protocol (HTTP or HTTPS) to use for NITRO REST API access.
Credentials for a Citrix system user that can sign in over the selected web protocol. The user password must contain uppercase and lowercase letters, numbers, or symbols. For this appliance type, the allowed symbols are
~!@#$%^*()_+-|`{}[]:;?/,.".The required command permissions for the partitions for which the connector will discover and manage assets:
For the default partition, use a Citrix superuser account or a user assigned the built-in
superusercommand policy.For non-default partitions, you can use a superuser account or a user that has the required command permissions and is assigned to each applicable partition. To grant only the minimum permissions required by the connector, configure the custom command policy described in the following section:
The Citrix connector requires one or more DigiCert® sensors on your network with connectivity to the Citrix appliance management port (port 443 by default for HTTPS access).
For fault-tolerant connectivity, select multiple sensors. If one sensor becomes unavailable, Trust Lifecycle Manager automatically uses another selected sensor.
To use credentials from a privileged access management (PAM) vault, you need a secrets manager connector in Trust Lifecycle Manager.
To configure the Citrix connector and manage the integration, you need the Manager user role for Trust Lifecycle Manager.
Add the Citrix connector
To add the Citrix ADC connector in Trust Lifecycle Manager:
From the Trust Lifecycle Manager menu, go to Integrations > Connectors.
Select Add connector.
In the Appliances section, select Citrix ADC.
Complete the Add connector form:
Name: Enter a friendly name for the connector to help identify it.
Business unit: Select a business unit for this connector for administrative purposes. Only users assigned to this business unit can manage the connector.
Managing sensor: Select one or more active DigiCert sensors to establish the connection and manage the appliance. Selecting multiple sensors provides fault-tolerant connectivity.
Management IP: Enter the management IP address for the appliance.
Management port: Enter the management port number for the appliance.
Web protocol: Select whether to use HTTP or HTTPS for REST API access to the appliance.
Authentication settings: Select how to provide the connector’s authentication credentials, and configure the required settings for the selected option.
Certificate assignment rules: (Optional) Select assignment rules for automatically assigning metadata to certificates discovered on the appliance.
Select Add to create the appliance connector with the configured settings.
Unlock or replace password-protected certificates
The Citrix connector discovers password-protected PKCS#12 (PFX) certificates and lists them in Inventory > Endpoints under the Automated view, with an automation status of Configured. To start monitoring and managing these endpoints in Trust Lifecycle Manager, use one of the following inventory actions:
Use the Unlock certificate action to provide the password so Trust Lifecycle Manager can decrypt the existing PKCS#12 file and retrieve its certificate details.
To unlock a single certificate, select Unlock certificate from the rightmost inventory table column for that certificate. In the dialog that opens, enter the PKCS#12 password and select Unlock.
To unlock multiple certificates with the same password, select them all in the inventory table, then select Unlock certificate from the actions dropdown in the table header. In the dialog that opens, enter the PKCS#12 password and select Unlock.
Alternatively, if you do not wish to unlock an existing PKCS#12 certificate, use the Request certificate action to automate deployment of a replacement certificate on that endpoint. For details, see Manage an existing certificate deployment.
What's next
Discovery
Trust Lifecycle Manager discovers existing certificates and unsecured endpoints on the connected appliance and adds them to your centralized Inventory.
On the Integrations > Connectors page, select the connector by name to view the connector details and see the number of assets Trust Lifecycle Manager found on it. You can use the links in the Assets found section to view those assets in your inventory.
Automation
Use the managed automation solution to automate management of certificates on a connected Citrix network appliance.
Select the
DigiCert sensorenrollment method in any certificate automation profiles you create for managing certificates on the Citrix appliance.