エージェント型検索の顧客管理の暗号鍵(CMEK)

エージェント検索(旧称ベクトル検索 2.0)では、Cloud Key Management Service で管理される暗号鍵を使用して、保存データを保護できます。この統合により、コアとなるお客様のコンテンツの暗号化に使用される鍵を制御できます。たとえば、鍵のローテーションや取り消しを行うことができます。

デフォルトでは、データは Google が管理するプラットフォームのデフォルトを使用して暗号化されます。CMEK を使用すると、暗号鍵を直接制御できます。

詳細については、顧客管理の暗号鍵(CMEK)のドキュメントをご覧ください。

前提条件と制約

コレクションで CMEK を使用するには、次の前提条件と制約を満たす必要があります。

  • Cloud KMS 鍵は、保護するコレクションと同じ Google Cloud リージョンに存在する必要があります。たとえば、us-central1 リージョンのコレクションでは、us-central1 にある Cloud KMS 鍵を使用する必要があります。

  • プロジェクトごと、プロダクトごと(P4)のサービス アカウントに、Cloud KMS 鍵に対する cryptoKeyEncrypterDecrypter ロールを付与する必要があります。P4 サービス アカウントの形式は service-${CONSUMER_PROJECT_NUMBER}@gcp-sa-vectorsearch.iam.gserviceaccount.com です。

CMEK で保護されたコレクションを作成する

すべての前提条件を満たしたら、gcloud CLI、REST API、または Python SDK を使用して、CMEK が有効になっている新しいコレクションを作成できます。

gcloud CLI を使用する場合

--kms-key 引数を使用して、Cloud KMS 鍵の完全修飾リソース ID を指定します。

gcloud vector-search collections create [COLLECTION_ID] \
    --kms-key projects/[KMS_PROJECT_ID]/locations/[REGION]/keyRings/[KEY_RING]/cryptoKeys/[KEY]

REST API の使用

POST リクエストの本文に encryption_spec を含めます。

{
  "encryption_spec": {
    "crypto_key_name": "projects/[PROJECT_ID]/locations/[REGION]/keyRings/[KEY_RING]/cryptoKeys/[KEY]"
  }
}

Python SDK の使用

Python SDK の使用:

   
request = vectorsearch_v1beta.CreateCollectionRequest(
    parent=f"projects/{PROJECT_ID}/locations/{LOCATION}",
    collection_id=collection_id,
    collection={
        "data_schema": {...},
        "vector_schema": {...},
        # Specifies the customer-managed encryption key spec for a Collection
        "encryption_spec": {
            "crypto_key_name": f"projects/{PROJECT_ID}/locations/{LOCATION}/keyRings/{KEY_RING}/cryptoKeys/{KEY}"
        }
    },
)

operation = vector_search_service_client.create_collection(request=request)
operation.result()

CMEK 以外のコレクションから CMEK 対応コレクションへのデータ オブジェクトの移行

既存のコレクションで CMEK を有効にすることはできません。代わりに、CMEK が有効になっている新しいコレクションにデータ オブジェクトを移行する必要があります。

手順は次のとおりです。

  1. 既存のコレクションから Cloud Storage バケットにデータ オブジェクトをエクスポートします。

  2. CMEK を有効にして新しいコレクションを作成します。

  3. データ オブジェクトをコレクションにインポートします。

鍵のローテーション

Cloud KMS で鍵がローテーションされると、新しいデータは主キーのバージョンを使用して暗号化されますが、既存のデータは以前のバージョンで暗号化されたままになります。詳細については、鍵のローテーションをご覧ください。

キーの取り消し

鍵を取り消すか無効にすると、コレクションはすぐに無効になります。関連付けられた ANN インデックスは自動的にデプロイ解除され、インメモリ データはパージされます。コレクションに対する読み取り、書き込み、検索オペレーションが失敗します。

鍵が復元されても、コレクションは自動的に再度有効になりません。

CMEK でサポートされるリソース

CMEK の対象となる Gemini Enterprise Agent Platform リソースは次のとおりです。プレビュー機能の CMEK サポートもプレビュー ステータスです。

リソース 暗号化されたマテリアル ドキュメントのリンク
データセット DataItems と Annotations でユーザーがインポートしたすべてのデータ(テキスト コンテンツなど)。

ユーザーが作成したコンテンツ(AnnotationSpecs, ColumnSpecs など)。
分類モデルと回帰モデルのトレーニング用データセットを作成する

予測モデルをトレーニングするためのデータセットを作成する
インデックス Gemini Enterprise Agent Platform のベクトル検索インデックスに使用されるすべてのデータファイルは、Cloud Storage、Pub/Sub、内部ストレージに保存されます。Index と IndexEndpoint は同じキーで作成する必要があります。

コレクション内のすべてのインデックスは、同じキーで作成する必要があります。
ベクトル検索でインデックスを管理する:

ベクトル検索 2 でインデックスを管理する
コレクション コレクションは、関連するデータ オブジェクトを保存するために使用されます。 ベクトル検索 2 でコレクションを管理する
DataObjects コレクションは、データをデータ オブジェクトと呼ばれる個々の JSON オブジェクトとして保存します。 ベクトル検索 2 でデータ オブジェクトを管理する