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

CMK の作成

このガイドでは、選択したキー管理システムで カスタマー マスター キーを生成する方法を学習します。 Queryable Encryption 対応のアプリケーションを作成する前に、 カスタマー マスター キーを生成 します。

Tip

CMK(カスタマー マスター キー)

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

続行する前に、前述のタスクを完了します。

以下で、キープロバイダーのタブを選択します。

1
  1. CMK の作成

    対称 キーの作成 に関する の公式ドキュメントに従って、新しい対称キーを作成しますAmazon Web Services KMS。作成したキーが CMK です。 それを識別するのに役立つ名前と説明を選択します。これらのフィールドは、 CMKの機能や構成に影響を与えません。

    キー生成プロセスのUsage Permissionsステップで、カスタマー マスター キーへのアクセスを許可するために、ID とアクセス管理( IAM )ポリシーを有効にする次のデフォルトのキーポリシーを適用します。

    { "Version": "2012-10-17", "Statement": [ { "Sid": "Enable IAM User Permissions", "Effect": "Allow", "Principal": { "AWS": "<ARN of your AWS account principal>" }, "Action": "kms:*", "Resource": "*" } ]}

    重要

    カスタマー マスター キーの Amazon リソース名( ARN )とリージョンを記録します。 これらはこのガイドの後の手順で使用します。

    Tip

    キー ポリシー

    キー ポリシーの詳細については、 Amazon Web Services の公式ドキュメントの Amazon Web Services KMS のキー ポリシー を参照してください。

2
  1. IAM ユーザーの作成

    Amazon Web Services マネジメント コンソールで、新しいプログラムによる IAM ユーザーを作成します。これには、ユーザーの追加 に関する Amazon Web Services の公式ドキュメントに従ってください。Queryable 暗号化 を使用するアプリケーションのサービス アカウントとして、この IAM ユーザーを使用します。アプリケーションは、IAM ユーザーを使用して AWS KMS との間で認証し、CMK を使用してデータ暗号化キー (DEK) を暗号化および復号化します。

    重要

    認証情報の記録

    IAM ユーザーを作成する最後のステップで、次の IAM 認証情報を必ず記録してください。

    • アクセスキー ID

    • シークレット アクセス キー

    これらの認証情報を記録する機会が 1 つあります。 このステップの実行中にこれらの認証情報を記録しない場合は、別のIAMユーザーを作成する必要があります。

  2. 権限の付与

    あなたの IAM ユーザーに、あなたのリモートマスターキーに対するkms:Encrypt と kms:Decrypt の権限を付与します。

    重要

    新しいクライアントIAM ユーザーには、マスター キーの管理権限があってはなりません。データを安全に保つには、最小特権の原則に従います。

    次のインライン ポリシーにより、 IAMユーザーは最小限の特権で CMK を使用して暗号化および復号化を実行できます。

    注意

    リモート マスター キー ARN

    次のポリシーには、このガイドの「 マスター キーの作成 」ステップで生成したキーの ARN が必要です。

    { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": ["kms:Decrypt", "kms:Encrypt"], "Resource": "<the Amazon Resource Name (ARN) of your remote master key>" } ]}

    IAM ユーザーに前述のポリシーを適用するには、 Amazon Web Servicesドキュメントの「 IAM ID 権限の追加 」ガイドに従ってください。

    重要

    本番環境での IAM ロールによる認証

    Queryable Encryption が有効なアプリケーションを本番環境に配置するときは、 IAM ユーザー ではなく IAM ロール を使用してアプリケーションを認証します。

    IAMロールの詳細については、 Amazon Web Servicesの公式ドキュメントの次のページを参照してください。

ドライバーと依存関係をインストールし、CMK を作成したら、Queryable Encryption 対応アプリケーションを作成できます。