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

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

  • Eindämmung kompromittierter Nutzer: Widerrufen Sie automatisch den Zugriff für mutmaßlich kompromittierte IAM-Nutzer, indem Sie während der Workflows zur Reaktion auf Vorfälle Inline-Ablehnungsrichtlinien anwenden.

  • Zugriffswiderruf und Anpassung von Berechtigungen: Entfernen Sie Nutzer aus sensiblen IAM-Gruppen, um den Zugriff auf kritische AWS-Ressourcen sofort einzuschränken, wenn ein ungewöhnliches Verhalten erkannt wird.

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

  • Identitätsprüfung und Statusermittlung: Rufen Sie Listen von Nutzern, Gruppen und verwalteten Richtlinien ab, um Sicherheitswarnungen anzureichern und IAM-Konfigurationen in Ihrer AWS-Umgebung zu prüfen.

  • Automatisierte Identitätsverwaltung: 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, müssen Sie prüfen, 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 die Netzwerkverbindung zwischen Google SecOps und dem globalen AWS IAM-Dienstendpunkt (iam.amazonaws.com).

  2. Rufen Sie AWS-API-Anmeldedaten (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-Dienstendpunkte.

  • Proxy-Konfiguration: Wenn Ihre Organisation ausgehenden Traffic über einen HTTP/HTTPS-Proxy weiterleitet, konfigurieren Sie Standard-Proxy-Variablen für die Umgebung (HTTP_PROXY, HTTPS_PROXY, NO_PROXY) auf dem Google SecOps-Server oder 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: Rufen Sie eine gültige AWS-Zugriffsschlüssel-ID und einen geheimen AWS-Schlüssel ab, die mit einem AWS-IAM-Nutzer oder einer AWS-IAM-Rolle verknüpft 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 die Berechtigungen auf die Aktionen, die für Ihre automatisierten Workflows erforderlich sind, und rotieren Sie die Anmeldedaten regelmäßig.

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

Aktionsberechtigungen konfigurieren

Gewähren Sie der authentifizierenden AWS-IAM-Identität die spezifischen Berechtigungen, die für die Aktionen Ihrer Google SecOps-Playbooks erforderlich sind.

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 zu einer Gruppe hinzufügen iam:AddUserToGroup iam:GetAccountSummary Fügt einen IAM-Nutzer einer IAM-Gruppe hinzu. Ressource: ARN der IAM-Zielgruppe.
Richtlinie anhängen iam:AttachUserPolicy
iam:AttachGroupPolicy
iam:AttachRolePolicy		 iam:ListPolicies Hängt eine verwaltete Richtlinie an einen IAM-Nutzer, eine IAM-Gruppe oder eine IAM-Rolle an. Erfordert iam:ListPolicies, um Richtlinien-ARNs nach Namen zu suchen.
Gruppe erstellen iam:CreateGroup iam:GetAccountSummary Erstellt eine neue IAM-Gruppe. Ressource: ARN der IAM-Zielgruppe.
Richtlinie erstellen iam:CreatePolicy iam:GetAccountSummary Erstellt eine neue vom Kunden verwaltete Richtlinie. Ressource: Ziel-IAM-Richtlinien-ARN.
Nutzer erstellen iam:CreateUser iam:GetAccountSummary Erstellt einen neuen IAM-Nutzer. Ressource: ARN des IAM-Zielnutzers.
Nutzerzugriff deaktivieren iam:PutUserPolicy – Hängt eine Inline-Ablehnungsrichtlinie (DisableUserAccessPolicy) an, um den Nutzerzugriff zu widerrufen. Ressource: ARN des Ziel-IAM-Nutzers.
Eintragsgruppen auflisten iam:ListGroups iam:GetAccountSummary Listet IAM-Gruppen im Konto auf. Ressource: *.
Richtlinien auflisten 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 – Validiert die Integrationsverbindung. Ressource: *.
Nutzer aus einer Gruppe entfernen iam:RemoveUserFromGroup iam:GetAccountSummary Entfernt einen IAM-Nutzer aus einer IAM-Gruppe. Ressource: ARN der IAM-Zielgruppe.

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 für die Integration verwendet werden soll.
AWS Secret Key Passwort – Ja AWS-Secret-Key, der in der Integration verwendet werden soll.
SSL überprüfen Boolesch Richtig Nein Wenn diese Option ausgewählt ist, validiert die Integration das SSL-Zertifikat, wenn eine Verbindung zum AWS IAM-Server hergestellt wird.

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.

Aktionen

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

Nutzer zu einer Gruppe hinzufügen

Fügt den angegebenen Nutzer der angegebenen IAM-Gruppe hinzu. Verwenden Sie Gruppen, um dieselben Berechtigungsrichtlinien auf mehrere Nutzer gleichzeitig anzuwenden.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Gruppenname String – Ja Der Name der zu aktualisierenden Gruppe. Hinweis: Gruppennamen dürfen keine Leerzeichen enthalten und müssen aus alphanumerischen Zeichen und/oder den folgenden Zeichen bestehen: +=.@_-.
Nutzername String – Ja Der Name des hinzuzufügenden Nutzers. Hinweis: Nutzernamen dürfen keine Leerzeichen enthalten und müssen aus alphanumerischen Zeichen und/oder den folgenden Zeichen bestehen: +=.@_-. Durch Kommas getrennte Werte.

Diese Aktion wird nicht für Google SecOps-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 nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

  • Bei Erfolg: „Der Nutzer <Nutzername> wurde der IAM-Gruppe <Gruppenname> hinzugefügt.“ ausgeben
  • Bei Fehler – Gruppe nicht vorhanden oder/und Nutzer nicht vorhanden:
    Gruppe nicht vorhanden: Ausgabe „<UserName> konnte nicht zu <Group name> hinzugefügt werden. Die Gruppe <group name> wurde nicht gefunden.
     Nutzer nicht vorhanden/beides: Ausgabe „<UserName> konnte nicht zu <Group name> hinzugefügt werden. Der Nutzer <user name> wurde nicht gefunden.
  • Bei Fehler
    Nutzerbeschränkung – IAM-Nutzer können Mitglied von 10 Gruppen sein
     Gruppenbeschränkung – 5.000 Nutzer können in einer Gruppe sein
    Ausgabe: „<UserName> konnte nicht zu <Group name> hinzugefügt werden, da versucht wurde, Ressourcen über die aktuellen AWS-Kontolimits hinaus zu erstellen.“

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

  • Wenn nicht erfolgreich (falsche Anmeldedaten, keine Verbindung, anderer SDK-Fehler): „Error executing action ‚Add a User to a Group‘“ ausgeben. 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
(Nutzer, Gruppe, Rolle)

 Gruppe Ja IAM-Identitätstyp.
Identitätsname 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 müssen ausschließlich aus alphanumerischen Zeichen und/oder den folgenden Zeichen bestehen: +=.@_-.
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 müssen aus alphanumerischen Zeichen und/oder den folgenden Zeichen bestehen: +=.@_-.

Diese Aktion wird nicht für Google SecOps-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 nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

  • Bei Erfolg: „Policy was attached to <Identity Type>: <Identity Name>“ ausgeben

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

  • Bei Fehler: Geben Sie „Die Richtlinie <policy name> konnte nicht erstellt werden. Richtliniennamen müssen innerhalb eines Kontos eindeutig sein.
  • Bei Fehler – Identitätsname war ungültig: „<policy name> konnte nicht an <Identity Type>: <Identity Name> angehängt werden. Namen dürfen nur alphanumerische Zeichen und/oder die folgenden Zeichen enthalten: +=,.@_-.“ ausgeben.
  • Wenn nicht erfolgreich (falsche Anmeldedaten, keine Verbindung zum Server, anderer Serverfehler): „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. Wenn Sie eine Gruppe einrichten möchten, müssen Sie sie erstellen. Weisen Sie der Gruppe dann Berechtigungen zu, die auf der Art der Arbeit basieren, die die Nutzer in der Gruppe voraussichtlich ausführen werden. 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 müssen ausschließlich aus alphanumerischen Zeichen und/oder den folgenden Zeichen bestehen: +=.@_-. Namen müssen innerhalb eines Kontos eindeutig sein.

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

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses 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 sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

  • Wenn erfolgreich (einige/alle Gruppennamen waren gültig): „Die folgenden Gruppen wurden IAM hinzugefügt: <Gruppennamen>“ ausgeben
  • Wenn Fehler – Gruppe ist bereits vorhanden: „Die folgenden Gruppen konnten nicht zu IAM hinzugefügt werden: <Gruppennamen>. Namen müssen innerhalb eines Kontos eindeutig sein.“ ausgeben.
  • Bei Fehler (einige Gruppennamen waren ungültig): „Die folgenden Gruppen konnten IAM nicht hinzugefügt werden: <Gruppennamen>. Gruppennamen dürfen nur alphanumerische Zeichen und/oder die folgenden Zeichen enthalten: +=,.@_-.“
  • Wenn ein Fehler auftritt (Einschränkung erhöhen. Max. 500 Gruppen pro Konto): Geben Sie „Die folgenden Gruppen konnten IAM nicht hinzugefügt werden: <Gruppennamen>. Die maximale Anzahl von Gruppen in Ihrem AWS-Konto wurde erreicht.“ aus.


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

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

Richtlinie erstellen

Erstellen Sie eine vom Kunden verwaltete IAM-Richtlinie für Ihr AWS-Konto. Durch diese Aktion wird eine Richtlinienversion mit der Versionskennung „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 muss ausschließlich aus alphanumerischen Zeichen und/oder den folgenden Zeichen bestehen: +=.@_-. 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 normalerweise 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 Skriptergebnisses 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 sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

  • if successful: print "<Policy name> policy was successfully created"

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

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

if not successful (LimitExceededException, wrong creds, no connection, other error): print "Error executing action 'Create a Policy'. Grund: {exception.stacktrace}

 Allgemein

Nutzer erstellen

Erstellen Sie einen neuen IAM-Nutzer für Ihr AWS-Konto. Sie können mehrere Nutzer gleichzeitig mit kommagetrennten Werten hinzufügen. In dieser Phase werden keine Richtlinien angewendet.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Nutzername String – Ja Name des zu erstellenden Nutzers. Durch Kommas getrennte Werte. Hinweis: Der Nutzername darf keine Leerzeichen und 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 Skriptergebnisses 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 sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

  • Bei Erfolg (einige Nutzernamen waren gültig): „Die folgenden Nutzer wurden IAM hinzugefügt: <Nutzernamen>“ ausgeben
  • Wenn der Fehler „Nutzer bereits vorhanden“ auftritt: Geben Sie „Die folgenden Nutzer konnten nicht zu IAM hinzugefügt werden: <Nutzernamen>. Namen müssen innerhalb eines Kontos eindeutig sein.“ aus.
  • Bei Fehler (einige Nutzernamen waren ungültig): „Die folgenden Nutzer konnten nicht zu IAM hinzugefügt werden: <Nutzernamen>. Nutzernamen dürfen nur alphanumerische Zeichen und/oder die folgenden Zeichen enthalten: +=,.@-.“
  • Wenn ein Fehler auftritt (Einschränkung erhöhen). Max. 5.000 Nutzer pro Konto): Geben Sie „Die folgenden Nutzer konnten nicht zu IAM hinzugefügt werden: <Nutzernamen>. Die Nutzerbeschränkung in Ihrem AWS-Konto wurde erreicht.“ aus.

Hinweis: Wenn nichts passiert ist, sind alle Nutzer ungültig, bereits vorhanden oder das Limit wurde erreicht → Die Aktion sollte fehlschlagen.

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

  • Wenn nicht erfolgreich (alle Nutzernamen ungültig, falsche Anmeldedaten, keine Verbindung, anderer Fehler): Gib „Fehler beim Ausführen der Aktion ‚Nutzer erstellen‘. Grund: {exception.stacktrace}

Hinweis: Wenn alle Nutzernamen ungültig sind, wird „Fehler beim Ausführen der Aktion ‚Nutzer erstellen‘“ ausgegeben. 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-Ablehnungsrichtlinie hinzufügen.

Diese Aktion unterstützt nur reguläre AWS-Nutzer, keine föderierten Nutzer oder IAM-Rollen.

Entitäten

Diese Aktion wird für die Entität „Nutzer“ ausgeführt.

Aktionseingaben

–

Aktionsausgaben

Aktionsausgabetyp
Anhang im Fall-Repository –
Link zum Fall-Repository –
Tabelle mit 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 Skriptergebnisses Wert
is_success Wahr/falsch
Fall-Repository

Die Aktion liefert die folgenden Ausgabenachrichten:

Ausgabemeldung Beschreibung der Nachricht

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 angegebenen Nutzer angewendet werden.
Error executing action "Disable User Access". Reason: ERROR_REASON

Aktion fehlgeschlagen.

Prü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 Skriptergebnisses 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 sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

if successful: print "Successfully listed available groups in AWS IAM"

Wenn keine Daten verfügbar sind: „Keine Gruppen in AWS IAM gefunden“ ausgeben


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

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

 Allgemein
CSV-Tabelle

Titel: IAM-Gruppen

Spalten:

Gruppenname

Gruppen-ID

ARN

Erstellungsdatum

 Allgemein

Richtlinien auflisten

Listen Sie alle verwalteten Richtlinien auf, die in Ihrem AWS-Konto verfügbar sind, einschließlich Ihrer eigenen benutzerdefinierten verwalteten Richtlinien und aller von AWS verwalteten Richtlinien. Sie können die Liste der zurückgegebenen Richtlinien mithilfe der optionalen Parameter „Nur angehängt“, „Bereich“ und „Richtliniennutzung“ filtern. Wenn Sie beispielsweise nur die vom Kunden verwalteten 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 IAM-Gruppe oder eine IAM-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 vom Kunden verwalteten Richtlinien in Ihrem AWS-Konto auflisten möchten, setzen Sie „Scope“ auf „Local“. 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 Maximalwert beträgt 1.000.

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

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses 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 sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

  • if successful: print "Successfully listed available policies in AWS IAM"
  • Wenn der Wert für „Max Policies“ kleiner ist als die Anzahl der Richtlinien, die mit dem Filter übereinstimmen: Geben Sie „Verfügbare Richtlinien in AWS IAM erfolgreich aufgelistet. Es gibt zusätzliche Richtlinien, die dem angegebenen Filter entsprechen.“
  • Wenn keine Daten vorhanden sind: Geben Sie „In AWS IAM wurden keine Richtlinien gefunden“ aus.


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

  • if not successful (wrong credentials, no connection to server, other server error, max>1000): print "Error executing action 'List Policies. 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. Die maximale Anzahl beträgt 1.000 Nutzer. Der Standardwert ist 50.

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

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses 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 sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

if successful: print "Successfully listed available users in AWS IAM"

Wenn keine Daten verfügbar sind: „Keine Nutzer in AWS IAM gefunden“ ausgeben


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

if not successful (wrong credentials, no connection to server, other server error, if max>10000): print "Error executing action 'List Users'. 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 den Parametern, die auf der Seite „Integrationskonfiguration“ im Google SecOps Content Hub angegeben sind.

Diese Aktion wird nicht für Google SecOps-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 nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

if successful: print "Successfully connected to the AWS IAM server with the provided connection parameters!"

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

if not successful: print "Failed to connect to the AWS IAM server! Error is {0}".format(exception.stacktrace)

 Allgemein

Nutzer aus einer Gruppe entfernen

Fügt den angegebenen Nutzer der angegebenen IAM-Gruppe hinzu. Verwenden Sie Gruppen, um dieselben Berechtigungsrichtlinien auf mehrere Nutzer gleichzeitig anzuwenden.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Gruppenname String – Ja Der Name der zu aktualisierenden Gruppe. Hinweis: Gruppennamen dürfen keine Leerzeichen enthalten und müssen aus alphanumerischen Zeichen und/oder den folgenden Zeichen bestehen: +=.@_-.
Nutzername String – Ja Der Name des zu entfernenden Nutzers. Hinweis: Nutzernamen dürfen keine Leerzeichen enthalten und müssen aus alphanumerischen Zeichen und/oder den folgenden Zeichen bestehen: +=.@_-. Durch Kommas getrennte Werte.

Diese Aktion wird nicht für Google SecOps-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 nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

  • if successful: print "<User name> has been removed from group: <Group name>"
  • Wenn der Fehler „Gruppe nicht vorhanden“ oder „Nutzer nicht vorhanden“ auftritt:
    Gruppe nicht vorhanden: Geben Sie „<UserName> konnte nicht aus <Group name> entfernt werden. Die Gruppe <group name> wurde nicht gefunden.“ aus.
     Nutzer nicht vorhanden/beides: Geben Sie „<UserName> konnte nicht aus <Group name> entfernt werden. Der Nutzer <user name> wurde nicht gefunden.“ aus.
  • If error
    User limitation - IAM user can be a member of 10 groups
     Group limitation - 5000 users can be in a group
    Print "Could not remove <UserName> from <Group name> because it attempted to create resources beyond the current AWS account limits."

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

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

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