/alfresco-ciphering

Alfresco Action to cipher & decipher the content of the files by using a password

Primary LanguageJavaOtherNOASSERTION

Alfresco Ciphering

This add-on replaces abandoned addons to cipher and decipher files with a password in Alfresco:

The addon creates a new PKCS5 mime type to identify ciphered files.

License The plugin is licensed under the LGPL v3.0.

State Current addon release is 1.0.0

Compatibility The current version has been developed using Alfresco 201707 and Alfresco SDK 3.0.1

No original Alfresco resources have been overwritten

Downloading the ready-to-deploy-plugin

The binary distribution is made of one JAR file to be deployed in Alfresco as a repo module:

You can install it by copying JAR file to $ALFRESCO_HOME/modules/platform and re-starting Alfresco.

There is also one JAR file for Share Web App:

You can install it by copying JAR file to $ALFRESCO_HOME/modules/share and re-starting Alfresco.

Building the artifacts

You can build the artifacts from source code using maven in alfresco-ciphering-repo and alfresco-ciphering-share folders.

$ mvn clean package

Configuration

Ciphering can be configured by including following properties in alfresco-global.properties

Refer https://docs.oracle.com/javase/8/docs/technotes/guides/security/StandardNames.html#SecretKeyFactory for options.

cipher.secret.key.factory
cipher.secret.key.spec
cipher.instance

By default, following values are pre-configured

cipher.secret.key.factory=PBKDF2WithHmacSHA256
cipher.secret.key.spec=AES
cipher.instance=AES/CBC/PKCS5Padding

Using

  • Configure a rule in a folder to apply keensoft-cipher-action for every incoming file. Include also a password in the box to the right.

  • Once a file is ciphered in PKCS5 format, a new action Decipher will be added to Share Web App. Password is required in order to decipher the file.

Testing

  • Basic integration testing provided for ciphering and deciphering actions.
$ mvn integration-test

Contributors

Alfresco Ciphering - Command Line Tool

Additionaly a command line tool based in Java JAR standalone program to decipher files is provided at ciphering-cmd