MongoDB C++ Driver  mongocxx-3.9.0
All Classes Namespaces Functions Typedefs Enumerations Enumerator Friends Pages
client_encryption.hpp
1 // Copyright 2020 MongoDB Inc.
2 //
3 // Licensed under the Apache License, Version 2.0 (the "License");
4 // you may not use this file except in compliance with the License.
5 // You may obtain a copy of the License at
6 //
7 // http://www.apache.org/licenses/LICENSE-2.0
8 //
9 // Unless required by applicable law or agreed to in writing, software
10 // distributed under the License is distributed on an "AS IS" BASIS,
11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 // See the License for the specific language governing permissions and
13 // limitations under the License.
14 
15 #pragma once
16 
17 #include <string>
18 
19 #include <bsoncxx/document/view_or_value.hpp>
20 #include <bsoncxx/stdx/optional.hpp>
21 #include <mongocxx/stdx.hpp>
22 
23 #include <mongocxx/config/prelude.hpp>
24 
25 namespace mongocxx {
26 inline namespace v_noabi {
27 class client;
28 class client_encryption;
29 
30 namespace options {
31 
35 class MONGOCXX_API client_encryption {
36  public:
51 
58  const stdx::optional<mongocxx::client*>& key_vault_client() const;
59 
76  using ns_pair = std::pair<std::string, std::string>;
77  client_encryption& key_vault_namespace(ns_pair ns);
78 
86  const stdx::optional<ns_pair>& key_vault_namespace() const;
87 
131  client_encryption& kms_providers(bsoncxx::document::view_or_value kms_providers);
132 
139  const stdx::optional<bsoncxx::document::view_or_value>& kms_providers() const;
140 
163  client_encryption& tls_opts(bsoncxx::document::view_or_value tls_opts);
164 
171  const stdx::optional<bsoncxx::document::view_or_value>& tls_opts() const;
172 
173  private:
174  friend class mongocxx::client_encryption;
175 
176  MONGOCXX_PRIVATE void* convert() const;
177 
178  stdx::optional<mongocxx::client*> _key_vault_client;
179  stdx::optional<ns_pair> _key_vault_namespace;
180  stdx::optional<bsoncxx::document::view_or_value> _kms_providers;
181  stdx::optional<bsoncxx::document::view_or_value> _tls_opts;
182 };
183 
184 } // namespace options
185 } // namespace v_noabi
186 } // namespace mongocxx
187 
188 #include <mongocxx/config/postlude.hpp>
Class supporting operations for MongoDB Client-Side Field Level Encryption.
Definition: client_encryption.hpp:38
Class representing a client connection to MongoDB.
Definition: client.hpp:54
Class representing options for the object managing explicit client-side encryption.
Definition: client_encryption.hpp:35
client_encryption & kms_providers(bsoncxx::document::view_or_value kms_providers)
Sets the KMS providers to use for client side encryption.
client_encryption & key_vault_client(mongocxx::client *client)
When the key vault collection is on a separate MongoDB cluster, sets the optional client to use to ro...
const stdx::optional< ns_pair > & key_vault_namespace() const
Gets the key vault namespace.
const stdx::optional< bsoncxx::document::view_or_value > & kms_providers() const
Gets the KMS providers.
std::pair< std::string, std::string > ns_pair
Sets the namespace to use to access the key vault collection, which contains all data keys used for e...
Definition: client_encryption.hpp:76
const stdx::optional< bsoncxx::document::view_or_value > & tls_opts() const
Gets the TLS options.
client_encryption & tls_opts(bsoncxx::document::view_or_value tls_opts)
Sets the TLS options to use for client side encryption with a given KMS provider.
const stdx::optional< mongocxx::client * > & key_vault_client() const
Gets the key vault client.
Class representing the optional arguments to a MongoDB driver client object.
Definition: client.hpp:36
The top-level namespace for mongocxx library entities.
Definition: bulk_write.hpp:24