Valores predeterminados de SSL en Liberty
Especifica el certificado SSL predeterminado, el almacén de claves y la configuración en Liberty.
Certificado y almacén de claves predeterminados
Como práctica herramienta para ayudar a los desarolladores a ponerse en marcha y trabajar, los usuarios pueden utilizar el parámetro createSSLCertificate en el mandato securityUtility para crear los certificados firmados automáticamente. Los usuarios pueden llamar a la herramienta directamente desde la línea de mandatos o dejar que el servidor la llame para crear el certificado predeterminado y el almacén de claves en el arranque del servidor.
<keyStore id="defaultKeyStore" password="yourPassword" />
Si una configuración de almacén de claves para defaultKeyStore está en su lugar y el almacén de claves no existe cuando se inicia el servidor, el servidor llama al parámetro createSSLCertificate para crear el almacén de claves con una contraseña especificada en la configuración.
- Ubicación: el archivo de almacén de claves se llama key.jks y está en el directorio resources/security del servidor o clientes.
- Tipo de almacén de claves: el tipo de almacén de claves es JKS.
- Contraseña: la contraseña que se proporciona en la configuración.
- Tipo: el certificado es un certificado firmado automáticamente.
- Tamaño: el tamaño predeterminado del certificado es 2048.
- Algoritmo de firma: el algoritmo de firma para el certificado es SHA256WITHRSA.
- Validez: el certificado es válido durante 365 días.
- DN de sujeto: el certificado se crea con CN=<nombrehost>,OU=<nombre de cliente o servidor>,O=ibm,C=US como SubjectDN.
Se puede llamar al parámetro createSSLCertificate en la línea de mandatos, si los usuarios desean personalizar el certificado.
Configuración predeterminada de SSL
La configuración mínima necesaria para SSL es un único elemento de almacén de claves llamado defaultKeyStore. Cuando existe defaultKeyStore en la configuración, el tiempo de ejecución crea una configuración de SSL que se llama defaultSSLConfig alrededor.
Detalles de defaultSSLConfig:
- Protocolo: Cuando se utiliza IBM® JRE, el protocolo está establecido en SSL_TLSv2 de forma predeterminada. Si se utiliza el Oracle JRE, se utiliza SSL como protocolo.
- Cifrados: la lista de cifrados se genera obteniendo una lista de cifrados soportados del JRE subyacente. De forma predeterminada, la lista de reduce a todos los cifrados que son de 128 bits y superior en 3DES. RC4 se elimina porque no se consideran seguros para estar habilitados. Los cifrados ECDHE se eliminan porque pueden provocar errores si va a un servidor que no los soporta. La lista de cifrados se puede personalizar para incluirlos.
- Autenticación de cliente: de forma predeterminada, clientAuthentication y clientAuthenticationSupported están inhabilitados.
- Almacén de claves: En la configuración predeterminada, se utiliza defaultKeyStore como almacén de claves y, también, de confianza.
Se puede especificar un elemento ssl que se llama defaultSSLConfig en el archivo server.xml para la personalización de las propiedades de configuración de SSL. Un elemento ssl personalizado que se llama defaultSSLConfig se sigue tratando como la configuración SSL predeterminada, siempre que no se haya identificado una configuración SSL diferente como valor predeterminado. Si desea más detalles sobre atributos que se pueden utilizar para personalizar una configuración SSL, consulte Atributos de configuración de SSL.
<sslDefault sslRef="customSSLConfiguration" />
Los atributos de la configuración SSL predeterminada de Liberty se utilizan para crear un SSLContext. Dicho SSLContext se establece en el proceso como el SSLContext predeterminado utilizando la API Java™ SSLContext.setDefault(). Si una aplicación realiza una llamada a la API como httpURLConnection() con un URL https y no proporciona ninguna información de SSL, la aplicación recoge el SSLContext predeterminado del proceso y, en este caso, el SSLContext que se crea con la configuración SSL predeterminada de Liberty.
Si no hay ninguna otra configuración predeterminada de SSL en Liberty, se utiliza el SSLContext predeterminado de JSSE. El SSLContext predeterminado de JSSE utiliza el archivo cacerts para el almacén de claves y el almacén de confianza. No hay ninguna configuración predeterminada de SSL en Liberty, si no hay ninguna característica SSL definida o si la configuración de SSL que existe no se ha identificado como valor predeterminado. La configuración predeterminada será la llamada defaultSSLConfig, que puede ser implícita si defaultKeyStore está definido o se puede designar una configuración de SSL alternativa utilizando el elemento sslDefault.
Se utilizan las propiedades del sistema javax (javax.net.ssl.keystore) para configurar la información de almacén de claves y almacén de confianza para el contexto SSL predeterminado y no se deben utilizar. Si las propiedades están establecidas en el proceso, la llamada a SSLContext.setDefault() las borra.
Tema de referencia