PYTHON-3001 Bump minimum pymongocrypt version to 1.2.0 (#793)

Author: ShaneHarvey

doc/changelog.rst

@@ -179,6 +179,8 @@ Breaking Changes in 4.0
   parsing MongoDB URIs.
 - Removed the `disable_md5` parameter for :class:`~gridfs.GridFSBucket` and
   :class:`~gridfs.GridFS`. See :ref:`removed-gridfs-checksum` for details.
+- PyMongoCrypt 1.2.0 or later is now required for client side field level
+  encryption support.
 
 Notable improvements
 ....................
@@ -194,6 +196,9 @@ Notable improvements
   choose a `srvMaxHosts` sized subset of hosts.
 - Added :attr:`pymongo.mongo_client.MongoClient.options` for read-only access
   to a client's configuration options.
+- Support for the "kmip" KMS provider for client side field level encryption.
+  See the docstring for :class:`~pymongo.encryption_options.AutoEncryptionOpts`
+  and :mod:`~pymongo.encryption`.
 
 Issues Resolved
 ...............

pymongo/encryption.py

@@ -426,6 +426,10 @@ def __init__(self, kms_providers, key_vault_namespace, key_vault_client,
 
               kms_tls_options={'kmip': {'tlsCAFile': certifi.where()}}
 
+            Or to supply a client certificate::
+
+              kms_tls_options={'kmip': {'tlsCertificateKeyFile': 'client.pem'}}
+
         .. versionchanged:: 4.0
            Added the `kms_tls_options` parameter and the "kmip" KMS provider.
 

pymongo/encryption_options.py

@@ -129,6 +129,10 @@ def __init__(self, kms_providers, key_vault_namespace,
 
               kms_tls_options={'kmip': {'tlsCAFile': certifi.where()}}
 
+            Or to supply a client certificate::
+
+              kms_tls_options={'kmip': {'tlsCertificateKeyFile': 'client.pem'}}
+
         .. versionchanged:: 4.0
            Added the `kms_tls_options` parameter and the "kmip" KMS provider.
 

setup.py

@@ -277,7 +277,7 @@ def build_extension(self, ext):
     pyopenssl_reqs.append('certifi')
 
 extras_require = {
-    'encryption': ['pymongocrypt>=1.1.0,<2.0.0'],
+    'encryption': ['pymongocrypt>=1.2.0,<2.0.0'],
     'ocsp': pyopenssl_reqs,
     'snappy': ['python-snappy'],
     'zstd': ['zstandard'],