Jasypt para Java: guia completo de criptografia para arquivos de configuração

Jasypt (Java Simplified Encryption) é uma biblioteca poderosa e fácil de usar para criptografia em aplicações Java. Ela oferece aos desenvolvedores uma API conveniente para realizar operações criptográficas, como criptografar e descriptografar texto, números, dados binários e, principalmente, arquivos de configuração. O principal objetivo do Jasypt é tornar o processo de criptografia o mais transparente e simples possível para integração, sem exigir conhecimento profundo em criptografia.

Por que usar o Jasypt? Em aplicações modernas, a segurança dos dados é crucial. Arquivos de configuração (properties, YAML, XML) frequentemente contêm informações sensíveis: senhas de bancos de dados, chaves de API, tokens de autenticação e strings de conexão com serviços externos. Armazenar esses dados em texto puro representa um enorme risco. O Jasypt resolve esse problema permitindo criptografar valores confidenciais diretamente nos arquivos de configuração. Ao iniciar a aplicação, a biblioteca descriptografa automaticamente esses valores, tornando o processo seguro e transparente para o desenvolvedor.

A principal vantagem do Jasypt é a integração com frameworks populares como o Spring Framework (através do módulo jasypt-spring-boot). Isso permite usar anotações e configurações para criptografar/descriptografar propriedades automaticamente. Além disso, o Jasypt suporta diversos algoritmos de criptografia (PBEWithMD5AndDES, PBEWithSHA1AndDESede, PBEWithSHA256AndAES e outros), oferecendo flexibilidade na escolha do nível de segurança. A biblioteca também inclui utilitários para trabalhar com chaves, salts e vetores de inicialização, tornando-a uma ferramenta completa para segurança de dados no ecossistema Java.

Instalação do Jasypt

O Jasypt é distribuído através do Maven Central. Para adicionar a biblioteca ao seu projeto, use o sistema de build Maven ou 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 integração com Spring Boot, adicione:

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

Início rápido: exemplo mínimo funcional

Vamos criar uma aplicação simples que criptografa e descriptografa uma string usando o Jasypt.

import org.jasypt.util.text.BasicTextEncryptor;

public class QuickStartExample {
    public static void main(String[] args) {
        // 1. Criar o criptografador
        BasicTextEncryptor encryptor = new BasicTextEncryptor();
        
        // 2. Definir a senha mestra (chave secreta)
        encryptor.setPassword("mySecretKey123");
        
        // 3. Criptografar o texto
        String plainText = "Olá, Jasypt!";
        String encryptedText = encryptor.encrypt(plainText);
        System.out.println("Texto criptografado: " + encryptedText);
        
        // 4. Descriptografar o texto
        String decryptedText = encryptor.decrypt(encryptedText);
        System.out.println("Texto descriptografado: " + decryptedText);
        
        // Verificação
        System.out.println("Sucesso: " + plainText.equals(decryptedText));
    }
}

Este exemplo demonstra o ciclo básico de uso do Jasypt: criar o criptografador, definir a senha, criptografar e descriptografar. Observe que o texto criptografado aparece como uma string aleatória de caracteres.