Necesita proteger las contraseñas contenidas en la configuración de
WebSphere Application Server. Después de crear el perfil de servidor, puede añadir protección creando
una clase personalizada para cifrar las contraseñas.
Acerca de esta tarea
Complete los pasos siguientes para habilitar el cifrado de contraseña personalizado. Para obtener una lista de archivos en un perfil de servidor de aplicaciones que contienen contraseñas que deben estar cifradas y sus rutas de navegación, consulte
Cifrado de contraseñas en archivos.
Procedimiento
- Añada las siguientes propiedades del sistema para cada proceso de servidor y cliente. Para los procesos del servidor, actualice el archivo server.xml para cada proceso. Añada estas propiedades como un argumento genericJvmArgument precedido por un prefijo -D.
com.ibm.wsspi.security.crypto.customPasswordEncryptionClass=
com.acme.myPasswordEncryptionClass
com.ibm.wsspi.security.crypto.customPasswordEncryptionEnabled=true
Importante: En cuento al cliente de wsadmin, si utiliza wsadmin en modalidad conectada, esta propiedad deberá establecerse en el gestor de despliegue o en el servidor conectado utilizando el mandato
AdminTask.setJVMSystemProperties o mediante la consola. Si utiliza wsadmin en modalidad local (
conntype=NONE),
puede establecer la propiedad con una opción de mandato
javaoption tal como se muestra a continuación:
wsadmin -conntype none -lang jython -javaoption
-Dcom.ibm.wsspi.security.crypto.customPasswordEncryptionClass=<encryptionClassToUse>
Consejo: Si el nombre de la clase del cifrado personalizado es com.ibm.wsspi.security.crypto.CustomPasswordEncryptionImpl, se habilita automáticamente si la clase está presente en la variable classpath.
No defina las propiedades del sistema que se listaron
previamente si la implementación personalizada tiene este paquete y nombre de clase. Para inhabilitar el cifrado para esta clase,
debe especificar com.ibm.wsspi.security.crypto.customPasswordEncryptionEnabled=false como una propiedad de sistema.
- Elija uno de los métodos siguientes para configurar el tiempo de ejecución de WebSphere Application Server para cargar la clase de implementación de cifrado personalizada:
- Coloque la clase de cifrado personalizado en un archivo JAR
(Java™
archive) que resida en el directorio ${WAS_INSTALL_ROOT}/classes, que ha
creado.
Avoid trouble: WebSphere Application Server no crea
el directorio
${WAS_INSTALL_ROOT}/classes. Para obtener más información sobre el directorio de clases, consulte el tema
"Creación de un subdirectorio de clases en el perfil para clases personalizadas".
gotcha
- Coloque la clase de cifrado personalizado en un archivo JAR (Java archive) que resida
en el directorio ${WAS_HOME}/lib/ext.
- Reinicie todos los procesos de servidor.
- Edite los documentos de configuración que contiene una contraseña y guarde la configuración. Todos los campos de contraseña se ejecutan a través del programa de utilidad WSEncoderDecoder, que llama al punto de conexión cuando está habilitado. Las etiquetas
{custom:alias} se visualizan en los documentos de configuración. Las contraseñas, aunque estén cifradas, siguen siendo datos con código ASCII base 64. Se parecen a las contraseñas cifradas, excepto para las etiquetas diferentes.
- Cifre las contraseñas que están en los archivos de propiedades del cliente utilizando el programa de utilidad PropsFilePasswordEncoder (.bat o .sh). Este programa de utilidad requiere que las propiedades listadas previamente se definan
como propiedades de sistema en el script para cifrar nuevas contraseñas, en lugar de cifrarlas.Deberá editar el script para añadir las propiedades a la línea de mandatos java. Por ejemplo:
%JAVA_EXE% -Dcom.ibm.wsspi.security.crypto.customPasswordEncryptionEnabled=true
-Dcom.ibm.wsspi.security.crypto.customPasswordEncryptionClass=mysample.MySampleEncryption
-Dcmd.properties.file=%TMPJAVAPROPFILE%
"-Dwas.install.root=%WAS_HOME%" com.ibm.ws.bootstrap.WSLauncher com.ibm.ws.security.util.PropFilePasswordEncoder %*
Para obtener la lista de archivos que deben ejecutarse utilizando PropsFilePasswordEncoder, consulte la tabla dos en Cifrado de contraseñas en archivos.
- Para descifrar contraseñas desde JVM
(Java
Virtual Machines) de cliente, añada las propiedades listadas previamente
como propiedades de sistema para cada programa de utilidad de cliente.
- Asegúrese de que todos los nodos tengan las clases de cifrado personalizado en sus classpaths antes de habilitar esta función.
Resultados
El cifrado de contraseña personalizado está habilitado.
Qué hacer a continuación
Si no se puede realizar el cifrado de contraseña personalizado o ya no es necesario, consulte
Inhabilitación del cifrado de contraseña personalizado.