Usar claves de encriptación administradas por el cliente

De forma predeterminada, Cloud Scheduler encripta el contenido del cliente almacenado en reposo. Cloud Scheduler controla la encriptación por ti sin que debas realizar ninguna acción adicional. Esta opción se denomina encriptación predeterminada de Google.

Si deseas controlar tus claves de encriptación, puedes usar las claves de encriptación administradas por el cliente (CMEK) en Cloud KMS con servicios integrados en CMEK, incluido Cloud Scheduler. El uso de claves de Cloud KMS te permite controlar su nivel de protección, ubicación, programa de rotación, permisos de uso y acceso, y límites criptográficos. El uso de Cloud KMS también te permite ver los registros de auditoría y controlar los ciclos de vida de las claves. En lugar de que Google posea y administre las claves de encriptación de claves (KEK) simétricas que protegen tus datos, tú las controlas y administras en Cloud KMS.

Después de configurar tus recursos con CMEK, la experiencia de acceso a tus recursos de Cloud Scheduler es similar a usar la encriptación predeterminada de Google. Para obtener más información sobre tus opciones de encriptación, consulta Claves de encriptación administradas por el cliente (CMEK).

Qué se protege con CMEK

Puedes especificar una clave de Cloud KMS por proyecto de Google Cloud y por región de Cloud Scheduler compatible. Esta clave se usa para proteger los siguientes datos en ese proyecto y región:

  • Trabajos con un destino de extremo HTTP o HTTPS: el cuerpo de la solicitud HTTP y los encabezados del cliente.
  • Trabajos con un destino de tema de Pub/Sub: la carga útil y los atributos del mensaje de Pub/Sub.

Antes de comenzar

Antes de usar CMEK en Cloud Scheduler, completa los siguientes pasos de requisitos previos.

  1. Configura el entorno.

  2. Actualiza los componentes de gcloud:

    gcloud components update

  3. Accede con tu cuenta.

    gcloud auth login

  4. Habilita la API de Cloud KMS para el proyecto que almacena tus claves de encriptación:

    gcloud services enable cloudkms.googleapis.com \
        --project=KMS_PROJECT_ID

    Reemplaza KMS_PROJECT_ID por el ID del proyecto que almacena tus claves de Cloud KMS. Este puede ser el mismo proyecto que tus trabajos de Cloud Scheduler o uno independiente.

  5. Cloud KMS produce registros de auditoría de Cloud cuando los recursos de Cloud Scheduler habilitan, inhabilitan o usan las claves para encriptar y desencriptar datos.

    Asegúrate de que el registro esté habilitado para la API de Cloud KMS en tu proyecto y de que hayas decidido qué permisos y roles específicos de registro se aplican a tu caso de uso. Para obtener más información, consulta Registros de auditoría de Cloud KMS.

Roles obligatorios

Para obtener los permisos que necesitas para configurar CMEK para Cloud Scheduler, pídele a tu administrador que te otorgue los siguientes roles de IAM:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Estos roles predefinidos contienen los permisos necesarios para configurar CMEK para Cloud Scheduler. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para configurar CMEK para Cloud Scheduler:

  • Otorga al agente de servicio acceso a la clave: cloudkms.cryptoKeys.setIamPolicy en la clave, el llavero de claves o el proyecto que contiene la clave de Cloud KMS
  • Habilita o inhabilita CMEK: cloudscheduler.cmekConfig.update en el proyecto de Cloud Scheduler
  • Consulta el estado operativo o la configuración de CMEK:
    • cloudscheduler.cmekConfig.get en el proyecto de Cloud Scheduler
    • cloudscheduler.operations.get en el proyecto de Cloud Scheduler

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Crea un llavero de claves y una clave de Cloud KMS globales

Puedes crear un llavero de claves nuevo o usar uno existente. Dentro del llavero de claves, puedes agregar una clave nueva o usar una existente. Te recomendamos que uses claves diferentes para aplicaciones, servicios o entornos distintos.

  1. Crea un llavero de claves.

  2. Crea una clave. La clave debe usar el algoritmo de encriptación simétrica.

Otorga al agente de servicio de Cloud Scheduler acceso a la clave

Debes otorgar al agente de servicio de Cloud Scheduler el rol de Identity and Access Management (IAM) de encriptador/desencriptador de CryptoKey de Cloud KMS para que pueda acceder a la clave de Cloud KMS. Si habilitaste la API de Cloud Scheduler recientemente en un proyecto y aún no creaste ningún trabajo, es posible que primero debas crear el agente de servicio ejecutando gcloud beta services identity create --service=cloudscheduler.googleapis.com --project=PROJECT_ID.

gcloud kms keys add-iam-policy-binding KEY_NAME \
    --keyring=KEY_RING \
    --location=LOCATION \
    --project=KMS_PROJECT_ID \
    --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-cloudscheduler.iam.gserviceaccount.com \
    --role=roles/cloudkms.cryptoKeyEncrypterDecrypter

Reemplaza lo siguiente:

  • KEY_NAME: Es el nombre de la clave, por ejemplo, my-key.
  • KEY_RING: Es el nombre del llavero de claves, por ejemplo, my-keyring.
  • LOCATION: la ubicación de la clave, por ejemplo, us-central1.
  • KMS_PROJECT_ID: Es el ID del proyecto en el que se encuentra la clave de Cloud KMS.
  • PROJECT_NUMBER: Es el número de tu proyecto de Cloud Scheduler Google Cloud . Para encontrar el número del proyecto, ve a la página de bienvenida de la consola de Google Cloud o ejecuta el siguiente comando:

    export PROJECT=$(gcloud info --format='value(config.project)')
    gcloud projects describe ${PROJECT} --format="value(projectNumber)"

Siempre que el agente de servicio tenga el rol roles/cloudkms.cryptoKeyEncrypterDecrypter, un trabajo en tu proyecto puede encriptar y desencriptar sus datos con la clave de CMEK. Si revocas este rol, o si inhabilitas o destruyes la clave de CMEK, no se podrá acceder a esos datos. En este documento, consulta Quita Cloud KMS.

Habilita CMEK para una región de Cloud Scheduler

Especifica la clave de Cloud KMS que se usará para la encriptación de datos en una región de Cloud Scheduler con el comando gcloud scheduler cmek-config update:

gcloud scheduler cmek-config update \
    --location=LOCATION \
    --kms-key-name=KEY_NAME \
    --kms-keyring=KEY_RING \
    --kms-project=KMS_PROJECT_ID

Reemplaza lo siguiente:

  • LOCATION: Es una región de Cloud Scheduler compatible.
  • KEY_NAME: Es el nombre de la clave, por ejemplo, my-key.
  • KEY_RING: Es el nombre del llavero de claves, por ejemplo, my-keyring.
  • KMS_PROJECT_ID: Es el ID del proyecto en el que se encuentra la clave de Cloud KMS que quieres usar.

Ten en cuenta lo siguiente:

  • La habilitación, el cambio o la inhabilitación de una clave de CMEK en Cloud Scheduler se ejecuta de forma asíncrona y devuelve una operación de larga duración (projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID). Puedes verificar si la actualización finalizó ejecutando el comando gcloud scheduler operations describe.
  • Cloud Scheduler encripta los trabajos nuevos y actualizados en el proyecto y la región protegidos con la clave habilitada. Los trabajos existentes que se encriptaron con una clave anterior se vuelven a encriptar con la clave nueva.
  • Se encriptan los trabajos existentes sin protección.
  • Rotar una clave en Cloud KMS no vuelve a encriptar de forma automática los trabajos existentes ni cambia los trabajos nuevos de la región a la nueva versión de la clave primaria. Para obtener más información, consulta Rotación de claves de CMEK.
  • Si inhabilitas las CMEK para una región, los trabajos existentes se encriptarán con la encriptación predeterminada de Google y los trabajos posteriores se crearán sin encriptación de CMEK. En este documento, consulta Inhabilita CMEK para una región de Cloud Scheduler.

Verifica la configuración de Cloud KMS

Verifica que la CMEK esté habilitada. Para ello, recupera la configuración de CMEK de una región de Cloud Scheduler con el comando gcloud scheduler cmek-config describe:

gcloud scheduler cmek-config describe \
    --location=LOCATION

El resultado es similar a lo siguiente:

kmsKeyName: projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY_NAME
name: projects/PROJECT_ID/locations/LOCATION/cmekConfig

El valor kmsKeyName es el ID de recurso de la clave de Cloud KMS que se usa para proteger los trabajos en la región.

Inhabilita las CMEK para una región de Cloud Scheduler

Puedes inhabilitar la CMEK para una región de Cloud Scheduler, de modo que los trabajos que se creen en esa región se creen sin la encriptación de CMEK.

gcloud scheduler cmek-config update \
    --location=LOCATION \
    --clear-kms-key

Esto inhabilita las CMEK para la región específica y los trabajos posteriores se crean sin encriptación de CMEK. Los trabajos existentes se encriptan con la encriptación predeterminada de Google.

Quita Cloud KMS

Si quieres revocar el acceso a los datos de tus trabajos, puedes quitar Cloud KMS de una de las siguientes maneras:

  • Inhabilita o destruye la versión de clave adecuada de tu clave de encriptación administrada por el cliente. Puedes verificar si una versión de clave está en uso. Inhabilitar una versión de clave de CMEK suspende el acceso a todos los datos protegidos por esa versión de clave hasta que se vuelva a habilitar. La destrucción de una versión de clave bloquea el acceso de forma permanente y puede provocar una pérdida de datos irrecuperable. Ambas afectan solo a los trabajos que están asociados con la versión de clave específica.

    No puedes ver los recursos protegidos por la versión de clave inhabilitada o destruida. Cualquier ejecución de trabajo activa falla con un mensaje de error correspondiente.

  • Revoca el rol de IAM roles/cloudkms.cryptoKeyEncrypterDecrypter del agente de servicio de Cloud Scheduler. Esto afecta a todos los trabajos del proyecto y la región deGoogle Cloud específicos que admiten la encriptación con CMEK. No puedes crear trabajos nuevos integrados en CMEK ni ver o enumerar trabajos encriptados con CMEK (aunque puedes borrarlos). Las ejecuciones de trabajos activos fallan con un mensaje de error correspondiente.

Aunque ninguna de estas operaciones garantiza la revocación de acceso instantánea, los cambios en la IAM suelen aplicarse más rápido. Para obtener más información, consulta Coherencia de recursos de Cloud KMS y Propagación del cambio de acceso.

Acerca de las restricciones de las políticas de la organización de CMEK

Cloud Scheduler admite las siguientes restricciones de la política de la organización, que pueden ayudarte a aplicar el uso de CMEK en una organización:

  • constraints/gcp.restrictNonCmekServices: Usa esta restricción para exigir que se usen CMEK para proteger todos los recursos nuevos de Cloud Scheduler en una organización, carpeta o proyecto.

    Si está activa, esta política de la organización impide crear o actualizar recursos, a menos que primero habilites una clave de Cloud KMS. Tampoco puedes inhabilitar las CMEK para una región de Cloud Scheduler.

  • constraints/gcp.restrictCmekCryptoKeyProjects: Usa esta restricción para asegurarte de que tus recursos de Cloud Scheduler protegidos con CMEK usen una clave de un proyecto aprobado.

    Por ejemplo, puedes especificar una regla similar a la siguiente: "Para todos los recursos de Cloud Scheduler en projects/my-company-data-project, la clave de Cloud KMS que se usa en este proyecto debe provenir de projects/my-company-central-keys O projects/team-specific-keys".

Ten en cuenta lo siguiente:

  • Después de aplicar una política de la organización de CMEK, puedes acceder a los trabajos existentes que usan la encriptación predeterminada de Google. Sin embargo, no puedes actualizarlos, a menos que primero configures una clave de Cloud KMS aceptable para la región de Cloud Scheduler.

  • Los trabajos que se orientan a una aplicación de App Engine no están sujetos a las políticas de la organización de CMEK. Por ejemplo, si estableces la restricción constraints/gcp.restrictNonCmekServices, puedes crear o actualizar un trabajo que se oriente a una aplicación de App Engine.

Para obtener más información sobre cómo configurar las políticas de la organización, consulta Políticas de la organización de CMEK.

Soluciona problemas

Es posible que encuentres errores cuando uses Cloud KMS con Cloud Scheduler. En la siguiente tabla, se describen los diferentes problemas y cómo resolverlos.

Problema Descripción
Se rechazó el permiso cloudkms.cryptoKeyVersions.useToEncrypt

Es posible que la clave de Cloud KMS proporcionada no exista o que el permiso no esté configurado de forma correcta.

Solución:

La versión de clave no está habilitada

Se inhabilitó la versión de la clave de Cloud KMS proporcionada.

Solución: Vuelve a habilitar la versión de la clave de Cloud KMS.

La región del llavero de claves no coincide con el recurso que se protegerá

La región del llavero de claves de Cloud KMS proporcionada es diferente de la región de Cloud Scheduler protegida.

Solución: Usa un llavero de claves de Cloud KMS de la misma región que la región de Cloud Scheduler. El llavero de claves puede estar en un proyecto diferente. Para obtener más información, consulta las ubicaciones de Cloud KMS y las ubicaciones de Cloud Scheduler.

El proyecto no es compatible con CMEK en Cloud Scheduler

La habilitación de CMEK falla con un error FAILED_PRECONDITION con el mensaje: Your project is currently not compatible with CMEK in Cloud Scheduler. Este error se produce cuando los trabajos de Cloud Scheduler existentes en tu proyecto no se migraron para admitir CMEK. Por ejemplo, la falta de permisos de agente de servicio o los trabajos heredados con nombres de temas de Pub/Sub no válidos pueden impedir la migración.

Solución:

  1. Revisa y corrige cualquier problema de permisos o configuración de trabajos en tu proyecto:
  2. Después de resolver cualquier problema de permisos o configuración de trabajos, abre una solicitud de asistencia en la consola de Google Cloud para completar la migración y poder habilitar las CMEK en tu proyecto. Corregir los permisos o las configuraciones de los trabajos por sí solo no borra el error hasta que se completa la migración.

Registros de auditoría

Cloud KMS produce registros de auditoría cuando los recursos de Cloud Scheduler habilitan, inhabilitan o usan las claves para encriptar y desencriptar mensajes. Para obtener más información, consulta Registros de auditoría de Cloud KMS.

Errores de Cloud EKM

Para resolver problemas que puedas encontrar cuando uses claves administradas de forma externa a través de Cloud External Key Manager (Cloud EKM), consulta la referencia de errores de Cloud EKM.

Estado de clave no disponible

Si, por algún motivo, Cloud KMS no está disponible, es posible que Cloud Scheduler no pueda recuperar el estado de tu clave de Cloud KMS.

Si Cloud KMS no está disponible cuando se programa la ejecución de un trabajo, Cloud Scheduler no puede desencriptar los datos del trabajo ni invocar su destino. En el caso de los errores transitorios de Cloud KMS (como UNAVAILABLE, RESOURCE_EXHAUSTED o una clave de Cloud EKM inaccesible), Cloud Scheduler reintenta la desencriptación de forma interna con una retirada exponencial y registra las entradas de registro CmekRetryFailure en Cloud Logging en cloudscheduler.googleapis.com/cmek. En el caso de los errores que no se pueden reintentar, como un error de permiso o una clave inhabilitada o destruida, la desencriptación falla de inmediato sin invocar el destino.

Cuotas de Cloud KMS

Cuando usas CMEK en Cloud Scheduler, tus proyectos pueden consumir cuotas de solicitudes criptográficas de Cloud KMS. Por ejemplo, Cloud Scheduler puede consumir estas cuotas cuando ejecuta trabajos, controla solicitudes de administración de trabajos o actualiza la configuración de CMEK. Cloud Scheduler reutiliza una clave intermediaria almacenada en caché durante un máximo de cinco minutos por proyecto y región, por lo que las ejecuciones frecuentes de trabajos no consumen cuota. Las operaciones de encriptación y desencriptación con claves CMEK afectan las cuotas de Cloud KMS solo si usas claves de hardware (Cloud HSM) o externas (Cloud EKM). Para obtener más información, consulta Cuotas de Cloud KMS.

Precios

Esta integración no genera costos adicionales más allá de las operaciones de clave de Cloud KMS, que se facturan en tu proyecto de Google Cloud .

Los recursos de entrega subyacentes que usan tu clave a través de otorgamientos de claves pueden realizar operaciones adicionales de Cloud KMS. Para ayudar a estimar el uso de Cloud KMS en las operaciones directas de Cloud Scheduler, se esperan las siguientes tasas de operaciones criptográficas por proyecto y región:

  • Ejecuciones de trabajos: Cloud Scheduler reutiliza una clave intermediaria almacenada en caché durante un máximo de cinco minutos por proyecto y región. Los proyectos con menos de una ejecución de trabajo cada cinco minutos realizan aproximadamente una operación de desencriptación de Cloud KMS por ejecución. Los proyectos con ejecuciones más frecuentes realizan aproximadamente una operación de desencriptación cada cinco minutos en toda la región.
  • Operaciones de administración de trabajos: Las solicitudes para crear, actualizar, obtener, enumerar, pausar o reanudar trabajos con datos protegidos usan una clave intermediaria almacenada en caché independiente durante un máximo de cinco minutos por proyecto y región.
  • Actualizaciones de la configuración de CMEK: Habilitar o cambiar una clave de CMEK con cmek-config realiza operaciones adicionales de claves de Cloud KMS para validar la clave y volver a encriptar los trabajos protegidos existentes en la región. Inhabilitar CMEK desencripta los trabajos protegidos existentes y los devuelve a la encriptación predeterminada de Google.

Para obtener información sobre los precios, consulta Precios de Cloud KMS.