Utilitários de imagem

Um conjunto de ações de utilidade para ajudar na análise, extração e conversão de conteúdo de imagens e ficheiros durante as investigações. As funções principais incluem o reconhecimento ótico de carateres (OCR) para extração de texto, a rasterização (conversão de conteúdo Web em imagens estáticas) e a conversão de formatos de ficheiros. Todas as ações requerem um agente remoto.

Ações

Para mais informações sobre ações, consulte os artigos Responda a ações pendentes da sua mesa de trabalho e Realize uma ação manual.

Converter ficheiro

Use a ação Converter ficheiro para alterar o formato de um ficheiro especificado.

Dados de ações

A ação Convert File requer os seguintes parâmetros:

Parâmetro Descrição

Parâmetro	Descrição
`Input File Format`	Obrigatório. O formato original do ficheiro que a ação converte. Os valores possíveis são os seguintes: `PNG` `PDF` O valor predefinido é `PNG`.
`Input File Path`	Obrigatório. O caminho para o ficheiro que a ação converte.
`Output File Format`	Obrigatório. O formato resultante do ficheiro após o processo de conversão. Os valores possíveis são os seguintes: `PNG` `PDF` O valor predefinido é `PDF`.

Input File Format

Obrigatório.

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

Os valores possíveis são os seguintes:

PNG
PDF

O valor predefinido é PNG.

Input File Path

Obrigatório.

O caminho para o ficheiro que a ação converte.

Output File Format

Obrigatório.

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

Os valores possíveis são os seguintes:

PNG
PDF

O valor predefinido é PDF.

Resultados da ação

A ação Converter ficheiro fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para capas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Resultado JSON

O exemplo seguinte mostra as saídas de resultados JSON recebidas quando usa a ação Converter ficheiro:

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

Mensagens de saída

A ação Converter ficheiro pode devolver as seguintes mensagens de saída:

Mensagem de saída Descrição da mensagem

Mensagem de saída	Descrição da mensagem
`Successfully converted file.`	A ação foi bem-sucedida.
`Error executing action "Convert File". Reason: ERROR_REASON`	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Successfully converted file.

A ação foi bem-sucedida.

Error executing action "Convert File". Reason:
     ERROR_REASON

A ação falhou.

Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte lista o valor do resultado do script quando usa a ação Converter ficheiro:

Nome do resultado do script	Valor
`is_success`	`true` ou `false`

Imagem OCR

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

Dados de ações

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

Parâmetro Descrição

Parâmetro	Descrição
`Base64 Encoded Image`	Opcional. A string codificada em base64 do ficheiro de imagem.
`File Path`	Obrigatório. O caminho para o ficheiro de imagem. Nota: se forem fornecidos um `Base64 Encoded Image` e um `File Path`, o `Base64 Encoded Image` é processado.

Base64 Encoded Image

Opcional.

A string codificada em base64 do ficheiro de imagem.

File Path

Obrigatório.

O caminho para o ficheiro de imagem.

Nota: se forem fornecidos um Base64 Encoded Image e um File Path, o Base64 Encoded Image é processado.

Resultados da ação

A ação Imagem de OCR fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para capas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Resultado JSON

O exemplo seguinte mostra as saídas de resultados JSON recebidas quando usa a ação OCR Image:

{ 
  "extracted_text": "",
}

Mensagens de saída

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

Mensagem de saída Descrição da mensagem

Mensagem de saída	Descrição da mensagem
`Successfully performed OCR on the provided image.`	A ação foi bem-sucedida.
`Error executing action "OCR Image". Reason: ERROR_REASON`	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Successfully performed OCR on the provided image.

A ação foi bem-sucedida.

Error executing action "OCR Image". Reason:
     ERROR_REASON

A ação falhou.

Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte indica o valor da saída do resultado do script quando usa a ação Imagem de OCR:

Nome do resultado do script	Valor
`is_success`	`true` ou `false`

Rasterize o conteúdo

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

Pré-requisitos do agente remoto (Debian)

Para garantir que a ação Rasterize Content é executada com êxito num agente remoto baseado no Debian, tem de instalar os seguintes pacotes e dependências:

Biblioteca Python do Playwright

Instale a biblioteca Python do Playwright com 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

Dados de ações

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 os seguintes: `URL` `Email` `HTML` O valor predefinido é `URL`.
`URLs or Body`	Obrigatório. O conteúdo de entrada a rasterizar, 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, indique o corpo completo do conteúdo desse tipo de entrada.
`Output Type`	Opcional. O formato de saída resultante para o conteúdo rasterizado. Os valores possíveis são os seguintes: `PNG` `PDF` `Both` O valor predefinido é `PNG`.
`Export Method`	Opcional. O método usado para gerar o conteúdo. Os valores possíveis são os seguintes: `Case Attachment` `File Path` `Both` O valor predefinido é `Case Attachment`.
`Width`	Obrigatório. A largura (em píxeis) usada para o conteúdo raster gerado. O valor predefinido é `1920`.
`Height`	Obrigatório. A altura (em píxeis) usada para o conteúdo raster gerado. O valor predefinido é `1080`.
`Full Screen`	Opcional. Se esta opção estiver selecionada, o conteúdo é renderizado em toda a janela do navegador antes de ser rasterizado. Desativada por predefiniçã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 predefinido é `120`.
`Wait For`	Opcional. O estado específico que o navegador tem de atingir antes de a ação prosseguir com a rasterização ou a extração de conteúdo. O estado `NETWORK_IDLE` é geralmente o mais fiável. Os valores possíveis são os seguintes: `LOAD` `DOM_CONTENT_LOADED` `NETWORK_IDLE COMMIT` O valor predefinido é `NETWORK_IDLE`.
`Wait for Selector`	Opcional. Um seletor CSS que a ação aguarda que apareça na página antes de capturar a captura de ecrã. Nota: esta definição é altamente recomendada para páginas onde o conteúdo é carregado dinamicamente, uma vez que confirma que todos os elementos estão presentes antes de a ação ser executada.

Resultados da ação

A ação Rasterizar conteúdo fornece os seguintes resultados:

Tipo de saída da ação	Disponibilidade
Fixação à parede da caixa	Não disponível
Link da parede da caixa	Não disponível
Mesa de parede para capas	Não disponível
Tabela de enriquecimento	Não disponível
Resultado JSON	Disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Resultado JSON

O exemplo seguinte mostra os resultados JSON recebidos quando usa a ação Rasterize Content:

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

Mensagens de saída

A ação Rasterize Content pode devolver as seguintes mensagens de saída:

Mensagem de saída Descrição da mensagem

Mensagem de saída	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 bem-sucedida.
`Error executing action "Rasterize Content". Reason: ERROR_REASON`	A ação falhou. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

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 bem-sucedida.

Error executing action "Rasterize Content". Reason:
     ERROR_REASON

A ação falhou.

Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela seguinte lista o valor do resultado do script quando usa a ação Rasterize Content:

Nome do resultado do script	Valor
`is_success`	`true` ou `false`

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