Configurar chaves de criptografia gerenciadas pelo cliente (CMEK) para sandboxes

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

  1. Crie o modelo de sandbox e o sandbox na instância da Gemini Enterprise Agent Platform protegida por CMEK.
  2. Confirme se a instância da Gemini Enterprise Agent Platform informa sua chave em encryption_spec.kms_key_name recebendo os detalhes da instância.
  3. 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