Class: Mongo::ClientEncryption

継承:
オブジェクト
  • オブジェクト
すべて表示
定義:
lib/mongo/client_encryption.rb

Overview

ClientEncryption は、MongoClient では直接実行できないキーヴォールト コレクションに対する明示的な操作をカプセル化します。 値を明示的に暗号化および復号化し、データキーを作成するための API を提供します。

インスタンス メソッドの概要を折りたたむ

コンストラクターの詳細

#initialize(key_vault_client, options = {}) ⇒ ClientEncryption

指定されたオプションを使用して新しい ClientEncryption オブジェクトを作成します。

パラメーター:

  • key_vault_client （ Mongo::Client ） —

    キーヴォールト コレクションが保存されている MongoDB インスタンスに接続される Mongo::Client。

  • options （ハッシュ） （デフォルトは{}です） —

    ClientEncryption オプション。

オプション ハッシュ（ options ）:

  • :key_vault_namespace （ string ） —

    database.collection」形式の、キーヴォールト コレクションの名前。

  • : kms_providers （ハッシュ） —

    KMS構成情報のハッシュ。 サポートされているすべてのプロバイダーのオプションのリストについては、「 Mongo::Crypt::KMS::認証情報 」を参照してください。 @note 複数の KMS プロバイダーを指定できます。

  • : kms_tls_options （ハッシュ） —

    KMS プロバイダーに接続するための TLS オプション。 ハッシュのキーは、K SM プロバイダー名である必要があります。値は、TLS 接続オプションのハッシュである必要があります。 オプションは、Mongo::Client の TLS 接続オプションと同じです。 TLS オプションのリストについては、「 Mongo::Client#initialize 」を参照してください。

  • :timeout_ms （整数） —

    操作のタイムアウト（ミリ秒単位）。 負でない整数である必要があります。 0 の明示的な値は無限を意味します。 デフォルト値が設定されていない場合は、機能が無効になります。

次の値が発生します。

  • (ArgumentError) —

    必須 オプションが欠落しているか、形式が正しくない場合。



49
50
51
52
53
54
55
56
 
# ファイル 'lib/mongo/client_encryption.rb' 行 49

デフォルト 初期化(key_vault_client, options = {})
  @encrypter = 暗号化::明示的暗号化.新着情報(
    key_vault_client,
    options[:key_vault_namespace],
    暗号化::KMS::Credentials.新着情報(options[: kms_providers]),
    暗号化::KMS::検証.validate_tls_options(options[: kms_tls_options])
  )
end

インスタンス メソッドの詳細

#add_key_alt_name(id, key_alt_name) ⇒ BSON::Document | nil

指定された ID を持つキーヴォールト コレクション内のキーの key_alt_name を追加します。

パラメーター:

  • id （ BSON ::Binary ） —

    新しいキー代替名を追加するキーの ID。

  • key_alt_name ( string ) —

    追加する新しいキー代替名。

次の値を返します。

  • (BSON::Document | nil) —

    キーの代替名を追加する前に、識別されたキーを説明するドキュメント。または、そのようなキーがない場合は nil 。



183
184
185
 
# ファイル 'lib/mongo/client_encryption.rb' 行 183

デフォルト add_key_alt_name(id, key_alt_name)
  @encrypter.add_key_alt_name(id, key_alt_name)
end

# create_data_key （kms_provider、オプション={}）= BSON::Binary

暗号化および復号化に使用されるデータキーを生成し、そのキーを KMS コレクションに保存します。 生成されたキーは KMS マスター キーで暗号化されます。

パラメーター:

  • kms_provider ( string ) —

    使用する KMS プロバイダー。 有効な値はAmazon Web Servicesと local です。

  • options （ハッシュ） （デフォルトは{}です）

オプション ハッシュ（ options ）:

  • : マスター_キー （ハッシュ） —

    Amazon Web Servicesのマスターキーに関する情報。 kms_provider がAmazon Web Servicesの場合は必須です。

    • :region [ string ] マスターキーのAmazon Web Servicesのリージョン（必須）。

    • :key [ string ] マスターキーのAmazonリソース名（ARN） （必須）。

    • :endpoint [ string ] KMSリクエストを送信する代替ホスト（任意）。 エンドポイントは、任意のポート番号をコロンで区切ったホスト名（例: kms.us-east- 1 .amazonaws.com」または " kms.us-east- 1 .Amazonaws.com: 443 ）。 他の形式のエンドポイントは適切に解析されません。

  • :key_alt_names （配列<String> ） —

    新しいデータキーの代替名を指定する文字列の任意の配列。

  • :key_rate （ string | nil ） —

    作成されるデータキーのカスタムキーマテリアルとして使用する任意の96バイト。 :key_rate オプションが指定されている場合、カスタム キー マテリアル はデータの暗号化と復号化に使用されます。

次の値を返します。

  • （ BSON ::Binary ） —

    :uuid 型の BSON::Binary オブジェクトとしての新しいデータキーの16バイト UUID 。



84
85
86
87
88
89
90
 
# ファイル 'lib/mongo/client_encryption.rb' 行 84

デフォルト create_data_key(kms_provider, options={})
  key_document = 暗号化::KMS::MasterKeyDocument.新着情報(kms_provider, options)

  key_alt_names = options[:key_alt_names]
  key_rate = options[:key_rate]
  @encrypter.create_and_insert_data_key(key_document, key_alt_names, key_rate)
end

# create_encrypted_collection (database, coll_name,coll_opts, kms_provider, Master_key) == Array =======================================

注：

このメソッドでは、クライアントの : auto_encryption_options の :encrypted_fields_map は更新されません。 したがって、このメソッドによって作成されたコレクションを自動暗号化で使用するには、:encrypted_fields が返されたこの関数を呼び出した後、新しいクライアントを作成する必要があります。

暗号化されたフィールドを持つコレクションを作成します。

:encryption_fields に null 値を持つ keyId が含まれている場合、データキーが自動的に生成され、keyId 値に割り当てられます。

パラメーター:

  • database （ Mongo::Database ） —

    コレクションを作成するデータベース。

  • coll_name ( string ) —

    作成するコレクションの名前。

  • coll_opts （ハッシュ） —

    作成するコレクションのオプション。

  • kms_provider ( string ) —

    フィールドを暗号化するための KMS プロバイダー。

  • マスター_キー (ハッシュ | nil ) —

    フィールドを暗号化するためのマスターキーを説明するドキュメント。

次の値を返します。

  • （配列未満操作 ::結果、ハッシュ> ） —

    コレクション作成操作の結果と、コレクションの作成に使用された暗号化されたフィールド マップ。

次の値が発生します。

  • (ArgumentError) 


270
271
272
273
274
275
276
277
278
279
280
281
 
# ファイル 'lib/mongo/client_encryption.rb' 行 270

デフォルト create_encrypted_collection(database, coll_name, coll_opts, kms_provider, マスター_キー)
  発生 ArgumentError, 「 coll_opts には :encrypted_fields が含まれている必要があります」 ただし、 coll_opts[:encrypted_fields]

  encryption_fields = create_data_keys(coll_opts[:encrypted_fields], kms_provider, マスター_キー)
  begin
    new_coll_opts = coll_opts.dup.merge(encryption_fields: encryption_fields)
    [database[coll_name].create(new_coll_opts), encryption_fields]
  ヘルプ mongo::エラー => e
    発生 エラー::CryptError, "暗号化されたフィールドを使用したコレクションの作成エラー\ #{ encrypted_fields } : #{ e .クラス} : #{ e .メッセージ} "
  end
end

#decryption （値）=オブジェクト

すでに暗号化されている値を復号化します。

パラメーター:

  • 価値 （ BSON ::Binary ） —

    復号化されるサブタイプ6 （暗号テキスト）の BSON バイナリ オブジェクト。

次の値を返します。

  • （オブジェクト） —

    復号化された値。



172
173
174
 
# ファイル 'lib/mongo/client_encryption.rb' 行 172

デフォルト 解読(価値)
  @encrypter.解読(価値)
end

# delete_key （ ID ） =操作::結果

指定された ID を持つキーをキーヴォールト コレクションから削除します。

パラメーター:

  • id （ BSON ::Binary ） —

    削除するキーの ID。

次の値を返します。

  • （操作 :: 結果） —

    キーを削除する delete_one 操作に対するデータベースからの応答。



193
194
195
 
# ファイル 'lib/mongo/client_encryption.rb' 行 193

デフォルト delete_key(id)
  @encrypter.delete_key(id)
end

#暗号化（値、オプション = {{}） = BSON::Binary

注：

:key_id オプションと :key_alt_name オプションは相互に排他的です。 明示的な暗号化を実行するには 1 つのみが必要です。

指定された暗号化キーとアルゴリズムを使って値を暗号化します。

暗号化アルゴリズムが [ Indexed（インデックス付き） ] に設定されている場合。 クエリタイプは、

only if encryption algorithm is set to "Indexed". The only allowed
value is "equality".

パラメーター:

  • 価値 （オブジェクト） —

    暗号化する値。

  • options （ハッシュ） （デフォルトは{}です）

オプション ハッシュ（ options ）:

  • :key_id （ BSON::Binary ） —

    キーヴォールトコレクションに保存されている暗号化のキーの UUID を表す :uuid の BSON::Binary オブジェクト。

  • :key_alt_name （ string ） —

    暗号化キーの代替名。

  • : アルゴリズム （ string ） —

    値を暗号化するために使用されるアルゴリズム。 有効なアルゴリズムは、AEAD_AES_ 256 _CBC_HMAC_SHA_ 512 -決定的）、AEAD_AES_ 256 _CBC_HMAC_SHA_ 512 -ランダム 、インデックス付き 、インデックスなし 。

  • :contention_factor (Integer | nil) —

    暗号化アルゴリズムが インデックス付き に設定されている場合に適用される競合係数。 指定しない場合、デフォルトは0の値になります。 競合係数は、暗号化アルゴリズムが [ Indexed（インデックス付き） ] に設定されている場合にのみ設定する必要があります。

  • query_type （ string | nil ） —

    適用するクエリの種類

次の値を返します。

  • （ BSON ::Binary ） —

    暗号化された値を表すサブタイプ6 （暗号テキスト）の BSON バイナリ オブジェクト。

次の値が発生します。

  • (ArgumentError) —

    は、content_factor または query_type のいずれかが設定され、 かつ アルゴリズムが インデックス付きでない 場合に適用されます。



122
123
124
 
# ファイル 'lib/mongo/client_encryption.rb' 行 122

デフォルト 暗号化(価値, options={})
  @encrypter.暗号化(価値, options)
end

#暗号化_式（式、オプション={{}）= BSON::Binary

注：

:key_id オプションと :key_alt_name オプションは相互に排他的です。 明示的な暗号化を実行するには 1 つのみが必要です。

範囲インデックスをクエリするには、 マッチ式 または 集計式 を暗号化します。

queryType が range で、アルゴリズムが Range の場合にのみサポートされます。 @note: Rangeアルゴリズムは実験的なもののみです。 意図したものではありません

for public use. It is subject to breaking changes.

# @ param [ ハッシュ ] オプション

例:

マッチ式を暗号化する。

encryption.encrypt_expression(
  {'$and' =>  [{'field' => {'$gt' => 10}}, {'field' =>  {'$lt' => 20 }}]}
)

集計式を暗号化する。

encryption.encrypt_expression(
  {'$and' =>  [{'$gt' => ['$field', 10]}, {'$lt' => ['$field', 20]}}
)
{$and: [{$gt: [<fieldpath>, <value1>]}, {$lt: [<fieldpath>, <value2>]}]

パラメーター:

  • 式 （ハッシュ） —

    暗号化する 式 。

  • options （ハッシュ） （デフォルトは{}です） —

    カスタマイズ可能なオプションのセット

オプション ハッシュ（ options ）:

  • :key_id （ BSON::Binary ） —

    キーヴォールトコレクションに保存されている暗号化のキーの UUID を表す :uuid の BSON::Binary オブジェクト。

  • :key_alt_name （ string ） —

    暗号化キーの代替名。

  • : アルゴリズム （ string ） —

    式を暗号化するために使用されるアルゴリズム。 許可される値は範囲のみ

  • :contention_factor (Integer | nil) —

    適用される競合係数。指定されない場合、デフォルトは0の値になります。

  • query_type （ string | nil ） —

    適用されるクエリのタイプ。 許可される値は範囲のみです。

次の値を返します。

  • （ BSON ::Binary ） —

    暗号化された式を表すサブタイプ6 （暗号テキスト）の BSON バイナリ オブジェクト。

次の値が発生します。

  • (ArgumentError) —

    オプションで許可されていない値が設定されている場合。



162
163
164
 
# ファイル 'lib/mongo/client_encryption.rb' 行 162

デフォルト encryption_式(式, options = {})
  @encrypter.encryption_式(式, options)
end

#get_key(id) ⇒ BSON::Document | nil

指定された ID を持つ単一のキーを検索します。

パラメーター:

  • id （ BSON ::Binary ） —

    取得するキーの ID。

次の値を返します。

  • (BSON::Document | nil) —

    見つかったキー ドキュメント、または見つからない場合は nil 。



203
204
205
 
# ファイル 'lib/mongo/client_encryption.rb' 行 203

デフォルト get_key(id)
  @encrypter.get_key(id)
end

#get_key_by_alt_name(key_alt_name) ⇒ BSON::Document | nil

指定された key_alt_name を持つキーヴォールト コレクション内のキーを返します。

パラメーター:

  • key_alt_name ( string ) —

    キーを検索するには、 キー代替名 を参照してください。

次の値を返します。

  • (BSON::Document | nil) —

    見つかったキー ドキュメント、または見つからない場合は nil 。



213
214
215
 
# ファイル 'lib/mongo/client_encryption.rb' 行 213

デフォルト get_key_by_alt_name(key_alt_name)
  @encrypter.get_key_by_alt_name(key_alt_name)
end

#get_keys = Collection::Viewとも呼ばれます:

キーヴォールト コレクション内のすべてのキーを返します。

次の値を返します。



220
221
222
 
# ファイル 'lib/mongo/client_encryption.rb' 行 220

デフォルト get_keys
  @encrypter.get_keys
end

#remove_key_alt_name(id, key_alt_name) ⇒ BSON::Document | nil

指定された ID を持つキーヴォールトコレクション内のキーから key_alt_name を削除します。

パラメーター:

  • id （ BSON ::Binary ） —

    キー代替名を削除するキーの ID。

  • key_alt_name ( string ) —

    削除するキーの代替名。

次の値を返します。

  • (BSON::Document | nil) —

    キーの代替名を削除する前に、識別されたキーを説明するドキュメント、またはそのようなキーがない場合は nil 。



232
233
234
 
# ファイル 'lib/mongo/client_encryption.rb' 行 232

デフォルト delete_key_alt_name(id, key_alt_name)
  @encrypter.delete_key_alt_name(id, key_alt_name)
end

# brewp_many_data_key （フィルター、opts = {}） = Crypt::RewriteManyDataKeyResult

複数のデータキーを復号化し、新しいマスター_キーでそれらを（再）暗号化します、

or with their current master_key if a new one is not given.

パラメーター:

  • フィルター （ハッシュ） —

    更新するキーを検索するために使用されるフィルター。

  • options （ハッシュ）

次の値を返します。



247
248
249
 
# ファイル 'lib/mongo/client_encryption.rb' 行 247

デフォルト rewrap_many_data_key(フィルター, ops = {})
  @encrypter.rewrap_many_data_key(フィルター, ops)
end