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)
<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. | 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:
|
| 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 . 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.
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"/>
<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"/>
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.
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.
Concept topic