Guide de référence des commandes Veritas NetBackup™
- Introduction
- Annexe A. Commandes NetBackup
Nom
nbkmscmd — configure le service de gestion des clés (KMS) dans NetBackup.
Synopsis
-configureCredential -credName nom_informations_authentification -certPath chemin_fichier_certificat -privateKeyPath chemin_fichier_clé_privée -trustStorePath chemin_fichier_certificat_autorité_certification [-passphrasePath chemin_fichier_phrase_passe_clé_privée] [-crlCheckLevel LEAF | CHAIN | DISABLE] [-server nom_serveur_maître] [-description description] [-force]
Pour configurer le service KMS de NetBackup (NBKMS) :
-configureKMS -name nom_configuration -type NBKMS -hmkId ID_clé_maître_hôte_pour_identifier_phrase_passe_HMK -kpkId ID_clé_protection_clé_pour_identifier_phrase_passe_KPK [-useRandomPassphrase 0 | 1] [-enabledForBackup 0 | 1] [-priority priorité_du_serveur_KMS] [-server nom_serveur_maître] [-description description]
Pour configurer un service KMS externe :
-configureKMS -name nom_configuration -type KMIP -port port_pour_connecter_au_serveur_KMS_externe -kmsServerName nom_réseau_du_serveurl_KMS_externe -credId ID_informations_authentification | -credName nom_informations_authentification [-enabledForBackup 0 | 1] [-priority priorité_du_serveur_KMS] [-server nom_serveur_maître] [-description description]
-createKey -name nom_configuration -keyName nom_de_la_clé_à _créer -keyGroupName nom_groupe_clés [-algorithm algorithme_clé] [-comment commentaire_sur_la_clé] [-keyPassphraseFilePath chemin_fichier_de_la_phrase_passe__de_la_clé] [-reason raison][-server nom_serveur_maître]
-deleteCredential -credName nom_informations_authentification | -credId ID_informations_authentifcation [-force] [-server nom_serveur_maître]
-deleteKMSConfig -name nom_configuration [-server nom_serveur_maître] [-reason raison_de_la_suppression] [-force]
-discoverNBKMS
-listCredential [-credName nom_informations_authentification | -credId ID_informations_authentification] [-server nom_serveur_maître] [-jsonCompact] [-jsonRaw] [-pageLimit nombre_enregistrements_à_répertorier_après_décalage] [-pageOffset numéro_enregistrement]
-listKeys -name nom_configuration [-keyGroupName nom_groupe_clés] [-server nom_serveur_maître] [-jsonCompact] [-jsonRaw] [-pageLimit nombre_enregistrements_à_répertorier_après_décalage] [-pageOffset numéro_enregistrement]
-listKMSConfig [-name nom_configuration] [-server nom_serveur_maître] [-jsonCompact] [-jsonRaw] [-pageLimit nombre_enregistrements_à_répertorier_après_décalage] [-pageOffset numéro_enregistrement]
-precheckKMSConfig -port port_pour_connecter_au_serveurl_KMS_externe -kmsServerName nom_réseau_du_serveur_KMS_externe -certPath chemin_fichier_certificat -privateKeyPath chemin_fichier_clé_privée -trustStorePath chemin_fichier_certificat_autorité_certification [-passphrasePath chemin_fichier_phrase_passe_clé_privée] [-crlCheckLevel LEAF | CHAIN | DISABLE] [-credId ID_informations_authentification | -credName nom_informations_authentiifcation] [-server nom_serveur_maître] [-jsonRaw]
-updateCredential -credId ID_informations_authentification | -credName nom_informations_authentiifcation -certPath chemin_fichier_certificat -privateKeyPath chemin_fichier_clé_privée -trustStorePath chemin_fichier_certificat_autorité_certification [-passphrasePath chemin_fichier_phrase_passe_clé_privée] [-crlCheckLevel LEAF | CHAIN | DISABLE] [-server nom_serveur_maître] [-description description] [-force]
Pour mettre à jour la configuration du service KMS de NetBackup (NBKMS) :
-updateKMSConfig -name nom_configuration [-server nom_serveur_maître] [-priority priorité_du_serveur_KMS] [-enabledForBackup 0 | 1] [-description description]
Pour mettre à jour la configuration du serveur KMS externe :
-updateKMSConfig -name nom_configuration [-server nom_serveur_maître] [-priority priorité_du_serveur_serveur] [-port port_à_connecter_au_serveur_KMS_externe] [-kmsServerName nom_réseau_du_serveur_KMS_externe] [-credId credential_ID | -credName nom_informations_authentification] [-enabledForBackup 0 | 1] [-description description]
-validateKMSConfig -name nom_configuration [-server nom_serveur_maître] [-jsonRaw]
Sur les systèmes UNIX, le chemin d'accès au répertoire de cette commande est /usr/openv/netbackup/bin/
Sur les systèmes Windows, le chemin d'accès au répertoire de cette commande est install_path\NetBackup\bin\
DESCRIPTION
La commande nbkmscmd permet de configurer le service de gestion des clés (KMS). Vous pouvez également créer des informations d'authentification KMS et des clés. Toutes ces commandes requièrent le privilège d'administration de NetBackup. De plus, ces opérations nécessitent la connexion Web bpnbat (bpnbat -login -loginType WEB) en utilisant un compte disposant de privilèges d'administration NetBackup.
La commande nbkmscmd prend en charge les opérations suivantes :
-configureCredential |
Ajoute les informations d'authentification de la configuration KMS dans la base de données NetBackup. L'ID des informations d'authentification et le nom correspondant sont ajoutés dans la base de données. Ces informations d'authentification sont utilisées pour se connecter au service de gestion des clés (KMS) externe. |
-configureKMS |
Ajoute une entrée pour la configuration KMS dans la base de données NetBackup. |
-createKey |
Crée une clé NetBackup active sur le serveur KMS qui est associé au nom de configuration fourni. Pour créer la clé, le serveur KMS doit autoriser NetBackup à créer la clé et à définir les attributs NetBackup sur cette clé. Pour le service de gestion des clés de NetBackup (NBKMS), si le nom du groupe de clés n'existe pas, le groupe de clés est créé avec l'algorithme spécifié. |
-deleteCredential |
Supprime les informations d'authentification spécifiées de la configuration KMS de la base de données NetBackup. |
-deleteKMSConfig |
Supprime l'entrée de configuration KMS de la base de données NetBackup. |
-discoverNBKMS |
Permet de découvrir si le service de gestion des clés NetBackup (NBKMS) est configuré et en cours d'exécution, et l'ajoute à la base de données NetBackup. |
-listCredential |
Affiche les détails des informations d'authentification de la configuration KMS spécifiée au format JSON. Si le nom ou l'ID des informations d'authentification n'est pas fourni, les détails des informations d'authentification de l'ensemble des configurations KMS s'affichent. |
-listKeys |
Affiche la liste des clés NetBackup de la configuration KMS spécifiée au format JSON. |
-listKMSConfig |
Affiche les détails de la configuration KMS spécifiée au format JSON. Si le nom de la configuration n'est pas fourni, cette opération affiche la liste des détails de configuration de tous les services de gestion des clés (KMS). |
-precheckKMSConfig |
Exécute à vide les opérations de configuration KMS pour valider les connexions requises et l'installation. |
-updateCredential |
Met à jour les informations d'authentification de la configuration KMS spécifiée. |
-updateKMSConfig |
Met à jour la configuration KMS spécifiée dans la base de données NetBackup. |
-validateKMSConfig |
Valide la fonctionnalité avec la configuration KMS spécifiée et vérifie que la fonctionnalité de sauvegarde et de restauration fonctionne. |
OPTIONS
- -algorithm algorithme
Spécifie l'algorithme de chiffrement de la clé qui a été créée.
- -certPath chemin_fichier_certificat
Spécifie le chemin du certificat utilisé pour se connecter au serveur distant.
- -comment commentaire
Spécifie un commentaire sur la clé.
- -credId ID_informations_authentification
Spécifie l'ID des informations d'authentification de la configuration KMS.
- -credName nom_informations_authentification
Spécifie le nom des informations d'authentification de la configuration KMS.
- -crlCheckLevel LEAF | CHAIN | DISABLE
Spécifie le niveau de contrôle de révocation pour les certificats du serveur KMS externe. La valeur par défaut est LEAF.
Valeurs acceptées pour le niveau de vérification de la liste de révocation des certificats :
DISABLE : le contrôle de la révocation est désactivé. L'état de révocation du certificat n'est pas validé par rapport à la liste de révocation des certifications pendant la communication avec l'hôte.
LEAF : l'état de révocation du certificat feuille est validé par rapport à la liste de révocation des certificats.
CHAIN : l'état de révocation de tous les certificats de la chaîne de certification est validé par rapport à la liste de révocation des certificats.
- -description description
Permet d'apporter des informations supplémentaires sur l'opération en cours.
- -enabledForBackup 0 | 1
Spécifie si les clés provenant de ce KMS doivent être utilisées pour la sauvegarde ou non. La valeur par défaut est de 1.
Indiquez 0 si les clés de ce KMS ne doivent pas être utilisées pour la sauvegarde.
- -force
Supprime les invites de confirmation et exécute l'opération spécifiée.
- -hmkId ID_clé_maître_hôte_pour_identifier_phrase_passe_HMK
Spécifie l'ID de clé HMK servant à identifier la phrase de passe HMK. Cette option s'applique uniquement si le type KMS est NBKMS.
- -jsonCompact
Génère des données de sortie dans un format JSON compacté.
- -jsonRaw
Affiche la réponse JSON du serveur web.
- -keyGroupName nom_groupe_clés
Spécifie le nom du groupe de clés qui est utilisé pour récupérer ou définir des clés.
- -keyName nom_clé
Spécifie le nom de la clé.
- -keyPassphraseFilePath chemin_fichier_de_la_phrase_passe_de_la_clé
Spécifie le chemin d'accès au fichier de la phrase de passe utilisée pour créer la clé. Seuls certains types KMS prennent en charge les phrases de passe de la clé.
- -kmsServerName nom_réseau_du_serveur_KMS_externe
Spécifie le nom de réseau du serveur KMS. S'il y a plusieurs noms de réseau pour le serveur KMS, séparez-les par une virgule (,). Cette option s'applique uniquement si le type KMS est KMIP.
- -kpkId ID__clé_protection_pour_identifier_phrase_passe_KPK
Spécifie l'ID de clé de protection de clés (KPK) servant à identifier la phrase de passe KPK. Cette option s'applique uniquement si le type KMS est NBKMS.
- -name nom_configuration
Spécifie un nom unique pour la configuration KMS.
- -pageLimit nombre_enregistrements_à_répertorier_après_décalage
Spécifie le nombre d'enregistrements à inclure dans la liste après le décalage. Les valeurs valides de -pageLimit vont de 1 à 100. La valeur par défaut est de 100.
- -pageOffset numéro_enregistrement
Spécifie le numéro d'enregistrement à partir duquel les enregistrement sont répertoriés. La valeur par défaut est de 0.
- -passphrasePath chemin_fichier_phrase_passe_clé_privée
Spécifie le chemin d'accès au fichier de la phrase de passe utilisée pour chiffrer la clé privée du certificat.
- -port port_pour_connecter_au_serveur_KMS_externe
Spécifie le numéro de port à utiliser pour se connecter au serveur KMS externe. Cette option s'applique uniquement si le type KMS est KMIP.
- -priority priorité_du_serveur_KMS
Spécifie le serveur KMS à utiliser lorsque NetBackup recherche des clés pendant le chiffrement ou le déchiffrement. Par défaut, la priorité du serveur KMS est définie sur 0. Le serveur KMS ayant la valeur la plus élevée devient prioritaire lors du chiffrement ou déchiffrement.
- -privateKeyPath chemin_fichier_clé_privée
Spécifie le chemin d'accès au fichier de la clé privée du certificat.
- -reason raison
Spécifie la raison pour laquelle l'opération en cours s'exécute.
- -server nom_serveur_maître
Spécifie un autre serveur maître. Par défaut, cette commande utilise la première entrée de serveur dans le fichier de configuration de NetBackup.
- -trustStorePath chemin_fichier_certificat_autorité_certification
Spécifie le chemin d'accès au fichier du certificat d'autorité de certification utilisé pour vérifier le serveur distant.
- -type NBKMS | KMIP
Spécifie le type KMS. NBKMS et KMIP sont des types KMS valides.
- -useRandomPassphrase 0|1
Spécifie si des phrases de passe aléatoires doivent être utilisées ou non. La valeur par défaut est de 0. Fournissez 1 si des phrases de passe aléatoires doivent être utilisées pour la configuration KMS.
EXEMPLES
Exemple 1 : configurer les informations d'authentification pour le serveur KMS externe
nbkmscmd -configureCredential -credName ExtKMS_Credential -certPath /EKMS_creds/cert_chain.pem -privateKeyPath /EKMS_creds/key.pem -trustStorePath /EKMS_creds/cacerts.pem -description "Configuring credential for external KMS"
Exemple 2 : configurer un serveur KMS externe.
nbkmscmd -configureKMS -name ExtKMS -type KMIP -kmsServerName extkms.veritas.com -port 5696 -credName ExtKMS_Credential -priority 1 -description "Configuring external KMS with configutation name ExtKMS"