Homomorphic Encryption Module

CLARUS Homomorphoc encryption module

License	TO BE DEFINED
Categories	Data
GroupId	eu.clarussecure
ArtifactId	dataoperations.homomorphic
Last Version	1.0.1
Release Date	Oct 27, 2017
Type	jar
Description	Homomorphic Encryption Module CLARUS Homomorphoc encryption module
Project URL	http://clarussecure.eu
Project Organization	The CLARUS Consortium
Source Code Management	http://github.com/clarus-proxy/homomorphicencryption-module/tree/master

Download dataoperations.homomorphic

Filename	Size
dataoperations.homomorphic-1.0.1.pom
dataoperations.homomorphic-1.0.1.jar	35 KB
dataoperations.homomorphic-1.0.1-sources.jar	24 KB
dataoperations.homomorphic-1.0.1-javadoc.jar	94 KB
dataoperations.homomorphic-1.0.1-jar-with-dependencies.jar	2 MB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/eu.clarussecure/dataoperations.homomorphic/ -->
<dependency>
    <groupId>eu.clarussecure</groupId>
    <artifactId>dataoperations.homomorphic</artifactId>
    <version>1.0.1</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/eu.clarussecure/dataoperations.homomorphic/
implementation 'eu.clarussecure:dataoperations.homomorphic:1.0.1'

Gradle Kotlin

// https://jarcasting.com/artifacts/eu.clarussecure/dataoperations.homomorphic/
implementation ("eu.clarussecure:dataoperations.homomorphic:1.0.1")

Apache Buildr

'eu.clarussecure:dataoperations.homomorphic:jar:1.0.1'

Apache Ivy

<dependency org="eu.clarussecure" name="dataoperations.homomorphic" rev="1.0.1">
  <artifact name="dataoperations.homomorphic" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='eu.clarussecure', module='dataoperations.homomorphic', version='1.0.1')
)

Scala SBT

libraryDependencies += "eu.clarussecure" % "dataoperations.homomorphic" % "1.0.1"

Leiningen

[eu.clarussecure/dataoperations.homomorphic "1.0.1"]

Dependencies

compile (3)

Group / Artifact	Type	Version
org.mongodb : mongodb-driver	jar	3.4.2
eu.clarussecure » encryption.paillier	jar	0.1
eu.clarussecure : dataoperations-api	jar	2.5

Project Modules

There are no modules declared in this project.

CLARUS Simple Encryption Module

Description

This is the Homomorphic Encryption Module for the CLARUS Proxy. The protection of the data is provided by Paillier encryption schema.

Initializaiton Vector and Key management

The Paillier cipher implements an asymetric encryption schema which requires both a Public Key and a Secret Key.

The security policy specifies the ID of the protected data. This is information is used by this module in order to find the right Public Key and Secret Key in the database. If no record is found, this module is capable of generating both parameters and store it in a mongo database for further usage.

The Key Pair length is stored in the key sotre. If this configuration is not available, a default lenght of 2048 bits will be used to generate the keys.

The connection data of the mongo Key Store is specified in the file: /etc/clarus/clarus-keystore.conf which is a JSON-based file with multiple configurations. The lines concerned with this module are:

• CLARUS_keystore_db_hostname: "localhost"
• CLARUS_keystore_db_port: 27017
• CLARUS_keystore_db_name: "CLARUS"

Please note that this file is required for the correct execution of the module.

Obtaining the code and compilation

The module depends only on the dataoperations-api project, whose code can be found here. Please refer to its README.md to compile this project.

In addition, this module also requires the Paillier encryption library that can be found here. Please refer to its README.md to compile this project.

Once the requirements are met, the Homomorphic Encryption Module can be downloaded and compiled:

# Get the code

git clone [email protected]:clarus-proxy/homomorphicencryption-module.git

# Compile it

cd homomorphicencryption-module/

mvn install

After this procedure, the compiled jar file can be found under target/dataoperations.homomorphic-(version)-SNAPSHOT.jar

Finally, it is required to install the configuraiton file in the machine. This is done by executing the script install_conf.sh as superuser. This is required since the script will create a folder under /etc and copy a file into it:

sudo ./install_conf.sh

Versions

Version
1.0.1 Oct 27, 2017