- Overview
- Reference Guide
- Setup & Architecture
- Release Notes
- Workflow
- API Reference
- Integration Guide
- Discovery Agent Setup Guide
NetScaler
The Citrix NS Agent is a windows service that works with CertSecure Manager to automate the renewal of the SSL certificate-key pairs on a Citrix NetScaler appliance. Each agent manages one NetScaler appliance, and you can register more than one agent if you manage more than one appliance. Once it is deployed, the Citrix NS Agent renews a certificate end to end, from generating the key pair and Certificate Signing Request (CSR) to installing the renewed certificate on the appliance, over SSH and using the NetScaler’s own CLI commands. Any virtual server or service already bound to the certificate-key pair keeps its binding automatically.
This section is divided into four parts. We recommend reading the Workflow first to understand how a renewal works, and then following the Setup to deploy the Citrix NS Agent in your environment.
- Workflow – explains the end-to-end renewal process and the data flow between the CertSecure Backend, the Citrix NS Agent, and the NetScaler, from polling for a renewal task to installing the renewed certificate and reporting the result back to CertSecure Manager. It also describes how automatic renewal decides when a certificate is due.
- Setup – covers the prerequisites for the agent host and the NetScaler, including network access and account permissions, followed by the steps to install, register, and validate the Citrix NS Agent.
- UI Guide – how to add the certificate-key pairs CertSecure should manage, renew certificates manually or automatically, and view the renewal tasks.
- Troubleshooting – what to check for installation, connectivity, and renewal errors, and where to find the agent log.