Skip to content

Latest commit

 

History

History
56 lines (34 loc) · 3.14 KB

README.md

File metadata and controls

56 lines (34 loc) · 3.14 KB
Raw

PRIVAaaS - EUBra-BISEA

PRIVAaaS is a set of libraries and tools that allow controlling and reducing data leakage in the context of Big Data processing and, consequently, protecting sensible information that is processed by data analytics algorithms.

Find the sources of PRIVAaaS big data privacy tool here. Find more about EUBra-BISEA at the project website http://www.eubra-bigsea.eu.

We will add ARX to the library soon.

Proof of Concept

The maven project contained in priva-poc implements a first version of the libraries. It includes LightPrivacyService, which implements a simple restful service. It does not require an external server.

How to use

You can include the library in your Java application or through its REST API. The library usage requires two inputs:

  • an anonymization policy, in a .json file, e.g. (policy example);
  • the data to be anonymized, in one or more .json files, e.g. (data example).

How to use the REST API

To setup the REST server, you should run the project with the main class LightPrivacyService. To run the project you can either use maven or the Docker solution below.

Then, you should use the HTTP method post to the url: http://localhost:4567/endpoint/. Tools can help you with that. You can use the postman or the cURL (in your shell) to try it.

Run the Project in a Docker container

To avoid the need for you to install java, maven, etc. we created a Docker container that makes the life much easier. You only need to install Docker, and after that the process is fully automated. In practice you need to run the files Docker-build.sh and Docker-run.sh.

Docker-build.sh creates the image based on the included Dockerfile and the first time may take a while, due to the need to download the required dependencies. Docker-run.sh starts the container with the LightPrivacyService.

Demo java client

Examples are provided with this code. The project in PRIVAaaS-client portrays how to use the web service provided.

Using cURL

Other rest clients can be used. For instance cURL, with a command like this.

curl -X POST -v http://localhost:4567/endpoint/ -d @"../../priva-poc/input/example-mock-data/mock_data.policy.json" -d @"../../priva-poc/input/example-mock-data/mock_data.json"

Html Form

Another usage example is provided with an html form in: