https://github.com/simonmittag/cryptoutils

Simple wrapper around JCE to initialise with keys from environment variables
https://github.com/simonmittag/cryptoutils

cryptoutils java jce

Last synced: 18 days ago
JSON representation

Simple wrapper around JCE to initialise with keys from environment variables

• Host: GitHub
• URL: https://github.com/simonmittag/cryptoutils
• Owner: simonmittag
• License: other
• Created: 2016-03-27T10:57:56.000Z (about 10 years ago)
• Default Branch: master
• Last Pushed: 2016-08-01T16:05:28.000Z (almost 10 years ago)
• Last Synced: 2025-01-18T07:43:50.191Z (over 1 year ago)
• Topics: cryptoutils, java, jce
• Language: Java
• Size: 230 KB
• Stars: 1
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
Cryptoutils

============

Provides an ultra simple wrapper around Java's Cryptography extension (JCE) and factory methods for AES 128 Bit symmetric key ciphers, and RSA 2048 Bit asymmetric key ciphers with encryption/decryption methods. See unit test cases for details.

Building from source

--------------------

Use maven to build:

    mvn clean package

Import

------

Declare as dependency in maven

    

      com.simonmittag

      cryptoutils

      1.0

    

Using the library from code

---------------------------

1) Use AsymmetricRSAKeyPairGenerator to create public/private keys (for asymmetric cipher) and save them to disk.

    mvn -q exec:java -Dexec.mainClass="com.simonmittag.cryptoutils.asymmetric.AsymmetricRSAKeyPairGenerator"

2) Create a random 16 byte String each for symmetric secret key and init vector (for the symmetric cipher).

3) put cryptoutils-1.0-SNAPSHOT.jar in your classpath, then use it like so from within code, replacing the property values with the base64 (UTF-8 Strings are ok for symmetric) encoded keys you generated in #1 and #2:

    System.setProperty("ASYMMETRIC_PRIVATE_KEY", "BASE64_PRIVATE_KEY")

    System.setProperty("ASYMMETRIC_PUBLIC_KEY", "BASE64_PUBLIC_KEY")

    or

    System.setProperty("SYMMETRIC_SECRET_KEY", "16_BYTE_SYMMETRIC_KEY");

    System.setProperty("INIT_VECTOR", "16_BYTE_INIT_VECTOR");

3b) alternatively define the above properties as unix environment variables on the shell before starting the Java process that contains the client code.

4) Create a cipher by using the Facade class in either package like so:

    SimpleCipher cipher = new CipherFacade();

    String encrypted = cipher.encrypt("Hello World");

    String decrypted = cipher.decrypt(encrypted);

Known Issues

------------

Cryptoutils was tested on Oracle JDK8+ with the built-in JCE provider. Other environments may vary

License

-------

Cryptoutils uses the Apache license.