Trend Micro Apex Central

In diesem Dokument wird beschrieben, wie Sie Trend Micro Apex Central in Google SecOps einbinden.

API-Schlüssel abrufen

Weitere Informationen zum Abrufen eines API-Schlüssels finden Sie unter Anwendung hinzufügen.

Trend Micro Apex Central-Integration in Google Security Operations konfigurieren

Eine ausführliche Anleitung zum Konfigurieren einer Integration in Google SecOps finden Sie unter Integrationen konfigurieren.

Integrationsparameter

Verwenden Sie die folgenden Parameter, um die Integration zu konfigurieren:

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
API-Stamm String http://x.x.x.x Ja API-Stamm der Trend Micro Apex Central-Instanz.
Anwendungs-ID String – Ja Anwendungs-ID der Trend Micro Apex Central-Instanz.
API-Schlüssel Passwort – Ja API-Schlüssel der Trend Micro Apex Central-Instanz.
SSL überprüfen Kästchen Aktiviert Ja Wenn diese Option aktiviert ist, prüfen Sie, ob das SSL-Zertifikat für die Verbindung zum Trend Micro Apex Central-Server gültig ist.

Aktionen

Ping

Beschreibung

Testen Sie die Verbindung zu Trend Micro Apex Central mit den Parametern, die auf der Seite „Integrationskonfiguration“ im Google SecOps Content Hub angegeben sind.

Parameter

–

Ausführen am

Diese Aktion wird nicht für Entitäten ausgeführt.

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen
is_success is_success=False
is_success is_success=True
Fall-Repository
Ergebnistyp Wert / Beschreibung Typ
Ausgabenachricht*

Bei Erfolg:
print Successfully connected to the Trend Micro Apex Central server with the provided connection parameters!

Nicht erfolgreich:Verbindung zum Trend Micro Apex Central-Server konnte nicht hergestellt werden. Fehler: {0}".format(exception.stacktrace)

Allgemein

Entitäten anreichern

Beschreibung

Entitäten mit Informationen aus Trend Micro Apex Central anreichern. Unterstützte Entitäten: IP-Adresse, MAC-Adresse, Hostname, URL, Hash.

Parameter

Entität
Name Standardwert Ist obligatorisch Beschreibung
Endpunktstatistik erstellen Wahr Nein Wenn diese Option aktiviert ist, wird durch die Aktion eine Statistik mit Informationen zu den angereicherten Endpunkten erstellt.
UDSO-Statistik erstellen Wahr Nein Wenn diese Option aktiviert ist, wird durch die Aktion eine Statistik mit Informationen zu den Entitäten erstellt, die mit dem UDSO übereinstimmen.
UDSO-Entitäten markieren Wahr NeinWenn diese Option aktiviert ist, werden alle Entitäten, die in der Liste der benutzerdefinierten verdächtigen Objekte enthalten sind, als verdächtig markiert.
Domain extrahieren Falsch Nein Wenn diese Option aktiviert ist, extrahiert die Aktion den Domainteil der URL-Entität und verwendet ihn für die Anreicherung.

Ausführen am

Diese Aktion wird für die folgenden Entitäten ausgeführt:

  • IP-Adresse
  • MAC‑Adresse
  • Hostname
  • URL
  • Hash

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen
is_success is_success=False
is_success is_success=True
Entitätsanreicherung

Host, IP, MAC

Name des Anreicherungsfelds Logik – Wann anwenden?
ip_address Wird zurückgegeben, wenn im JSON-Ergebnis vorhanden.
mac_address Wird zurückgegeben, wenn im JSON-Ergebnis vorhanden.
Hostname Wird zurückgegeben, wenn im JSON-Ergebnis vorhanden.
has_endpoint_sensor Wird zurückgegeben, wenn im JSON-Ergebnis vorhanden.
isolation_status Wird zurückgegeben, wenn im JSON-Ergebnis vorhanden.
ad_domain Wird zurückgegeben, wenn im JSON-Ergebnis vorhanden.

URL, Hash, IP

Name des Anreicherungsfelds Logik – Wann anwenden?
Typ Wird zurückgegeben, wenn im JSON-Ergebnis vorhanden.
Hinweis Wird zurückgegeben, wenn im JSON-Ergebnis vorhanden.
Aktion Wird zurückgegeben, wenn im JSON-Ergebnis vorhanden.
expiration Wird zurückgegeben, wenn im JSON-Ergebnis vorhanden.
Fall-Repository
Ergebnistyp Wert / Beschreibung Typ
Ausgabenachricht*

Die Aktion sollte die Ausführung eines Playbooks weder fehlschlagen lassen noch stoppen:

  • Bei Erfolg für 1 Entität: Informationen zu den folgenden Entitäten wurden erfolgreich aus Trend Micro Apex Central abgerufen: {\n entity.identifier}

  • Wenn nicht erfolgreich für 1 Entität: Die Aktion konnte keine Informationen zu den folgenden Entitäten aus Trend Micro Apex Central abrufen: {\n entity.identifier}

  • Nicht für alle erfolgreich: Es wurden keine Entitäten mit Informationen aus Trend Micro Apex Central angereichert.

Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden:

  • Schwerwiegender Fehler, ungültige Anmeldedaten, API-Stammverzeichnis: Fehler beim Ausführen der Aktion „Entitäten anreichern“. Grund: {error traceback}
Allgemein
Tabelle mit Fall-Repository

Name: Found Endpoints

Spalte:

IP-Adresse

MAC-Adresse

Hostname

Hat Endpunktsensor

Isolationsstatus

AD-Domain

(Host, IP, MAC)
Tabelle mit Fall-Repository

Name: Found UDSO

Spalte:

Entität

Notiz

Aktion

(URL, Hash, IP)

Datei-UDSO erstellen

Beschreibung

Erstellen Sie in Trend Micro Apex Central ein benutzerdefiniertes verdächtiges Objekt basierend auf einer Datei.

Bekannte Probleme

Bei der Arbeit mit EML-Dateien wird das JSON-Ergebnis nicht zurückgegeben.

Parameter

Name Standardwert Ist obligatorisch Beschreibung
Dateipfade – Ja Geben Sie eine durch Kommas getrennte Liste von Dateipfaden an, die zum Erstellen eines UDSO verwendet werden sollen.
Aktion

Blockieren

Mögliche Werte:

Blockieren

Log

Quarantäne

Ja Geben Sie an, welche Aktion auf das UDSO angewendet werden soll.
Notiz – Falsch Geben Sie einen zusätzlichen Hinweis für das bereitgestellte UDSO an. Warnung: Die Notiz darf nicht mehr als 256 Zeichen enthalten.
Läuft ab in (Tage) – Falsch Geben Sie an, in wie vielen Tagen das UDSO ablaufen soll. Wenn nichts angegeben ist, läuft UDSO nie ab.

Ausführen am

Diese Aktion wird nicht für Entitäten ausgeführt.

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen
is_success is_success=False
is_success is_success=True
Fall-Repository
Fall Erfolgreich Nicht bestanden Nachricht
wenn erfolgreich für 1 Datei wahr falsch UDSO wurde anhand der folgenden Dateien in Trend Micro Apex Central erstellt: {\n Dateipfade}
wenn nicht erfolgreich für 1 Entität wahr falsch Die Aktion konnte in Trend Micro Apex Central kein UDSO basierend auf den folgenden Dateien erstellen: {\n Dateipfade}
Wenn bereits vorhanden wahr falsch Die folgenden UDSOs sind bereits in Trend Micro Apex Central vorhanden: {\n Dateipfade}
nicht für alle erfolgreich falsch falsch In Trend Micro Apex Central wurden keine UDSOs erstellt.
Schwerwiegender Fehler, ungültige Anmeldedaten, API-Stamm falsch wahr Fehler beim Ausführen der Aktion „UDSO für Datei erstellen“. Grund: {error traceback}
Wenn die Notiz mehr als 256 Zeichen enthält falsch wahr Fehler beim Ausführen der Aktion „UDSO für Datei erstellen“. Grund: Die Notiz darf nicht mehr als 256 Zeichen enthalten.

Entitäts-UDSO erstellen

Beschreibung

Erstellen Sie ein benutzerdefiniertes verdächtiges Objekt basierend auf den Entitäten in Trend Micro Apex Central. Unterstützte Entitäten: IP, URL, Hash.

Parameter

Name Standardwert Ist obligatorisch Beschreibung
Aktion

Blockieren

Mögliche Werte:

Blockieren

Log

Ja Geben Sie an, welche Aktion auf das UDSO angewendet werden soll.
Notiz – Falsch Geben Sie einen zusätzlichen Hinweis für das bereitgestellte UDSO an. Warnung: Die Notiz darf nicht mehr als 256 Zeichen enthalten.
Läuft ab in (Tage) – Falsch Geben Sie an, in wie vielen Tagen das UDSO ablaufen soll. Wenn nichts angegeben ist, läuft UDSO nie ab.

Ausführen am

Diese Aktion wird für die folgenden Entitäten ausgeführt:

  • IP-Adresse
  • URL
  • Hash

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen
is_success is_success=False
is_success is_success=True
Fall-Repository
Fall Erfolgreich Nicht bestanden Nachricht
wenn erfolgreich für 1 Entität wahr falsch UDSO wurde basierend auf den folgenden Entitäten in Trend Micro Apex Central erstellt: {\n entity.identifier}
wenn nicht erfolgreich für 1 Entität wahr falsch Die Aktion konnte basierend auf den folgenden Entitäten in Trend Micro Apex Central kein UDSO erstellen: {\n entity.identifier}
Wenn bereits vorhanden wahr falsch Die folgenden UDSOs sind bereits in Trend Micro Apex Central vorhanden: {\n entity.identifier}
nicht für alle erfolgreich falsch falsch In Trend Micro Apex Central wurden keine UDSOs erstellt.
Schwerwiegender Fehler, ungültige Anmeldedaten, API-Stamm falsch wahr Fehler beim Ausführen der Aktion „Entitäts-UDSO erstellen“. Grund: {error traceback}
Wenn die Notiz mehr als 256 Zeichen enthält falsch wahr Fehler beim Ausführen der Aktion „Entitäts-UDSO erstellen“. Grund: Die Notiz darf nicht mehr als 256 Zeichen enthalten.

Endpunkte nicht mehr isolieren

Beschreibung

Isolierung von Endpunkten in Trend Micro Apex Central aufheben Unterstützte Entitäten: IP, Mac, Hostname.

Parameter

Name Standardwert Ist obligatorisch Beschreibung
– – – –

Ausführen am

Diese Aktion wird für die folgenden Entitäten ausgeführt:

  • IP-Adresse
  • MAC‑Adresse
  • Hostname

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen
is_success is_success=False
is_success is_success=True
Fall-Repository
Fall Erfolgreich Nicht bestanden Nachricht
wenn erfolgreich für 1 Entität wahr falsch Die folgenden Endpunkte in Trend Micro Apex Central wurden isoliert: {\n entity.identifier}
wenn nicht erfolgreich für 1 Entität wahr falsch Die Aktion konnte die folgenden Endpunkte in Trend Micro Apex Central nicht aus der Isolation entfernen: {\n entity.identifier}
nicht für alle erfolgreich falsch falsch In Trend Micro Apex Central wurden keine Endpunkte isoliert.
Asynchrone Nachricht falsch falsch Die Aufhebung der Endpunktisolation wurde für die folgenden Endpunkte initiiert: {entity.identifier}. Warten, bis die Aufhebung der Isolation abgeschlossen ist.
Zeitüberschreitungsmeldung falsch falsch

Die Aktion hat die Aufhebung der Isolation eingeleitet, ist aber für die folgenden Endpunkte noch ausstehend: {entity.identifier}.

Erhöhen Sie das Zeitlimit in der IDE.

Schwerwiegender Fehler, ungültige Anmeldedaten, API-Stamm falsch wahr Fehler beim Ausführen der Aktion „Endpunkte isolieren“. Grund: {error traceback}

Endpunkte isolieren

Beschreibung

Isolieren Sie Endpunkte in Trend Micro Apex Central. Unterstützte Entitäten: IP, Mac, Hostname.

Parameter

Name Standardwert Ist obligatorisch Beschreibung
– – – –

Ausführen am

Diese Aktion wird für die folgenden Entitäten ausgeführt:

  • IP-Adresse
  • MAC‑Adresse
  • Hostname

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen
is_success is_success=False
is_success is_success=True
Fall-Repository
Fall Erfolgreich Nicht bestanden Nachricht
wenn erfolgreich für 1 Entität wahr falsch Die folgenden Endpunkte wurden in Trend Micro Apex Central isoliert: {\n entity.identifier}
wenn nicht erfolgreich für 1 Entität wahr falsch Die folgenden Endpunkte konnten in Trend Micro Apex Central nicht isoliert werden: {\n entity.identifier}
nicht für alle erfolgreich falsch falsch In Trend Micro Apex Central wurden keine Endpunkte isoliert.
Asynchrone Nachricht falsch falsch Endpunktisolation für die folgenden Endpunkte initiiert: {entity.identifier}. Warten, bis die Isolierung abgeschlossen ist.
Zeitüberschreitungsmeldung wahr falsch

Die Aktion hat die Isolierung initiiert, sie steht aber für die folgenden Endpunkte noch aus: {entity.identifier}.

Erhöhen Sie das Zeitlimit in der IDE.

Schwerwiegender Fehler, ungültige Anmeldedaten, API-Stamm falsch wahr Fehler beim Ausführen der Aktion „Endpunkte isolieren“. Grund: {error traceback}

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