AWS IAM Access Analyzer

In diesem Dokument wird beschrieben, wie Sie AWS IAM Access Analyzer in Google Security Operations einbinden.

Anwendungsbereiche

  1. Ergebnisse zur Untersuchung in Google Security Operations aufnehmen
  2. Aktive Aktionen – Statistiken aktualisieren, Ressourcen scannen

AWS IAM Access Analyzer-Integration in Google SecOps 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
AWS-Zugriffsschlüssel-ID String – Ja AWS-Zugriffsschlüssel-ID, die in der Integration verwendet werden soll.
AWS Secret Key Passwort – Ja AWS-Secret-Key, der in der Integration verwendet werden soll.
AWS-Standardregion String – Ja AWS-Standardregion, die in der Integration verwendet werden soll, z. B. us-west-2.
Analyzer-Name String – Ja Name des Analysators, der in der Integration verwendet werden soll.

Aktionen

Ping

Beschreibung

Testen Sie die Verbindung zu AWS IAM Access Analyzer mit den Parametern, die auf der Seite „Integrationskonfiguration“ im Google SecOps Content Hub angegeben sind.

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*

Die Aktion darf nicht fehlschlagen und die Ausführung eines Playbooks nicht beenden:
Bei Erfolg: Ausgabe „Successfully connected to the AWS IAM Access Analyzer server with the provided connection parameters!“

Die Aktion sollte fehlschlagen und die Ausführung eines Playbooks beenden:
if not successful: print "Failed to connect to the AWS IAM Access Analyzer server! Error is {0}".format(exception.stacktrace)

 Allgemein

Ressourcen scannen

Beschreibung

Ressourcen mit AWS IAM Access Analyzer scannen

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Ressourcen-ARNs CSV – Ja Geben Sie eine durch Kommas getrennte Liste der Ressourcen-ARNs an, die gescannt werden sollen.

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
JSON-Ergebnis
{"ResponseMetadata": {"HTTPHeaders": {"connection": "keep-alive",
    "content-length": "178",
    "content-type": "application/json",
    "date": "Sun, 22 Nov 2020 09:22:03 GMT",
    "x-amz-apigw-id": "WZwVQFICIAMFjnQ=",
    "x-amzn-requestid": "c15d8ab2-afc7-4cb0-bea2-a47ebc649cb8",
    "x-amzn-trace-id": "Root=1-5fba2dbb-042d89bb2964e4f635bd7843"},
"HTTPStatusCode": 200,
"RequestId": "c15d8ab2-afc7-4cb0-bea2-a47ebc649cb8",
"RetryAttempts": 0},
"resource": {"analyzedAt": datetime.datetime(2020, 11, 22, 9, 21, 50, 919000, tzinfo=tzutc()),
"isPublic": False,
"resourceArn": "arn:aws:s3:::asddsa",
"resourceOwnerAccount": "582302349248",
"resourceType": "AWS::S3::Bucket"}}
Fall-Repository
Ergebnistyp Wert / Beschreibung Typ
Ausgabenachricht*

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

Wenn Scans für mindestens eine Ressource erfolgreich zurückgegeben wurden (is_success = true) : print"Successfully scanned the following resources using AWS IAM Access Analyzer: \n".format(Resource IDs)

If fail for at least one (is_success = true): print"Action wasn't able to scan the following resources using AWS IAM Access Analyzer: \n".format(Resource IDs)

Wenn alle fehlschlagen (is_success = false): „No resources were scanned.“ ausgeben

Asynchrone Nachricht:

"Waiting for the following resources to be scanned using AWS IAM Access Analyzer: {0}".format(unprocessed resources)

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

if fatal error, SDK error, like wrong credentials, no connection to server, other: print "Error executing action "Scan Resources". Reason: {0}''.format(error.Stacktrace)

Wenn Analyzer nicht gefunden wird: Drucken Sie „Fehler beim Ausführen der Aktion ‚Ressourcen scannen‘“. Grund: Der Analysator „{0}“ wurde nicht gefunden.format(Analyzer Name).

 Allgemein

Ergebnis archivieren

Ergebnis in AWS Security Hub archivieren.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Ergebnis-ID String – Ja Geben Sie die ID des Ergebnisses an, das Sie archivieren möchten.

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*

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

Wenn keine Fehler vom SDK gemeldet werden (is_success = true) : print"Successfully archived finding with ID '{0}' in AWS IAM Access Analyzer".format(Finding ID)

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

if fatal error, SDK error, like wrong credentials, no connection to server, other: print "Error executing action "Archive Finding". Reason: {0}''.format(error.Stacktrace)

Wenn Analyzer nicht gefunden wird: Drucken Sie „Fehler beim Ausführen der Aktion ‚Ergebnis archivieren‘“. Grund: Der Analysator „{0}“ wurde nicht gefunden.format(Analyzer Name).

 Allgemein

Connector

AWS IAM Access Analyzer – Findings Connector

Beschreibung

Ergebnisse aus AWS IAM Access Analyzer abrufen.

AWS IAM Access Analyzer – Findings Connector in Google SecOps konfigurieren

Eine detaillierte Anleitung zum Konfigurieren eines Connectors in Google SecOps finden Sie unter Connector konfigurieren.

Connector-Parameter

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

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Produktfeldname String Produktname Ja Geben Sie den Namen des Quellfelds ein, um den Namen des Produktfelds abzurufen.
Name des Ereignisfelds String resourceType Ja Geben Sie den Namen des Quellfelds ein, um den Namen des Ereignisfelds abzurufen.
Name des Umgebungsfelds String "" Nein

Beschreibt den Namen des Felds, in dem der Umgebungsname gespeichert ist.

Wenn das Feld „environment“ nicht gefunden wird, ist die Umgebung die Standardumgebung.
Regex-Muster für Umgebung String .* Nein

Ein Regex-Muster, das für den Wert im Feld „Environment Field Name“ ausgeführt werden soll.

Der Standardwert ist .*, um alle Werte zu erfassen und unverändert zurückzugeben.

Wird verwendet, um dem Nutzer die Möglichkeit zu geben, das Feld „Umgebung“ über Regex-Logik zu bearbeiten.

Wenn das Regex-Muster null oder leer ist oder der Umgebungswert null ist, ist das endgültige Umgebungsergebnis die Standardumgebung.
Zeitlimit für Script (Sekunden) Ganzzahl 180 Ja Zeitlimit für den Python-Prozess, der das aktuelle Script ausführt.
AWS-Zugriffsschlüssel-ID String – Wahr AWS-Zugriffsschlüssel-ID, die in der Integration verwendet werden soll.
AWS Secret Key Passwort – Wahr AWS-Secret-Key, der in der Integration verwendet werden soll.
AWS-Standardregion String – Wahr AWS-Standardregion, die in der Integration verwendet werden soll, z. B. us-west-2.
Analyzer-Name String – Wahr Name des Analysators, der in der Integration verwendet werden soll.
Schweregrad der Benachrichtigung String Mittel Falsch

Schweregrad der Google SecOps-Benachrichtigungen, die von diesem Connector erstellt werden. Mögliche Werte:

Kritisch, Hoch, Mittel,Niedrig,Informativ
Maximale Anzahl abzurufender Ergebnisse Ganzzahl 50 Nein Wie viele Ergebnisse pro Connector-Iteration verarbeitet werden sollen.
Maximale Anzahl von Stunden rückwärts Ganzzahl 1 Nein Wie viele Stunden zurück sollen Ergebnisse abgerufen werden?
Zulassungsliste als Sperrliste verwenden Kästchen Deaktiviert Ja Wenn diese Option aktiviert ist, wird die Zulassungsliste als Sperrliste verwendet.
SSL überprüfen Kästchen Deaktiviert Ja Wenn aktiviert, prüfen Sie, ob das SSL-Zertifikat für die Verbindung zum AWS IAM Access Analyzer-Server gültig ist.
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

Proxyunterstützung

Der Connector unterstützt Proxy.

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