MongoDB C++ Driver  mongocxx-3.8.1
All Classes Namespaces Functions Typedefs Enumerations Enumerator Friends Pages
data_key.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 #include <vector>
19 
20 #include <bsoncxx/document/view_or_value.hpp>
21 #include <bsoncxx/stdx/optional.hpp>
22 #include <mongocxx/stdx.hpp>
23 
24 #include <mongocxx/config/prelude.hpp>
25 
26 namespace mongocxx {
27 MONGOCXX_INLINE_NAMESPACE_BEGIN
28 
29 class client_encryption;
30 
31 namespace options {
32 
36 class MONGOCXX_API data_key {
37  public:
75  // keyId: Optional<String>, // keyId is the KMIP Unique Identifier to a 96 byte KMIP Secret
76  // // Data managed object.If keyId is omitted, the driver creates a
77  // // random 96 byte KMIP Secret Data managed object.
78  // endpoint: Optional<String> // Host with optional port.
92 
99  const stdx::optional<bsoncxx::document::view_or_value>& master_key() const;
100 
114  data_key& key_alt_names(std::vector<std::string> key_alt_names);
115 
122  const std::vector<std::string>& key_alt_names() const;
123 
142  using key_material_type = std::vector<uint8_t>;
143  data_key& key_material(key_material_type key_material);
144 
153  const stdx::optional<key_material_type>& key_material();
154 
155  private:
156  friend class mongocxx::client_encryption;
157  MONGOCXX_PRIVATE void* convert() const;
158 
159  stdx::optional<bsoncxx::document::view_or_value> _master_key;
160  std::vector<std::string> _key_alt_names;
161  stdx::optional<key_material_type> _key_material;
162 };
163 
164 } // namespace options
165 
166 MONGOCXX_INLINE_NAMESPACE_END
167 } // namespace mongocxx
Class supporting operations for MongoDB Client-Side Field Level Encryption.
Definition: client_encryption.hpp:39
Class representing options for data key generation for encryption.
Definition: data_key.hpp:36
const stdx::optional< key_material_type > & key_material()
Gets the keyMaterial as binary data.
const std::vector< std::string > & key_alt_names() const
Gets the alternate names for the data key.
data_key & master_key(bsoncxx::document::view_or_value master_key)
Sets a KMS-specific key used to encrypt the new data key.
data_key & key_alt_names(std::vector< std::string > key_alt_names)
Sets an optional list of string alternate names used to reference the key.
std::vector< uint8_t > key_material_type
Sets the binary data for the key material.
Definition: data_key.hpp:142
const stdx::optional< bsoncxx::document::view_or_value > & master_key() const
Gets the master key.
Top level namespace for the MongoDB C++ driver.
Definition: bulk_write.hpp:24