Skip to content

Latest commit

 

History

History
114 lines (92 loc) · 4.28 KB

README.md

File metadata and controls

114 lines (92 loc) · 4.28 KB
Raw

SECRECY: Secure collaborative analytics in untrusted clouds

This repository includes the implementation of the Secrecy relational Multi-Party Computation framework described in the USENIX NSDI'23 paper by John Liagouris, Vasiliki Kalavri, Muhammad Faisal, and Mayank Varia.

You can cite the paper using the BibTeX below:

@inproceedings {285183,
author = {John Liagouris and Vasiliki Kalavri and Muhammad Faisal and Mayank Varia},
title = {{SECRECY}: Secure collaborative analytics in untrusted clouds},
booktitle = {20th USENIX Symposium on Networked Systems Design and Implementation (NSDI 23)},
year = {2023},
isbn = {978-1-939133-33-5},
address = {Boston, MA},
pages = {1031--1056},
url = {https://www.usenix.org/conference/nsdi23/presentation/liagouris},
publisher = {USENIX Association},
month = apr,
}

NOTICE: This is an academic proof-of-concept prototype and has not received careful code review. This implementation is NOT ready for production use.

Building and running Secrecy

Repository organization

This repository is organized as follows:

  • The deployment folder contains automation scripts to deploy secrecy in AWS in either same region or cross region setups.
  • The src folder contains the core functionality of Secrecy, including the implementation of MPC primitives, relational oblivious operators, and party communication.
  • The examples folder contains the implementation of example queries with the Secrecy API.
  • The src/test folder contains various unit and end-to-end tests.
  • The src/experiments folder contains the implementation of various microbenchmarks and performance experiments.
  • Plotting scripts and other helper utilies are located in the results/scripts folder.

Dependencies

To build Secrecy, you will need to install:

  • CMake
  • Libsodium
  • an MPI implementation, such as OpenMPI or MPICH.
  • Create a new directory include/external-lib and clone https://github.com/mfaisal97/sql-parser inside it.

Building and running using the CMakeLists.txt file:

  • Make sure you have pkg-config installed.

    On Linux:

    sudo apt install pkg-config

    On OSX:

    brew install pkg-config

  • To compile and run all test cases:

    ./run_tests.sh

  • To run a specific test file or experiment:

    • First use cmake to create the build dir and make file: 
      mkdir build
cd build
cmake ..
    • Build and run a test file: 
      cd build
make planner
mpirun -np 3 ./planner ../examples/queries/q1.txt ../examples/schemas/q1_schema.txt 128 128  // Will compile and run Q1 with 128 and 128 rows per input tables

License

Secrecy is distributed under the terms of the Apache License (Version 2.0).