Zero-touch certificate management

Zero-touch certificate management automates the installation and management of SSL certificates, eliminating the need for manual configuration. By uploading certificates to NetScaler Console, administrators can centralize certificate management. NetScaler then periodically polls both NetScaler Console and packet engine, intelligently identifies the changes to the zero-touch certificate store. This ensures that the packet engine remains synchronized with the zero-touch certificate store on NetScaler Console. Through this process, the packet engine automatically handles the otherwise tedious tasks of adding, binding, and linking certificates, streamlining the certificate management process.

Benefits of zero-touch certificate management

By enabling the zero-touch certificate management feature, you can ensure that the underlying processes are done without any manual intervention:

• Adding, binding, and linking the certificates
• Providing certificates and keys in a specific order or together
• Installing and using the best suitable certificate during TLS handshake.
• Deleting the expired certificates from the packet engine.
• Pushing certificates with a future issue date to the packet engine from NetScaler Console once the date is valid.

With the zero-touch certificate management feature, you can prevent the following errors commonly associated with manual processes:

• Overwriting certificates or keys. If you upload another certificate or key with the same name that exists on NetScaler, it overwrites the existing one. This might cause applications to go down after a reboot.
• Accidental certificate deletion can lead to application downtime after a reboot.

To enable the zero-touch certificate management feature, see Zero-touch certificate management.

How it works

The following picture shows the workflow of zero-touch certificate management:

The following are the high-level steps involved in zero-touch certificate management.

• An admin uploads all certificates and keys, in any format, to NetScaler Console. For more information on uploading certificates and keys, see Zero-touch certificate management.
• NetScaler Console validates and stores the certificates and keys in the database.
• The zero-touch certificate store validates and discards the files that are in an incorrect format. The supported file formats are:
  • Certificate (PEM or DER)
  • Private Keys
  • Password-protected private keys
  • CA certificates (Root or Intermediate certificates)
  • PFX files
  • Certificate bundle
• NetScaler pulls the certificates and keys from NetScaler Console and pushes them to the packet engine.
• The packet engine then handles tasks such as installing, deleting, adding, binding, and linking the certificates and keys.
• During each polling, NetScaler performs a comparison to identify any certificates and keys that are present in the packet engine but not in NetScaler Console. In such cases, it deletes these certificates and keys from the packet engine, ensuring the system remains synchronized with NetScaler Console.

Note:

Ensure that the instance is managed by NetScaler Console. Enable the zero-touch certificate management feature in NetScaler Console. For more information, see Zero-touch certificate management.

Certificates states in NetScaler

Certificates in NetScaler can be active or inactive.

• Active Certificates: Certificates that are available for immediate use. NetScaler selects server certificates for TLS transactions based on the received SNI or the default SNI configured on a virtual server.
• Inactive Certificates: The certificates in NetScaler might become inactive due to any of the following reasons.
  • The private key for the server certificate is not present on the remote server.
  • The server certificate contains SAN entries that conflict with multiple other active certificates.
  • The server certificate contains SAN entries that conflict with one of the active certificates but do not cover all the SAN entries of the active certificate.
  • The server certificate contains SAN entries conflicting with an active certificate and has an earlier expiry date than the active certificate.
  • The server certificate contains a SAN that exceeds the maximum allowed entries.
  • The server certificate does not have a common name.
  • The SSL certificate has a common name or SAN name that exceeds the maximum allowed length.
  • The server certificate is inactive due to a lack of memory in the packet engine.
  • The CA certificate is inactive because its property increases the request message length beyond 14 KB.
  • The CA certificate is inactive because its distinguished name cannot be encoded for the certificate request message.

CA certificate management

CA certificates uploaded to NetScaler Console are used to authenticate both the client and server once installed on the packet engine. The maximum length of the certificate request message is 14 KB. CAs included in the certificate request message remain in an active state and participate in the TLS authentication process, while others are in an inactive state. If any active CA certificate is deleted, NetScaler reassesses the list of active certificates.

CA certificates fetched from NetScaler Console are used for the TLS handshake if the zero-touch certificate management feature is enabled and no server certificate is bound to a virtual server.

Note:

• Uploaded certificates are classified as CA certificates if the basic constraints extension has the CA field set to true. Otherwise, they are considered as server certificates.
• Certificates and keys are available in the packet engine and not physically stored in NetScaler.

TLS handshake process

During the TLS handshake, the server certificate is selected based on the Server Name Indication (SNI) received from the client. To support clients that do not include the SNI extension in their request, NetScaler provides an option to configure a default SNI. To configure the default SNI, use the following command:

set ssl vserver -defaultSNI <sni_name>

Notes:

• The administrator must ensure that the certificate corresponding to the default SNI is uploaded to NetScaler Console.
• The server certificates fetched from NetScaler Console are used for the TLS handshake if the zero-touch certificate management feature is enabled and no server certificate is bound to a virtual server.

View the certificate and key list

NetScaler displays the source of the certificates and keys as remote if they are fetched from NetScaler Console.

Also, you can verify whether the zero touch certificate management feature is enabled using the show command.

To view the status of zero-touch Certificate management using the CLI

At the command prompt, type:

show ssl zerotouchparam

Example:

show ssl zerotouchparam

        SSL Zerotouch Config Params: ENABLED
                Remoteserver IP  : 10.146.111.81
                Keyfile Name     : sslparam.key

 Zerotouch Certfetcher Polled Status:
                Request Status     : SUCCESS
                Request Type       : GET-LIST
                HTTP Status Code   : 200
                Time-Stamp         : 2024-10-08T09:15:56Z
                Next Polling At    : 2024-10-08T09:25:56Z
 Done
<!--NeedCopy-->

To view the certificate source using CLI

At the command prompt, type:

show ssl certkey

Example(Certificate which is in active state):

show ssl certkey

 Name: 023a2b9d-de07-b53a-70b8-b925fc09efe8
        Certificate Source: REMOTE      Certkey Status: ACTIVE
        Cert Path: entity654_ec.crt
        Key Path: entity654_ec.key
        Format: PEM
        Status: Valid,   Days to expiration:3635
        Certificate Expiry Monitor: DISABLED
        Certificate Type:       "Client Certificate"    "Server Certificate"
        Version: 3
        Serial Number: 12494655570E02CA2B5CCCB1DC317C41271B8BD1
        Signature Algorithm: sha256WithRSAEncryption
        Issuer:  CN=Intermediate5.Root4
        Validity
                Not Before: Oct  1 10:15:53 2024 GMT
                Not After : Sep 29 10:15:53 2034 GMT
        Subject:  CN=Entity6.Intermediate5.Root4
        Public Key Algorithm: id-ecPublicKey
        Digest:
        Public Key size: 256
        Ocsp Response Status: NONE
        deleteCertKeyFilesOnRemoval:
 Done
<!--NeedCopy-->

Example(Certificate which is in inactive state):

show ssl certkey
Name: ed9d7c90-6f28-5407-8073-346440044e34
        Certificate Source: REMOTE      Certkey Status: INACTIVE(No Private Key)
        Cert Path: server_rsa_4096_9.crt
        Format: PEM
        Status: Valid,   Days to expiration:280
        Certificate Expiry Monitor: DISABLED
        Certificate Type:       "Server Certificate"
        Version: 3
        Serial Number: 04B5502077AFC2EF9581F49BDFA104C9360CA6D2
        Signature Algorithm: sha256WithRSAEncryption
        Issuer:  C=US,ST=InterState2,L=InterCity2,O=InterOrganization2,OU=InterUnit2,CN=IntermediateCA2_9/emailAddress=intermediate29@example.com
        Validity
                Not Before: Jul 23 09:47:54 2024 GMT
                Not After : Jul 23 09:47:54 2025 GMT
        Subject:  C=US,ST=ServerState,L=ServerCity,O=ServerOrganization,OU=ServerUnit,CN=Server9/emailAddress=server9@example.com
        Public Key Algorithm: rsaEncryption
        Digest:
        Public Key size: 4096
        Ocsp Response Status: NONE
Done
<!--NeedCopy-->

To view the certificate source using the GUI

1. Navigate to Traffic Management > SSL > Certificates

2. On the Certificates page, the list of certificates and keys is displayed along with the source.

Restrict virtual servers with limited domain

The virtual servers configured on NetScaler can access all the domains using the server certificates uploaded in NetScaler Console. You have the option to restrict access by configuring the virtual server with a limited domain.

Restrict the virtual servers with a limited domain using CLI

At the command prompt, type:

add policy patset <name> [-patsetFile <string>]
bind policy patset <name> <string>  [-index <positive_integer>]
add ssl policy <name> -rule <expression>
bind ssl vserver <vServerName> (-policyName <string> [-priority <positive_integer>] [-type <type>])
<!--NeedCopy-->

Example:

add policy patset pat_sni_list
bind policy patset pat_sni_list Server8 -index 1
bind policy patset pat_sni_list Server1 -index 2
bind policy patset pat_sni_list Server3 -index 3
add ssl policy pol_ssl_sni_allowed -rule "client.ssl.client_hello.sni.equals_any(\"pat_sni_list\").not" -action RESET
bind ssl vserver v1 -policyName pol_ssl_sni_allowed -priority 1 -type CLIENTHELLO_REQ
<!--NeedCopy-->

Restrict the virtual servers with a limited domain using the GUI

1. Create the patterns and bind them to the pattern set.

   For information on creating and binding, see Configure a pattern set.

2. Configure an SSL policy.

   For information on configuring an SSL policy, see Configure an SSL policy by using the GUI.

3. Bind an SSL policy to a virtual server.

   For more information, see Bind an SSL policy to a virtual server by using the GUI.

Limitations

• VPN and authentication virtual servers are not part of the zero-touch certificate management feature. You have to manually bind the certificates to the virtual servers.
  • VPN and authentication virtual server might not come up automatically when you run the add vpn/auth v-server command.
  • After the virtual server is operational, if server certificates are manually bound to it and later unbound, its state might not be marked as down.
• The following features are not supported in the release 14.1 build 34. x:
  • OCSP
  • CRL
  • TLS1.3
  • Admin partition
• Multiple NetScaler devices managed by a single NetScaler Console have access to the entire zero-touch certificate store.
• The zero-touch certificate management feature cannot be enabled in MPX 14 K and SDX 14 K.