Criptografe os dados em repouso de um sandbox com uma chave do Cloud Key Management Service que você possui e controla.
Visão geral
Por padrão, o Google Cloud criptografa seus dados em repouso com o Google-owned and Google-managed encryption keys. As chaves de criptografia gerenciadas pelo cliente (CMEK) permitem criar e gerenciar uma chave de criptografia do Cloud KMS para auditar o uso, alternar, desativar ou destruir a chave para tornar os dados protegidos ilegíveis.
O sandbox da Gemini Enterprise Agent Platform executa o código, o navegador ou o contêiner personalizado do agente em um ambiente isolado. Esse ambiente grava o conteúdo do cliente no disco e pode ser salvo em snapshots, que são protegidos pela CMEK quando você a ativa na instância pai da Gemini Enterprise Agent Platform do sandbox.
Só é possível configurar CMEK para sandboxes da Gemini Enterprise Agent Platform ao criar a instância da plataforma. A chave CMEK protege a instância da Gemini Enterprise Agent Platform e os sub-recursos dela, incluindo os ambientes de sandbox, os modelos e os snapshots.
O que a CMEK criptografa para o sandbox
Ativar a CMEK na instância pai da Gemini Enterprise Agent Platform criptografa as superfícies em repouso do sandbox com sua chave:
- Disco de inicialização do nó do GKE / sistema de arquivos raiz: arquivos que a sessão grava no ambiente de execução e no estado na memória paginado no disco (CMEK do disco de inicialização do nó).
- Bucket do Cloud Storage de snapshot: checkpoints de disco e memória de um sandbox (snapshots) (criptografia padrão do bucket).
Os metadados de recursos (nomes, rótulos, estado, informações de conexão), as variáveis de ambiente e os e-mails de contas de serviço não são criptografados com a chave CMEK.
Para criptografar imagens de contêiner personalizadas, defina a CMEK no seu próprio repositório do Artifact Registry.
Limitações e considerações
- Somente chaves de região única são compatíveis com CMEK na Gemini Enterprise Agent Platform. Não há suporte para chaves multirregionais, birregionais e globais.
- A chave é imutável quando você cria a instância da Gemini Enterprise Agent Platform. Para usar uma chave diferente, crie uma nova instância da Gemini Enterprise Agent Platform. A rotação para novas versões da mesma chave é aceita e aplicada automaticamente.
- Se você desativar ou destruir a versão da chave ou revogar o papel de criptografador/descriptografador, os sandboxes não poderão ser provisionados ou retomados, e as gravações de snapshot vão falhar. Restaure o acesso à chave para recuperar os recursos do sandbox.
Antes de começar
- Ter ou criar um keyring e uma chave do Cloud KMS. Como prática recomendada, mantenha as chaves em um projeto separado das cargas de trabalho da Gemini Enterprise Agent Platform, gerenciado por um administrador diferente.
- Confirme se você tem os papéis para criar e gerenciar chaves (
roles/cloudkms.admin) e para criar a instância da Gemini Enterprise Agent Platform. Crie um agente de serviço do Agent Runtime, se ainda não tiver feito isso:
# Create the service agent if needed gcloud beta services identity create \ --service=aiplatform.googleapis.com \ --project=PROJECT_ID
Criar uma chave do Cloud KMS
Crie uma chave de região única na mesma região da sua instância da 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
Substitua:
REGION: a região do Google Cloud da sua instância da Gemini Enterprise Agent Platform (por exemplo,us-central1).
Conceder ao agente de serviço da plataforma de agentes acesso à sua chave
Conceda ao agente de serviço do Agent Runtime o papel de criptografador/descriptografador de CryptoKey do Cloud KMS (roles/cloudkms.cryptoKeyEncrypterDecrypter) na chave:
# 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"
Substitua:
PROJECT_NUMBER: o número do projeto do Google Cloud .
Ativar a CMEK na instância da Agent Platform
Defina encryption_spec.kms_key_name ao criar a instância da Gemini Enterprise Agent Platform. Todos os modelos de sandbox e sandboxes criados nela herdam essa chave.
SDK do Python
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
Usando a API REST, defina o mesmo valor em reasoningEngines.encryptionSpec.kmsKeyName na criação:
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"
}
}'
Criar um sandbox e verificar a configuração da CMEK
- Crie o modelo de sandbox e o sandbox na instância da Gemini Enterprise Agent Platform protegida por CMEK.
- Confirme se a instância da Gemini Enterprise Agent Platform informa sua chave em
encryption_spec.kms_key_namerecebendo os detalhes da instância. - Se quiser, verifique os registros de auditoria do Cloud KMS para confirmar se as operações de criptografia e descriptografia ocorrem conforme os sandboxes são iniciados e os snapshots são gravados.
A seguir
- Leia CMEK para a plataforma de agentes do Gemini Enterprise.
- Consulte Implantar agentes para ativar a CMEK no Agent Runtime.
- Revise as integrações de CMEK e a rotação de chaves no Cloud KMS.
- Leia a Visão geral do Sandbox e Gerenciar snapshots.