StyleBookを使用して証明書ストアからSSL証明書を管理する

最終公開日 : Sep 25, 2026
NetScaler Consoleの証明書ストアを使用すると、SSL証明書を1か所に保存して管理できます。そのため、SSL証明書をNetScaler Consoleに保存し、NetScalerの設定中に再利用できます。
この記事では、NetScaler Consoleの証明書ストアからSSL証明書をアップロードして再利用できるStyleBook定義を作成する方法について説明します。

パラメータ

StyleBook定義は、新しい組み込みパラメータタイプとしてcertkeyをサポートしています。このパラメータタイプを使用して、NetScaler Consoleの証明書ストアからSSL証明書を再利用できます。
parameters:
-
    name: certificate
    label: Certificate
    description: "Certificate to be bound to this virtual load balanced application"
    type: certkey
    required: true
この例では、証明書パラメータはNetScaler Consoleの証明書ストアからのSSL証明書または証明書チェーンを指します。
StyleBook定義では、certkeyパラメータについて以下のプロパティを参照できます。
  • certkeyname – インスタンスに構成するSSL証明書キーの名前。
  • cert_filename – SSL証明書のファイル名。
  • password – 必要に応じてSSL証明書にアクセスするために必要なパスワード。
  • key_filename – SSL証明書キーのファイル名。
  • keyfile_contents – SSL証明書の内容。
  • subject – SSL証明書に記載されているサブジェクト。
  • issuer – SSL証明書を発行した機関。
  • certchain_certkeyname – 証明書チェーンの名前。
    注:
    サーバー証明書は、複数の階層型認証局 (CA) によって署名されることがあり、その場合、証明書はチェーンを形成します。証明書ストアに証明書チェーンがある場合は、このプロパティを使用します。これにより、証明書を参照してまとめてバインドできます。構成パックを作成すると、証明書チェーンはリストとして表示されます。
これらのプロパティは、StyleBook 定義で必要なコンポーネントを作成するのに役立ちます。

コンポーネント

StyleBook に type: certkey パラメーターがある場合、NetScaler Console 証明書ストアからこのパラメーターの証明書を提供できます。このワークフローでは、NetScaler Console 証明書ストアから証明書を表示および選択するだけでなく、次のことも実行できます。
  • 新しい証明書をアップロードします。
  • 既存の証明書を更新します。たとえば、期限切れの証明書などです。
  • 証明書を削除します。
注:
  • NetScaler Console SSL ダッシュボードを使用して、NetScaler Console 証明書ストアの証明書を管理することもできます。
  • NetScaler Console 証明書ストアで SSL 証明書を更新した後、その SSL 証明書に関連付けられている構成パックを更新する必要があります。構成パックの更新の詳細については、API を使用して既存の構成パックを更新する または 構成パックを作成および編集する を参照してください。

StyleBook を構築する

次の StyleBook 定義は、NetScaler Console 証明書ストアの SSL 証明書を使用します。この StyleBook には、メイン証明書とキーファイルを NetScaler インスタンスにアップロードするコンポーネントが含まれています。これらのファイルがすでに NetScaler インスタンスに存在する場合、NetScaler Console はアップロード手順をスキップし、これらのコンポーネントは効果がありません。
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