Docs HomeMongoDB Manual

Compatibility

This page describes the MongoDB and driver versions with which Client-Side Field Level Encryption is compatible.

MongoDB Edition and Version Compatibility

Automatic encryption with Client-Side Field Level Encryption is only available with MongoDB Enterprise Edition, version 4.2 or later.

Manual encryption with Client-Side Field Level Encryption is available with MongoDB Community and Enterprise Edition, version 4.2 or later.

Driver Compatibility Table

Client-Side Field Level Encryption is only available the following official compatible driver versions or later:

DriverSupported VersionsQuickstarts / Tutorials
Node3.4.0+
Java3.12.0+
Java Reactive Streams1.13.0+Java RS Documentation
Python (PyMongo)3.10.0+
C#/.NET2.10.0+.NET Driver Quickstart
C1.17.5C Driver Client-Side Field Level Encryption
Go1.2+Go Driver Quickstart
Scala2.8.0+Scala Documentation
PHP1.6.0+PHP Driver Quickstart
Ruby2.12.1+Ruby Driver Quickstart

Important

Key Rotation Support

To use the key rotation API of CSFLE, such as the rewrapManyDateKey method, you must use specific versions of either your driver's binding package or libmongocrypt.

The following list details each driver's key rotation API dependencies:

  • Node.js Driver: Use mongodb-client-encryption version 2.2.0-alpha.6 or later.

  • Java Driver: Use mongodb-crypt version 1.7.3 or later.

  • pymongo: Use pymongocrypt version 1.3.1 or later.

  • Go Driver: Use libmongocrypt version 1.5.2 or later.

  • C#/.NET Driver: Use the MongoDB C#/.NET Driver version 2.17.1 or later.

Please refer to the driver reference documentation for syntax and implementation examples.