サンドボックスに顧客管理の暗号鍵(CMEK)を構成する

所有および管理する Cloud Key Management Service 鍵を使用して、サンドボックスの保存データを暗号化します。

概要

デフォルトでは、 Google Cloud は Google-owned and Google-managed encryption keysを使用して保存データを暗号化します。顧客管理の暗号鍵(CMEK)を使用すると、Cloud KMS 暗号鍵を作成して管理できます。これにより、鍵の使用状況の監査、鍵のローテーション、鍵の無効化または破棄を行って、保護されたデータを読み取り不能にできます。

Gemini Enterprise Agent Platform サンドボックスは、エージェントのコード、ブラウザ、カスタム コンテナを隔離された環境で実行します。この環境は、顧客コンテンツをディスクに書き込み、スナップショットにチェックポイントを設定できます。CMEK は、サンドボックスの親 Gemini Enterprise Agent Platform インスタンスで有効にすると、このスナップショットを保護します。

Gemini Enterprise Agent Platform サンドボックスの CMEK は、Gemini Enterprise Agent Platform インスタンスの作成時にのみ構成できます。CMEK 鍵は、Gemini Enterprise Agent Platform インスタンスとそのサブリソース(サンドボックス環境、テンプレート、スナップショットなど)を保護します。

CMEK がサンドボックス用に暗号化するもの

親の Gemini Enterprise Agent Platform インスタンスで CMEK を有効にすると、サンドボックスの保存データが鍵で暗号化されます。

  • GKE ノードのブートディスク / ルート ファイル システム: セッションがランタイムに書き込むファイルと、ディスクにページングされたメモリ内の状態(ノードのブートディスク CMEK)。
  • スナップショット Cloud Storage バケット: サンドボックスのディスクとメモリのチェックポイント(スナップショット)(バケットのデフォルトの暗号化)。

リソース メタデータ(名前、ラベル、状態、接続情報)、環境変数、サービス アカウントのメールアドレスは、CMEK 鍵で暗号化されません。

カスタム コンテナ イメージを暗号化するには、独自の Artifact Registry リポジトリに CMEK を設定します。

制限事項と考慮事項

  • Gemini Enterprise Agent Platform の CMEK では、シングルリージョン鍵のみがサポートされています。マルチリージョン鍵、デュアルリージョン鍵、グローバル鍵はサポートされていません。
  • この鍵は、Gemini Enterprise Agent Platform インスタンスの作成時に変更できません。別の鍵を使用するには、新しい Gemini Enterprise Agent Platform インスタンスを作成する必要があります。同じ鍵の新しいバージョンへのローテーションはサポートされており、自動的に適用されます。
  • 鍵バージョンを無効化または破棄するか、暗号化 / 復号ロールを取り消すと、サンドボックスのプロビジョニングや再開ができなくなり、スナップショットの書き込みが失敗します。鍵へのアクセスを復元して、サンドボックス リソースを復元します。

始める前に

  • Cloud KMS のキーリングと鍵を用意するか、作成します。ベスト プラクティスとして、鍵は Gemini Enterprise Agent Platform ワークロードとは別のプロジェクトに保管し、別の管理者が管理するようにしてください。
  • 鍵の作成と管理(roles/cloudkms.admin)および Gemini Enterprise Agent Platform インスタンスの作成に必要なロールがあることを確認します。
  • Agent Runtime サービス エージェントをまだ作成していない場合は、作成します。

    # Create the service agent if needed
    gcloud beta services identity create \
        --service=aiplatform.googleapis.com \
        --project=PROJECT_ID
    

Cloud KMS 鍵を作成する

Gemini Enterprise Agent Platform インスタンスと同じリージョンに単一リージョン鍵を作成します。

# Key ring (once per region)
gcloud kms keyrings create sandbox-keyring \
    --location=REGION

# Key
gcloud kms keys create sandbox-key \
    --location=REGION \
    --keyring=sandbox-keyring \
    --purpose=encryption

次のように置き換えます。

  • REGION: Gemini Enterprise Agent Platform インスタンスの Google Cloud リージョン(例: us-central1)。

Agent Platform サービス エージェントに鍵へのアクセス権を付与する

Agent Runtime サービス エージェントに、鍵に対する Cloud KMS CryptoKey 暗号化 / 復号ロール(roles/cloudkms.cryptoKeyEncrypterDecrypter)を付与します。

# Grant Encrypter/Decrypter on the key
gcloud kms keys add-iam-policy-binding sandbox-key \
    --location=REGION \
    --keyring=sandbox-keyring \
    --member="serviceAccount:service-PROJECT_NUMBER@gcp-sa-aiplatform-re.iam.gserviceaccount.com" \
    --role="roles/cloudkms.cryptoKeyEncrypterDecrypter"

次のように置き換えます。

  • PROJECT_NUMBER: Google Cloud プロジェクトの番号。

Agent Platform インスタンスで CMEK を有効にする

Gemini Enterprise Agent Platform インスタンスを作成するときに encryption_spec.kms_key_name を設定します。作成したすべてのサンドボックス テンプレートとサンドボックスは、この鍵を継承します。

Python SDK

import vertexai

client = vertexai.Client(project="PROJECT_ID", location="REGION",
                        http_options={"api_version": "v1beta1"})
agent_instance = client.agent_engines.create(
    config={
        "encryption_spec": {
            "kms_key_name":
                "projects/PROJECT_ID/locations/REGION/keyRings/sandbox-keyring/cryptoKeys/sandbox-key"
        }
    },
)

REST

REST API を使用して、作成時に reasoningEngines.encryptionSpec.kmsKeyName に同じ値を設定します。

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  https://REGION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/REGION/reasoningEngines \
  -d '{
    "display_name": "cmek-protected-engine",
    "encryption_spec": {
      "kms_key_name": "projects/PROJECT_ID/locations/REGION/keyRings/sandbox-keyring/cryptoKeys/sandbox-key"
    }
  }'

サンドボックスを作成して CMEK 構成を確認する

  1. CMEK で保護された Gemini Enterprise Agent Platform インスタンスにサンドボックス テンプレートとサンドボックスを作成します。
  2. インスタンスの詳細を取得して、Gemini Enterprise Agent Platform インスタンスが encryption_spec.kms_key_name で鍵を報告していることを確認します。
  3. 必要に応じて、Cloud KMS 監査ログをチェックして、サンドボックスの起動時とスナップショットの書き込み時に暗号化と復号のオペレーションが行われていることを確認します。

次のステップ