AWS Identity and Access Management (IAM) in Google SecOps einbinden

In diesem Dokument wird beschrieben, wie Sie AWS Identity and Access Management in Google Security Operations einbinden.

Anwendungsbereiche

Bei der AWS IAM-Integration werden Google SecOps-Funktionen verwendet, um die folgenden Anwendungsfälle zu unterstützen:

  • Eindämmung kompromittierter Nutzerkonten: Der Zugriff für mutmaßlich kompromittierte IAM-Nutzer wird automatisch widerrufen, indem während der Incident Response-Workflows Inline-Deny-Richtlinien angewendet werden.

  • Zugriffsentzug und Berechtigungsanpassung: Entfernen Sie Nutzer aus sensiblen IAM-Gruppen, um den Zugriff auf kritische AWS-Ressourcen sofort einzuschränken, wenn anomales Verhalten erkannt wird.

  • Richtlinien- und Gruppenverwaltung: Automatisieren Sie das Erstellen und Anhängen von verwalteten IAM-Richtlinien und -Gruppen, um Zugriffssteuerungen mit dem Prinzip der geringsten Berechtigung zu erzwingen.

  • Identitäts-Audit und Ermittlung der Sicherheitslage: Rufen Sie Listen von Nutzern, Gruppen und verwalteten Richtlinien ab, um Sicherheitswarnungen zu ergänzen und IAM-Konfigurationen in Ihrer AWS-Umgebung zu prüfen.

  • Automatisierte Identitätsbereitstellung: Erstellen Sie IAM-Nutzer und weisen Sie sie im Rahmen automatisierter Onboarding- oder Eindämmungsaufgaben vordefinierten Funktionsgruppen zu.

Hinweis

Bevor Sie die AWS IAM-Integration in Google SecOps konfigurieren, prüfen Sie, ob Ihre Netzwerkumgebung und Ihre AWS-Anmeldedaten alle betrieblichen Voraussetzungen erfüllen.

So bereiten Sie Ihre Umgebung für die Integration vor:

  1. Prüfen Sie, ob eine direkte Netzwerkverbindung zwischen Google SecOps und dem globalen AWS IAM-Dienstendpunkt (iam.amazonaws.com) besteht.

  2. Rufen Sie AWS-Anmeldedaten für die programmatische API (eine Zugriffsschlüssel-ID und einen geheimen Zugriffsschlüssel) mit den entsprechenden IAM-Berechtigungen ab.

  3. Konfigurieren und testen Sie die Integrationsinstanz in Google SecOps.

Netzwerkanforderungen

Google SecOps kommuniziert direkt mit dem AWS IAM-Dienstendpunkt über HTTPS-REST-APIs und das AWS Python SDK (boto3).

Ihre Netzwerkumgebung muss die folgenden Verbindungsregeln erfüllen:

  • Ausgehender HTTPS-Zugriff: Aktivieren Sie die ausgehende HTTPS-Kommunikation von Ihrer Google SecOps-Instanz oder Ihrem Remote Agent zum globalen AWS IAM-Endpunkt (iam.amazonaws.com) über Port 443/TCP.

    Weitere Informationen zu AWS-Endpunkten finden Sie in der AWS-Dokumentation unter AWS Service Endpoints.

  • Proxykonfiguration: Wenn Ihre Organisation ausgehenden Traffic über einen HTTP-/HTTPS-Proxy weiterleitet, konfigurieren Sie die Standard-Umgebungsproxyvariablen (HTTP_PROXY, HTTPS_PROXY, NO_PROXY) auf dem Google SecOps-Server oder dem Remote Agent-Host.

Authentifizierung und Anmeldedaten

Für die AWS IAM-Integration sind programmatische API-Anmeldedaten erforderlich, um Anfragen mit AWS Signature Version 4 zu authentifizieren.

Ihre AWS-Umgebung muss die folgenden Authentifizierungsanforderungen erfüllen:

  • Programmatische Anmeldedaten: Besorgen Sie sich eine gültige AWS-Zugriffsschlüssel-ID und einen AWS-Secret-Key, die einem AWS IAM-Nutzer oder einer AWS IAM-Rolle zugeordnet sind.

    Informationen zum Erstellen von IAM-Identitäten und zum Generieren von Anmeldedaten finden Sie in der AWS-Dokumentation unter Zugriffsschlüssel für IAM-Nutzer verwalten und IAM-Identitäten.

  • Geringste Berechtigung: Beschränken Sie Berechtigungen auf die Aktionen, die für Ihre automatisierten Workflows erforderlich sind, und rotieren Sie Anmeldedaten regelmäßig.

    Details zu Sicherheitsempfehlungen finden Sie in der AWS-Dokumentation unter Best Practices für die Sicherheit in IAM.

Aktionsberechtigungen konfigurieren

Erteilen Sie der authentifizierenden AWS IAM-Identität die spezifischen Berechtigungen, die für die Aktionen erforderlich sind, die von Ihren Google SecOps-Playbooks ausgeführt werden.

In der folgenden Tabelle finden Sie die Mindestberechtigungen für AWS IAM-Aktionen:

Aktionsname Erforderliche AWS IAM-Berechtigung (ActionName:Permission) Erforderliche Berechtigung Beschreibung / Ressourcenbereich
Nutzer einer Gruppe hinzufügen iam:AddUserToGroup iam:GetAccountSummary Fügt einen IAM-Nutzer einer IAM-Gruppe hinzu. Ressource: ARN der Ziel-IAM-Gruppe.
Richtlinie anhängen iam:AttachUserPolicy
iam:AttachGroupPolicy
iam:AttachRolePolicy		 iam:ListPolicies Verknüpft eine verwaltete Richtlinie mit einem IAM-Nutzer, einer Gruppe oder Rolle. Erfordert iam:ListPolicies, um Richtlinien-ARNs anhand des Namens zu suchen.
Gruppe erstellen iam:CreateGroup iam:GetAccountSummary Erstellt eine neue IAM-Gruppe. Ressource: ARN der Ziel-IAM-Gruppe.
Richtlinie erstellen iam:CreatePolicy iam:GetAccountSummary Erstellt eine neue vom Kunden verwaltete Richtlinie. Ressource: ARN der Ziel-IAM-Richtlinie.
Nutzer erstellen iam:CreateUser iam:GetAccountSummary Erstellt einen neuen IAM-Nutzer. Ressource: ARN des Ziel-IAM-Nutzers.
Nutzerzugriff deaktivieren iam:PutUserPolicy – Fügt eine Inline-Richtlinie zum Verweigern (DisableUserAccessPolicy) an, um den Nutzerzugriff zu widerrufen. Ressource: ARN des Ziel-IAM-Nutzers.
Gruppen auflisten iam:ListGroups iam:GetAccountSummary Listet IAM-Gruppen im Konto auf. Ressource: *.
Richtlinien für Einträge iam:ListPolicies iam:GetAccountSummary Listet verwaltete Richtlinien im Konto auf. Ressource: *.
Nutzer auflisten iam:ListUsers iam:GetAccountSummary Listet IAM-Nutzer im Konto auf. Ressource: *.
Ping iam:GetAccountSummary – Prüft die Konnektivität der Integration. Ressource: *.
Nutzer aus einer Gruppe entfernen iam:RemoveUserFromGroup iam:GetAccountSummary Entfernt einen IAM-Nutzer aus einer IAM-Gruppe. Ressource: ARN der Ziel-IAM-Gruppe.

Kurzreferenz (ActionName:Permission)

In der folgenden Kurzübersicht finden Sie die erforderlichen Berechtigungen für die einzelnen Aktionen:

Ping: iam:GetAccountSummary
Add a User to a Group: iam:AddUserToGroup, iam:GetAccountSummary
Attach a Policy: iam:ListPolicies, iam:AttachUserPolicy, iam:AttachGroupPolicy, iam:AttachRolePolicy
Create a Group: iam:CreateGroup, iam:GetAccountSummary
Create a Policy: iam:CreatePolicy, iam:GetAccountSummary
Create a User: iam:CreateUser, iam:GetAccountSummary
Disable User Access: iam:PutUserPolicy
List Groups: iam:ListGroups, iam:GetAccountSummary
List Policies: iam:ListPolicies, iam:GetAccountSummary
List Users: iam:ListUsers, iam:GetAccountSummary
Remove a User from a Group: iam:RemoveUserFromGroup, iam:GetAccountSummary

Beispiel für eine IAM-Richtlinie (geringste Berechtigung)

Die folgende Beispielrichtlinie zeigt die Berechtigungen, die zum Ausführen aller AWS IAM-Aktionen in Google SecOps erforderlich sind.

Eine Anleitung zum Erstellen und Anhängen von IAM-Richtlinien finden Sie in der AWS-Dokumentation unter IAM-Richtlinien erstellen.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "SecOpsIAMDiscovery",
      "Effect": "Allow",
      "Action": [
        "iam:GetAccountSummary",
        "iam:ListUsers",
        "iam:ListGroups",
        "iam:ListPolicies"
      ],
      "Resource": "*"
    },
    {
      "Sid": "SecOpsIAMManagement",
      "Effect": "Allow",
      "Action": [
        "iam:CreateUser",
        "iam:CreateGroup",
        "iam:CreatePolicy",
        "iam:AddUserToGroup",
        "iam:RemoveUserFromGroup",
        "iam:PutUserPolicy",
        "iam:AttachUserPolicy",
        "iam:AttachGroupPolicy",
        "iam:AttachRolePolicy"
      ],
      "Resource": [
        "arn:aws:iam::*:user/*",
        "arn:aws:iam::*:group/*",
        "arn:aws:iam::*:role/*",
        "arn:aws:iam::*:policy/*"
      ]
    }
  ]
}

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.
Geheimer AWS-Schlüssel Passwort – Ja Der geheime AWS-Schlüssel, der in der Integration verwendet werden soll.
SSL überprüfen Boolesch Wahr Nein Wenn diese Option ausgewählt ist, wird das SSL-Zertifikat bei der Verbindung zum AWS IAM-Server validiert.

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

Bei Bedarf können Sie später Ä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.

Aktionen

Weitere Informationen zu Aktionen finden Sie unter Ausstehende Aktionen über „Mein Arbeitsbereich“ bearbeiten und Manuelle Maßnahme ausführen.

Nutzer zu einer Gruppe hinzufügen

Fügt den angegebenen Nutzer der angegebenen IAM-Gruppe hinzu. Mit Gruppen können Sie dieselben Berechtigungsrichtlinien auf mehrere Nutzer gleichzeitig anwenden.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Gruppenname String – Ja Der Name der Gruppe, die aktualisiert werden soll. Hinweis: Gruppennamen dürfen keine Leerzeichen enthalten und müssen nur alphanumerische Zeichen und/oder die folgenden Zeichen enthalten: +=.@_-.
Nutzername String – Ja Der Name des Nutzers, der hinzugefügt werden soll. Hinweis: Nutzernamen dürfen keine Leerzeichen enthalten und müssen nur alphanumerische Zeichen und/oder die folgenden Zeichen enthalten: +=.@_-. Kommagetrennte Werte.

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

Aktionsergebnisse

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

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

  • Bei Erfolg: „Der Nutzer <Nutzername> wurde der IAM-Gruppe <Gruppenname> hinzugefügt.“
  • Bei Fehler – Gruppe nicht vorhanden und/oder Nutzer nicht vorhanden:
    Gruppe nicht vorhanden: Gib Folgendes aus: „Could not add <UserName> to <Group name>. The Group <group name> cannot be found.“ (Nutzer <UserName> konnte nicht zu <Group name> hinzugefügt werden. Die Gruppe <group name> wurde nicht gefunden.)
     Nutzer nicht vorhanden/beides: Gib Folgendes aus: „Could not add <UserName> to <Group name>. The user <user name> cannot be found.“ (Nutzer <UserName> konnte nicht zu <Group name> hinzugefügt werden. Der Nutzer <user name> wurde nicht gefunden.)
  • Bei Fehler
    Nutzerbeschränkung – IAM-Nutzer kann Mitglied von 10 Gruppen sein
     Gruppenbeschränkung – Eine Gruppe kann 5.000 Nutzer umfassen
    Gibt „Could not add <UserName> to <Group name> because it attempted to create resources beyond the current AWS account limits.“ (Nutzer <UserName> konnte nicht zu <Group name> hinzugefügt werden, da versucht wurde, Ressourcen zu erstellen, die über die aktuellen AWS-Kontolimits hinausgehen.) aus.

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

  • Wenn nicht erfolgreich (falsche Anmeldedaten, keine Verbindung, anderer SDK-Fehler): Gib „Error executing action 'Add a User to a Group. Grund: {exception.stacktrace}
 Allgemein

Richtlinie anhängen

Hängen Sie die angegebene verwaltete Richtlinie an eine Identität (Nutzer, Gruppe, Rolle) an.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Identitätstyp

DDL
(User, Group, Role)

 Gruppe Ja IAM-Identitätstyp.
Name der Identität String – Ja Der Name (Anzeigename, nicht ARN) der Identität, an die die Richtlinie angehängt werden soll. Identitätsnamen dürfen keine Leerzeichen enthalten und dürfen nur alphanumerische Zeichen und/oder die folgenden Zeichen enthalten: +=.@_-.
Richtlinienname String – Ja Der Name (Anzeigename, nicht ARN) der Richtlinie, an die die Richtlinie angehängt werden soll. Richtliniennamen dürfen keine Leerzeichen enthalten und dürfen nur alphanumerische Zeichen und/oder die folgenden Zeichen enthalten: +=.@_-.

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

Aktionsergebnisse

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

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

  • Bei Erfolg: print "Policy was attached to <Identity Type>: <Identity Name>" (Die Richtlinie wurde an <Identity Type>: <Identity Name> angehängt)

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

  • Bei Fehler -: Gib „Die Richtlinie <policy name> konnte nicht erstellt werden. Richtliniennamen müssen innerhalb eines Kontos eindeutig sein.
  • Bei Fehler – Identitätsname war ungültig:Gib „Could not attach <policy name> to <Identity Type>: <Identity Name>. Names must contain only alphanumeric characters and/or the following: +=,.@_-.“ aus.
  • Wenn nicht erfolgreich (falsche Anmeldedaten, keine Verbindung zum Server, anderer Serverfehler): Gib „Fehler beim Ausführen der Aktion ‚Richtlinie anhängen‘. Grund: {exception.stacktrace}
 Allgemein

Gruppe erstellen

Erstellen Sie eine neue IAM-Gruppe für Ihr AWS-Konto. Um eine Gruppe einzurichten, müssen Sie sie erstellen. Weisen Sie der Gruppe dann Berechtigungen basierend auf der Art der Arbeit zu, die die Nutzer in der Gruppe ausführen sollen. Fügen Sie der Gruppe schließlich Nutzer hinzu.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Gruppenname String – Ja Name der zu erstellenden Gruppe. Durch Kommas getrennte Werte. Hinweis: Gruppennamen dürfen keine Leerzeichen enthalten und dürfen nur alphanumerische Zeichen und/oder die folgenden Zeichen enthalten: +=.@_-. Namen müssen innerhalb eines Kontos eindeutig sein.

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

Aktionsergebnisse

Scriptergebnis
Name des Scriptergebnisses Wertoptionen
is_success is_success=False
is_success is_success=True
JSON-Ergebnis
[{
   "Arn":"arn:aws:iam::582302349248:group/ZivGroup",
   "CreateDate":"2020-12-05 16:18:36+00:00",
   "Path":"/",
   "GroupId":"'AGPAYPE7MW7AMKCWMJPMX",
   "GroupName":"ZivGroup"
}]
Fall-Repository
Ergebnistyp Wert / Beschreibung Typ
Ausgabenachricht*

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

  • Bei Erfolg (einige oder alle Gruppennamen waren gültig): print "Successfully added the following groups to IAM: <Group names>" (Die folgenden Gruppen wurden erfolgreich zu IAM hinzugefügt: <Gruppennamen>)
  • Fehler – Gruppe ist bereits vorhanden: Geben Sie Folgendes aus: „Die folgenden Gruppen konnten nicht zu IAM hinzugefügt werden: <Gruppennamen>. Namen müssen innerhalb eines Kontos eindeutig sein.
  • Bei Fehler (einige Gruppennamen waren ungültig): Geben Sie Folgendes aus: „Die folgenden Gruppen konnten nicht zu IAM hinzugefügt werden: <Gruppennamen>. Gruppennamen dürfen nur alphanumerische Zeichen und/oder die folgenden Zeichen enthalten: +=,.@_-.“
  • Bei Fehler: Einschränkung aufheben. Max. 500 Gruppen pro Konto: Drucken Sie „Die folgenden Gruppen konnten nicht zu IAM hinzugefügt werden: <Gruppennamen>. Das Limit für Gruppen in Ihrem AWS-Konto wurde erreicht.


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

  • Wenn nicht erfolgreich (alle Namen waren ungültig, falsche Anmeldedaten, keine Verbindung, anderer Fehler): Gib „Error executing action 'Create a Group. Grund: {exception.stacktrace}
 Allgemein

Richtlinie erstellen

Erstellen Sie eine kundenverwaltete IAM-Richtlinie für Ihr AWS-Konto. Durch diese Aktion wird eine Richtlinienversion mit der Versions-ID „v1“ erstellt und „v1“ als Standardversion der Richtlinie festgelegt.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Richtlinienname String – Ja Name der zu erstellenden Richtlinie. Der Richtlinienname darf keine Leerzeichen enthalten und darf nur alphanumerische Zeichen und/oder die folgenden Zeichen enthalten: +=.@_-. Richtliniennamen müssen innerhalb eines Kontos eindeutig sein.
Richtliniendokument String – Ja Das JSON-Richtliniendokument, das Sie als Inhalt für die neue Richtlinie verwenden möchten.
Beschreibung String – Nein Beschreibung der Richtlinie.Wird in der Regel verwendet, um Informationen zu den in der Richtlinie definierten Berechtigungen zu speichern. Beispiel: „Gewährt Zugriff auf DynamoDB-Produktionstabellen.“ Die Richtlinienbeschreibung ist unveränderlich. Nachdem ein Wert zugewiesen wurde, kann er nicht mehr geändert werden.

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

Aktionsergebnisse

Scriptergebnis
Name des Scriptergebnisses Wertoptionen
is_success is_success=False
is_success is_success=True
JSON-Ergebnis
{
    "PolicyName": "S3-read-only-bucket",
    "PolicyId": "ANPAYPE7MW7AFKUDK3HD7",
    "Arn": "arn:aws:iam::582302349248:policy/S3-read-only-bucket",
    "Path": "/",
    "DefaultVersionId": "v1",
    "AttachmentCount": 0,
    "PermissionsBoundaryUsageCount": 0,
    "IsAttachable": true,
    "CreateDate": "2020-12-6T17:16:45",
    "UpdateDate": "2020-12-6T17:16:45"
}
Fall-Repository
Ergebnistyp Wert / Beschreibung Typ
Ausgabenachricht*

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

  • Bei Erfolg:print "<Policy name> policy was successfully created"

Die Aktion sollte fehlschlagen und eine Playbook-Ausführung beenden:

  • Bei Fehler – Richtlinie ist bereits vorhanden:Geben Sie „Die Richtlinie <policy name> konnte nicht erstellt werden. Richtliniennamen müssen innerhalb eines Kontos eindeutig sein.
  • Bei Fehler – Richtlinienname war ungültig:Gib „Die Richtlinie <policy name> konnte nicht erstellt werden. Richtliniennamen dürfen nur alphanumerische Zeichen und/oder die folgenden Zeichen enthalten: +=,.@_-.
  • Bei Fehler – Richtliniendokument war fehlerhaft :Gib „Die Richtlinie <policy name> konnte nicht erstellt werden. Das Richtliniendokument ist fehlerhaft.Grund: {exception.stacktrace}

Wenn nicht erfolgreich (LimitExceededException, falsche Anmeldedaten, keine Verbindung, anderer Fehler): Gib „Fehler beim Ausführen der Aktion ‚Richtlinie erstellen‘ aus. Grund: {exception.stacktrace}

 Allgemein

Nutzer erstellen

Erstellen Sie einen neuen IAM-Nutzer für Ihr AWS-Konto. Sie können mehrere Nutzer gleichzeitig hinzufügen, indem Sie kommagetrennte Werte verwenden. Zu diesem Zeitpunkt werden noch keine Richtlinien angewendet.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Nutzername String – Ja Name des Nutzers, der erstellt werden soll. Durch Kommas getrennte Werte. Hinweis: Der Nutzername darf keine Leerzeichen enthalten und darf nur alphanumerische Zeichen und/oder die folgenden Zeichen enthalten: +=.@_-. Namen müssen innerhalb eines Kontos eindeutig sein.

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

Aktionsergebnisse

Scriptergebnis
Name des Scriptergebnisses Wertoptionen
is_success is_success=False
is_success is_success=True
JSON-Ergebnis
[{
   "Arn":"arn:aws:iam::582302349248:user/ziv",
   "CreateDate":"2020-12-03T12:12:20",
   "Path":"/",
   "UserId":"AIDAYPE7MW7AFMHK4WCHS",
   "UserName":"ziv"
}]
Fall-Repository
Ergebnistyp Wert / Beschreibung Typ
Ausgabenachricht*

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

  • Bei Erfolg (nur wenige Nutzernamen waren gültig): „Die folgenden Nutzer wurden erfolgreich zu IAM hinzugefügt: <User names>“
  • Bei Fehler – Nutzer ist bereits vorhanden:Gib „Die folgenden Nutzer konnten nicht zu IAM hinzugefügt werden: <Usernames>. Namen müssen innerhalb eines Kontos eindeutig sein.“ aus.
  • Bei Fehler (wenige Nutzernamen waren ungültig): Gib „Die folgenden Nutzer konnten nicht zu IAM hinzugefügt werden: <Usernames>. Nutzernamen dürfen nur alphanumerische Zeichen und/oder die folgenden Zeichen enthalten: +=,.@-. aus.
  • Bei Fehler: Einschränkung aufheben. Max. 5.000 Nutzer pro Konto: Drucken Sie „Could not add the following users to IAM: <Usernames>. Reach to Users limitation in your aws account.

Hinweis:Wenn nichts passiert ist: Alle Nutzer sind ungültig/vorhanden/Limit erreicht → Aktion sollte fehlgeschlagen sein

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

  • Wenn nicht erfolgreich (alle Nutzernamen waren ungültig, falsche Anmeldedaten, keine Verbindung, anderer Fehler): print "Error executing action 'Create a User'. Grund: {exception.stacktrace}

Hinweis:Wenn alle Nutzernamen ungültig waren, geben Sie „Fehler beim Ausführen der Aktion ‚Nutzer erstellen‘“ aus. Grund: {invalid usernames}: Nutzernamen dürfen nur alphanumerische Zeichen und/oder die folgenden Zeichen enthalten: +=,.@-. {existing usernames}: Namen müssen innerhalb eines Kontos eindeutig sein.

 Allgemein

Nutzerzugriff deaktivieren

Deaktivieren Sie den Nutzerzugriff in AWS, indem Sie eine explizite Inline-Richtlinie zur Zugriffsbeschränkung hinzufügen.

Diese Aktion unterstützt nur reguläre AWS-Nutzer, nicht Verbundnutzer oder IAM-Rollen.

Entitäten

Diese Aktion wird für die Nutzerentität ausgeführt.

Aktionseingaben

–

Aktionsausgaben

Ausgabetyp der Aktion
Anhang im Fall-Repository –
Link zum Fall‑Repository –
Tabelle „Fall-Repository“ –
Anreicherungstabelle –
JSON-Ergebnis Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis
[
  {
    "Entity": "//iam.googleapis.com/projects/example/serviceAccounts/service-account@example.iam.gserviceaccount.com",
    "EntityResult": [
      {
        "fullResourceName": "//iam.googleapis.com/projects/example/serviceAccounts/service-account@example.iam.gserviceaccount.com",
        "activityType": "serviceAccountLastAuthentication",
        "observationPeriod": {
          "startTime": "2023-05-23T07:00:00Z",
          "endTime": "2023-08-20T07:00:00Z"
        },
        "activity": {
          "lastAuthenticatedTime": "2023-08-20T07:00:00Z",
          "serviceAccount": {
            "serviceAccountId": "example-account-id",
            "projectNumber": "example-project-id",
            "fullResourceName": "//iam.googleapis.com/projects/example/serviceAccounts/service-account@example.iam.gserviceaccount.com"
          }
        }
      }
    ]
  }
]
Scriptergebnis
Name des Scriptergebnisses Wert
is_success Wahr/falsch
Fall-Repository

Die Aktion gibt die folgenden Ausgabenachrichten aus:

Ausgabemeldung Nachrichtenbeschreibung

Successfully added deny policy to the following users in AWS IAM: USERNAME_LIST

Action wasn't able to find the following users in AWS IAM: USERNAME_LIST

Action wasn't able to add deny policy to the following users in AWS IAM: USERNAME_LIST

 Aktion erfolgreich.
Successfully added deny policy to the following users in AWS IAM: USERNAME_LIST

Aktion fehlgeschlagen.

Aufgrund eines Fehlers konnte die Ablehnungsrichtlinie nicht auf mindestens einen der angegebenen Nutzer angewendet werden.
Error executing action "Disable User Access". Reason: ERROR_REASON

Aktion fehlgeschlagen.

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

Gruppen auflisten

Rufen Sie eine Liste aller Gruppen in IAM ab.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Maximale Anzahl zurückzugebender Gruppen Ganzzahl 50 Nein Geben Sie an, wie viele Gruppen zurückgegeben werden sollen. Maximal 1.000 Gruppen. Der Standardwert ist 50.

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

Aktionsergebnisse

Scriptergebnis
Name des Scriptergebnisses Wertoptionen
is_success is_success=False
is_success is_success=True
JSON-Ergebnis
[{
   "Arn":"arn:aws:iam::582302349248:group/ZivGroup",
   "CreateDate":"2020-12-05 16:18:36+00:00",
   "Path":"/",
   "GroupId":"AGPAYPE7MW7AMKCWMJPMX",
   "GroupName":"ZivGroup"
}]
Fall-Repository
Ergebnistyp Wert / Beschreibung Typ
Ausgabenachricht*

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

Bei Erfolg:print "Successfully listed available groups in AWS IAM"

Wenn keine Daten verfügbar sind: „No Groups found in AWS IAM“ (Keine Gruppen in AWS IAM gefunden) ausgeben


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

Wenn nicht erfolgreich (falsche Anmeldedaten, keine Verbindung zum Server, anderer Serverfehler, wenn „Max Groups“ > 1.000): „Fehler beim Ausführen der Aktion ‚List Groups‘. Grund: {exception.stacktrace}

 Allgemein
CSV-Tabelle

Titel: IAM-Gruppen

Spalten:

Gruppenname

Gruppen-ID

ARN

Erstellungsdatum

 Allgemein

Richtlinien auflisten

Listet alle verwalteten Richtlinien auf, die in Ihrem AWS-Konto verfügbar sind, einschließlich Ihrer eigenen kundendefinierten verwalteten Richtlinien und aller von AWS verwalteten Richtlinien. Sie können die Liste der zurückgegebenen Richtlinien mit den optionalen Parametern „Only Attached“, „Scope“ und „Policy Usage“ filtern. Wenn Sie beispielsweise nur die kundenverwalteten Richtlinien in Ihrem AWS-Konto auflisten möchten, legen Sie „Scope“ auf „Local“ fest. Wenn Sie nur von AWS verwaltete Richtlinien auflisten möchten, legen Sie „Scope“ auf „AWS“ fest.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Nur angehängte Boolesch Nein Nein Wenn diese Option aktiviert ist, werden die Ergebnisse nur nach den Richtlinien gefiltert, die an einen IAM-Nutzer, eine Gruppe oder eine Rolle angehängt sind. Wenn das Häkchen nicht gesetzt ist, werden alle Richtlinien zurückgegeben.
Umfang

DDL
(Alle, AWS, Lokal)

 Alle Nein Der Bereich, der zum Filtern der Ergebnisse verwendet werden soll. Wenn Sie nur von AWS verwaltete Richtlinien auflisten möchten, legen Sie „Scope“ auf „AWS“ fest. Wenn Sie nur die kundenverwalteten Richtlinien in Ihrem AWS-Konto auflisten möchten, legen Sie „Scope“ auf „Local“ fest. Standardmäßig werden alle Richtlinien zurückgegeben.
Maximale Anzahl zurückzugebender Richtlinien Ganzzahl 100 Nein Geben Sie an, wie viele Richtlinien zurückgegeben werden sollen. Der Standardwert ist 100. Der Höchstwert liegt bei 1.000.

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

Aktionsergebnisse

Scriptergebnis
Name des Scriptergebnisses Wertoptionen
is_success is_success=False
is_success is_success=True
JSON-Ergebnis
[{
'PolicyName': 'string',
'PolicyId': 'string',
'Arn': 'string',
'Path': 'string',
'DefaultVersionId': 'string',
'AttachmentCount': 123,
'PermissionsBoundaryUsageCount': 123,
'IsAttachable': True|False,
'Description': 'string',
'CreateDate': "2020-12-6T17:16:45",
'UpdateDate':"2020-12-6T17:16:45"
}]
Fall-Repository
Ergebnistyp Wert / Beschreibung Typ
Ausgabenachricht*

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

  • Bei Erfolg:print "Successfully listed available policies in AWS IAM"
  • Wenn der Wert für „Max Policies“ < übereinstimmende Richtlinien basierend auf dem Filter: Geben Sie „Successfully listed available policies in AWS IAM“ (Verfügbare Richtlinien in AWS IAM wurden erfolgreich aufgelistet) aus. Bitte beachten Sie, dass es zusätzliche Richtlinien gibt, die dem angegebenen Filter entsprechen.“
  • Wenn keine Daten vorhanden sind: „No Policies were found in AWS IAM“ (Es wurden keine Richtlinien in AWS IAM gefunden) ausgeben.


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

  • Wenn nicht erfolgreich (falsche Anmeldedaten, keine Verbindung zum Server, anderer Serverfehler, max>1000): Gib „Fehler beim Ausführen der Aktion ‚List Policies‘“ aus. Grund: {exception.stacktrace}
 Allgemein
CSV-Tabelle

Titel:IAM-Richtlinien

Spalten:

Richtlinienname

Richtlinien-ID

Erstellungsdatum

Datum der Aktualisierung

 Allgemein

Nutzer auflisten

Rufen Sie eine Liste aller Nutzer in IAM ab.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Maximale Anzahl zurückzugebender Nutzer Ganzzahl 50 Nein Geben Sie an, wie viele Nutzer zurückgegeben werden sollen. Maximal 1.000 Nutzer. Der Standardwert ist 50.

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

Aktionsergebnisse

Scriptergebnis
Name des Scriptergebnisses Wertoptionen
is_success is_success=False
is_success is_success=True
JSON-Ergebnis
[{
   "Arn":"arn:aws:iam::582302349248:user/ziv",
   "CreateDate":"2020-12-03T12:12:20",
   "Path":"/",
   "UserId":"AIDAYPE7MW7AFMHK4WCHS",
   "UserName":"ziv"
}]
Fall-Repository
Ergebnistyp Wert / Beschreibung Typ
Ausgabenachricht*

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

Bei Erfolg:print "Successfully listed available users in AWS IAM"

Wenn keine Daten verfügbar sind: „No users found in AWS IAM“ (Keine Nutzer in AWS IAM gefunden) ausgeben


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

Wenn nicht erfolgreich (falsche Anmeldedaten, keine Verbindung zum Server, anderer Serverfehler, wenn max>10000): Gib „Fehler beim Ausführen der Aktion ‚Nutzer auflisten‘ aus. Grund: {exception.stacktrace}

 Allgemein
CSV-Tabelle

Titel:IAM-Nutzer

Spalten:

Nutzername

Nutzer-ID

ARN

Erstellungsdatum

 Allgemein

Ping

Testen Sie die Verbindung zu AWS IAM mit Parametern, die auf der Seite für die Integrationskonfiguration auf dem Tab „Google Security Operations Marketplace“ angegeben sind.

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

Aktionsergebnisse

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

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

Bei Erfolg:print "Successfully connected to the AWS IAM 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 server! Fehler: {0}".format(exception.stacktrace)

 Allgemein

Nutzer aus einer Gruppe entfernen

Fügt den angegebenen Nutzer der angegebenen IAM-Gruppe hinzu. Mit Gruppen können Sie dieselben Berechtigungsrichtlinien auf mehrere Nutzer gleichzeitig anwenden.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Gruppenname String – Ja Der Name der Gruppe, die aktualisiert werden soll. Hinweis: Gruppennamen dürfen keine Leerzeichen enthalten und müssen nur alphanumerische Zeichen und/oder die folgenden Zeichen enthalten: +=.@_-.
Nutzername String – Ja Der Name des zu entfernenden Nutzers. Hinweis: Nutzernamen dürfen keine Leerzeichen enthalten und müssen nur alphanumerische Zeichen und/oder die folgenden Zeichen enthalten: +=.@_-. Kommagetrennte Werte.

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

Aktionsergebnisse

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

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

  • Bei Erfolg:print "<User name> has been removed from group: <Group name>"
  • Bei Fehler – Gruppe nicht vorhanden und/oder Nutzer nicht vorhanden
    Gruppe nicht vorhanden Gib Folgendes aus: „Could not remove <UserName> from <Group name>. The Group <group name> cannot be found.
     Nutzer nicht vorhanden/beides Gib Folgendes aus: „Could not remove <UserName> from <Group name>. The user <user name> cannot be found.
  • Bei Fehler
    Nutzerbeschränkung – IAM-Nutzer kann Mitglied von 10 Gruppen sein
     Gruppenbeschränkung – Eine Gruppe kann 5.000 Nutzer enthalten
    Gibt „Could not remove <UserName> from <Group name> because it attempted to create resources beyond the current AWS account limits.“ (Nutzer <UserName> konnte nicht aus der Gruppe <Group name> entfernt werden, da versucht wurde, Ressourcen zu erstellen, die über die aktuellen AWS-Kontolimits hinausgehen.) aus.

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

  • Wenn nicht erfolgreich (falsche Anmeldedaten, keine Verbindung, anderer SDK-Fehler): Gib „Error executing action 'Remove a User from a Group. Grund: {exception.stacktrace}
 Allgemein

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