使用样书管理证书库中的 SSL 证书
NetScaler 控制台证书存储可帮助您在一个位置存储和管理 SSL 证书。因此，您可以将 SSL 证书存储在 NetScaler 控制台中，并在配置 NetScaler 期间重复使用它们。
本文介绍如何创建样书定义，允许您上载和重用 NetScaler 控制台证书存储区中的 SSL 证书。
参数
样书 定义支持 certkey 作为新的内置参数类型。使用此参数类型可重用 NetScaler 控制台证书存储库中的 SSL 证书。
parameters:
-
name: certificate
label: Certificate
description: "Certificate to be bound to this virtual load balanced application"
type: certkey
required: true
<!--NeedCopy-->
在此示例中，证书参数是指来自 NetScaler 控制台证书存储库的 SSL 证书或证书链。
在 样书 定义中，您可以引用 certkey 参数的以下属性：
-
certkeyname— 要在实例上配置的 SSL 证书密钥的名称。 -
cert_filename— SSL 证书的文件名。 -
password— 必要时访问 SSL 证书所需的密码。 -
key_filename— SSL 证书密钥的文件名。 -
keyfile_contents— SSL 证书的文件内容。 -
subject— SSL 证书中提到的主题。 -
issuer— 它指颁发 SSL 证书的颁发机构。 -
certchain_certkeyname— 有时，服务器证书由多个分层证书颁发机构 (CA) 签署，这意味着证书形成链。当证书存储有证书链时，使用此属性。它可以帮助您将证书引用和绑定在一起。创建配置包时，证书链显示为列表。
这些属性可帮助您在 样书 定义中创建所需的组件。
组件
当样书有 参数时type: certkey，样书用户可以从 NetScaler 控制台证书存储库中为该参数提供证书。在此工作流程中，除了从 NetScaler 控制台证书存储库中查看和选择证书外，用户还可以执行以下操作：
- 上载新证书。
- 更新现有证书。例如，过期的证书。
- 移除证书。
备注
您还可以使用 NetScaler 控制台SSL 控制面板管理 NetScaler 控制台证书存储库中的证书。
在 NetScaler 控制台证书存储库中更新 SSL 证书时，与 SSL 证书关联的配置包会自动更新。
构建您的样书
以下是样书定义示例。它是一个使用来自 NetScaler 控制台证书存储库的 SSL 证书的完整定义。该样书包含将主证书和密钥文件上载到 NetScaler 实例的组件。如果这些文件已经存在于 NetScaler 实例上，则 NetScaler 控制台将跳过上载步骤，这些组件将不起作用。
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
<!--NeedCopy-->