AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。

CSFLE によるドキュメントの復号化

このページでは、CSFLE がデータ暗号化キーとカスタマー マスター キーのメタデータを使用してデータを復号化する方法について説明します。

CSFLE を使用してデータを暗号化すると、暗号化されたデータは、次のメタデータを含むBinDataサブタイプ 6 オブジェクトとして保存されます。

  • データの暗号化に使用されるデータ暗号化キーの_id

  • データの暗号化に使用される暗号化アルゴリズム

データ暗号化キーには、暗号化に使用されたカスタマー マスター キーを記述するメタデータが含まれています。

ドライバーとmongoshはこのメタデータを使用して、データの自動復号を試行します。

データを自動的に復号化するには、CSFLE 対応クライアントは次の手順を実行します。

  1. 値の暗号化に使用されるデータ暗号化キーと暗号化アルゴリズムについて、復号化するフィールドのBinData lob メタデータを確認します。

  2. 指定されたデータ暗号化キーについて、現在のデータベース接続で構成されているキーヴォールト コレクションを確認します。 Key Vault コレクションに指定されたキーが含まれていない場合、自動復号は失敗し、ドライバーはエラーを返します。

  3. キーマテリアルの暗号化に使用される CMK(Customer Master Key)の データ暗号化キー メタデータを確認します。

  4. データ暗号化キーを復号化します。 このプロセスは KMS プロバイダーによって異なります。

    Amazon Web Services (AWS) KMSの場合、データ暗号化キーをAWS KMSインスタンスに送信して復号化します。CMKが存在しない場合、または接続設定でCMKへのアクセスが許可されていない場合、復号化は失敗し、ドライバーはエラーを返します。

    Tip

    Amazon Web Services KMSを使用して自動暗号化を実行する方法については、「 Amazon Web Services でのAmazon Web Servicesクライアント側フィールドレベル暗号化の使用 」を参照してください。

  5. 復号化されたデータ暗号化キーと適切なアルゴリズムを使用して、 BinData値を復号化します。

MongoDB サーバーにアクセスでき、必要な CMK とデータ暗号化キーにもアクセスできないアプリケーションは、 BinData値を復号化できません。

読み取り操作では、ドライバーは読み取り操作を発行する前に、暗号化スキーマを使用してクエリ ドキュメント内のフィールド値を暗号化します。

その後、クライアント アプリケーションはBinDataメタデータを使用して、MongoDB から受信したドキュメントを自動的に復号化します。

暗号化スキーマの詳細については、「暗号化スキーマ 」を参照してください。

クライアント側のフィールドレベル暗号化のためのデータベース接続の構成方法については、「 CSFLE 用の MongoClient オプション 」を参照してください。

データ暗号化キーとカスタマー マスター キーの関係の詳細については、「暗号化キーとキーヴォールト 」を参照してください。