Veritas NetBackup™ コマンドリファレンスガイド
- 概要
- 付録 A. NetBackup コマンド
名前
configureWebServerCerts — は、NetBackup または外部の認証局をサポートするように NetBackup ドメインを有効にする方法を提供します。ユーザーが NetBackup Web サーバーの証明書を構成するようにします。
概要
configureWebServerCerts -addNBCert
configureWebServerCerts -removeNBCert [-force]
configureWebServerCerts -addExternalCert [-nbHost | -webUI | -all] {[-certPath path_to_certificate_file] [-privateKeyPath path_to_certificate_key_file] [-trustStorePath path_to_CA_certificate_file] [-passphrasePath path_to_passphrase_file]} [-crlCheckLevel DISABLE | LEAF | CHAIN] [-crlPath directory_path_to_CRLs]
configureWebServerCerts -addExternalCert [-nbHost | -webUI] [-copyNbHost | -copyWebUI ]
configureWebServerCerts -removeExternalCert [-nbHost | -webUI | -all] [-force]
configureWebServerCerts -validateExternalCert {[-certPath path_to_certificate_file] [-privateKeyPath path_to_certificate_key_file] [-trustStorePathpath_to_CA_certificate_file] [-passphrasePathpath_to_passphrase_file] [-crlCheckLevel DISABLE | LEAF | CHAIN] [-crlPath directory_path_to_CRLs] [-fmt DETAILS | FAILURES_ONLY]}
On UNIX systems, the directory path to this command is /usr/openv/wmc/bin/install/
On Windows systems, the directory path to this command is install_path\NetBackup\wmc\bin\install\
説明
configureWebServerCerts コマンドは、NetBackup Web サーバー用の外部証明書または NetBackup 証明書を構成する手段を提供します。NetBackup Web サーバーインスタンスは、セキュリティ証明書のリポジトリとして Java キーストアを使用します。
このコマンドを実行するには、マスターサーバーでルート権限または管理者権限が必要です。
初めてこのコマンドを実行する場合は、実行後に NetBackup Web 管理コンソールサービス (nbwmc) を再起動する必要があります。
NetBackup Messaging Broker (nbmqbroker
) サービスが有効な場合、configureWebServerCerts コマンドを正常に実行した後にサービスを再起動する必要があります。
NetBackup は、NetBackup Web サーバー証明書のソースとして Windows 証明書ストアをサポートしていません。
このコマンドは、NetBackup Appliance には適用されません。
オプション
- -addExternalCert
Web サーバー用に外部証明書を構成します。
- -addNBCert
Web サーバー用に NetBackup 認証局が署名した証明書を構成します。
- -all
NetBackup ホスト間や NetBackup Web ユーザーインターフェースとの通信用に外部証明書を構成します。
- -certPath
証明書ファイルへのパスを指定します。このコマンドでは、Windows 証明書ストアのパスの使用はサポートされていません。
証明書ファイルには、証明書との証明書チェーンが正しい順序で含まれている必要があります。チェーンはサーバー証明書 (リーフ証明書とも呼ばれる) から始まり、ゼロ個以上の中間証明書が続きます。チェーンには、ルート CA 証明書までのすべての中間証明書が含まれている必要がありますが、ルート CA 証明書そのものは含まれていません。チェーン内の各証明書がチェーン内の前の証明書に署名するように、チェーンが作成されます。
証明書ファイルは、次のいずれかの形式である必要があります。
指定された順序で証明書が含まれた、DER または PEM エンコードされた PKCS #7 または P7B ファイル
指定された順序で結合された PEM 証明書を持つファイル
- -copyNbHost
ホストの通信に使用する証明書と同じ証明書を Web UI の通信で使用するように指定します。
- -copyWebUI
Web UI の通信に使用する証明書と同じ証明書をホストの通信で使用するように指定します。
- -crlCheckLevel
ホストの外部証明書の失効の確認レベルを指定します。次の値を指定できます。
DISABLE: 失効の確認を無効にします。ホストとの通信時に、CRL で証明書の失効状態は検証されません。
LEAF: 証明書失効リスト (CRL) でリーフ証明書の失効状態が検証されます。このオプションのデフォルト値は LEAF です。
CHAIN: CRL で証明書チェーンの証明書すべての失効状態が検証されます。
- -crlPath
外部 CA の証明書失効リスト (CRL) が保存されているディレクトリのパスを指定します。
- -fmt DETAILS | FAILURES_ONLY
外部証明書固有の構成オプションについて実行された検証チェックの詳細を提供します。DETAILS オプションを指定すると、成功と失敗を含むすべての検証チェックに関するレポートが提供されます。FAILURES_ONLY オプションを指定すると、失敗したチェックのみに関するレポートが提供されます。
- -force
証明書を強制的に削除するには -force オプションを使用します。この削除を行うと、Web サーバー用の証明書が構成されていない場合は NetBackup Web 管理コンソールサービスを起動できません。
- -nbHost
NetBackup ホスト間の通信用に外部証明書を構成します。
- -passphrasePath
秘密鍵を暗号化するためのパスフレーズが格納されたパスフレーズファイルのパスを指定します。
- -privateKeyPath
証明書の秘密鍵ファイルへのパスを指定します。
NetBackup は、プレーンテキストまたは暗号化された PKCS #1 と PKCS #8 形式の秘密鍵をサポートします。これらのファイルは、PEM または DER でエンコードされている場合があります。ただし、鍵が PKCS #1 で暗号化されている場合は、PEM でエンコードされている必要があります。暗号化された秘密鍵の場合、NetBackup は次の暗号化アルゴリズムをサポートしています。
DES、3DES、AES (秘密鍵が PKCS #1 形式の場合)
DES、3DES、AES、RC2、RC4 (秘密鍵が PKCS #8 形式の場合)
- -removeExternalCert
構成したオプションに基づいて、NetBackup ホスト間、NetBackup Web ユーザーインターフェース、またはその両方の通信用に Web サーバーに構成されている外部証明書を削除します。このコマンドは、-nbHost、-webUI、または -all オプションとともに使用します。
- -removeNBCert
NetBackup ホスト間および NetBackup Web ユーザーインターフェースとの通信用に Web サーバーに構成されている NetBackup 証明書を削除します。
- -trustStorePath
認証局バンドルファイルへのパスを指定します。認証局バンドルファイルは、次のいずれかの形式である必要があります。
信頼できるルート認証局の、バンドルされている証明書を持つ PKCS #7 または P7B ファイル。このファイルは、PEM または DER でエンコードされている場合があります。
信頼できるルート認証局の PEM エンコードされた証明書が連結されて含まれるファイル。
- -validateExternalCert
提供された外部証明書固有の構成が有効かどうかを検証します。成功と失敗の両方を含む検証チェックのレポートが提供されます。
- -webUI
NetBackup Web ユーザーインターフェースとの通信用に外部証明書を構成します。
例
例 1: NetBackup ホストの通信用に Web サーバーに外部証明書を構成します。
configureWebServerCerts -addExternaCert -nbHost -certPath /root/ example_certs/device.crt -privateKeyPath /root/example_certs/ device.key -trustStorePath /root/example_certs/rootCA.pem -passphrasePath root/example_certs/PassPhrase.txt
例 2: Web UI との通信用に構成されている証明書を使用して、ホストの通信用に Web サーバーに外部証明書を構成します。
configureWebServerCerts -addExternalCert -webUI -copyNbHost
例 3: すべての種類の通信 (Web UI や NetBackup ホスト) 用に構成されている外部証明書を削除します。
configureWebServerCerts -removeExternalCert -all