The companion C library for field-level encryption in drivers. This is a work-in-progress and subject to sweeping changes.

These instructions have been tested on macOS 10.14.1 and Ubuntu 16.04. Windows support coming soon.

First build the following dependencies.

1. The BSON library (part of the C driver), consisting of libbson. Build it from source.

   wget https://github.com/mongodb/mongo-c-driver/releases/download/1.14.0/mongo-c-driver-1.14.0.tar.gz
   tar xzf mongo-c-driver-1.14.0.tar.gz
   cd mongo-c-driver-1.14.0
   mkdir cmake-build && cd cmake-build
   cmake -DENABLE_MONGOC=OFF -DCMAKE_INSTALL_PATH="/path/to/bson-install" -DCMAKE_C_FLAGS="-fPIC" ../
   make -j8 install
   

   This installs the library and includes into /path/to/bson-install. The prefix can be omitted if you prefer installing in /usr/local.

2. kms-message, a small library for making encrypt and decrypt requests with AWS KMS.

   git clone git@github.com:10gen/kms-message.git
   cd kms-message
   mkdir cmake-build && cd cmake-build
   cmake -DCMAKE_INSTALL_PREFIX="/path/to/kms-install" -DCMAKE_C_FLAGS="-fPIC" ../
   make install
   

   This installs the library and includes into /path/to/kms-install. The prefix can be omitted if you prefer installing in /usr/local.

3. Install OpenSSL (if on Linux).

Then build libmongocrypt.

git clone git@github.com:10gen/libmongocrypt.git
cd libmongocrypt
mkdir cmake-build && cd cmake-build
cmake -DCMAKE_PREFIX_PATH="/path/to/bson-install;/path/to/kms-install" ../
make

This builds libmongocrypt.dylib and test-libmongocrypt, in the cmake-build directory. Note, the CMAKE_PREFIX_PATH must include the paths to the kms-message and BSON library installation directories if they were not the defaults.

Generate test data by running the script etc/generate-test-data.py. Then build and run test-mongocrypt.

If OpenSSL is installed in a non-default directory, pass -DOPENSSL_ROOT_DIR=/path/to/openssl to the cmake command for libmongocrypt.

If there are errors with cmake configuration, send the set of steps you performed and their output to Kevin Albertson.

If there are compilation or linker errors, run make again, setting VERBOSE=1 in the environment or on the command line (which shows exact compile and link commands), and send the output to Kevin Albertson.