Jasypt para Java: guía completa de cifrado de archivos de configuración

Jasypt (Java Simplified Encryption) es una biblioteca potente y fácil de usar para el cifrado en aplicaciones Java. Proporciona a los desarrolladores una API cómoda para realizar operaciones criptográficas, como el cifrado y descifrado de texto, números, datos binarios y, lo que es más importante, archivos de configuración. El objetivo principal de Jasypt es hacer que el proceso de cifrado sea lo más transparente y fácil de integrar posible, sin requerir conocimientos profundos de criptografía.

¿Por qué necesitas Jasypt? En las aplicaciones modernas, la seguridad de los datos es fundamental. Los archivos de configuración (properties, YAML, XML) a menudo contienen información sensible: contraseñas de bases de datos, claves de API, tokens de autenticación, cadenas de conexión a servicios externos. Almacenar estos datos en texto plano supone un riesgo enorme. Jasypt resuelve este problema permitiendo cifrar valores confidenciales directamente en los archivos de configuración. Al iniciar la aplicación, la biblioteca los descifra automáticamente, haciendo que el proceso sea seguro e invisible para el desarrollador.

La ventaja clave de Jasypt es su integración con frameworks populares como Spring Framework (a través del módulo jasypt-spring-boot). Esto permite usar anotaciones y configuraciones para el cifrado/descifrado automático de propiedades. Además, Jasypt admite varios algoritmos de cifrado (PBEWithMD5AndDES, PBEWithSHA1AndDESede, PBEWithSHA256AndAES y otros), lo que brinda flexibilidad para elegir el nivel de seguridad. La biblioteca también incluye utilidades para trabajar con claves, sales y vectores de inicialización, convirtiéndola en una herramienta completa para garantizar la seguridad de los datos en el ecosistema Java.

Instalación de Jasypt

Jasypt se distribuye a través de Maven Central. Para agregar la biblioteca a tu proyecto, usa el sistema de compilación Maven o Gradle.

Maven

<dependency>
    <groupId>org.jasypt</groupId>
    <artifactId>jasypt</artifactId>
    <version>1.9.3</version>
</dependency>

Gradle

implementation 'org.jasypt:jasypt:1.9.3'

Para la integración con Spring Boot, agrega:

<dependency>
    <groupId>com.github.ulisesbocchio</groupId>
    <artifactId>jasypt-spring-boot-starter</artifactId>
    <version>3.0.5</version>
</dependency>

Inicio rápido: ejemplo mínimo funcional

Vamos a crear una aplicación simple que cifra y descifra una cadena usando Jasypt.

import org.jasypt.util.text.BasicTextEncryptor;

public class QuickStartExample {
    public static void main(String[] args) {
        // 1. Creamos el cifrador
        BasicTextEncryptor encryptor = new BasicTextEncryptor();
        
        // 2. Establecemos la contraseña maestra (clave secreta)
        encryptor.setPassword("miClaveSecreta123");
        
        // 3. Ciframos el texto
        String plainText = "¡Hola, Jasypt!";
        String encryptedText = encryptor.encrypt(plainText);
        System.out.println("Texto cifrado: " + encryptedText);
        
        // 4. Desciframos el texto
        String decryptedText = encryptor.decrypt(encryptedText);
        System.out.println("Texto descifrado: " + decryptedText);
        
        // Verificación
        System.out.println("Éxito: " + plainText.equals(decryptedText));
    }
}

Este ejemplo muestra el ciclo básico de trabajo con Jasypt: crear un cifrador, establecer una contraseña, cifrar y descifrar. Observa que el texto cifrado parece una cadena aleatoria de caracteres.

Métodos y clases principales de Jasypt

A continuación se presentan 8 clases y métodos clave de la biblioteca Jasypt con descripciones detalladas y ejemplos de código.

1. BasicTextEn