botanj

Botanj - Java Security Provider (JSP)

Index

1. Einführung
2. Bau der Bibliothek
3. Unterstützte Primitive
4. Verwenden von Botan JSP

Einführung

Botanj ist ein Java -Sicherheitsanbieter (JSP), der Botaner verwendet, um Teile der Java Cryptography Extension (JCE) zu implementieren. Diese Implementierung ist mit anderen JSPs (z. B. Bouncy Castle) kompatibel, wodurch eine reibungslose Migration ermöglicht wird.

Botanj verwendet JNR-FFI zum Laden von Botan Native Code.

Bau der Bibliothek

• Installieren Sie die native Botanbibliothek (getestet mit Botan 2. {14/16} .0)
• Installieren Sie Apache Maven
• Installieren Sie Java 11+ (getestet mit OpenJDK 11)
• Führen Sie Tests aus: mvn test

Unterstützte Primitive

Chiffren, Hashes, Macs und Prüfsummen

• Authentifizierte Chiffre -Modi: EAX, OCB, GCM, SIV, CCM
• Cipher -Modi: CBC, CTR, CFB, OFB
• Blockveränderungen: AES, DES/3DES
• Stream -Chiffren: (x) Salsa20, (x) Chacha20
• Hash-Funktionen: SHA-1, SHA-2, SHA-3, MD4, MD5, RIPEMD-160, Blake2b
• Nachrichtenauthentifizierungscodes: HMAC, CMAC, Poly1305, Siphash

Öffentliche Schlüsselkryptographie

• Noch nicht unterstützt

Öffentliche Schlüsselinfrastruktur

• Nicht ja unterstützt

TLS -Protokoll (Transport Layer Security) (JSSE)

• Noch nicht unterstützt

Verwenden von Botanj

• Ein Beispiel, das die Prozedur zur Berechnung eines MessagedIGest -Objekts beschreibt:

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

• Ein Beispiel, das die Prozedur zur Berechnung eines Mac -Objekts beschreibt:

 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 ());

• Ein Beispiel, das das Verfahren mit AES-256/GCM beschreibt:

 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 ());

• Ein Beispiel, das das Verfahren mit AES-256/CBC/PKCS7 beschreibt:

 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 ());

• Ein Beispiel, das das Verschlüsselung des Verfahrens mit Chacha20 beschreibt:

 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 ());