Encripta los datos en reposo de una zona de pruebas con una clave de Cloud Key Management Service que poseas y controles.
Descripción general
De forma predeterminada, Google Cloud encripta tus datos en reposo con Google-owned and Google-managed encryption keys. Las claves de encriptación administradas por el cliente (CMEK) te permiten crear y administrar una clave de encriptación de Cloud KMS para que puedas auditar su uso, rotarla, inhabilitarla o destruirla para que los datos protegidos sean ilegibles.
La zona de pruebas de Gemini Enterprise Agent Platform ejecuta el código, el navegador o el contenedor personalizado de tu agente en un entorno aislado. Ese entorno escribe el contenido del cliente en el disco y se puede guardar en instantáneas, que las CMEK protegen cuando las habilitas en la instancia superior de Gemini Enterprise Agent Platform de la zona de pruebas.
Solo puedes configurar CMEK para las zonas de pruebas de Gemini Enterprise Agent Platform cuando creas la instancia de Gemini Enterprise Agent Platform. La clave de CMEK protege la instancia de Gemini Enterprise Agent Platform y sus recursos secundarios, incluidos los entornos de zona de pruebas, las plantillas y las instantáneas.
Qué encripta la CMEK para la zona de pruebas
Habilitar CMEK en la instancia superior de Gemini Enterprise Agent Platform encripta las superficies en reposo de la zona de pruebas con tu clave:
- Disco de arranque del nodo de GKE/sistema de archivos raíz: Archivos que la sesión escribe en el entorno de ejecución y el estado en memoria paginado en el disco (CMEK del disco de arranque del nodo).
- Bucket de Cloud Storage de instantáneas: Puntos de control de disco y memoria de una zona de pruebas (instantáneas) (encriptación predeterminada del bucket).
Los metadatos de recursos (nombres, etiquetas, estado, información de conexión), las variables de entorno y los correos electrónicos de las cuentas de servicio no se encriptan con la clave CMEK.
Para encriptar imágenes de contenedor personalizadas, configura CMEK en tu propio repositorio de Artifact Registry.
Limitaciones y consideraciones
- Solo se admiten claves de una sola región para CMEK en Gemini Enterprise Agent Platform. No se admiten las claves multirregionales, birregionales ni globales.
- La clave es inmutable cuando creas la instancia de Gemini Enterprise Agent Platform. Para usar una clave diferente, debes crear una nueva instancia de Gemini Enterprise Agent Platform. La rotación a versiones nuevas de la misma clave se admite y se aplica automáticamente.
- Si inhabilitas o destruyes la versión de la clave, o revocas el rol de encriptador/desencriptador, no se podrán aprovisionar ni reanudar las zonas de pruebas, y fallarán las escrituras de instantáneas. Restablece el acceso a la clave para recuperar los recursos de la zona de pruebas.
Antes de comenzar
- Tener o crear un llavero de claves y una clave de Cloud KMS Como práctica recomendada, mantén las claves en un proyecto separado de tus cargas de trabajo de Gemini Enterprise Agent Platform, administrado por un administrador diferente.
- Confirma que tienes los roles para crear y administrar claves (
roles/cloudkms.admin) y para crear la instancia de Gemini Enterprise Agent Platform. Si aún no lo hiciste, crea un agente de servicio de Agent Runtime:
# Create the service agent if needed gcloud beta services identity create \ --service=aiplatform.googleapis.com \ --project=PROJECT_ID
Crea una clave de Cloud KMS
Crea una clave de una sola región en la misma región que tu instancia de 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
Reemplaza lo siguiente:
REGION: Es la región de Google Cloud tu instancia de Gemini Enterprise Agent Platform (por ejemplo,us-central1).
Otorga al agente de servicio de Agent Platform acceso a tu clave
Otorga al agente de servicio de Agent Runtime el rol de encriptador/desencriptador de CryptoKey de Cloud KMS (roles/cloudkms.cryptoKeyEncrypterDecrypter) en la clave:
# 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"
Reemplaza lo siguiente:
PROJECT_NUMBER: Es el número del proyecto de Google Cloud .
Habilita CMEK en la instancia de Agent Platform
Establece encryption_spec.kms_key_name cuando crees la instancia de Gemini Enterprise Agent Platform. Todas las plantillas de zona de pruebas y las zonas de pruebas que crees en ella heredarán esta clave.
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
Con la API de REST, establece el mismo valor en reasoningEngines.encryptionSpec.kmsKeyName en el momento de la creación:
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"
}
}'
Crea una zona de pruebas y verifica la configuración de CMEK
- Crea tu plantilla de zona de pruebas y la zona de pruebas en la instancia de Gemini Enterprise Agent Platform protegida por CMEK.
- Confirma que la instancia de Gemini Enterprise Agent Platform informe tu clave en
encryption_spec.kms_key_nameobteniendo los detalles de la instancia. - De manera opcional, verifica los registros de auditoría de Cloud KMS para confirmar que las operaciones de encriptación y desencriptación se realicen cuando se inicien las zonas de pruebas y se escriban las instantáneas.
¿Qué sigue?
- Lee CMEK para Gemini Enterprise Agent Platform.
- Consulta Implementa agentes para habilitar CMEK en Agent Runtime.
- Revisa las integraciones de CMEK y la rotación de claves en Cloud KMS.
- Lee la descripción general de la zona de pruebas y Administra instantáneas.