Utilidades de imágenes

Es un conjunto de acciones de utilidad para ayudar a analizar, extraer y convertir el contenido de imágenes y archivos durante las investigaciones. Las funciones clave incluyen el reconocimiento óptico de caracteres (OCR) para la extracción de 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 Cómo responder a las acciones pendientes desde Tu escritorio y Cómo realizar una acción manual.

Convertir archivo

Usa la acción Convert File para cambiar el formato de un archivo especificado.

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

Entradas de acción

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

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

Resultados de la acción

La acción Convert File proporciona los siguientes resultados:

Tipo de salida de la acción	Disponibilidad
Adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	Disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Resultado de JSON

En el siguiente ejemplo, se muestran los resultados JSON que se reciben cuando se usa la acción Convert File:

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

Mensajes de salida

La acción Convert File puede devolver los siguientes mensajes de salida:

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

Resultado de secuencia de comandos

En la siguiente tabla, se indica el valor del resultado de la secuencia de comandos cuando se usa la acción Convert File:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Imagen de OCR

Usa la acción OCR Image para realizar el OCR y extraer texto de un archivo de imagen.

Importante: Esta acción requiere un agente remoto con el paquete tesseract-ocr instalado para funcionar correctamente.

Entradas de acción

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

Parámetro	Descripción
Base64 Encoded Image	Es opcional. Es la cadena codificada en base64 del archivo de imagen.
File Path	Obligatorio. Es la ruta de acceso al archivo de imagen. Nota: Si se proporcionan Base64 Encoded Image y File Path, se procesa Base64 Encoded Image.

Resultados de la acción

La acción OCR Image proporciona los siguientes resultados:

Tipo de salida de la acción	Disponibilidad
Adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	Disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Resultado de JSON

En el siguiente ejemplo, se muestran los resultados JSON que se reciben cuando se usa la acción OCR Image:

{ 
  "extracted_text": "",
}

Mensajes de salida

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

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

Resultado de secuencia de comandos

En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción OCR Image:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Rasterizar contenido

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

Importante: Esta acción requiere un agente remoto con el paquete playwright instalado para funcionar correctamente.

Requisitos previos del agente remoto (Debian)

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

Biblioteca de Playwright para Python

Instala la biblioteca de Playwright para Python 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 acción

Parámetro	Descripción
Input Type	Obligatorio. Es el tipo de contenido que la acción usa como entrada principal. Los valores posibles son los siguientes: URL Email HTML El valor predeterminado es URL.
URLs or Body	Obligatorio. Es el contenido de entrada que se rasterizará, según el Input Type seleccionado. Si se selecciona URL, proporciona una lista de URLs separadas por comas. Si se selecciona Email o HTML, proporciona el cuerpo completo del contenido de ese tipo de entrada.
Output Type	Es opcional. Es el formato de salida resultante para el contenido rasterizado. Los valores posibles son los siguientes: PNG PDF Both El valor predeterminado es PNG.
Export Method	Es opcional. Es el método que se usa para generar el contenido. Los valores posibles son los siguientes: Case Attachment File Path Both El valor predeterminado es Case Attachment.
Width	Obligatorio. Ancho (en píxeles) que se usa para el contenido ráster generado. El valor predeterminado es 1920.
Height	Obligatorio. Altura (en píxeles) que se usa para el contenido ráster generado. El valor predeterminado es 1080.
Full Screen	Es opcional. Si se selecciona esta opción, el contenido se renderiza en toda la ventana del navegador antes de rasterizarse. Está inhabilitado de forma predeterminada.
Timeout	Es opcional. Es el tiempo máximo (en segundos) que el navegador dedica a renderizar el contenido antes de que comience la rasterización. El valor máximo es 60. El valor predeterminado es 120.
Wait For	Es opcional. 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. Por lo general, el estado NETWORK_IDLE es el más confiable. Los valores posibles son los siguientes: LOAD DOM_CONTENT_LOADED NETWORK_IDLE COMMIT El valor predeterminado es NETWORK_IDLE.
Wait for Selector	Es opcional. Es un selector CSS que la acción espera que aparezca en la página antes de capturar la captura de pantalla. Nota: Se recomienda usar este parámetro de configuración en 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 Rasterize Content proporciona los siguientes resultados:

Tipo de salida de la acción	Disponibilidad
Adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	Disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Resultado de JSON

En el siguiente ejemplo, se muestran los resultados JSON que se reciben cuando se usa la acción Rasterize Content:

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

Mensajes de salida

La acción Rasterize Content puede devolver los siguientes mensajes de salida:

Mensaje de salida	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 completó correctamente.
Error executing action "Rasterize Content". Reason: ERROR_REASON	No se pudo realizar la acción. Verifica la conexión al servidor, los parámetros de entrada o las credenciales.

Resultado de secuencia de comandos

En la siguiente tabla, se indica el valor del resultado del script cuando se usa la acción Rasterize Content:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.