Bild-Dienstprogramme

Eine Reihe von Dienstprogrammaktionen, die bei der Analyse, Extraktion und Konvertierung von Bild- und Dateiinhalten während der Ermittlungen helfen. Zu den wichtigsten Funktionen gehören die optische Zeichenerkennung (OCR) zum Extrahieren von Text, die Rasterung (Konvertierung von Webinhalten in statische Bilder) und die Konvertierung von Dateiformaten. Für alle Aktionen ist ein Remote-Agent erforderlich.

Aktionen

Weitere Informationen zu Aktionen finden Sie unter Ausstehende Aktionen in „Mein Arbeitsbereich“ beantworten und Manuelle Aktion ausführen.

Datei konvertieren

Mit der Aktion Datei konvertieren können Sie das Format einer angegebenen Datei ändern.

Aktionseingaben

Für die Aktion Datei konvertieren sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Input File Format

Erforderlich.

Das ursprüngliche Format der Datei, die durch die Aktion konvertiert wird.

Folgende Werte sind möglich:

  • PNG
  • PDF

Der Standardwert ist PNG.
Input File Path

Erforderlich.

Der Pfad zu der Datei, die durch die Aktion konvertiert wird.
Output File Format

Erforderlich.

Das Format der Datei nach der Konvertierung.

Folgende Werte sind möglich:

  • PNG
  • PDF

Der Standardwert ist PDF.

Aktionsausgaben

Die Aktion Datei konvertieren liefert die folgenden Ausgaben:

Ausgabetyp der Aktion Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall‑Repository Nicht verfügbar
Tabelle im Fall-Repository Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgaben, die bei Verwendung der Aktion Datei konvertieren empfangen werden:

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

Die Aktion Datei konvertieren kann die folgenden Ausgabemeldungen zurückgeben:

Ausgabemeldung Nachrichtenbeschreibung

Successfully converted file.

 Die Aktion wurde ausgeführt.
Error executing action "Convert File". Reason: ERROR_REASON

Die Aktion ist fehlgeschlagen.

Überprüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.
Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Datei konvertieren verwendet wird:

Name des Scriptergebnisses Wert
is_success true oder false

OCR-Bild

Mit der Aktion OCR-Bild können Sie eine OCR durchführen und Text aus einer Bilddatei extrahieren.

Aktionseingaben

Für die Aktion OCR Image sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Base64 Encoded Image

Optional.

Der Base64-codierte String der Bilddatei.
File Path

Erforderlich.

Der Pfad zur Bilddatei.

Aktionsausgaben

Die Aktion OCR-Bild bietet die folgenden Ausgaben:

Ausgabetyp der Aktion Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall‑Repository Nicht verfügbar
Tabelle im Fall-Repository Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgaben, die bei Verwendung der Aktion OCR Image (OCR-Bild) empfangen werden:

{ 
  "extracted_text": "",
}
Ausgabenachrichten

Die Aktion OCR Image kann die folgenden Ausgabemeldungen zurückgeben:

Ausgabemeldung Nachrichtenbeschreibung

Successfully performed OCR on the provided image.

 Die Aktion wurde ausgeführt.
Error executing action "OCR Image". Reason: ERROR_REASON

Die Aktion ist fehlgeschlagen.

Überprüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.
Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses bei Verwendung der Aktion OCR Image aufgeführt:

Name des Scriptergebnisses Wert
is_success true oder false

Inhalte rastern

Mit der Aktion In Rasterbild umwandeln können Sie Vektor- oder komplexe Inhalte in ein festes Bitmap-Bildformat umwandeln.

Voraussetzungen für Remote-Agents (Debian)

Damit die Aktion Rasterize Content (Inhalte rastern) auf einem Debian-basierten Remote Agent ausgeführt werden kann, müssen Sie die folgenden Pakete und Abhängigkeiten installieren:

Playwright-Python-Bibliothek

Installieren Sie die Playwright-Python-Bibliothek mit dem folgenden Befehl:

python3.11 -m pip install playwright
Browserabhängigkeiten

Installieren Sie die erforderlichen Chromium-Browserabhängigkeiten, damit Playwright ordnungsgemäß funktioniert:

playwright install --with-deps chromium

Aktionseingaben

Parameter Beschreibung
Input Type

Erforderlich.

Der Inhaltstyp, der von der Aktion als primäre Eingabe verwendet wird.

Folgende Werte sind möglich:

  • URL
  • Email
  • HTML

Der Standardwert ist URL.
URLs or Body

Erforderlich.

Die Eingabeinhalte, die gerastert werden sollen, basierend auf der ausgewählten Input Type.

Wenn URL ausgewählt ist, geben Sie eine durch Kommas getrennte Liste von URLs an.

Wenn Email oder HTML ausgewählt ist, geben Sie den vollständigen Inhaltstext dieses Eingabetyps an.
Output Type

Optional.

Das resultierende Ausgabeformat für die gerasterten Inhalte.

Folgende Werte sind möglich:

  • PNG
  • PDF
  • Both

Der Standardwert ist PNG.
Export Method

Optional.

Die Methode, mit der die generierten Inhalte ausgegeben werden.

Folgende Werte sind möglich:

  • Case Attachment
  • File Path
  • Both

Der Standardwert ist Case Attachment.
Width

Erforderlich.

Die Breite (in Pixeln), die für die generierten Rasterinhalte verwendet wird.

Der Standardwert ist 1920.
Height

Erforderlich.

Die Höhe (in Pixeln), die für die generierten Rasterinhalte verwendet wird.

Der Standardwert ist 1080.
Full Screen

Optional.

Wenn diese Option ausgewählt ist, wird der Inhalt im gesamten Browserfenster gerendert, bevor er gerastert wird.

Standardmäßig deaktiviert.
Timeout

Optional.

Die maximale Zeit (in Sekunden), die der Browser für das Rendern der Inhalte verwendet, bevor die Rasterung beginnt.

Der Höchstwert ist 60.

Der Standardwert ist 120.
Wait For

Optional.

Der spezifische Status, den der Browser erreichen muss, bevor die Aktion mit der Rasterung oder dem Extrahieren von Inhalten fortgesetzt wird.

Der Status NETWORK_IDLE ist in der Regel der zuverlässigste.

Folgende Werte sind möglich:

  • LOAD
  • DOM_CONTENT_LOADED
  • NETWORK_IDLE COMMIT

Der Standardwert ist NETWORK_IDLE.
Wait for Selector

Optional.

Ein CSS-Selektor, auf den die Aktion wartet, bis er auf der Seite angezeigt wird, bevor der Screenshot aufgenommen wird.

Aktionsausgaben

Die Aktion In Rasterbild umwandeln bietet die folgenden Ausgaben:

Ausgabetyp der Aktion Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall‑Repository Nicht verfügbar
Tabelle im Fall-Repository Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgaben, die bei Verwendung der Aktion Rasterize Content (Inhalte rastern) empfangen werden:

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

Die Aktion Inhalte rastern kann die folgenden Ausgabemeldungen zurückgeben:

Ausgabemeldung Nachrichtenbeschreibung

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.

 Die Aktion wurde ausgeführt.
Error executing action "Rasterize Content". Reason: ERROR_REASON

Die Aktion ist fehlgeschlagen.

Überprüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.
Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion In Rasterbild umwandeln verwendet wird:

Name des Scriptergebnisses Wert
is_success true oder false

Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten