Utilidades de imagen

Conjunto de acciones de utilidad para ayudar a analizar, extraer y convertir contenido de imágenes y archivos durante las investigaciones. Entre sus funciones clave se incluyen el reconocimiento óptico de caracteres (OCR) para extraer texto, la rasterización (conversión de contenido web en imágenes estáticas) y la conversión de formatos de archivo. Todas las acciones requieren un agente remoto.

Acciones

Para obtener más información sobre las acciones, consulta Responder a acciones pendientes desde Tu espacio de trabajo y Realizar una acción manual.

Convertir archivo

Usa la acción Convertir archivo para cambiar el formato de un archivo específico.

Importante: Esta acción requiere un agente remoto para funcionar correctamente.

Entradas de acciones

La acción Convert File requiere los siguientes parámetros:

Parámetro	Descripción
Input File Format	Obligatorio. El formato original del archivo que convierte la acción. Estos son los valores posibles: PNG PDF El valor predeterminado es PNG.
Input File Path	Obligatorio. Ruta al archivo que convierte la acción.
Output File Format	Obligatorio. El formato del archivo después del proceso de conversión. Estos son los valores posibles: PNG PDF El valor predeterminado es PDF.

Resultados de la acción

La acción Convertir archivo proporciona los siguientes resultados:

Tipo de salida de la acción	Disponibilidad
Adjunto del panel de casos	No disponible
Enlace del panel de casos	No disponible
Tabla del panel de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	Disponible
Mensajes de salida	Disponible
Resultado de la secuencia de comandos	Disponible

Resultado de JSON

En el siguiente ejemplo se muestran los resultados JSON recibidos al usar la acción Convert File (Convertir archivo):

[
   {
       "output_format": ""  
       "file_path": ""
   }
]

Mensajes de salida

La acción Convertir archivo puede devolver los siguientes mensajes de salida:

Mensaje resultante	Descripción del mensaje
Successfully converted file.	La acción se ha realizado correctamente.
Error executing action "Convert File". Reason: ERROR_REASON	No se ha podido realizar la acción. Comprueba la conexión al servidor, los parámetros de entrada o las credenciales.

Resultado de la secuencia de comandos

En la siguiente tabla se indica el valor de la salida del resultado de la secuencia de comandos al usar la acción Convertir archivo:

Nombre del resultado del script	Valor
is_success	true o false

Imagen OCR

Usa la acción Imagen OCR para aplicar OCR y extraer texto de un archivo de imagen.

Importante: Para que esta acción funcione correctamente, es necesario que un agente remoto tenga instalado el paquete tesseract-ocr.

Entradas de acciones

La acción Imagen de OCR requiere los siguientes parámetros:

Parámetro	Descripción
Base64 Encoded Image	Opcional. Cadena codificada en Base64 del archivo de imagen.
File Path	Obligatorio. Ruta al archivo de imagen. Nota: Si se proporcionan tanto Base64 Encoded Image como File Path, se procesará Base64 Encoded Image.

Resultados de la acción

La acción Imagen OCR proporciona los siguientes resultados:

Tipo de salida de la acción	Disponibilidad
Adjunto del panel de casos	No disponible
Enlace del panel de casos	No disponible
Tabla del panel de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	Disponible
Mensajes de salida	Disponible
Resultado de la secuencia de comandos	Disponible

Resultado de JSON

En el siguiente ejemplo se muestran los resultados en JSON que se obtienen al usar la acción OCR Image (OCR de imagen):

{ 
  "extracted_text": "",
}

Mensajes de salida

La acción Imagen OCR puede devolver los siguientes mensajes de salida:

Mensaje resultante	Descripción del mensaje
Successfully performed OCR on the provided image.	La acción se ha realizado correctamente.
Error executing action "OCR Image". Reason: ERROR_REASON	No se ha podido realizar la acción. Comprueba la conexión al servidor, los parámetros de entrada o las credenciales.

Resultado de la secuencia de comandos

En la siguiente tabla se muestra el valor de la salida del resultado de la secuencia de comandos al usar la acción Imagen OCR:

Nombre del resultado del script	Valor
is_success	true o false

Rasterizar contenido

Usa la acción Rasterizar contenido para convertir contenido vectorial o complejo en un formato de imagen de mapa de bits fijo.

Importante: Para llevar a cabo esta acción, necesitas un agente remoto con el paquete playwright instalado para que funcione correctamente.

Requisitos previos de los agentes remotos (Debian)

Para que la acción Rasterizar contenido se ejecute correctamente en un agente remoto basado en Debian, debes instalar los siguientes paquetes y dependencias:

Biblioteca de Python de Playwright

Instala la biblioteca de Python de Playwright con el siguiente comando:

python3.11 -m pip install playwright

Dependencias del navegador

Instala las dependencias necesarias del navegador Chromium para que Playwright funcione correctamente:

playwright install --with-deps chromium

Entradas de acciones

Parámetro	Descripción
Input Type	Obligatorio. El tipo de contenido que usa la acción como entrada principal. Estos son los valores posibles: URL Email HTML El valor predeterminado es URL.
URLs or Body	Obligatorio. El contenido de entrada que se va a rasterizar, en función del Input Type seleccionado. Si se selecciona URL, proporcione una lista de URLs separadas por comas. Si se selecciona Email o HTML, proporciona el cuerpo de contenido completo de ese tipo de entrada.
Output Type	Opcional. El formato de salida resultante del contenido rasterizado. Estos son los valores posibles: PNG PDF Both El valor predeterminado es PNG.
Export Method	Opcional. El método utilizado para generar el contenido. Estos son los valores posibles: Case Attachment File Path Both El valor predeterminado es Case Attachment.
Width	Obligatorio. Anchura (en píxeles) que se usa para el contenido rasterizado generado. El valor predeterminado es 1920.
Height	Obligatorio. Altura (en píxeles) que se ha usado para el contenido rasterizado generado. El valor predeterminado es 1080.
Full Screen	Opcional. Si se selecciona esta opción, el contenido se renderiza en toda la ventana del navegador antes de rasterizarse. Esta opción está inhabilitada de forma predeterminada.
Timeout	Opcional. Tiempo máximo (en segundos) que el navegador dedica a renderizar el contenido antes de que empiece la rasterización. El valor máximo es 60. El valor predeterminado es 120.
Wait For	Opcional. El estado específico que debe alcanzar el navegador antes de que la acción continúe con la rasterización o la extracción de contenido. El estado NETWORK_IDLE suele ser el más fiable. Estos son los valores posibles: LOAD DOM_CONTENT_LOADED NETWORK_IDLE COMMIT El valor predeterminado es NETWORK_IDLE.
Wait for Selector	Opcional. Un selector de CSS que espera a que aparezca en la página antes de hacer la captura de pantalla. Nota: Este ajuste es muy recomendable para las páginas en las que el contenido se carga de forma dinámica, ya que confirma que todos los elementos están presentes antes de que se ejecute la acción.

Resultados de la acción

La acción Rasterizar contenido proporciona los siguientes resultados:

Tipo de salida de la acción	Disponibilidad
Adjunto del panel de casos	No disponible
Enlace del panel de casos	No disponible
Tabla del panel de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	Disponible
Mensajes de salida	Disponible
Resultado de la secuencia de comandos	Disponible

Resultado de JSON

En el siguiente ejemplo se muestran los resultados JSON que se reciben al usar la acción Rasterize Content (Rasterizar contenido):

[
   {
       "attachment_name": "",
       "file_path": ""
   }
]

Mensajes de salida

La acción Rasterizar contenido puede devolver los siguientes mensajes de salida:

Mensaje resultante	Descripción del mensaje
Successfully rasterized content based on the provided input. Successfully rasterized content based on the following URLs: URLS Action wasn't able to rasterize content for the following URLs: URLS Action wasn't able to rasterize content for the provided URLs.	La acción se ha realizado correctamente.
Error executing action "Rasterize Content". Reason: ERROR_REASON	No se ha podido realizar la acción. Comprueba la conexión al servidor, los parámetros de entrada o las credenciales.

Resultado de la secuencia de comandos

En la siguiente tabla se muestra el valor de la salida del resultado de la secuencia de comandos al usar la acción Rasterize Content (Rasterizar contenido):

Nombre del resultado del script	Valor
is_success	true o false

¿Necesitas más ayuda? Recibe respuestas de los miembros de la comunidad y de los profesionales de Google SecOps.