Skip to content

Application properties encryption/decryption gradle plugin

License

Notifications You must be signed in to change notification settings

ximtech/jasypt-encrypt-plugin

Repository files navigation

Jasypt gradle plugin

build codecov Codacy Badge

Based on moberwasserlechner/jasypt-gradle-plugin

This plugin uses Jasypt library for encrypting/decrypting application properties. Works great with Spring Boot, but also can work independently. With provided password as encryption key plugin hides sensitive data from direct reading and decrypt them at runtime. Can be useful for data that don't need to be changed frequently and also allow reducing parameters or system environment variables amount passing to the docker container.

How to use

Using plugins DSL

Check latest version at Gradle repository

plugins {
    id "io.github.ximtech.jasypt-encrypt-plugin" version "1.3.3"
}

Manually add to project

  1. Copy jar file to classpath. Get prebuild jar file from assets -> jasypt-encrypt-plugin-<version>.jar
  2. Add buildscript to the top of build.gradle
buildscript {
    dependencies {
        classpath files('jasypt-encrypt-plugin-1.3.3.jar')
    }
}

Add plugin:

apply plugin: io.github.jasypt.encrypt.JasyptPlugin

Jasypt configuration

NOTE: This section can be skipped if default configuration is ok for you.

For custom encryption configuration add .yaml or.properties file in the project root In Spring Boot application just add Jasypt configuration to application.yaml

Example:

jasypt:
    encryptor:
        password: ${JASYPT_ENCRYPTOR_PASSWORD}  # pass as environment variable
        algorithm: "PBEWITHHMACSHA512ANDAES_256"
        salt-generator-classname: "org.jasypt.salt.RandomSaltGenerator"
        iv-generator-classname: "org.jasypt.iv.RandomIvGenerator"
        provider-name: "SunJCE"
        string-output-type: "base64"
        pool-size: 1
        key-obtention-iterations: 1000

And for .properties configuration:

jasypt.encryptor.password="password"
jasypt.encryptor.algorithm="PBEWITHHMACSHA512ANDAES_256"
jasypt.encryptor.salt-generator-classname="org.jasypt.salt.RandomSaltGenerator"
jasypt.encryptor.iv-generator-classname="org.jasypt.iv.RandomIvGenerator"
jasypt.encryptor.provider-name="SunJCE"
jasypt.encryptor.string-output-type="base64"
jasypt.encryptor.pool-size=1
jasypt.encryptor.key-obtention-iterations=1000

Plugin will catch up configuration from file and setup encryptor/decryptor or use default if no configs found. More info about Spring Boot usage with Jasypt you can find here

Project build configuration

Create environment variable JASYPT_ENCRYPTOR_PASSWORD with encryption password. Then add to project build.gradle

encryptProperties {
    password = System.getenv('JASYPT_ENCRYPTOR_PASSWORD')
}

decryptProperties {
    password = System.getenv('JASYPT_ENCRYPTOR_PASSWORD')
}

Optionally: setup executable build task for encryption 'open' properties

jar {
    dependsOn(encryptProperties)
}

CI/CD pipeline

For running project in pipeline, add JASYPT_ENCRYPTOR_PASSWORD system environment variable in build configuration

env:
  JASYPT_ENCRYPTOR_PASSWORD: ${{ secrets.JASYPT_ENCRYPTOR_PASSWORD }}

Tasks

All plugin tasks require password parameter or system environment variable

encryptProperties

Search for all .properties/.yaml files for values wrapped with ENCRYPT() and encrypt them.

gradle encryptProperties --password=encryptorToken

Example:

some.very.secret.property=ENCRYPT(private)

Will be encrypted to:

some.very.secret.property=ENC(Lk5VWETH98C0/E/wOqzioQ==)

Property files can be filtered by pattern. In the example has been shown how search for non production yaml files and encrypt their values.

gradle encryptProperties --file-filter-pattern='application-((?!prod).*)\.yaml' --password=encryptorToken

Multiline properties

  • Yaml file example:
multiline.property: |
    ENCRYPT(
    some
    very
    long
    text
    )

NOTE: For the yaml file the indentation level should be the same for all multiline values. Also the pipe character '|' must be present on the first line, otherwise encryption/decryption won't work correctly.

  • Properties file:
multiline.property=\
  ENCRYPT(\
  example\
  multiline\
  )

decryptProperties

Search for all .properties/.yaml files for values wrapped with ENC() and decrypt them.

gradle decryptProperties --password=encryptorToken

Search for non production .properties/.yaml files and decrypt their values.

gradle decryptProperties --file-filter-pattern='application-((?!prod).*)\.yaml' --password=encryptorToken

encryptText

gradle encryptText --text=someText --password=encryptorToken

Output:

Encrypted text: SCw2qhh2bvTFJ4TPXgolTqM1kDDZ8FWbSW3yHlvPLDV9yektRCO7Jx8I1ZMuzSzm

decryptText

gradle decryptText --text=SCw2qhh2bvTFJ4TPXgolTqM1kDDZ8FWbSW3yHlvPLDV9yektRCO7Jx8I1ZMuzSzm --password=encryptorToken

Output:

Decrypted text: someText

About

Application properties encryption/decryption gradle plugin

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published