SYNOPSIS

          void
          mongoc_client_encryption_datakey_opts_set_masterkey (
             mongoc_client_encryption_datakey_opts_t *opts, const bson_t *masterkey);

       Identifies the masterkey for the Key Management Service (KMS) provider used to encrypt a new data key.

PARAMETERS

       • opts: A mongoc_client_encryption_datakey_opts_t <>

       • masterkey:  A  bson_t  <https://www.mongoc.org/libbson/current/bson_t.html> document describing the KMS
         provider specific masterkey.

DESCRIPTION

       Setting the masterkey is required when creating a data key with the KMS provider types: aws, azure,  gcp,
       and kmip.

       Setting the masterkey is prohibited with the KMS provider type local.

       The format of masterkey for the KMS provider type aws is as follows:

          {
             region: String,
             key: String, /* The Amazon Resource Name (ARN) to the AWS customer master key (CMK). */
             endpoint: Optional<String> /* An alternate host identifier to send KMS requests to. May include port number. Defaults to "kms.<region>.amazonaws.com" */
          }

       The format of masterkey for the KMS provider type azure is as follows:

          {
             keyVaultEndpoint: String, /* Host with optional port. Example: "example.vault.azure.net". */
             keyName: String,
             keyVersion: Optional<String> /* A specific version of the named key, defaults to using the key's primary version. */
          }

       The format of masterkey for the KMS provider type gcp is as follows:

          {
             projectId: String,
             location: String,
             keyRing: String,
             keyName: String,
             keyVersion: Optional<String>, /* A specific version of the named key, defaults to using the key's primary version. */
             endpoint: Optional<String> /* Host with optional port. Defaults to "cloudkms.googleapis.com". */
          }

       The format of masterkey for the KMS provider type kmip is as follows:

          {
             keyId: Optional<String>,
             delegated: Optional<Boolean>, /* If true (recommended), the KMIP server must decrypt this key. Defaults to false. */
             endpoint: Optional<String> /* Host with optional port. */
          }

Author

       MongoDB, Inc

Copyright

       2009-present, MongoDB, Inc.

2.2.0                                             Nov 26, 202MONGOC_CLIENT_ENCRYPTI...AKEY_OPTS_SET_MASTERKEY(3)