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.
Actualiza los componentes de
gcloud:gcloud components update
Accede con tu cuenta.
gcloud auth login
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_IDpor 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.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:
-
Otorga al agente de servicio acceso a la clave:
Administrador de Cloud KMS (
roles/cloudkms.admin) en la clave, el llavero de claves o el proyecto que contiene la clave de Cloud KMS -
Habilita o inhabilita CMEK:
Administrador de Cloud Scheduler (
roles/cloudscheduler.admin) en el proyecto de Cloud Scheduler -
Consulta el estado de la configuración o el estado operativo de CMEK:
- Visualizador de Cloud Scheduler (
roles/cloudscheduler.viewer) en el proyecto de Cloud Scheduler - Administrador de Cloud Scheduler (
roles/cloudscheduler.admin) en el proyecto de Cloud Scheduler
- Visualizador de Cloud Scheduler (
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.setIamPolicyen la clave, el llavero de claves o el proyecto que contiene la clave de Cloud KMS -
Habilita o inhabilita CMEK:
cloudscheduler.cmekConfig.updateen el proyecto de Cloud Scheduler -
Consulta el estado operativo o la configuración de CMEK:
-
cloudscheduler.cmekConfig.geten el proyecto de Cloud Scheduler -
cloudscheduler.operations.geten 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.
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 comandogcloud 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.cryptoKeyEncrypterDecrypterdel 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 deprojects/my-company-central-keysOprojects/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 Solució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-configrealiza 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.