Consulta los conectores compatibles con Application Integration.

Tarea Cloud KMS - decrypt

Vista previa

Esta función está sujeta a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

La tarea Cloud KMS - decrypt te permite desencriptar texto cifrado o datos encriptados con una clave de Cloud Key Management Service (Cloud KMS). Para desencriptar los datos encriptados, debes usar la misma clave que usaste durante la encriptación. El texto desencriptado que se muestra desde Cloud KMS está codificado en base64.

Cloud KMS es un servicio de Google Cloud que te permite crear, importar y administrar claves criptográficas y realizar operaciones criptográficas en un único servicio en la nube.

Antes de comenzar

Asegúrate de realizar las siguientes tareas en tu proyecto de Google Cloud antes de configurar la tarea Cloud KMS - decrypt:

1. Habilita la API de Cloud Key Management Service (KMS) (cloudkms.googleapis.com).

   Habilita la API de Cloud Key Management Service (KMS)

2. Crea un perfil de autenticación. Application Integration usa un perfil de autenticación para conectarse a un extremo de autenticación en la tarea Cloud KMS: desencriptar.
   Nota: Si creas un perfil de autenticación de tipo Cuenta de servicio, asegúrate de que la cuenta de servicio tenga asignado el rol de IAM que contiene los siguientes permisos de IAM:

   • cloudkms.cryptoKeyVersions.useToDecrypt

   Para obtener información sobre los permisos de IAM y los roles predefinidos de IAM que los otorgan, consulta la referencia de los permisos de IAM.

   Para obtener información sobre cómo otorgar roles o permisos adicionales a una cuenta de servicio, consulta Cómo otorgar, cambiar y revocar el acceso a los recursos.

Configura la tarea de Cloud KMS - decrypt

1. En la consola de Google Cloud, ve a la página Application Integration.

   Ir a Application Integration

2. En el menú de navegación, haz clic en Integraciones.

   Aparecerá la página Integraciones con una lista de todas las integraciones disponibles en el proyecto de Google Cloud.

3. Selecciona una integración existente o haz clic en Crear integración para crear una nueva.

   Si creas una integración nueva, haz lo siguiente:

   1. Ingresa un nombre y una descripción en el panel Crear integración.
   2. Selecciona una región para la integración.
      Nota: En el menú desplegable Regiones, solo se enumeran las regiones aprovisionadas en el proyecto de Google Cloud. Para aprovisionar una región nueva, haz clic en Habilitar región. Consulta Habilita una región nueva para obtener más información.
   3. Selecciona una cuenta de servicio para la integración. Puedes cambiar o actualizar los detalles de la cuenta de servicio de una integración en cualquier momento desde el panel Resumen de la integración en la barra de herramientas de la integración.
      Nota: La opción para seleccionar una cuenta de servicio solo se muestra si habilitaste la administración de integración para la región seleccionada.
   4. Haz clic en Crear.

   Esto abrirá la integración en la página del editor de integración.

4. En la barra de navegación del editor de integración, haz clic en Tasks para ver la lista de tareas y conectores disponibles.
5. Haz clic y coloca el elemento Cloud KMS - decrypt en el editor de integración.
6. Haz clic en el elemento Cloud KMS - decrypt en el diseñador para ver el panel de configuración de tareas de Cloud KMS - decrypt.
7. Ve a Autenticación y selecciona un perfil de autenticación existente que desees usar.

   Opcional. Si no creaste un perfil de autenticación antes de configurar la tarea, haz clic en + Nuevo perfil de autenticación y sigue los pasos que se mencionan en Crea un perfil de autenticación nuevo.

8. Ve a Entrada de tarea y configura los campos de entrada que se muestran con la siguiente tabla de parámetros de entrada de la tarea.

   Los cambios en los campos de entrada se guardan de forma automática.

Parámetros de entrada de la tarea

En la siguiente tabla, se describen los parámetros de entrada de la tarea Cloud KMS - decrypt:

Propiedad	Tipo de datos	Descripción
Región	String	Ubicación de Cloud KMS para el llavero de claves.
ProjectsId	String	Tu ID del proyecto de Google Cloud.
KeyRingsId	String	El nombre del llavero de claves en el que se ubicará la clave.
CryptoKeysId	String	Nombre de la clave que se usará para la desencriptación.
Solicitud	JSON	Consulta la estructura de solicitud JSON. Especifica el texto encriptado (cifrado) que se desencriptará en el campo ciphertext del cuerpo de la solicitud.

Resultado de la tarea

La tarea Cloud KMS - decrypt muestra una respuesta que contiene los datos desencriptados en un formato con codificación base64. Debes decodificar el valor codificado en base64 para obtener la cadena de resultado.

Sugerencia: Puedes codificar o decodificar datos en Base64 con el comando base64 en Linux o macOS, o el comando Base64.exe en Windows. Los lenguajes de programación y secuencias de comandos suelen incluir bibliotecas para la codificación en base64. Para ver ejemplos de la línea de comandos, consulta Decodifica en base64 en la documentación de Cloud Text-to-Speech.

Estrategia de manejo de errores

Una estrategia de manejo de errores de una tarea específica la acción que se debe realizar si la tarea falla debido a un error temporal. Para obtener información sobre cómo usar una estrategia de manejo de errores y conocer los diferentes tipos de estrategias de manejo de errores, consulta Estrategias de manejo de errores.

¿Qué sigue?

1. Agrega perímetros y condiciones perimetrales.
2. Prueba y publica tu integración.
3. Configura un activador.
4. Agrega una tarea de asignación de datos.
5. Consulta todas las tareas para los servicios de Google Cloud.