Contenu

Introduction

Conditions préalables

Conditions requises

Components Used

Configuration

Explication de commande

Commandes

Sauvegarde des alias

Exporter le clavier

Supprimer l'alias

Créer un certificat auto-signé

Exporter le certificat auto-signé

Générer une demande de signature de certificat (CSR)

Importer des certificats signés CA

Vérification

Dépannage

Introduction

Ce document décrit une façon d'automatiser les différentes commandes utilisées avec les certificats CVP. Ceci fournit également des options pour rendre le certificat conforme à RFC.

Conditions préalables

Conditions requises

Cisco vous recommande de prendre connaissance des rubriques suivantes :

- Cisco Voice Portal (CVP)

- Clavier Java

- Certificats PKI (Public Key Infrastructure)

Components Used

Les informations contenues dans ce document sont basées sur les versions de logiciel suivantes :

- Cisco Voice Portal (CVP) 12.5(1)

- Unified Contact Center Enterprise (UCCE)

- Packaged Contact Center Enterprise (PCCE)

- Portail de gestion des opérations et de l'administration (OAMP)

The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. Si votre réseau est en ligne, assurez-vous de bien comprendre l’incidence possible des commandes.

Configuration

Explication de commande

Ces commandes ont été conçues pour automatiser en grande partie les commandes utilisées dans la gestion des certificats de gestion avec CVP. Ils ne sont pas officiellement pris en charge, mais sont testés.

Exemple de sortie security.properties :

Security.keystorePW = xt_PXM-*4Z!!ZQID7YX*6K(3iii

La partie de ces commandes qui leur permet d'être automatisés est la première partie de la ligne. Cette section présente la ligne, puis explique comment elle fonctionne.

FOR /f "tokens=3" %i IN ('more %CVP_HOME%\conf\security.properties') DO <command>

Parties de commande :

Section de commande

Explication

POUR /f

Il s'agit de la commande DOS FOR avec un commutateur utilisé pour traiter le contenu des fichiers pour des correspondances spécifiques.

« jetons=3 »

Cela indique que nous avons besoin du 3ème jeton ou mot.

Avec l'exemple de fichier security.properties présenté dans cette section, les 3 jetons sont les suivants :

Jeton 1 : Sécurité.keystorePW

Jeton 2 : =

Jeton 3 : xt_PXM-*4Z ! ! ZQID7YX*6K(3iii)

%i

Il s'agit de la variable dans laquelle est stockée la valeur de la commande IN qui correspond au paramètre FOR.

IN ('more %CVP_HOME%\conf\security.properties')

Exécutez la commande « more %CVP_HOME%\conf\security.properties" et passez le contenu dans la commande FOR.

DO <commande>

Exécutez la commande et passez la valeur pour %i.

Les commandes présentées dans ce document lisent le mot de passe dans security.properties et automatisent l'entrée dans les commandes keystore. Cela garantit que l'utilisateur final n'a pas besoin de taper ou de copier/coller ce mot de passe et élimine les erreurs que cela peut provoquer.

Commandes

L'exemple de commande fonctionne tous avec un alias arbritraire nommé cvp_certificate. Veillez à remplacer le nom d'alias si nécessaire.

Sauvegarde des alias

Cette commande n'est généralement pas utilisée, mais elle est utile pour effectuer une sauvegarde de l'ancien certificat et de l'ancienne clé privée.

L'exemple renomme cvp_certificate en cvp_certificate_back.

FOR /f "tokens=3" %i IN ('more %CVP_HOME%\conf\security.properties') DO %CVP_HOME%\jre\bin\keytool.exe -storetype JCEKS -keystore %CVP_HOME%\conf\security\.keystore -storepass %i -changealias -alias cvp_certificate -destalias cvp_certificate_back

Exporter le clavier

Cette commande exporte l'intégralité du keystore vers un fichier texte. Cela permet à un utilisateur d'inspecter le contenu du keystore.

FOR /f "tokens=3" %i IN ('more %CVP_HOME%\conf\security.properties') DO %CVP_HOME%\jre\bin\keytool.exe -storetype JCEKS -keystore %CVP_HOME%\conf\security\.keystore -storepass %i -list -v > %CVP_HOME%\conf\security\cvp_keystore.txt

Supprimer l'alias

Cette commande supprime l'alias et le certificat actuels. Ce processus est irrévocable, il est fortement recommandé d'effectuer une sauvegarde de la banque de clés.

FOR /f "tokens=3" %i IN ('more %CVP_HOME%\conf\security.properties') DO %CVP_HOME%\jre\bin\keytool.exe -storetype JCEKS -keystore %CVP_HOME%\conf\security\.keystore -storepass %i -delete -alias cvp_certificate

Créer un certificat auto-signé

Cette commande crée un nouveau certificat auto-signé. Cette commande est requise même si vous choisissez de faire signer le certificat par une autorité de certification (AC), car cela crée la clé privée requise pour le certificat.

Pour les certificats RSA sans SAN (standard) :

FOR /f "tokens=3" %i IN ('more %CVP_HOME%\conf\security.properties') DO %CVP_HOME%\jre\bin\keytool.exe -storetype JCEKS -keystore %CVP_HOME%\conf\security\.keystore -storepass %i -genkeypair -alias cvp_certificate -keysize 2048 -keyalg RSA -validity 1825

Pour les certificats RSA avec SAN :

FOR /f "tokens=3" %i IN ('more %CVP_HOME%\conf\security.properties') DO %CVP_HOME%\jre\bin\keytool.exe -storetype JCEKS -keystore %CVP_HOME%\conf\security\.keystore -storepass %i -genkeypair -alias cvp_certificate -keysize 2048 -keyalg RSA -validity 1825 -ext san=dns:mycvp.mydomain.com,dns:localhost

Nom alternatif de l'objet

Le paramètre -ext permet à un utilisateur d'accéder à des postes spécifiques. L'exemple présenté ajoute un nom de domaine alternatif (SAN) avec le nom de domaine complet (FQDN) du serveur ainsi que localhost. Des champs SAN supplémentaires peuvent être ajoutés sous forme de valeurs séparées par des virgules.

Les types de SAN valides sont les suivants :

ip:192.168.0.1

dns:myserver.mydomain.com

email:name@mydomain.com

Chacune de ces commandes nécessite 6 valeurs à fournir. Dans l'ordre, ils sont : Nom commun, Unité organisationnelle, Organisation, Ville, État et Pays. Copiez les réponses et mettez-les à jour en fonction de vos besoins spécifiques. Vous pouvez ensuite les coller dans l'invite de commandes si nécessaire.

myserver.mydomain.com

My Organizational Unit

My Company

City

My State

US

Exporter le certificat auto-signé

Cette commande exporte le certificat auto-signé. Cela permet d'importer le certificat vers d'autres composants tels qu'OAMP ou le serveur de données d'administration PCCE.

FOR /f "tokens=3" %i IN ('more %CVP_HOME%\conf\security.properties') DO %CVP_HOME%\jre\bin\keytool.exe -storetype JCEKS -keystore %CVP_HOME%\conf\security\.keystore -storepass %i -export -alias cvp_certificate -file %CVP_HOME%\conf\security\cvp.crt

Générer une demande de signature de certificat (CSR)

Cette commande crée un CSR pour qu'une autorité de certification puisse signer la demande.Pour les certificats sans SAN :

FOR /f "tokens=3" %i IN ('more %CVP_HOME%\conf\security.properties') DO %CVP_HOME%\jre\bin\keytool.exe -storetype JCEKS -keystore %CVP_HOME%\conf\security\.keystore -storepass %i -certreq -alias cvp_certificate -file %CVP_HOME%\conf\security\cvp.csr

Pour les certificats avec SAN :

FOR /f "tokens=3" %i IN ('more %CVP_HOME%\conf\security.properties') DO %CVP_HOME%\jre\bin\keytool.exe -storetype JCEKS -keystore %CVP_HOME%\conf\security\.keystore -storepass %i -certreq -alias cvp_certificate -file %CVP_HOME%\conf\security\cvp.csr -ext san=dns:mycvp.mydomain.com,dns:localhost

Note: Vous devez inclure l'extension SAN dans la demande CSR pour que le certificat contienne un SAN.

Importer des certificats signés CA

Ces commandes importent les certificats racine, intermédiaire et serveur CA à leur tour.

Copiez les certificats dans %CVP_HOME%\conf\security\ directory.

Veillez à mettre à jour le nom d'alias et le nom de certificat selon les besoins.

FOR /f "tokens=3" %i IN ('more %CVP_HOME%\conf\security.properties') DO %CVP_HOME%\jre\bin\keytool.exe -storetype JCEKS -keystore %CVP_HOME%\conf\security\.keystore -storepass %i -import -v -trustcacerts -alias myrootca -file %CVP_HOME%\conf\security\root.crt

FOR /f "tokens=3" %i IN ('more %CVP_HOME%\conf\security.properties') DO %CVP_HOME%\jre\bin\keytool.exe -storetype JCEKS -keystore %CVP_HOME%\conf\security\.keystore -storepass %i -import -v -trustcacerts -alias myintermediate -file %CVP_HOME%\conf\security\intermediate.crt

FOR /f "tokens=3" %i IN ('more %CVP_HOME%\conf\security.properties') DO %CVP_HOME%\jre\bin\keytool.exe -storetype JCEKS -keystore %CVP_HOME%\conf\security\.keystore -storepass %i -import -v -trustcacerts -alias cvp_certificate -file %CVP_HOME%\conf\security\cvp.crt

Vérification

Il n'y a aucune étape pour vérifier cette procédure.

Dépannage

Il n'y a aucune étape pour dépanner cette procédure.