Trend Micro Cloud App Security

In diesem Dokument wird beschrieben, wie Sie Trend Micro Cloud App Security in Google SecOps einbinden.

Anwendungsfälle für Produkte

Aktive Aktionen ausführen – Entitäten anreichern, E-Mails suchen, Blockierungsliste aktualisieren, E-Mails/Konten entschärfen usw.

API-Token generieren

  1. Gehen Sie zu Verwaltung > Automatisierungs- und Integrations-APIs.
  2. Tippen Sie auf den Button „Hinzufügen“.
  3. Wählen Sie „For External Application“ (Für externe Anwendung) aus.
  4. Geben Sie einen Namen ein und setzen Sie alle Häkchen.
  5. Klicken Sie auf „Token erstellen“.
  6. Kopieren Sie das Token.
  7. Aktualisieren Sie den Parameter „API-Schlüssel“ in der Integrationskonfiguration.
  8. Verbindung testen

Trend Micro Cloud App Security-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 https://api-eu.tmcas.trendmicro.com Ja API-Stamm der Trend Micro Cloud App Security-Instanz.
API-Schlüssel Passwort – Ja API-Schlüssel der Trend Micro Cloud App Security-Instanz.
SSL überprüfen Kästchen Aktiviert Ja Wenn diese Option aktiviert ist, wird geprüft, ob das SSL-Zertifikat für die Verbindung zum Trend Micro Cloud App Security-Server gültig ist.

Aktionen

Ping

Beschreibung

Testen Sie die Verbindung zu Trend Micro Cloud App Security 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*

Wenn erfolgreich (is success = true): Successfully connected to the Trend Micro Cloud App Security server with the provided connection parameters!

Wenn nicht erfolgreich (is success = false): Verbindung zum Trend Micro Cloud App Security-Server konnte nicht hergestellt werden. Fehler: {0}".format(exception.stacktrace)

 Allgemein

Entitäten zur Sperrliste hinzufügen

Beschreibung

Entitäten zu einer Sperrliste in Trend Micro Cloud App Security hinzufügen. Unterstützte Entitäten: URL, Hash und E-Mail (Nutzerentität, die dem E-Mail-Adressmuster entspricht).

Parameter

Name Standardwert Ist obligatorisch Beschreibung
– – – –

Ausführen am

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

  • URL
  • Hash
  • E-Mail

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success:False
Fall-Repository
Fall Erfolgreich Nicht bestanden Nachricht
wenn erfolgreich für 1 Entität wahr falsch Die folgenden Entitäten wurden der Sperrliste in Trend Micro Cloud App Security hinzugefügt: {\n entity.identifier}
wenn nicht erfolgreich für 1 Entität wahr falsch Die Aktion konnte die folgenden Entitäten nicht zur Sperrliste in Trend Micro Cloud App Security hinzufügen: {\n entity.identifier}
Wenn Duplikate vorhanden sind wahr falsch Die folgenden Entitäten sind bereits Teil der Sperrliste in Trend Micro Cloud App Security: {\n entity.identifier}
nicht für alle erfolgreich falsch falsch Es wurden keine Entitäten mit Informationen aus Trend Micro Cloud App Security hinzugefügt
Schwerwiegender Fehler, ungültige Anmeldedaten, API-Stamm falsch wahr Fehler beim Ausführen der Aktion „Entitäten zur Sperrliste hinzufügen“. Grund: {error traceback}

E‑Mails zur Aussetzung von Maßnahmen

Beschreibung

E-Mails mit Trend Micro Cloud App Security löschen oder unter Quarantäne stellen. Hinweis: In Gmail können Sie nur E‑Mails löschen.

Parameter

Name Standardwert Ist obligatorisch Beschreibung
Nachrichten-IDs – Ja Geben Sie eine durch Kommas getrennte Liste von Nachrichten-IDs an, für die Maßnahmen ausgesetzt werden sollen.
Maßnahme zur Aussetzung

Löschen

Mögliche Werte:

Löschen

Quarantäne

 Ja Geben Sie an, welche Maßnahme zur Aussetzung von Maßnahmen angewendet werden soll.
Dienst

Gmail

Mögliche Werte

Gmail

Datenaustausch

 Ja Geben Sie den Dienst an, der für E-Mails verwendet wird.

Ausführen am

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

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success:False
Fall-Repository
Fall Erfolgreich Nicht bestanden Nachricht
wenn erfolgreich für 1 message_id Wahr falsch Die folgenden E‑Mails wurden in Trend Micro Cloud App Security erfolgreich entschärft: {\n unique message ids}
wenn nicht erfolgreich für 1 message_id Wahr falsch Die folgenden E‑Mails konnten in Trend Micro Cloud App Security nicht entschärft werden: {\n unique message ids}
nicht für alle erfolgreich falsch falsch Es wurden keine E‑Mails von Trend Micro Cloud App Security entschärft.
Schwerwiegender Fehler, ungültige Anmeldedaten, API-Stamm falsch wahr Fehler beim Ausführen der Aktion „E‑Mails aussetzen“. Grund: {error traceback}
Wenn „Quarantäne“ ausgewählt und „Gmail“ der Dienst ist falsch wahr Fehler beim Ausführen der Aktion „E‑Mails entschärfen“. Grund: Sie können E‑Mails nur in Gmail löschen.

Beschreibung

E‑Mails anhand von Entitäten in Trend Micro Cloud App Security suchen. Unterstützte Entitäten: URL, Hash, E-Mail (Nutzerentität, die dem E-Mail-Adressmuster entspricht), E-Mail-Betreff, Dateiname, IP.

Parameter

Name Standardwert Ist obligatorisch Beschreibung
Max. Tage zurück 30 Nein Geben Sie an, wie viele Tage in der Vergangenheit nach E-Mails gesucht werden soll. Der Höchstwert ist 90. Standard: 30.
Maximale Anzahl zurückzugebender E‑Mails 100 Nein Geben Sie an, wie viele E-Mails zurückgegeben werden sollen. Der Standardwert is 100.

Ausführen am

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

  • URL
  • Hash
  • E-Mail
  • E-Mail-Betreff
  • Dateiname
  • IP-Adresse

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success:False
JSON-Ergebnis
emails=[{list of unique emails}]
Fall-Repository
Fall Erfolgreich Nicht bestanden Nachricht
wenn Daten verfügbar sind: wahr falsch Informationen zu E‑Mails, die sich auf die angegebenen Entitäten in Trend Micro Cloud App Security beziehen, wurden erfolgreich zurückgegeben.
wenn keine Daten verfügbar sind falsch falsch In Trend Micro Cloud App Security wurden keine Informationen zu E‑Mails im Zusammenhang mit Entitäten gefunden.
Schwerwiegender Fehler, ungültige Anmeldedaten, API-Stamm falsch wahr Fehler beim Ausführen der Aktion „E‑Mail-Suche nach Entität“. Grund: {error traceback}
Wenn „Max. Tage rückwärts“ > 90 falsch wahr Fehler beim Ausführen der Aktion „E‑Mail-Suche nach Entität“. Grund: „Max. Tage rückwärts“ muss im Bereich von 1 bis 90 liegen.

Entitäten anreichern

Beschreibung

Entitäten mit Informationen aus Trend Micro Cloud App Security anreichern. Unterstützte Entitäten: URL, Hash und E-Mail (Nutzerentität, die dem E-Mail-Adressmuster entspricht).

Parameter

Name Standardwert Ist obligatorisch Beschreibung
– – – –

Ausführen am

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

  • URL
  • Hash
  • E-Mail

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success:False
JSON-Ergebnis
blocked_url = [URL entities that were found]
blocked_hashes = [hashes entities that were found]
blocked_senders = [User entities that were found]
Fall-Repository
Fall Erfolgreich Nicht bestanden Nachricht
wenn erfolgreich für 1 Entität wahr falsch Informationen zu den folgenden Entitäten wurden erfolgreich aus Trend Micro Cloud App Security abgerufen: {\n entity.identifier}
wenn nicht erfolgreich für 1 Entität wahr falsch Die Aktion konnte keine Informationen zu den folgenden Entitäten aus Trend Micro Cloud App Security abrufen: {\n entity.identifier}
nicht für alle erfolgreich falsch falsch Es wurden keine Entitäten mit Informationen aus Trend Micro Cloud App Security angereichert
Schwerwiegender Fehler, ungültige Anmeldedaten, API-Stamm falsch wahr Fehler beim Ausführen der Aktion „Entitäten anreichern“. Grund: {error traceback}

Maßnahmen für Konten aussetzen

Beschreibung

Führen Sie über Trend Micro Cloud App Security Maßnahmen zur Risikominimierung für das Nutzerkonto aus.

Parameter

Name Standardwert Ist obligatorisch Beschreibung
E‑Mail-Adressen – Ja Geben Sie eine durch Kommas getrennte Liste von E‑Mail-Adressen an, für die die Maßnahmen ausgesetzt werden sollen.
Maßnahme zur Aussetzung

Konto deaktivieren

MFA aktivieren

Passwort zurücksetzen

Anmeldesitzungen widerrufen

 Ja Geben Sie an, welche Maßnahme zur Aussetzung von Maßnahmen angewendet werden soll.

Ausführen am

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

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success:False
Fall-Repository
Fall Erfolgreich Nicht bestanden Nachricht
wenn der Vorgang für eine E‑Mail-Adresse erfolgreich war. wahr falsch Die folgenden Konten in Trend Micro Cloud App Security wurden erfolgreich entschärft: {\n email addresses}
wenn nicht erfolgreich für 1 Entität wahr falsch Die Aktion konnte die folgenden Konten in Trend Micro Cloud App Security nicht aussetzen: {\n email addresses}
nicht für alle erfolgreich falsch falsch Es wurden keine Konten mithilfe von Informationen aus Trend Micro Cloud App Security entschärft.
Asynchrone Nachricht falsch falsch Warten auf Abschluss der Maßnahmen zur Aussetzung…
Schwerwiegender Fehler, ungültige Anmeldedaten, API-Stamm falsch wahr Fehler beim Ausführen der Aktion „Maßnahmen für Konto aussetzen“. Grund: {error traceback}

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