botanj

Botanj - Provedor de Segurança Java (JSP)

Índice

1. Introdução
2. Construindo a biblioteca
3. Primitivos apoiados
4. Usando Botan JSP

Introdução

Botanj é um provedor de segurança Java (JSP), que usa Botan para implementar partes da Extensão de Criptografia Java (JCE). Esta implementação é compatível com outros JSPs (por exemplo, castelo saltitante), permitindo assim uma migração suave.

Botanj usa o JNR-FFI para carregar o código nativo de Botan.

Construindo a biblioteca

• Instale a biblioteca nativa de Botan (testada com Botan 2. {14/16} .0)
• Instale o Apache Maven
• Instale o Java 11+ (testado com o OpenJDK 11)
• Executar testes: mvn test

Primitivos apoiados

Cifras, hashes, macs e somas de verificação

• Modos de cifra autenticados: EAX, OCB, GCM, SIV, CCM
• Modos de cifra: CBC, CTR, CFB, OFB
• Block cifras: AES, DES/3DES
• Cifras de fluxo: (x) salsa20, (x) chacha20
• Funções de hash: SHA-1, SHA-2, SHA-3, MD4, MD5, RIPEMD-160, BLAKE2B
• Códigos de autenticação de mensagem: HMAC, CMAC, Poly1305, Siphash

Criptografia de chave pública

• Ainda não suportado

Infraestrutura de chave pública

• Não sim suportado

Protocolo de segurança da camada de transporte (TLS) (JSSE)

• Ainda não suportado

Usando Botanj

• Um exemplo descrevendo o procedimento para calcular um objeto Messagedigest:

 final MessageDigest digest = MessageDigest . getInstance ( "blake2b-512" , BotanProvider . NAME );
final byte [] output = digest . digest ( "hello world" . getBytes ());

• Um exemplo descrevendo o procedimento para calcular um objeto Mac:

 final SecretKeySpec key = new SecretKeySpec ( key , "HMAC-SHA512" );
final Mac mac = Mac . getInstance ( "HMAC-SHA512" , BotanProvider . NAME );
mac . init ( key );
final byte [] output = mac . doFinal ( "hello world" . getBytes ());

• Um exemplo que descreve o procedimento para criptografar usando AES-256/GCM:

 final Cipher cipher = Cipher . getInstance ( "AES-256/GCM/NoPadding" , BotanProvider . NAME );
// Never reuse the IV with the same key
cipher . init ( Cipher . ENCRYPT_MODE , key , iv );
cipher . updateAAD ( aad );
final byte [] output = cipher . doFinal ( "hello world" . getBytes ());

• Um exemplo que descreve o procedimento para criptografar usando AES-256/CBC/PKCS7:

 final Cipher cipher = Cipher . getInstance ( "AES-256/CBC/PKCS7" , BotanProvider . NAME );
cipher . init ( Cipher . ENCRYPT_MODE , key , iv );
final byte [] output = cipher . doFinal ( "hello world" . getBytes ());

• Um exemplo que descreve o procedimento para criptografar usando o chacha20:

 final Cipher cipher = Cipher . getInstance ( "ChaCha20/None/NoPadding" , BotanProvider . NAME );
// Never reuse the IV with the same key
cipher . init ( Cipher . ENCRYPT_MODE , key , iv );
final byte [] output = cipher . doFinal ( "hello world" . getBytes ());