Administrar certificados SSL desde el almacén de certificados mediante StyleBooks

Last published : Oct 02, 2026
El almacén de certificados de NetScaler Console le ayuda a almacenar y administrar sus certificados SSL en una única ubicación. Así, puede almacenar certificados SSL en NetScaler Console y reutilizarlos durante la configuración de NetScaler.
Este artículo describe cómo crear una definición de StyleBook que le permite cargar y reutilizar certificados SSL desde el almacén de certificados de NetScaler Console.
Related information
Crear y usar StyleBooks personalizados

Parámetros

La definición de StyleBook admite certkey como un nuevo tipo de parámetro integrado. Utilice este tipo de parámetro para reutilizar certificados SSL del almacén de certificados de NetScaler Console.
parameters:
-
    name: certificate
    label: Certificate
    description: "Certificate to be bound to this virtual load balanced application"
    type: certkey
    required: true
En este ejemplo, el parámetro de certificado se refiere a un certificado SSL o a una cadena de certificados del almacén de certificados de NetScaler Console.
En la definición de StyleBook, puede hacer referencia a las siguientes propiedades para un parámetro certkey:
  • certkeyname – Nombre de la clave del certificado SSL que desea configurar en una instancia.
  • cert_filename – Nombre de archivo de un certificado SSL.
  • password – Contraseña necesaria para acceder a un certificado SSL si es necesario.
  • key_filename – Nombre de archivo de una clave de certificado SSL.
  • keyfile_contents – Contenido de un certificado SSL.
  • subject – Asunto mencionado en un certificado SSL.
  • issuer – Autoridad que emitió el certificado SSL.
  • certchain_certkeyname – Nombre de la cadena de certificados.
    Nota:
    A veces, varias Autoridades de Certificación (CA) jerárquicas firman los certificados de servidor, lo que significa que los certificados forman una cadena. Utilice esta propiedad cuando el almacén de certificados tenga una cadena de certificados. Le ayuda a referenciar y vincular los certificados. Al crear un paquete de configuración, la cadena de certificados aparece como una lista.
Estas propiedades le ayudan a crear los componentes necesarios en la definición de StyleBook.

Componentes

Cuando un StyleBook tiene un parámetro type: certkey, puede proporcionar un certificado para este parámetro desde el almacén de certificados de NetScaler Console. En este flujo de trabajo, además de ver y seleccionar certificados del almacén de certificados de NetScaler Console, también puede hacer lo siguiente:
  • Cargar nuevos certificados.
  • Actualizar certificados existentes. Por ejemplo, certificados caducados.
  • Eliminar certificados.
Nota:

Cree su StyleBook

La siguiente definición de StyleBook utiliza certificados SSL del almacén de certificados de NetScaler Console. Este StyleBook incluye componentes que cargan los archivos de certificado principal y clave en la instancia de NetScaler. Si estos archivos ya están presentes en la instancia de NetScaler, NetScaler Console omite los pasos de carga y estos componentes no tienen ningún efecto.
name: lb-with-cert-from-certstore
namespace: com.example.stylebooks
version: "1.0"
display-name: Application using a CertStore certificate
description: This StyleBook defines a simple SSL Vserver.
schema-version: "1.0"

import-stylebooks:
 -
    namespace: netscaler.nitro.config
    version: "13.0"
    prefix: ns

parameters:
 -
  name: name
  type: string
  label: Application Name
  description: Give a name to the application configuration.
  required: true
 -
  name: ip
  type: ipaddress
  label: Application Virtual IP (VIP)
  description: The Application VIP that clients access
  required: true
 -
  name: certificate
  label: Application Certificate
  description: Certificate chain and key to be bound to this application
  type: certkey
  required: true


components:
 -
    name: pem-cert-files-comp
    type: ns::systemfile
    description: This component uploads the PEM certificate file onto the NetScaler
    condition: $parameters.certificate
    properties:
      filename: $parameters.certificate.cert_filename
      filelocation: /nsconfig/ssl
      filecontent: base64($parameters.certificate.certfile_contents)
      fileencoding: BASE64
 -
    name: pem-KEY-files-comp
    type: ns::systemfile
    description: This component uploads the PEM key file onto the NetScaler.
    condition: $parameters.certificate
    properties:
      filename: $parameters.certificate.key_filename
      filelocation: /nsconfig/ssl
      filecontent: base64($parameters.certificate.keyfile_contents)
      fileencoding: BASE64
 -
    name: cert-files-comp
    type: ns::sslcertkey
    description: This component creates the certkey on the NetScaler using the uploaded files.
    condition: $parameters.certificate
    properties:
      certkey:  $parameters.certificate.certkeyname
      cert: $parameters.certificate.cert_filename
      key: $parameters.certificate.key_filename
 -
  name: lbvserver-comp
  type: ns::lbvserver
  description: This component creates the lbvserver of the application.
  properties:
   name: $parameters.name + "-lbvserver"
   servicetype: SSL
   ipv46: $parameters.ip
   port: 443
   lbmethod: ROUNDROBIN
  components:
      -
        name: sslvserver-comp
        type: ns::sslvserver
        description: This component configures SSL settings on the vserver
        properties:
          vservername: $parent.properties.name
          ssl3?: ENABLED
          tls1?: ENABLED
          tls11?: ENABLED
      -
       name: cert-bindings-adv-comp
       type: ns::sslvserver_sslcertkey_binding
       description: This component binds the certkey to the vserver
       condition: $parameters.certificate
       properties:
         vservername: $parent.properties.name
         certkeyname: $parameters.certificate.certkeyname