|
4 | 4 |
|
5 | 5 | .. replacement:: driver-specific-content
|
6 | 6 |
|
7 |
| -Libmongocrypt |
8 |
| -------------- |
9 |
| - |
10 |
| -Libmongocrypt is a C library utilized by the driver for client-side encryption. |
11 |
| -To enable client-side encryption, you must install the libmongocrypt library on |
12 |
| -the machine running your application. The driver includes the MongoDB.libmongocrypt |
13 |
| -NuGet package, which bundles libmongocrypt libraries for various operating systems. |
14 |
| -However, on Linux systems, the bundled libmongocrypt library does not use the system's |
15 |
| -native encryption providers due to OpenSSL versioning issues. For high-performance |
16 |
| -applications on Linux, it is recommended to manually install the libmongocrypt |
17 |
| -library and specify its path to the driver using the ``LIBMONGOCRYPT_PATH`` |
18 |
| -environment variable. This is only recommended for users on linux systems. |
19 |
| - |
20 |
| -You can download a pre-built binary libmongocrypt and manually place the required |
21 |
| -shared object on your computer, as follows: |
22 |
| - |
23 |
| - * Download a tarball of all libmongocrypt variations `here <https://s3.amazonaws.com/mciuploads/libmongocrypt/all/master/latest/libmongocrypt-all.tar.gz>`_. |
24 |
| - * Extract the file you downloaded. You will see a list of directories, each |
25 |
| - corresponding to an operating system. Find the directory that matches your |
26 |
| - operating system and open it. |
27 |
| - * Inside that folder, open either the lib or lib64 folder, you will find the |
28 |
| - libmongocrypt.so or libmongocrypt.dylib or libmongocrypt.dll file, depending |
29 |
| - on your OS. |
30 |
| - * Move that file to wherever you want to keep it on your machine. You may delete |
31 |
| - the other files included in the tarball. |
32 |
| - |
33 |
| -To build the binary from source: |
34 |
| - |
35 |
| - * Follow the instructions in the README in the `libmongocrypt GitHub repo <https://github.com/mongodb/libmongocrypt>`_. |
36 |
| - |
37 |
| -Once you have the libmongocrypt binary on your machine, specify the path to the |
38 |
| -binary using the ``LIBMONGOCRYPT_PATH`` environment variable. It is reccomended |
39 |
| -that you add this variable to your rc files. |
40 |
| - |
41 |
| -For example: |
42 |
| - |
43 |
| -.. code-block:: csharp |
44 |
| - |
45 |
| - export LIBMONGOCRYPT_PATH=/absolute/path/to/your/libmongocrypt.so |
| 7 | +To use CSFLE with the driver, you need to have the MongoDB.Driver.Encryption |
| 8 | +nuget package. This package bundles libmongocrypt (library that manages encryption) |
| 9 | +libraries for various operating systems. However, on Linux systems, the bundled |
| 10 | +libmongocrypt library does not use the system's native encryption providers due |
| 11 | +to OpenSSL versioning issues. For high-performance applications on Linux, we |
| 12 | +recommend manually installing the libmongocrypt library and specifying its path |
| 13 | +to the driver using the LIBMONGOCRYPT_PATH environment variable. |
| 14 | + |
| 15 | +You can find the instructions for downloading a pre-built binary libmongocrypt |
| 16 | +library `here <https://www.mongodb.com/docs/manual/core/queryable-encryption/reference/libmongocrypt/>`_. |
0 commit comments