Amazon GuardDuty in Google SecOps einbinden

In diesem Dokument wird beschrieben, wie Sie Amazon GuardDuty in Google Security Operations (Google SecOps) einbinden.

Vorbereitung

Wenn Sie nur Lesezugriff auf die Integration benötigen, z. B. zum Ausführen des Connectors, verwenden Sie die Richtlinie AmazonGuardDutyReadOnlyAccess.

Wenn Sie vollen Zugriff auf alle Integrationsfunktionen erhalten möchten, verwenden Sie die Richtlinie AmazonGuardDutyFullAccess.

Weitere Informationen zur Verwendung von Richtlinien finden Sie unter Von AWS verwaltete Richtlinien.

Google Cloud Web Identity-Föderation (OIDC) für AWS konfigurieren

Google SecOps-Integrationen und ‑Connectors können sich mithilfe der OpenID Connect (OIDC) Web Identity Federation bei AWS authentifizieren. Dadurch müssen keine langlebigen AWS-Zugriffsschlüssel und geheimen Schlüssel auf der Plattform gespeichert werden.

Wenn Sie die OIDC-Föderation einrichten möchten, müssen Sie eine Vertrauensstellung zwischen IhrerGoogle Cloud -Umgebung und Ihrer AWS-Umgebung konfigurieren.

Schritt 1: Google Cloud -Dienstkonto konfigurieren

  1. Erstellen oder wählen Sie in der Google Cloud Konsole ein Ziel- Google Cloud -Dienstkonto aus, das für Ihre AWS-Integrationen vorgesehen ist.
  2. Weisen Sie dem Dienstkonto die Rolle Ersteller von Dienstkonto-Tokens (roles/iam.serviceAccountTokenCreator) zu, um die Tokengenerierung und Identitätsübernahme zu ermöglichen.
  3. Kopieren Sie die OAuth 2.0-Client-ID (auch als eindeutige ID oder Subjekt-ID bezeichnet) dieses Dienstkontos. Sie benötigen diesen Wert, wenn Sie AWS konfigurieren.
  4. Konfigurieren Sie, wie sich Ihre Google SecOps-Umgebung als dieses Zieldienstkonto authentifiziert:
    • Workload Identity (empfohlen): Wenn Ihr Google SecOps-Agent oder Ihre Google SecOps-Umgebung nativ in Google Cloudausgeführt wird, muss er bzw. sie die Berechtigung haben, die Identität dieses Zieldienstkontos mithilfe von Workload Identity zu übernehmen.
    • Dienstkontoschlüssel: Wenn Ihre Umgebung oder Ihr Agent extern oder lokal ausgeführt wird, laden Sie eine JSON-Dienstkontoschlüsseldatei für dieses Zieldienstkonto herunter und konfigurieren Sie Ihre Plattformumgebung so, dass sie für die Authentifizierung verwendet wird.

Schritt 2: OIDC-Identitätsanbieter in AWS hinzufügen

  1. Rufen Sie in der AWS-Managementkonsole IAM > Identity Providers (Identitätsanbieter) auf.
  2. Klicken Sie auf Anbieter hinzufügen und wählen Sie OpenID Connect aus.
  3. Geben Sie als Anbieter-URL Folgendes ein: https://accounts.google.com
  4. Geben Sie für die Zielgruppe die OAuth 2.0-Client-ID des Google Cloud-Dienstkontos ein, die Sie in Schritt 1 kopiert haben.

Schritt 3: Föderierte AWS-IAM-Rolle erstellen

  1. Erstellen Sie in der AWS IAM-Konsole eine neue IAM-Rolle.
  2. Wählen Sie Web Identity als Typ der vertrauenswürdigen Entität aus, um automatisch eine Vertrauensrichtlinie mit dem Amazon Security Token Service (sts:AssumeRoleWithWebIdentity) zu konfigurieren.
  3. Hängen Sie die spezifischen Berechtigungsrichtlinien an, die für die Integration oder den Connector erforderlich sind (z. B. AmazonGuardDutyReadOnlyAccess).
  4. Rufen Sie den Tab Vertrauensstellungen der Rolle auf, klicken Sie auf Vertrauensrichtlinie bearbeiten und wenden Sie die folgende JSON-Konfiguration an:

    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Principal": {
            "Federated": "arn:aws:iam::<AWS_ACCOUNT_ID>:oidc-provider/accounts.google.com"
          },
          "Action": "sts:AssumeRoleWithWebIdentity",
          "Condition": {
            "StringEquals": {
              "accounts.google.com:aud": "<GCP_SERVICE_ACCOUNT_CLIENT_ID>",
              "accounts.google.com:sub": "<GCP_SERVICE_ACCOUNT_CLIENT_ID>"
            }
          }
        }
      ]
    }
    

Integrationsparameter

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

Parametername Typ Standardwert Ist obligatorisch Beschreibung
AWS-Zugriffsschlüssel-ID String – Nein AWS-Zugriffsschlüssel-ID, die für die Integration verwendet werden soll. Lassen Sie das Feld leer, wenn Sie die Web Identity (OIDC)-Föderation von Google Cloudverwenden.
AWS Secret Key Passwort – Nein AWS-Secret-Key, der in der Integration verwendet werden soll. Lassen Sie das Feld leer, wenn Sie die Web Identity (OIDC) Federation von Google Cloud verwenden.
AWS-Standardregion String – Ja AWS-Standardregion, die in der Integration verwendet werden soll, z. B. us-west-1.
Remote ausführen Kästchen Deaktiviert Nein

Setzen Sie ein Häkchen, um die konfigurierte Integration remote auszuführen.

Nachdem Sie das Häkchen gesetzt haben, wird die Option zum Auswählen des Remote-Nutzers (Agenten) angezeigt.

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

Sie können später bei Bedarf Änderungen vornehmen. Nachdem Sie eine Integrationsinstanz konfiguriert haben, können Sie sie in Playbooks verwenden. Weitere Informationen zum Konfigurieren und Unterstützen mehrerer Instanzen finden Sie unter Mehrere Instanzen unterstützen.

Anwendungsfälle

  1. Bedrohungen im AWS-System mithilfe von Playbooks oder manuellen Aktionen erkennen und verwalten.
  2. Amazon GuardDuty-Ergebnisse werden aufgenommen und dann in das GuardDuty-Archiv verschoben.

Aktionen

Weitere Informationen zu Aktionen finden Sie unter Auf ausstehende Aktionen im Workdesk reagieren und Manuelle Aktion in einem Fall ausführen.

Ping

Testen Sie die Verbindung zu Amazon GuardDuty.

Parameter

Keine.

Ausführen am

Diese Aktion wird nicht für Entitäten ausgeführt und hat keine obligatorischen Eingabeparameter.

Aktionsergebnisse

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

Bei Erfolg: „Successfully connected to the AWS GuardDuty server with the provided connection parameters!“

Andernfalls: „Failed to connect to the AWS“ (Verbindung zu AWS konnte nicht hergestellt werden). Wenn erfolgreich: „Successfully connected to the AWS GuardDuty server with the provided connection parameters!“ (Verbindung zum AWS GuardDuty-Server mit den angegebenen Verbindungsparametern erfolgreich hergestellt!)

Else: "Failed to connect to the AWS GuardDuty server! Fehler: {0}"

Allgemein

Detektor erstellen

Erstellt einen einzelnen Amazon GuardDuty-Detektor. Ein Detektor ist eine Ressource, die den GuardDuty-Dienst darstellt. Sie können nur einen Detektor pro Konto und Region haben.

Parameter

Parametername Typ Standardwert Ist obligatorisch Beschreibung
Aktivieren Kästchen Deaktiviert Ja Gibt an, ob der Detektor aktiviert werden soll.

Ausführen am

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

Aktionsergebnisse

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

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

Erfolgreich: „Der Detektor <neue Detektor-ID> wurde erstellt.“

Wenn der Detektor nicht erstellt wurde (is_success=false): „Die Aktion konnte keinen Detektor erstellen. Grund: Für das aktuelle Konto ist bereits ein Detektor vorhanden.

Wenn „ErrorCode“ gemeldet wird (is_success=false): „Die Aktion konnte keinen Detektor erstellen. Error: {}".format (ErrorMessage)"

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

Eine ungültige Detektor-ID sollte ebenfalls eine Ausnahme auslösen, das Playbook beenden und „is_success“ auf „false“ setzen.

Wenn ein schwerwiegender Fehler oder ein SDK-Fehler wie falsche Anmeldedaten, keine Verbindung oder ein anderer Fehler gemeldet wird: „Fehler beim Ausführen der Aktion ‚Detektor erstellen‘. Reason: {0}''.format(error.Stacktrace)

Allgemein

Detektor löschen

Löscht einen Amazon GuardDuty-Detektor, der durch die Detektor-ID angegeben wird.

Parameter

Parametername Typ Standardwert Ist obligatorisch Beschreibung
Detektor-ID String – Ja Die eindeutige ID des Detektors, den Sie löschen möchten.

Ausführen am

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

Aktionsergebnisse

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

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

Wenn der Detektor nicht gelöscht wird (is_success=false): „Der Detektor <detector_ID> konnte nicht gelöscht werden. Error: {}".format(ErrorMessage)"

Wenn der Detektor erfolgreich gelöscht wurde (is_success=true): „Der Detektor <detector ID> wurde gelöscht.“

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

Eine ungültige Detektor-ID sollte ebenfalls eine Ausnahme auslösen, das Playbook stoppen und „is_success“ auf „false“ setzen.

Wenn ein schwerwiegender Fehler oder ein SDK-Fehler wie falsche Anmeldedaten, keine Verbindung oder ein anderer Fehler gemeldet wird: „Fehler beim Ausführen der Aktion ‚Detektor löschen‘. Reason: {0}''.format(error.Stacktrace)

Allgemein

Detektor aktualisieren

Aktualisieren Sie den Amazon GuardDuty-Detektor, der durch die Detektor-ID angegeben ist.

Parameter

Parametername Typ Standardwert Ist obligatorisch Beschreibung
Detektor-ID String – Ja Die eindeutige ID des Detektors, den Sie aktualisieren möchten.
Aktivieren Kästchen Deaktiviert Nein Gibt an, ob der Detektor aktiviert werden soll.

Ausführen am

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

Aktionsergebnisse

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

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

Wenn „ErrorCode“ gemeldet wird (is_success=false): „Die Aktion konnte keinen Detektor erstellen. Error: {}".format(ErrorMessage)"

Wenn der Detektor erfolgreich aktualisiert wurde (is_success=true): „Der Detektor <detector ID> wurde aktualisiert.“

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

Eine ungültige Detektor-ID sollte ebenfalls eine Ausnahme auslösen, das Playbook beenden und is_success auf „false“ setzen.

Wenn ein schwerwiegender Fehler oder ein SDK-Fehler wie falsche Anmeldedaten, keine Verbindung oder ein anderer Fehler gemeldet wird: „Fehler beim Ausführen der Aktion ‚Detektor aktualisieren‘. Reason: {0}''.format(error.Stacktrace)

Allgemein

Detektordetails abrufen

Ruft einen Amazon GuardDuty-Detektor ab, der durch die Detektor-ID angegeben wird.

Parameter

Parametername Typ Standardwert Ist obligatorisch Beschreibung
Detektor-ID String – Ja Die eindeutige ID des Detektors, den Sie abrufen möchten. CSV.

Ausführen am

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

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success True oder False is_success=False
JSON-Ergebnis
{
   "DetectorId": "DETECTOR_ID",
   "CreatedAt": "response['CreatedAt']",
   "ServiceRole": "response['ServiceRole']",
   "Status": "response['Status']",
   "UpdatedAt": "response['UpdatedAt']",
}
Fall-Repository
Ergebnistyp Beschreibung Typ
Ausgabenachricht*

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

Bei Erfolg: „Informationen zum Indikator <Indicator ID> wurden abgerufen.“

Hinweis: Wenn einige Detektor-IDs gefunden werden und andere nicht, werden beide Meldungen basierend auf der entsprechenden Detektor-ID angezeigt.

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

Eine ungültige Detektor-ID sollte ebenfalls eine Ausnahme auslösen, das Playbook beenden und „is_success“ auf „false“ setzen.

Wenn ein schwerwiegender Fehler oder ein SDK-Fehler wie falsche Anmeldedaten, keine Verbindung oder ein anderer Fehler gemeldet wird: „Fehler beim Ausführen der Aktion ‚Detektordetails abrufen‘. Reason: {0}''.format(error.Stacktrace)

Allgemein
CSV-Tabelle

Tabellentitel: Detektordetails

Tabellenspalten:

  • Detektor-ID
  • Status
  • Dienstrolle
  • Erstellt am
  • Aktualisiert am
Allgemein

Detektoren auflisten

Listet die detectorIds aller vorhandenen Amazon GuardDuty-Detektorressourcen auf.

Parameter

Parametername Typ Standardwert Ist obligatorisch Beschreibung
Maximale Anzahl zurückzugebender Detektoren Ganzzahl 50 Nein Geben Sie die Anzahl der zurückzugebenden Detektoren an.

Ausführen am

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

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success True oder False is_success=False
JSON-Ergebnis
{
    "detectorIds": ["ID1,ID2"]
}
Fall-Repository
Ergebnistyp Beschreibung Typ
Ausgabenachricht*

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

Wenn der Statuscode 200 zurückgegeben wird (is_success=true): „Die verfügbaren Detektoren in Amazon GuardDuty wurden aufgelistet. Indicator ID:<value>"

Wenn ein anderer Statuscode gemeldet wird (is_success=false): „Action wasn't able to list available detectors“

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

Wenn ein schwerwiegender Fehler, ein SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server oder ein anderer Fehler gemeldet wird: „Fehler beim Ausführen der Aktion ‚Detektoren auflisten‘. Reason: {0}''.format(error.Stacktrace)

Allgemein

Ergebnisse für einen Detektor auflisten

Listet alle Amazon GuardDuty-Ergebnisse für die angegebene Detektor-ID auf.

Parameter

Parametername Typ Standardwert Ist obligatorisch Beschreibung
Detektor-ID String – Ja Die eindeutige ID des Detektors, den Sie abrufen möchten.
Maximale Anzahl zurückzugebender Ergebnisse Ganzzahl 50 Nein Geben Sie die Anzahl der zurückzugebenden Detektoren an.
Sortieren nach String – Nein Stellt das Ergebnisattribut dar, nach dem Ergebnisse sortiert werden sollen, z. B. accountId.
Sortieren nach DDL

ASC

Mögliche Werte:

  • ASC
  • DESC
Nein Die Reihenfolge, in der die sortierten Ergebnisse angezeigt werden sollen.
AWS-Region String – Nein Geben Sie optional die AWS-Region an, die in der Aktion verwendet werden soll. Diese kann sich von der Standardregion unterscheiden, die auf der Konfigurationsseite der Integration angegeben ist.

Ausführen am

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

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success True oder False is_success=False
JSON-Ergebnis
{"FindingIds": ["10ba96ae50733ae38b9cae95431b7558"]}
Fall-Repository
Ergebnistyp Beschreibung Typ
Ausgabenachricht*

Die Aktion sollte nicht fehlschlagen und die Ausführung eines Playbooks stoppen:

Wenn „ErrorCode“ gemeldet wird (is_success=false): „Action wasn't able to get findings for <detector ID> detector. Error: {}".format(ErrorMessage)"

Bei Erfolg: „Successfully retrieved available findings IDs for detector {detector ID}“

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

Wenn ein schwerwiegender Fehler oder ein SDK-Fehler wie falsche Anmeldedaten, keine Verbindung oder ein anderer Fehler gemeldet wird: „Fehler beim Ausführen der Aktion ‚Ergebnisse für einen Detektor auflisten‘. Reason: {0}''.format(error.Stacktrace)

Allgemein

Ergebnisse archivieren

GuardDuty-Ergebnisse archivieren, die durch Ergebnis-IDs angegeben sind.

Parameter

Parametername Typ Standardwert Ist obligatorisch Beschreibung
Ergebnis-IDs String – Ja

Die IDs der Ergebnisse, die Sie abrufen möchten.

Kommagetrennte IDs.

Detektor-ID String – Ja Die eindeutige ID des Detektors
AWS-Region String – Nein Optional können Sie die AWS-Region angeben, die in der Aktion verwendet werden soll. Diese kann sich von der Standardregion unterscheiden, die auf der Konfigurationsseite der Integration angegeben ist.

AWS-IAM-Richtlinienberechtigung:

  • Auswirkung: Zulassen
  • Aktion: guardduty:ArchiveFindings

Nur das Administratorkonto kann Ergebnisse archivieren. Mitgliedskonten sind nicht berechtigt, Ergebnisse aus ihren Konten zu archivieren.

Ausführen am

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

Aktionsergebnisse

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

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

Wenn „ErrorCode“ gemeldet wird (is_success=false): „Die Aktion konnte die Ergebnisse nicht archivieren. Error: {}".format(ErrorMessage). Prüfen Sie, ob alle Ergebnis-IDs korrekt sind.“

Bei Erfolg: „Ergebnisse wurden archiviert“ → Geändert in: „Die folgenden Ergebnisse wurden archiviert: <IDs>“

Wenn eine oder alle Ergebnis-IDs ungültig sind, sollte die Aktion nicht fehlschlagen, aber „is_success“ sollte auf „false“ gesetzt werden: „Die folgenden Ergebnisse konnten nicht archiviert werden: <ids>“

Hinweis: Der Fehlercode darf nicht für eine der IDs gelten. Wenn die Ergebnis-ID falsch ist, wird eine Ausnahme mit dem folgenden Fehler ausgelöst: „Beim Aufrufen des Vorgangs ‚ArchiveFindings‘ (maximale Anzahl von Wiederholungen erreicht: 4): Interner Serverfehler.“

Gleiches gilt hier:Prüfen Sie zuerst, ob das Ergebnis gültig ist.

Die folgenden Ergebnisse wurden archiviert: 88bac20f959084244a2b91778d12e883

Die folgenden Ergebnisse konnten nicht archiviert werden: 1abac689941ae6f3e3e24d02ac4cf612

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

Eine ungültige Detektor-ID sollte ebenfalls eine Ausnahme auslösen, das Playbook beenden und „is_success“ auf „false“ setzen.

Wenn ein schwerwiegender Fehler oder ein SDK-Fehler wie falsche Anmeldedaten, keine Verbindung oder ein anderer Fehler gemeldet wird: „Fehler beim Ausführen der Aktion ‚Ergebnisse archivieren‘. Reason: {0}''.format(error.Stacktrace)"

Allgemein

Ergebnisse aus dem Archiv wiederherstellen

GuardDuty-Ergebnisse extrahieren, die durch Ergebnis-IDs angegeben sind.

Parameter

Parametername Typ Standardwert Ist obligatorisch Beschreibung
Ergebnis-IDs String – Ja Die IDs der Ergebnisse, die Sie abrufen möchten. CSV.
Detektor-ID String – Ja Die eindeutige ID des Detektors.

AWS-IAM-Richtlinienberechtigung:

  • Auswirkung: Zulassen
  • Aktion: guardduty:UnarchiveFindings

Nur das Administratorkonto kann Ergebnisse archivieren. Mitgliedskonten sind nicht berechtigt, Ergebnisse aus ihren Konten zu archivieren.

Ausführen am

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

Aktionsergebnisse

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

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

Bei Erfolg: „Die folgenden Ergebnisse wurden archiviert: <IDs>“

Wenn eine oder alle Ergebnis-IDs ungültig sind, sollte die Aktion nicht fehlschlagen, aber „is_success“ sollte auf „false“ gesetzt werden: „Die folgenden Ergebnisse konnten nicht aus dem Archiv entfernt werden: <ids>

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

Eine ungültige Detektor-ID sollte ebenfalls eine Ausnahme auslösen, das Playbook stoppen und „is_success“ auf „false“ setzen.

Wenn ein schwerwiegender Fehler oder ein SDK-Fehler wie falsche Anmeldedaten, keine Verbindung oder ein anderer Fehler gemeldet wird: „Fehler beim Ausführen der Aktion ‚Ergebnisse aus dem Archiv holen‘. Reason: {0}''.format(error.Stacktrace)"

Hinweis: Der Fehlercode darf nicht für eine der IDs gelten. Wenn die Ergebnis-ID falsch ist, wird eine Ausnahme mit dem folgenden Fehler ausgelöst: „Beim Aufrufen des Vorgangs ‚ArchiveFindings‘ (maximale Anzahl von Wiederholungen erreicht: 4): Interner Serverfehler.“

Gleiches gilt hier: Prüfen Sie zuerst, ob das Ergebnis gültig ist.

Die folgenden Ergebnisse wurden archiviert: 88bac20f959084244a2b91778d12e883

Die folgenden Ergebnisse konnten nicht archiviert werden: 1abac689941ae6f3e3e24d02ac4cf612

Allgemein

Beispielergebnisse erstellen

Generiert Beispielergebnisse der Typen, die in der Liste der Ergebnisse angegeben sind.

Parameter

Parametername Typ Standardwert Ist obligatorisch Beschreibung
Detektor-ID String – Ja Die eindeutige ID des Detektors, für den Beispielergebnisse erstellt werden sollen.
Ergebnistypen String – Nein

Die Typen der zu generierenden Beispielergebnisse. CSV.

Die Typen finden Sie in der Benutzeroberfläche im Bereich „Ergebnisse“ in der Spalte „Ergebnistyp“.

Ausführen am

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

Aktionsergebnisse

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

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

Wenn „ErrorCode“ gemeldet wird (is_success=false): „Die Aktion konnte keine Beispielergebnisse erstellen. Error: {}".format(ErrorMessage)"

Bei Erfolg: „Beispielergebnisse wurden erstellt“

Wenn eine der Eingaben (Ergebnistypen) ungültig ist, fangen Sie die folgende Ausnahme ab: „Die Anfrage wird abgelehnt, weil ein ungültiger oder außerhalb des Bereichs liegender Wert als Eingabeparameter angegeben wurde.“ set, is_sucess=false: „Die Aktion konnte keine Beispielergebnisse erstellen, da ein ungültiger Wert als Parameter für Ergebnistypen gefunden wurde.

Aktualisiert: Bei einem ungültigen Ergebnistyp sollte die Aktion mit dieser Meldung fehlschlagen: „Die Aktion konnte keine Beispielergebnisse erstellen, da ein ungültiger Wert als Parameter für Ergebnistypen gefunden wurde. Fehler: <traceback>

  • ungültiger Ergebnistyp + ungültiger Detektor → Aktion sollte fehlschlagen, is_success=false
  • Mehrere Ergebnisse – ungültig + ungültig – Aktion schlägt trotzdem fehl!

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

Eine ungültige Detektor-ID sollte ebenfalls eine Ausnahme auslösen, das Playbook stoppen und „is_success“ auf „false“ setzen.

Wenn ein schwerwiegender Fehler, SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung oder ein anderer Fehler gemeldet wird: „Fehler beim Ausführen der Aktion ‚Beispielergebnisse erstellen‘. Reason: {0}''.format(error.Stacktrace)

Allgemein

Feedback zu Ergebnissen aktualisieren

Markieren Sie die angegebenen Amazon GuardDuty-Ergebnisse als nützlich oder nicht nützlich.

Parameter

Parametername Typ Standardwert Ist obligatorisch Beschreibung
Detektor-ID String – Ja Die eindeutige ID des Detektors, der mit den Ergebnissen verknüpft ist, für die das Feedback aktualisiert werden soll.
Nützlich? Kästchen Deaktiviert Ja Das Feedback zum Ergebnis.
Ergebnis-IDs String – Ja Die IDs der Ergebnisse, die Sie als nützlich oder nicht nützlich markieren möchten. CSV.
Kommentar String – Nein Zusätzliches Feedback zu den GuardDuty-Ergebnissen.
AWS-Region String – Nein Geben Sie optional die AWS-Region an, die in der Aktion verwendet werden soll. Diese kann sich von der Standardregion unterscheiden, die auf der Konfigurationsseite der Integration angegeben ist.

Ausführen am

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

Aktionsergebnisse

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

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

Wenn „ErrorCode“ gemeldet wird (is_success=false): „Action wasn't able to update findings feedback. Error: {}".format(ErrorMessage)

Bei Erfolg: „Findings feedback was updated.“

Wenn für eine der Ergebnis-IDs ein Fehler auftritt oder sie nicht gefunden wird, wird trotzdem eine leere Antwort zurückgegeben, obwohl eine der IDs nicht vorhanden ist.

Wenn keine Ergebnisse gefunden werden: „Feedback kann nicht aktualisiert werden. <finding id> ist ungültig.“

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

Eine ungültige Detektor-ID sollte ebenfalls eine Ausnahme auslösen, das Playbook beenden und „is_success“ auf „false“ setzen.

Wenn ein schwerwiegender Fehler oder ein SDK-Fehler wie falsche Anmeldedaten, keine Verbindung oder ein anderer Fehler gemeldet wird: „Fehler beim Ausführen der Aktion ‚Feedback zu Ergebnissen aktualisieren‘. Reason: {0}''.format(error.Stacktrace)"

Allgemein

Liste vertrauenswürdiger IP-Adressen löschen

Löscht das durch die ID angegebene IPSet.

Parameter

Parametername Typ Standardwert Ist obligatorisch Beschreibung
Detektor-ID String – Ja

Geben Sie die Detektor-ID an, die zum Löschen eines IP-Sets verwendet werden soll.

Diesen Parameter finden Sie auf dem Tab Einstellungen.

IDs der Liste vertrauenswürdiger IP-Adressen String – Ja

Geben Sie die durch Kommas getrennte Liste der IDs von IP-Sätzen an.

Beispiel: id_1,id_2

Ausführen am

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

Aktionsergebnisse

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

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

Bei Erfolg (is_success=true): „Die folgenden Listen vertrauenswürdiger IP-Adressen wurden gelöscht: <ids>“

Wenn die Aktion für einige der IDs nicht erfolgreich war (is_success=true): „Die Aktion konnte die folgenden vertrauenswürdigen IP-Listen nicht aus Amazon GuardDuty löschen:\n{0}.“.format(list_of_ids)“

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

Eine ungültige Detektor-ID sollte ebenfalls eine Ausnahme auslösen, das Playbook beenden und „is_success“ auf „false“ setzen.

Wenn ein schwerwiegender Fehler, SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server oder ein anderer Fehler gemeldet wird: „Fehler beim Ausführen der Aktion ‚Liste vertrauenswürdiger IP-Adressen löschen‘. Reason: {0}''.format(error.Stacktrace"

Allgemein

Ergebnisdetails abrufen

Detaillierte Informationen zu einem Ergebnis in AWS Guard Duty zurückgeben.

Parameter

Parametername Typ Standardwert Ist obligatorisch Beschreibung
Ergebnis-IDs String – Ja

Die IDs der Ergebnisse, die Sie abrufen möchten. Kommagetrennte IDs.

Detektor-ID String – Ja Die eindeutige ID des Detektors, den Sie abrufen möchten.
AWS-Region String – Nein Geben Sie optional die AWS-Region an, die in der Aktion verwendet werden soll. Diese kann sich von der Standardregion unterscheiden, die auf der Konfigurationsseite der Integration angegeben ist.

Ausführen am

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

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success True oder False is_success=False
JSON-Ergebnis
{
    "Findings": [{
        "AccountId": "ACCOUNT_ID",
        "Arn": "arn:aws:guardduty:us-east-1:ACCOUNT_ID:detector/DETECTOR_ID/finding/FINDING_ID",
        "CreatedAt": "2020-10-06T05:19:50.794Z",
        "Description": "203.0.113.9 is performing RDP brute force attacks against i-INSTANCE_ID. Brute force attacks are used to gain unauthorized access to your instance by guessing the RDP password.", "Id": "ID",
        "Partition": "aws",
        "Region": "us-east-1",
        "Resource": {
            "InstanceDetails": {
                "AvailabilityZone": "us-east-1e",
                "ImageId": "ami-IMAGE_ID",
                "InstanceId": "i-INSTANCE_ID",
                "InstanceState": "running",
                "InstanceType": "t2.micro",
                "LaunchTime": "2020-05-27T08:54:03Z", "NetworkInterfaces": [{
                    "Ipv6Addresses": [],
                    "NetworkInterfaceId": "eni-012d9b8a1a3b4e40a",
                    "PrivateDnsName": "ip-192.0.2.1.ec2.internal",
                    "PrivateIpAddress": "192.0.2.1",
                    "PrivateIpAddresses": [{
                        "PrivateDnsName": "ip-192.0.2.1.ec2.internal",
                        "PrivateIpAddress": "192.0.2.1"
                    }],
                    "PublicDnsName": "ec2-54-234-69-236.compute-1.amazonaws.com",
                    "PublicIp": "198.51.100.236",
                    "SecurityGroups": [{
                        "GroupId": "sg-0fa42e04e9cd15407",
                        "GroupName": "Windows Server 2016"
                    }],
                    "SubnetId": "subnet-2edddf10",
                    "VpcId": "vpc-48a7ac32"
                }],
                "Platform": "windows",
                "ProductCodes": [],
                "Tags": [{
                    "Key": "Name",
                    "Value": "CiscoAMP-win2012"
                }]},
            "ResourceType": "Instance"
        },
        "SchemaVersion": "2.0",
        "Service": {
            "Action": {
                "ActionType": "NETWORK_CONNECTION", "NetworkConnectionAction": {
                    "Blocked": false,
                    "ConnectionDirection": "INBOUND",
                    "LocalPortDetails": {
                        "Port": 3389, "PortName": "RDP"
                    },
                    "Protocol": "TCP",
                    "LocalIpDetails": {
                        "IpAddressV4": "192.0.2.1"
                    },
                    "RemoteIpDetails": {
                        "IpAddressV4": "203.0.113.9",
                        "Organization": {
                            "Asn": "24875",
                            "AsnOrg": "Example Inc.",
                            "Isp": "Example Inc.",
                            "Org": "Example Inc."
                        }},
                    "RemotePortDetails": {
                            "Port": 1549,
                        "PortName": "Unknown"
                    }}},
            "Archived": false,
            "Count": 5,
            "DetectorId": "DETECTOR_ID",
            "EventFirstSeen": "2020-10-06T05:10:58Z",
            "EventLastSeen": "2020-10-06T05:46:59Z",
            "ResourceRole": "TARGET",
            "ServiceName": "guardduty"
        },
        "Severity": 2,
        "Title": "203.0.113.9 is performing RDP brute force attacks against i-INSTANCE_ID.",
        "Type": "UnauthorizedAccess:EC2/RDPBruteForce",
        "UpdatedAt": "2020-10-06T06:01:46.380Z"
    }]
}
Fall-Repository
Ergebnistyp Beschreibung Typ
Ausgabenachricht*

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

Wenn „ErrorCode“ gemeldet wird (is_success=false): „Die Aktion konnte keine Details zu den Ergebnissen abrufen. Error: {}".format(ErrorMessage)"

Bei Erfolg: „Informationen für die folgenden Ergebnisse wurden erfolgreich abgerufen: <abgerufene Ergebnis-IDs>“

Wenn für eine der IDs ein Fehler gemeldet wird, enthält das Antwortobjekt nur Ergebnisse für die fehlerfreien IDs. Prüfen Sie, ob im Antwortobjekt einige der IDs fehlen, und geben Sie eine entsprechende Meldung aus.

E.g. data = ['4cba8180b5959ae56a3be24cc722aaaa', '6eba7eae0e24ffe28a4109f2594febff', '24ba6761dc4cf85cfc292bbadd1c2655']

The first ID does not exist, therefore I will not get a result for that one. Output message:

"Successfully retrieved information for the following findings: 6eba7eae0e24ffe28a4109f2594febff,24ba6761dc4cf85cfc292bbadd1c2655. Failed to retrieve information for the following findings: 4cba8180b5959ae56a3be24cc722aaaa

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

Wenn ein schwerwiegender Fehler, SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung oder ein anderer Fehler gemeldet wird: „Fehler beim Ausführen der Aktion ‚Ergebnisse abrufen‘. Reason: {0}''.format(error.Stacktrace)"

Allgemein
Tabelle mit Fall-Repository

Hinweis: Falls vorhanden.

Tabellenspalten:

  • Ergebnis-ID
  • Titel
  • Beschreibung
  • Typ
  • Schweregrad
  • Anzahl
  • Ressourcen-ID
  • Erstellt am
  • Aktualisiert am
  • Konto-ID
Allgemein

Alle Listen vertrauenswürdiger IP-Adressen abrufen

Beschreibung

Rufen Sie alle vertrauenswürdigen IP-Listen (IPSets) des GuardDuty-Dienstes ab, die durch die Detektor-ID angegeben sind.

Parameter

Parametername Typ Standardwert Ist obligatorisch Beschreibung
Detektor-ID String – Ja

Geben Sie die Detektor-ID an, die zum Auflisten von IP-Sätzen verwendet werden soll.

Diesen Parameter finden Sie auf dem Tab „Einstellungen“.

Maximale Anzahl zurückzugebender vertrauenswürdiger IP-Listen Ganzzahl 50 Nein Geben Sie die Anzahl der Listen vertrauenswürdiger IP-Adressen an, die zurückgegeben werden sollen.
AWS-Region String – Nein Geben Sie optional die AWS-Region an, die in der Aktion verwendet werden soll. Diese kann sich von der Standardregion unterscheiden, die auf der Konfigurationsseite der Integration angegeben ist.

Ausführen am

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

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success True oder False is_success=False
JSON-Ergebnis
{
    "IpSetIds": ['', '' , '']
}
Fall-Repository
Ergebnistyp Beschreibung Typ
Ausgabenachricht*

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

Wenn die verfügbaren Sätze erfolgreich aufgelistet wurden (is_success=true): „Verfügbare Listen vertrauenswürdiger IP-Adressen wurden erfolgreich abgerufen.“

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

Wenn ein schwerwiegender Fehler oder ein SDK-Fehler wie falsche Anmeldedaten, keine Verbindung zum Server oder ein anderer Fehler gemeldet wird: „Fehler beim Ausführen der Aktion ‚Alle vertrauenswürdigen IP-Listen abrufen‘. Reason: {0}''.format(error.Stacktrace)

Allgemein

Liste vertrauenswürdiger IP-Adressen abrufen

Beschreibung

Details zu einer Liste vertrauenswürdiger IP-Adressen in Amazon GuardDuty abrufen.

Parameter

Parametername Typ Standardwert Ist obligatorisch Beschreibung
Detektor-ID String – Ja

Geben Sie die Detektor-ID an, die zum Abrufen eines IP-Satzes verwendet werden soll.

Diesen Parameter finden Sie auf dem Tab „Einstellungen“.

IDs der Liste vertrauenswürdiger IP-Adressen CSV – Ja

Geben Sie die durch Kommas getrennte Liste der IDs für IP-Sets an, z. B. id_1,id_2.

Ausführen am

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

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success True oder False is_success=False
JSON-Ergebnis
{
    "ip_set_id": {
        "Format": "response['Format']",
        "Location": "response['Location']",
        "Name": "response['Name']",
        "Status": "response['Status']"
        }
}
Fall-Repository
Ergebnistyp Beschreibung Typ
Ausgabenachricht*

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

Wenn Details erfolgreich zurückgegeben wurden (is_success=true): „Successfully retrieved details about the following Trusted IP Lists from Amazon GuardDuty:\n{0}.“.format(list_of_ids)“

Wenn für einige der IDs nicht erfolgreich (is_success=true): „Die Aktion konnte keine Details zu den folgenden vertrauenswürdigen IP-Listen von Amazon GuardDuty abrufen:\n{0}.“.format(list_of_ids)

Wenn keine IDs verwendet werden (is_success=false): „No details were retrieved about the provided Trusted IP Lists“.format(list_of_ids)“

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

Wenn ein schwerwiegender Fehler oder ein SDK-Fehler wie falsche Anmeldedaten, keine Verbindung zum Server oder ein anderer Fehler gemeldet wird: „Fehler beim Ausführen der Aktion ‚Vertrauenswürdige IP-Listen auflisten‘. Reason: {0}''.format(error.Stacktrace)

Allgemein
CSV

Tabellenname: Details zu vertrauenswürdigen IP-Listen

Tabellenspalten:

  • Name (zugeordnet als Name)
  • ID der Liste vertrauenswürdiger IP-Adressen (aus Aktionsparameter)
  • Standort (als Standort zugeordnet)
  • Status (zugeordnet als Status)
Allgemein

Liste vertrauenswürdiger IP-Adressen aktualisieren

Beschreibung

Aktualisieren Sie eine Liste vertrauenswürdiger IP-Adressen in Amazon GuardDuty.

Parameter

Parametername Typ Standardwert Ist obligatorisch Beschreibung
Detektor-ID String – Ja

Geben Sie die Detektor-ID an, die zum Aktualisieren einer Liste vertrauenswürdiger IP-Adressen verwendet werden soll.

Diesen Parameter finden Sie auf dem Tab „Einstellungen“.

ID der Liste vertrauenswürdiger IP-Adressen String – Ja Geben Sie die ID der Liste vertrauenswürdiger IP-Adressen an, die aktualisiert werden soll.
Name String – Nein Geben Sie den neuen Namen der Liste vertrauenswürdiger IP-Adressen an.
Dateispeicherort String https://s3.amazonaws.com/{bucket-name}/file.txt Nein Geben Sie einen neuen URI-Speicherort an, an dem sich die Datei befindet.
Aktivieren Kästchen Aktiviert Ja Wenn diese Option aktiviert ist, wird die Liste vertrauenswürdiger IP-Adressen aktiviert.
AWS-Region String – Nein Geben Sie optional die AWS-Region an, die in der Aktion verwendet werden soll. Diese kann sich von der Standardregion unterscheiden, die auf der Konfigurationsseite der Integration angegeben ist.

Ausführen am

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

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success True oder False is_success=False
JSON-Ergebnis
N/A
Fall-Repository
Ergebnistyp Beschreibung Typ
Ausgabenachricht*

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

Wenn ein Set erfolgreich aktualisiert wurde (is_success=true): „Die Liste der vertrauenswürdigen IP-Adressen ‚{0}‘ in Amazon GuardDuty wurde aktualisiert.“ (Threat ID)

Wenn die Aktualisierung eines Sets fehlschlägt (is_success=false): „Die Aktion konnte die Liste der vertrauenswürdigen IP-Adressen ‚{0}‘ in Amazon GuardDuty nicht aktualisieren.“ (Threat ID)

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

Wenn ein schwerwiegender Fehler oder ein SDK-Fehler gemeldet wird, z. B. falsche Anmeldedaten, keine Verbindung zum Server oder ein anderer Fehler: „Fehler beim Ausführen der Aktion ‚Liste vertrauenswürdiger IP-Adressen aktualisieren‘. Reason: {0}''.format(error.Stacktrace)

Allgemein

Liste vertrauenswürdiger IP-Adressen erstellen

Erstellt eine neue Liste vertrauenswürdiger IP-Adressen (IPSet), die in der dynamischen Liste für die sichere Kommunikation mit der AWS-Infrastruktur und den AWS-Anwendungen enthalten waren.

GuardDuty generiert keine Ergebnisse für IP-Adressen, die in IPSets enthalten sind. Nur Nutzer des Administratorkontos können diesen Vorgang verwenden.

Parameter

Parametername Typ Standardwert Ist obligatorisch Beschreibung
Detektor-ID String – Ja

Geben Sie die Detektor-ID an, die zum Erstellen einer Liste vertrauenswürdiger IP-Adressen verwendet werden soll.

Diesen Parameter finden Sie auf dem Tab Einstellungen.

Name String – Ja Geben Sie den Namen der Liste vertrauenswürdiger IP-Adressen an.
Dateiformat DDL Klartext Ja

Wählen Sie das Format der Datei aus, die zum Erstellen einer Liste vertrauenswürdiger IP-Adressen verwendet werden soll.

Mögliche Werte:

  • Klartext-STIX (Structured Threat Information Expression)
  • Open Threat Exchange (OTX) CSV
  • FireEye iSIGHT Threat Intelligence CSV
  • Proofpoint ET Intelligence Feed CSV
  • AlienVault Reputation Feed
Dateispeicherort String https://s3.amazonaws.com/{bucket-name}/file.txt Ja Geben Sie den URI-Speicherort der Datei an.
Aktivieren Kästchen Aktiviert Ja Wenn diese Option aktiviert ist, wird die neu erstellte Liste vertrauenswürdiger IP-Adressen aktiviert.
AWS-Region String – Nein Geben Sie optional die AWS-Region an, die in der Aktion verwendet werden soll. Diese kann sich von der Standardregion unterscheiden, die auf der Konfigurationsseite der Integration angegeben ist.

Ausführen am

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

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success True oder False is_success=False
JSON-Ergebnis
{
    "TrustedIPID": "TRUSTED_IP_ID"
}
Fall-Repository
Ergebnistyp Beschreibung Typ
Ausgabenachricht*

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

Wenn ein Set erfolgreich erstellt wurde (is_success=true): „Successfully created new Trusted IP List '{0}' in Amazon GuardDuty.“ format(Name)“

Wenn das Erstellen einer Gruppe fehlschlägt (is_success=false): „Action wasn't able to create new Trusted IP List '{0}' in Amazon GuardDuty.“ format(name)“

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

Wenn ein schwerwiegender Fehler oder ein SDK-Fehler wie falsche Anmeldedaten, keine Verbindung zum Server oder ein anderer Fehler gemeldet wird: „Fehler beim Ausführen der Aktion ‚Liste vertrauenswürdiger IP-Adressen erstellen‘. Reason: {0}''.format(error.Stacktrace)"

Allgemein

Threat Intelligence-Sets auflisten

Verfügbare Threat Intelligence-Sets in Amazon GuardDuty auflisten.

Parameter

Parametername Typ Standardwert Ist obligatorisch Beschreibung
Detektor-ID String – Ja

Geben Sie die Detektor-ID an, die zum Auflisten von Threat Intelligence-Sets verwendet werden soll.

Diesen Parameter finden Sie auf dem Tab „Einstellungen“.

Maximale Anzahl der zurückzugebenden Threat Intelligence-Sets Ganzzahl 50 Nein Geben Sie die Anzahl der Threat Intelligence-Sets an, die zurückgegeben werden sollen.
AWS-Region String – Nein Geben Sie optional die AWS-Region an, die in der Aktion verwendet werden soll. Diese kann sich von der Standardregion unterscheiden, die auf der Konfigurationsseite der Integration angegeben ist.

Ausführen am

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

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success True oder False is_success=False
JSON-Ergebnis
{
    "ThreatIntelSetIds": ["14ba8b942b76c1be6d985715eb7443eb",
                       "32ba8b92e553fe04d06dab543ed57a70",
                       "8aba8b93ba6e08e8fd5349b2c2b57709"
                       ]
}
Fall-Repository
Ergebnistyp Beschreibung Typ
Ausgabenachricht*

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

Wenn verfügbare Sets erfolgreich aufgelistet wurden (is_success=true): „Verfügbare Threat Intelligence-Sets wurden erfolgreich aufgelistet.“

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

Wenn ein schwerwiegender Fehler, ein SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server oder ein anderer Fehler gemeldet wird: „Fehler beim Ausführen der Aktion ‚Threat Intelligence-Sets auflisten‘. Reason: {0}''.format(error.Stacktrace)

Allgemein

Details zum Threat Intelligence-Set abrufen

Details zu einem Threat Intelligence-Set in Amazon GuardDuty abrufen.

Parameter

Parametername Typ Standardwert Ist obligatorisch Beschreibung
Detektor-ID String – Ja

Geben Sie die Detektor-ID an, die zum Abrufen von Details zu Threat Intelligence-Sets verwendet werden soll.

Diesen Parameter finden Sie auf dem Tab „Einstellungen“.

Threat Intelligence-Set-IDs String 50 Ja

Geben Sie die durch Kommas getrennte Liste der IDs von Threat Intelligence-Sets an.

Beispiel: id_1,id_2

AWS-Region String – Nein Geben Sie optional die AWS-Region an, die in der Aktion verwendet werden soll. Diese kann sich von der Standardregion unterscheiden, die auf der Konfigurationsseite der Integration angegeben ist.

Ausführen am

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

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success True oder False is_success=False
JSON-Ergebnis
{
    "Format": "TXT",
    "Location": "https: //example.s3.amazonaws.com/test.txt",
    "Name": "API Test",
    "ResponseMetadata": {
        "HTTPHeaders": {
            "connection": "keep-alive",
            "content-length": "149",
            "content-type": "application/json",
            "date": "Mon,19 Oct 2020 06: 23: 22 GMT",
            "x-amz-apigw-id": "ID",
            "x-amzn-requestid": "REQUEST_ID",
            "x-amzn-trace-id": "TRACE_ID"
        },
        "HTTPStatusCode": 200,
        "RequestId": "REQUEST_ID",
        "RetryAttempts": 0
    },
    "Status": "ERROR",
    "Tags": {}
}
Fall-Repository
Ergebnistyp Beschreibung Typ
Ausgabenachricht*

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

Wenn Details zu mindestens einem Set erfolgreich zurückgegeben wurden (is_success=true): "Successfully retrieved details about the following Threat Intelligence Sets from Amazon GuardDuty:\n{0}.".format(list_of_ids)"

Wenn die Aktion für einige der IDs nicht erfolgreich war (is_success=true): „Die Aktion konnte keine Details zu den folgenden Threat Intelligence-Sets von Amazon GuardDuty abrufen:\n{0}.“.format(list_of_ids)“

Wenn keine IDs verwendet werden: „No details were retrieved about the provided Threat Intelligence Sets.“ format(list_of_ids)

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

Wenn ein schwerwiegender Fehler, ein SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server oder ein anderer Fehler gemeldet wird: „Fehler beim Ausführen der Aktion ‚Threat Intelligence-Sets auflisten‘. Reason: {0}''.format(error.Stacktrace)

Allgemein
CSV

Tabellenname: Threat Intelligence-Set-Details

Tabellenspalte:

  • Name (zugeordnet als Name)
  • ID (aus Aktionsparameter)
  • Standort (als Standort zugeordnet)
  • Status (zugeordnet als Status)

Threat Intelligence-Satz erstellen

Erstellen Sie in Amazon GuardDuty einen Threat-Intelligence-Satz.

Parameter

Parametername Typ Standardwert Ist obligatorisch Beschreibung
Detektor-ID String – Ja

Geben Sie die Detektor-ID an, die zum Erstellen eines Threat Intelligence-Sets verwendet werden soll.

Diesen Parameter finden Sie auf dem Tab „Einstellungen“.

Name String – Ja Geben Sie den Namen des Threat Intelligence-Sets an.
Dateiformat DDL

Klartext

Mögliche Werte:

  • Klartext
  • Structured Threat Information Expression (STIX)
  • Open Threat Exchange (OTX) CSV
  • FireEye iSIGHT Threat Intelligence CSV
  • Proofpoint ET Intelligence Feed CSV
  • AlienVault Reputation Feed
Ja Wählen Sie das Format der Datei aus, die zum Erstellen eines Threat Intelligence-Sets verwendet wird.
Dateispeicherort String https://s3.amazonaws.com/{bucket-name}/file.txt Ja Geben Sie den URI-Speicherort an, an dem sich die Datei befindet.
Aktiv Kästchen Aktiviert Ja Wenn diese Option aktiviert ist, wird der neu erstellte Threat Intelligence-Satz aktiviert.
Tags CSV – Nein

Geben Sie zusätzliche Tags an, die dem Threat Intelligence-Set hinzugefügt werden sollen.

Format: key_1:value_1,key_2:value_1

Ausführen am

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

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success True oder False is_success=False
JSON-Ergebnis
{
    "ThreatIntelSetId": "b6f0c884a54449cc8e29eed3094e9c31"
}
Fall-Repository
Ergebnistyp Beschreibung Typ
Ausgabenachricht*

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

Wenn ein Set erfolgreich erstellt wurde (is_success=true): „Successfully created the Threat Intelligence Set '{0}' in Amazon GuardDuty.“ format(Name)

Wenn das Erstellen eines Sets nicht erfolgreich war (is_success=false): „Action wasn't able to create the Threat Intelligence Set '{0}' in Amazon GuardDuty.“ .format(name)

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

Wenn ein schwerwiegender Fehler oder ein SDK-Fehler wie falsche Anmeldedaten, keine Verbindung zum Server oder ein anderer Fehler gemeldet wird: „Fehler beim Ausführen der Aktion ‚Threat Intelligence-Set erstellen‘. Reason: {0}''.format(error.Stacktrace)

Allgemein

Threat Intelligence-Set aktualisieren

Threat Intelligence-Set in Amazon GuardDuty aktualisieren.

Parameter

Parametername Typ Standardwert Ist obligatorisch Beschreibung
Detektor-ID String – Ja

Geben Sie die Detektor-ID an, die zum Aktualisieren eines Threat Intelligence-Sets verwendet werden soll.

Diesen Parameter finden Sie auf dem Tab Einstellungen.

ID String – Ja Geben Sie die ID des Threat Intelligence-Sets an, das aktualisiert werden soll.
Name String – Nein Geben Sie den neuen Namen des Threat Intelligence-Sets an.
Dateispeicherort String https://s3.amazonaws.com/{bucket-name}/file.txt Nein Geben Sie einen neuen URI-Speicherort an, an dem sich die Datei befindet.
Aktiv Kästchen Aktiviert Ja Wenn diese Option aktiviert ist, wird der Threat Intelligence-Satz aktiviert.

Ausführen am

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

Aktionsergebnisse

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

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

Wenn ein Set erfolgreich aktualisiert wurde (is_success=true): "Successfully updated the Threat Intelligence Set '{0}' in Amazon GuardDuty.".format(Threat ID)

Wenn ein Set nicht aktualisiert werden konnte (is_success=false): „Action wasn't able to update the Threat Intelligence Set '{0}' in Amazon GuardDuty.“ (Threat ID)

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

Wenn ein schwerwiegender Fehler, SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server oder ein anderer Fehler gemeldet wird: „Fehler beim Ausführen der Aktion ‚Threat Intelligence-Set aktualisieren‘. Reason: {0}''.format(error.Stacktrace)

Allgemein

Threat Intelligence-Satz löschen

Threat Intelligence-Satz in Amazon GuardDuty löschen.

Parameter

Parametername Typ Standardwert Wasserzeichen Ist obligatorisch Beschreibung
Detektor-ID String – – Ja

Geben Sie die Detektor-ID an, die zum Abrufen von Details zu Threat Intelligence-Sets verwendet werden soll.

Diesen Parameter finden Sie auf dem Tab „Einstellungen“.

Threat Intelligence-Set-IDs CSV – – Ja

Geben Sie die durch Kommas getrennte Liste der IDs von Threat Intelligence-Sets an.

Beispiel: id_1,id_2

Ausführen am

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

Aktionsergebnisse

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

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

Wenn Details zu mindestens einem Set erfolgreich zurückgegeben wurden (is_success=true): „Die folgenden Threat Intelligence-Sets wurden in Amazon GuardDuty gelöscht:\n{0}.“.format(list_of_ids)

Wenn die Aktion für einige der IDs nicht erfolgreich war (is_success=true): "Action wasn't able to delete the following Threat Intelligence Sets in Amazon GuardDuty:\n{0}.".format(list_of_ids)

Wenn keine IDs verwendet werden: „No Threat Intelligence Sets were deleted.“.format(list_of_ids)

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

Eine ungültige Detektor-ID sollte ebenfalls eine Ausnahme auslösen, das Playbook beenden und „is_success“ auf „false“ setzen.

Bei einem schwerwiegenden Fehler, SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Threat Intelligence-Sets löschen‘. Reason: {0}''.format(error.Stacktrace)

Allgemein

Connectors

Weitere Informationen zum Konfigurieren von Connectors in Google SecOps finden Sie unter Daten aufnehmen (Connectors).

AWS GuardDuty – Findings Connector

Ergebnisse aus Amazon GuardDuty abrufen.

Connector-Eingaben

Verwenden Sie die folgenden Parameter, um den Connector zu konfigurieren:

Parametername Typ Standardwert Ist obligatorisch Beschreibung
Produktfeldname String Produktname Ja

Der Name des Felds, in dem der Produktname gespeichert ist.

Der Produktname wirkt sich hauptsächlich auf die Zuordnung aus. Um den Zuordnungsprozess für den Connector zu optimieren und zu verbessern, wird der Standardwert in einen Fallback-Wert aufgelöst, auf den im Code verwiesen wird. Jede ungültige Eingabe für diesen Parameter wird standardmäßig in einen Fallback-Wert aufgelöst.

Der Standardwert ist Product Name.

Name des Ereignisfelds String Typ Ja

Der Name des Felds, das den Ereignisnamen (Untertyp) bestimmt.

Name des Umgebungsfelds String "" Nein

Der Name des Felds, in dem der Umgebungsname gespeichert ist.

Wenn das Feld „environment“ fehlt, verwendet der Connector den Standardwert.

Environment Regex Pattern String .* Nein

Ein reguläres Ausdrucksmuster, das für den im Feld Environment Field Name gefundenen Wert ausgeführt werden soll. Mit diesem Parameter können Sie das Umgebungsfeld mithilfe der Logik regulärer Ausdrücke bearbeiten.

Verwenden Sie den Standardwert .*, um den erforderlichen Rohwert Environment Field Name abzurufen.

Wenn das Muster des regulären Ausdrucks null oder leer ist oder der Umgebungswert null ist, ist das endgültige Umgebungsergebnis die Standardumgebung.

Zeitlimit für Script (Sekunden) Ganzzahl 180 Ja

Das Zeitlimit in Sekunden für den Python-Prozess, der das aktuelle Script ausführt.

AWS-Zugriffsschlüssel-ID String – Nein AWS-Zugriffsschlüssel-ID, die für die Integration verwendet werden soll. Lassen Sie das Feld leer, wenn Sie die Web Identity (OIDC)-Föderation von Google Cloudverwenden.
AWS Secret Key Passwort – Nein AWS-Secret-Key, der in der Integration verwendet werden soll. Lassen Sie das Feld leer, wenn Sie die Web Identity (OIDC) Federation von Google Cloud verwenden.
AWS-Standardregion String – Ja

AWS-Standardregion, die in der Integration verwendet werden soll.

Beispiel: us-west-2

Google Cloud Web Identity (OIDC) verwenden Kästchen Deaktiviert Nein Klicken Sie dieses Kästchen an, um sich sicher mit der Web Identity (OIDC) Federation von Google Cloud anstelle von statischen AWS-Anmeldedaten zu authentifizieren.
Detektor-ID String – Ja ID des Detektors. Sie finden sie auf dem Tab Einstellungen.
Niedrigster abzurufender Schweregrad Ganzzahl 1 Ja

Der niedrigste Schweregrad der abzurufenden Benachrichtigungen.

Wenn Sie diesen Parameter nicht konfigurieren, werden Benachrichtigungen mit allen Schweregraden aufgenommen.

Mögliche Werte liegen im Bereich von 1 bis 8.

Hinweis: Amazon GuardDuty ordnet den Ganzzahlwert in der folgenden Reihenfolge zu:

  • 1,2,3 – Niedrig
  • 4,5,6 – mittel
  • 7,8 – Hoch
Maximale Anzahl von Stunden rückwärts abrufen Ganzzahl 1 Nein Die Anzahl der Stunden vor dem aktuellen Zeitpunkt, für die Ergebnisse abgerufen werden sollen.

Dieser Parameter kann für die erste Connector-Iteration gelten, nachdem Sie den Connector zum ersten Mal aktiviert haben, oder für den Fallback-Wert für einen abgelaufenen Connector-Zeitstempel.

Maximale Anzahl abzurufender Ergebnisse Ganzzahl 50 Nein

Anzahl der Ergebnisse, die pro Connector-Iteration verarbeitet werden sollen.

Maximum: 50

Dies ist eine GuardDuty-Einschränkung.

Use whitelist as a blacklist Kästchen Deaktiviert Ja

Wenn diese Option ausgewählt ist, verwendet der Connector die dynamische Liste als Sperrliste.

Proxyserveradresse String – Nein Die Adresse des zu verwendenden Proxyservers.
Proxy-Nutzername String – Nein Der Proxy-Nutzername für die Authentifizierung.
Proxy-Passwort Passwort – Nein Das Proxy-Passwort für die Authentifizierung.

Connector-Regeln

Der Connector unterstützt Proxys.

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