Utilitários de imagem

Um conjunto de ações utilitárias para ajudar a analisar, extrair e converter conteúdo de imagens e arquivos durante investigações. As principais funções incluem reconhecimento óptico de caracteres (OCR) para extração de texto, rasterização (conversão de conteúdo da Web em imagens estáticas) e conversão de formato de arquivo. Todas as ações exigem um agente remoto.

Ações

Para mais informações sobre ações, consulte Responder a ações pendentes da sua mesa de trabalho e Realizar uma ação manual.

Converter arquivo

Use a ação Converter arquivo para mudar o formato de um arquivo especificado.

Entradas de ação

A ação Converter arquivo exige os seguintes parâmetros:

Parâmetro Descrição
Input File Format

Obrigatório.

O formato original do arquivo que a ação converte.

Os valores possíveis são:

  • PNG
  • PDF

O valor padrão é PNG.
Input File Path

Obrigatório.

O caminho para o arquivo que a ação converte.
Output File Format

Obrigatório.

O formato resultante do arquivo após o processo de conversão.

Os valores possíveis são:

  • PNG
  • PDF

O valor padrão é PDF.

Saídas de ação

A ação Converter arquivo oferece as seguintes saídas:

Tipo de saída da ação Disponibilidade
Anexo do Painel de Casos Indisponível
Link do Painel de Casos Indisponível
Tabela do painel de casos Indisponível
Tabela de enriquecimento Indisponível
Resultado JSON Disponível
Mensagens de saída Disponível
Resultado do script Disponível
Resultado JSON

O exemplo a seguir mostra as saídas de resultados JSON recebidas ao usar a ação Converter arquivo:

[
   {
       "output_format": ""  
       "file_path": ""
   }
]
Mensagens de saída

A ação Converter arquivo pode retornar as seguintes mensagens de saída:

Mensagem de resposta Descrição da mensagem

Successfully converted file.

 A ação foi concluída.
Error executing action "Convert File". Reason: ERROR_REASON

A ação falhou.

Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.
Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Converter arquivo:

Nome do resultado do script Valor
is_success true ou false

Imagem de OCR

Use a ação Imagem de OCR para realizar o OCR e extrair texto de um arquivo de imagem.

Entradas de ação

A ação Imagem de OCR exige os seguintes parâmetros:

Parâmetro Descrição
Base64 Encoded Image

Opcional.

A string codificada em base64 do arquivo de imagem.
File Path

Obrigatório.

O caminho para o arquivo de imagem.

Saídas de ação

A ação Imagem de OCR fornece as seguintes saídas:

Tipo de saída da ação Disponibilidade
Anexo do Painel de Casos Indisponível
Link do Painel de Casos Indisponível
Tabela do painel de casos Indisponível
Tabela de enriquecimento Indisponível
Resultado JSON Disponível
Mensagens de saída Disponível
Resultado do script Disponível
Resultado JSON

O exemplo a seguir mostra as saídas de resultados JSON recebidas ao usar a ação OCR Image:

{ 
  "extracted_text": "",
}
Mensagens de saída

A ação Imagem de OCR pode retornar as seguintes mensagens de saída:

Mensagem de resposta Descrição da mensagem

Successfully performed OCR on the provided image.

 A ação foi concluída.
Error executing action "OCR Image". Reason: ERROR_REASON

A ação falhou.

Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.
Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Imagem de OCR:

Nome do resultado do script Valor
is_success true ou false

Rasterizar conteúdo

Use a ação Rasterizar conteúdo para converter conteúdo vetorial ou complexo em um formato de imagem bitmap fixo.

Pré-requisitos do agente remoto (Debian)

Para garantir que a ação Rasterizar conteúdo seja executada corretamente em um agente remoto baseado no Debian, instale os seguintes pacotes e dependências:

Biblioteca Python do Playwright

Instale a biblioteca Python do Playwright usando o seguinte comando:

python3.11 -m pip install playwright
Dependências do navegador

Instale as dependências necessárias do navegador Chromium para que o Playwright funcione corretamente:

playwright install --with-deps chromium

Entradas de ação

Parâmetro Descrição
Input Type

Obrigatório.

O tipo de conteúdo que a ação usa como entrada principal.

Os valores possíveis são:

  • URL
  • Email
  • HTML

O valor padrão é URL.
URLs or Body

Obrigatório.

O conteúdo de entrada a ser rasterizado, com base no Input Type selecionado.

Se URL estiver selecionado, forneça uma lista de URLs separados por vírgulas.

Se Email ou HTML estiver selecionado, forneça o corpo completo do conteúdo desse tipo de entrada.
Output Type

Opcional.

O formato de saída resultante do conteúdo rasterizado.

Os valores possíveis são:

  • PNG
  • PDF
  • Both

O valor padrão é PNG.
Export Method

Opcional.

O método usado para gerar o conteúdo.

Os valores possíveis são:

  • Case Attachment
  • File Path
  • Both

O valor padrão é Case Attachment.
Width

Obrigatório.

A largura (em pixels) usada para o conteúdo raster gerado.

O valor padrão é 1920.
Height

Obrigatório.

A altura (em pixels) usada para o conteúdo raster gerado.

O valor padrão é 1080.
Full Screen

Opcional.

Se selecionado, o conteúdo será renderizado em toda a janela do navegador antes de ser rasterizado.

Essa configuração está desativada por padrão.
Timeout

Opcional.

O tempo máximo (em segundos) que o navegador dedica à renderização do conteúdo antes do início da rasterização.

O valor máximo é 60.

O valor padrão é 120.
Wait For

Opcional.

O estado específico que o navegador precisa alcançar antes que a ação prossiga com rasterização ou extração de conteúdo.

O estado NETWORK_IDLE geralmente é o mais confiável.

Os valores possíveis são:

  • LOAD
  • DOM_CONTENT_LOADED
  • NETWORK_IDLE COMMIT

O valor padrão é NETWORK_IDLE.
Wait for Selector

Opcional.

Um seletor de CSS que a ação aguarda aparecer na página antes de capturar a captura de tela.

Saídas de ação

A ação Rasterizar conteúdo oferece as seguintes saídas:

Tipo de saída da ação Disponibilidade
Anexo do Painel de Casos Indisponível
Link do Painel de Casos Indisponível
Tabela do painel de casos Indisponível
Tabela de enriquecimento Indisponível
Resultado JSON Disponível
Mensagens de saída Disponível
Resultado do script Disponível
Resultado JSON

O exemplo a seguir mostra as saídas de resultados JSON recebidas ao usar a ação Rasterizar conteúdo:

[
   {
       "attachment_name": "",
       "file_path": ""
   }
]
Mensagens de saída

A ação Rasterizar conteúdo pode retornar as seguintes mensagens de saída:

Mensagem de resposta Descrição da mensagem

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.

 A ação foi concluída.
Error executing action "Rasterize Content". Reason: ERROR_REASON

A ação falhou.

Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.
Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Rasterizar conteúdo:

Nome do resultado do script Valor
is_success true ou false

Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais do Google SecOps.