Vom Kunden verwaltete Verschlüsselungsschlüssel (CMEK) für Sandboxes konfigurieren

Ruhende Daten einer Sandbox mit einem Cloud Key Management Service-Schlüssel verschlüsseln, den Sie besitzen und kontrollieren.

Übersicht

Standardmäßig verschlüsselt Google Cloud Ihre inaktiven Daten mit Google-owned and Google-managed encryption keys. Mit kundenverwalteten Verschlüsselungsschlüsseln (CMEK) können Sie einen Cloud KMS-Verschlüsselungsschlüssel erstellen und verwalten, um seine Verwendung zu prüfen, ihn zu rotieren und ihn zu deaktivieren oder zu löschen, damit die geschützten Daten nicht mehr lesbar sind.

In der Sandbox der Gemini Enterprise Agent Platform werden der Code, der Browser oder der benutzerdefinierte Container Ihres KI-Agenten in einer isolierten Umgebung ausgeführt. In dieser Umgebung werden Kundendaten auf das Laufwerk geschrieben und können in Snapshots gespeichert werden, die durch CMEK geschützt werden, wenn Sie es auf der übergeordneten Gemini Enterprise Agent Platform-Instanz der Sandbox aktivieren.

Sie können CMEK für Gemini Enterprise Agent Platform-Sandboxen nur konfigurieren, wenn Sie die Gemini Enterprise Agent Platform-Instanz erstellen. Der CMEK-Schlüssel sichert die Gemini Enterprise Agent Platform-Instanz und ihre Unterressourcen, einschließlich der Sandbox-Umgebungen, Vorlagen und Snapshots.

Was CMEK für die Sandbox verschlüsselt

Wenn Sie CMEK auf der übergeordneten Gemini Enterprise Agent Platform-Instanz aktivieren, werden die inaktiven Oberflächen der Sandbox mit Ihrem Schlüssel verschlüsselt:

  • GKE-Knoten-Bootlaufwerk/Root-Dateisystem: Dateien, die die Sitzung zur Laufzeit schreibt, und der In-Memory-Zustand, der auf das Laufwerk ausgelagert wird (CMEK für Knoten-Bootlaufwerk).
  • Snapshot-Cloud Storage-Bucket: Laufwerk- und Arbeitsspeicherprüfpunkte einer Sandbox (Snapshots) (Standardverschlüsselung des Buckets).

Ressourcenmetadaten (Namen, Labels, Status, Verbindungsinformationen) sowie Umgebungsvariablen und Dienstkonto-E-Mails werden nicht mit dem CMEK-Schlüssel verschlüsselt.

Wenn Sie benutzerdefinierte Container-Images verschlüsseln möchten, legen Sie CMEK für Ihr eigenes Artifact Registry-Repository fest.

Einschränkungen und Überlegungen

  • Für CMEK auf der Gemini Enterprise Agent Platform werden nur Schlüssel für eine einzelne Region unterstützt. Multiregionale, Dual-Region- und globale Schlüssel werden nicht unterstützt.
  • Der Schlüssel ist unveränderlich, wenn Sie die Gemini Enterprise Agent Platform-Instanz erstellen. Wenn Sie einen anderen Schlüssel verwenden möchten, müssen Sie eine neue Gemini Enterprise Agent Platform-Instanz erstellen. Die Rotation zu neuen Versionen desselben Schlüssels wird unterstützt und automatisch angewendet.
  • Wenn Sie die Schlüsselversion deaktivieren oder löschen oder die Rolle „Encrypter/Decrypter“ widerrufen, können keine Sandboxen bereitgestellt oder fortgesetzt werden und Snapshot-Schreibvorgänge schlagen fehl. Stellen Sie den Schlüsselzugriff wieder her, um die Sandbox-Ressourcen wiederherzustellen.

Hinweis

  • Sie benötigen einen Cloud KMS-Schlüsselbund und einen Schlüssel. Als Best Practice sollten Sie Schlüssel in einem separaten Projekt von Ihren Gemini Enterprise Agent Platform-Arbeitslasten aufbewahren, die von einem anderen Administrator verwaltet werden.
  • Prüfen Sie, ob Sie die Rollen zum Erstellen und Verwalten von Schlüsseln (roles/cloudkms.admin) und zum Erstellen der Gemini Enterprise Agent Platform-Instanz haben.

  • Erstellen Sie einen Agent Runtime-Dienst-Agent, falls noch nicht geschehen:

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

Cloud KMS-Schlüssel erstellen

Erstellen Sie einen Schlüssel für eine einzelne Region in derselben Region wie Ihre Gemini Enterprise Agent Platform-Instanz:

# 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

Ersetzen Sie Folgendes:

  • REGION: Die Google Cloud Region Ihrer Gemini Enterprise Agent Platform-Instanz (z. B. us-central1).

Dem Agent Platform-Dienst-Agent Zugriff auf Ihren Schlüssel gewähren

Weisen Sie dem Agent Runtime-Dienst-Agenten die Rolle „Cloud KMS CryptoKey Encrypter/Decrypter“ (roles/cloudkms.cryptoKeyEncrypterDecrypter) für den Schlüssel zu:

# 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"

Ersetzen Sie Folgendes:

  • PROJECT_NUMBER: Ihre Google Cloud -Projektnummer.

CMEK auf der Agent Platform-Instanz aktivieren

Legen Sie encryption_spec.kms_key_name fest, wenn Sie die Gemini Enterprise Agent Platform-Instanz erstellen. Alle Sandbox-Vorlagen und Sandboxen, die Sie darunter erstellen, übernehmen diesen Schlüssel.

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

Legen Sie mit der REST API beim Erstellen denselben Wert für reasoningEngines.encryptionSpec.kmsKeyName fest:

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"
    }
  }'

Sandbox erstellen und CMEK-Konfiguration prüfen

  1. Erstellen Sie Ihre Sandbox-Vorlage und Sandbox unter der CMEK-geschützten Gemini Enterprise Agent Platform-Instanz.
  2. Prüfen Sie, ob die Gemini Enterprise Agent Platform-Instanz Ihren Schlüssel in encryption_spec.kms_key_name meldet, indem Sie die Instanzdetails abrufen.
  3. Optional können Sie die Cloud KMS-Audit-Logs prüfen, um zu bestätigen, dass Verschlüsselungs- und Entschlüsselungsvorgänge beim Starten von Sandboxes und beim Schreiben von Snapshots ausgeführt werden.

Nächste Schritte