Configuraciones de almacén de claves para SSL

Utilice las configuraciones de almacén de claves para definir cómo el tiempo de ejecución de WebSphere carga y gestiona los tipos de almacén de claves para las configuraciones SSL (Secure Sockets Layer).

De forma predeterminada, el atributo java.security.Security.getAlgorithms("KeyStore") no muestra una lista predefinida de los tipos de almacén de claves en la consola administrativa. En lugar de ello, WebSphere Application Server recupera todos los tipos de almacén de claves a los que el objeto java.security.KeyStore puede hacer referencia, incluyendo almacenes de claves criptográficos de hardware, de plataforma z/OS, de plataforma IBM® i, de IBMJCE (IBM Java™ Cryptography Extension) y de proveedores CMS (Certificate Management Services) basados en Java. Si especifica un proveedor de almacén de claves en el archivo java.security o lo añade a la lista de proveedores de forma programada, WebSphere Application Server también recupera los almacenes de claves personalizados. La lista de recuperación depende de la configuración de java.security para esa plataforma y proceso.

Almacenes de claves basados en el archivo IBMJCE (JCEKS, JKS y PKCS12)

Una configuración de almacén de claves basada en el archivo IBMJCE típica se muestra en el siguiente código de ejemplo:
<keyStores xmi:id="KeyStore_1" name="NodeDefaultKeyStore" 
password="{xor}349dkckdd=" provider="IBMJCE"
location="${USER_INSTALL_ROOT}/config/cells/myhostNode01Cell
/nodes/myhostNode01/key.p12" type="PKCS12" fileBased="true" 
hostList="" initializeAtStartup="true" readOnly="false" 
description="Default key store for myhostNode01" usage="SSLKeys" 
managementScope="ManagementScope_1"/>
Para obtener más información sobre las configuraciones de almacén de claves predeterminadas, consulte Configuración de certificado encadenado predeterminado en SSL.
La tabla 1 describe los atributos que se utilizan en el código de ejemplo.
Tabla 1. Configuraciones de almacén de claves. En esta tabla se describen las configuraciones de almacén de claves.
Nombre de atributo Valor predeterminado Descripción
xmi:id Varía Valor que se emite para hacer referencia al almacén de claves de otra área de la configuración, por ejemplo, de una configuración SSL. Asegúrese de que este valor es exclusivo en el archivo security.xml.
nombre Para el almacén de claves JSSE (Java Secure Socket Extension): NodeDefaultKeyStore. Para el almacén de confianza JSSE: NodeDefaultTrustStore. Nombre que se utiliza para identificar el almacén de claves visualmente. El nombre puede determinar si el almacén de claves es un almacén de claves por omisión basándose en si el nombre termina por DefaultKeyStore o DefaultTrustStore.
password La contraseña predeterminada del almacén de claves es WebAS. Se recomienda que se cambia tan pronto como sea posible. Para obtener más información, consulte el apartado Actualización de contraseñas de almacén de claves predeterminado utilizando scripts. La contraseña que se utiliza para acceder al nombre de almacén de claves también es el valor predeterminado utilizado para almacenar claves en el almacén de claves.
descripción Sin valor predeterminado Descripción del almacén de claves.
uso Atributo que especifica para qué se utiliza el almacén de claves. Los valores válidos son: SSLKeys, KeySetKeys, RootKeys, DeletedKeys, DefaultSigners, RSATokenKeys.
provider El proveedor por omisión es IBMJCE. Proveedor Java que implementa el atributo type (por ejemplo, el tipo PKCS12). El proveedor puede dejarse sin especificar y se utiliza el primer proveedor que implemente el tipo de almacén de claves especificado.
location El valor predeterminado varía, pero generalmente hace referencia a un archivo key.p12 o trust.p12 de los directorios de nodo o célula del repositorio de configuración. Estos archivos son almacenes de claves de tipo PKCS12. Referencia de la ubicación del almacén de claves. Si el almacén de claves esta basado en un archivo, la ubicación puede hacer referencia a cualquier vía de acceso del sistema de archivos del nodo donde esté ubicado el almacén de claves. No obstante, si la ubicación está fuera del repositorio de configuración y desea gestionar el almacén de claves de forma remota desde la consola administrativa o desde el programa de utilidad wsadamin, especifique el atributo hostList que contiene el nombre de host del nodo donde reside.
type El tipo de almacén de claves predeterminado de dispositivo criptográfico Java es PKCS12. Este tipo especifica el almacén de claves. Los tipos válidos pueden ser los devueltos por el atributo java.security.Security.getAlgorithms("KeyStore"). Estos tipos incluyen los siguientes tipos de almacén de claves y la disponibilidad depende de la configuración de java.security de la plataforma:
  • JKS
  • JCEKS
  • PKCS12
  • PKCS11 (dispositivo criptográfico Java)
  • CMSKS
  • IBMi5OSKeyStore
  • JCERACFKS
  • Almacenes de claves JCECCAKS (sustituyendo a JCE4758KS) - (dispositivo criptográfico de z/OS)
fileBased El valor predeterminado es true. Esta opción es necesaria para los almacenes de claves por omisión. Indica un almacén de claves del sistema de archivos para que pueda utilizar FileInputStream o FileOutputStream para cargar y almacenar el almacén de claves.
hostList El atributo hostList se utiliza para especificar un nombre de host remoto de modo que el almacén de claves pueda gestionarse de forma remota. No existen almacenes de claves gestionados de forma remota por omisión. Todos los almacenes de claves por omisión se gestionan localmente en el repositorio de configuración y se sincronizan con cada uno de los nodos. La opción gestiona un almacén de claves de forma remota. Puede establecer el nombre de host de un nodo válido para un almacén de claves. Cuando se utiliza la consola administrativa o el programa de utilidad wsadmin para gestionar los certificados de este almacén de claves, se realiza una llamada de MBean al nodo donde se encuentra el almacén de claves para obtener la operación aprobada. Puede especificar varios hosts, aunque la sincronización de las operaciones de almacén de claves no está garantizada. Por ejemplo, uno de los hosts enumerados puede estar inactivo cuando se realice una operación específica. Por lo tanto, utilice varios hosts de esta lista.
initializeAtStartup El valor predeterminado es true. Esta opción indica al tiempo de ejecución que debe inicializar el almacén de claves durante el inicio. Esta opción puede ser importante para la aceleración de dispositivos criptográficos de hardware.
readOnly El valor predeterminado es false. Esta opción indica a la configuración que no se puede escribir en este almacén de claves. Es decir, ciertas operaciones del almacén de claves no puede realizarse y no están permitidas. Un ejemplo de tipo de almacén de claves de sólo lectura es JCERACFKS en la plataforma z/OS. Este tipo es de sólo lectura desde el punto de vista de la gestión de certificados de WebSphere, pero puede actualizarlo utilizando el recurso de gestión de almacén de claves para RACF.
managementScope El ámbito por omisión es el ámbito de nodo para un entorno de servidor de aplicaciones base y el ámbito de célula para un entorno de Network Deployment. Esta opción hace referencia a un determinado ámbito de gestión en el que puede ver este almacén de claves. Por ejemplo, si un dispositivo criptográfico de hardware está ubicado físicamente en un nodo específico, cree el almacén de claves a partir de un enlace con ese nodo de la vista de topología bajo Seguridad > Comunicaciones de seguridad > Configuraciones SSL. Asimismo puede utilizar el ámbito de gestión para aislar una referencia de almacén de claves. En algunos casos, es posible que sólo pueda permitir que un servidor de aplicaciones específico haga referencia al almacén de claves. El ámbito de gestión es para ese servidor específico.

Almacenes de claves CMS

Puede establecer algunos atributos específicos del proveedor en los almacenes de claves CMS.

[AIX Solaris HP-UX Linux Windows]Si el proveedor CMSKS da soporte al atributo createStashFileForCMS y éste se establece en true para los almacenes de claves CMSKS, WebSphere Application Server crea un archivo .sth en la ubicación de almacén de claves a la que hace referencia el atributo. La extensión .sth se anexa al nombre de almacén de claves. Por ejemplo, si el almacén de claves CMSKS está disponible para una configuración de plug-in y se establece createStashFileForCMS en true, el archivo stash representado en el siguiente código de ejemplo se crea en la vía de acceso ${USER_INSTALL_ROOT}\profiles\AppSrv01/config/cells/myhostCell01/nodes/myhostNode01/servers/webserver1/plugin-key.sth.
<keyStores xmi:id="KeyStore_1132071489571" name="CMSKeyStore" 
password="{xor}HRYNFAtrbxEwOzpvbhw6MzM=" provider="IBMCMSProvider" 
location="${USER_INSTALL_ROOT}\profiles\AppSrv01/config/cells/myhostCell01
/nodes/myhostNode01/servers/webserver1/plugin-key.kdb" type="CMSKS"
fileBased="true" createStashFileForCMS="true"
managementScope="ManagementScope_1132071489569"/>
Cuando se crea un almacén de claves CMS, el proveedor CMS es IBMi5OSJSSEProvider y el tipo CMS es IBMi5OSKeyStore, como se muestra en el ejemplo siguiente:
<keyStores xmi:id="KeyStore_1132071489571" name="CMSKeyStore" 
password="{xor}HRYNFAtrbxEwOzpvbhw6MzM=" provider="IBMi5OSJSSEProvider" 
location="${USER_INSTALL_ROOT}\profiles\AppSrv01/config/cells/myhostCell01
/nodes/myhostNode01/servers/webserver1/plugin-key.kdb" type="IBMi5OSKeyStore"
fileBased="true" createStashFileForCMS="true" 
managementScope="ManagementScope_1132071489569"/>
[IBM i]Nota: El tipo de almacén de claves IBM i IBMi5OSKeyStore no reconoce ni genera archivos stash de contraseñas .sth. En lugar de eso, conserva un registro interno de la contraseña del archivo de almacén de claves .kdb donde se creó. Si se mueve el archivo .kdb, la contraseña deja de estar asociada con el almacén de claves. En ese caso, DCM (Digital Certificate Manager) debe utilizarse para volver a crear el registro interno de la contraseña para el archivo de almacén de claves .kdb. Para obtener más información, consulte Recreación del registro de contraseñas internas de almacén de claves .kdb.
[IBM i]Atención: Cuando se crean certificados personales encadenados o se utiliza la tarea requestCACertificate con IBMi5OSKeyStore, IBMi5OSJSSEProvider requiere que el firmante de cada parte de la cadena esté presente en el almacén de claves antes de crear el nuevo certificado. Por lo tanto, debe importar el firmante en el almacén de claves IBMi5OSKeyStore antes de crear un nuevo certificado.

Almacenes de claves criptográficos de hardware

Para la configuración de dispositivos criptográficos, consulte Gestión de claves para los usos criptográficos .

Puede añadir una ranura como la propiedad personalizada com.ibm.ssl.keyStoreSlot, o como el atributo de configuración slot="0". La propiedad personalizada se lee antes que el atributo para la compatibilidad con versiones anteriores.


Icon that indicates the type of topic Concept topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-base-dist&topic=csec_sslkeystoreconfs
File name: csec_sslkeystoreconfs.html