Automatisierungsregeln erstellen

Eine Automatisierungsregel kann verwendet werden, um Ergebnisse automatisch zu aktualisieren AWS Security Hub. Sie können eine benutzerdefinierte Automatisierungsregel von Grund auf neu erstellen oder in der Security Hub Hub-Konsole eine vorausgefüllte Regelvorlage verwenden. Hintergrundinformationen zur Funktionsweise von Automatisierungsregeln finden Sie unterGrundlegendes zu den Automatisierungsregeln in Security Hub.

Sie können jeweils nur eine Automatisierungsregel erstellen. Um mehrere Automatisierungsregeln zu erstellen, folgen Sie den Konsolenprozeduren mehrmals oder rufen Sie die API oder den Befehl mehrmals mit den gewünschten Parametern auf.

Sie müssen in jeder Region und jedem Konto, in dem die Regel auf Ergebnisse angewendet werden soll, eine Automatisierungsregel erstellen.

Wenn Sie eine Automatisierungsregel in der Security Hub-Konsole erstellen, zeigt Ihnen Security Hub eine Vorschau der Ergebnisse, für die Ihre Regel gilt. Die Vorschau wird derzeit nicht unterstützt, wenn Ihre Regelkriterien einen CONTAINS- oder NOT_CONTAINS-Filter enthalten. Sie können diese Filter für Zuordnungs- und Zeichenkettenfeldtypen auswählen.

Wichtig

AWS empfiehlt, keine personenbezogenen, vertraulichen oder sensiblen Informationen in den Regelnamen, die Beschreibung oder andere Felder aufzunehmen.

Eine benutzerdefinierte Automatisierungsregel erstellen

Wählen Sie Ihre bevorzugte Methode und führen Sie die folgenden Schritte aus, um eine benutzerdefinierte Automatisierungsregel zu erstellen.

Console

So erstellen Sie eine benutzerdefinierte Automatisierungsregel (Konsole)

1. Öffnen Sie mit den Anmeldeinformationen des Security Hub-Administrators die AWS Security Hub Konsole unter https://console.aws.amazon.com/securityhub/.

2. Wählen Sie im Navigationsbereich Automations aus.

3. Wählen Sie Regel erstellen aus. Wählen Sie für Regeltyp die Option Benutzerdefinierte Regel erstellen aus.

4. Geben Sie im Abschnitt Regel einen eindeutigen Regelnamen und eine Beschreibung für Ihre Regel ein.

5. Verwenden Sie für Kriterien die Dropdownmenüs Schlüssel, Operator und Wert, um Ihre Regelkriterien anzugeben. Sie müssen mindestens ein Regelkriterium angeben.

   Sofern dies für Ihre ausgewählten Kriterien unterstützt wird, zeigt Ihnen die Konsole eine Vorschau der Ergebnisse, die Ihren Kriterien entsprechen.

6. Verwenden Sie für automatisierte Aktionen die Dropdownmenüs, um anzugeben, welche Ergebnisfelder aktualisiert werden sollen, wenn die Ergebnisse Ihren Regelkriterien entsprechen. Sie müssen mindestens eine Regelaktion angeben.

7. Wählen Sie unter Regelstatus aus, ob die Regel nach ihrer Erstellung aktiviert oder deaktiviert werden soll.

8. (Optional) Erweitern Sie den Abschnitt Zusätzliche Einstellungen. Wählen Sie Nachfolgende Regeln für Ergebnisse ignorieren, die diesen Kriterien entsprechen, wenn diese Regel die letzte Regel sein soll, die auf Ergebnisse angewendet wird, die den Regelkriterien entsprechen.

9. (Optional) Fügen Sie für Tags Tags als Schlüssel-Wert-Paare hinzu, damit Sie die Regel leichter identifizieren können.

10. Wählen Sie Regel erstellen aus.

API

Um eine benutzerdefinierte Automatisierungsregel (API) zu erstellen

1. Führen Sie die Ausführung über das Security Hub-Administratorkonto CreateAutomationRuleaus. Diese API erstellt eine Regel mit einem bestimmten Amazon-Ressourcennamen (ARN).

2. Geben Sie einen Namen und eine Beschreibung für die Regel ein.

3. Legen Sie den IsTerminal Parameter auf fest, true wenn diese Regel die letzte Regel sein soll, die auf Ergebnisse angewendet wird, die den Regelkriterien entsprechen.

4. Geben Sie für den RuleOrder Parameter die Reihenfolge der Regel an. Security Hub wendet zuerst Regeln mit einem niedrigeren numerischen Wert für diesen Parameter an.

5. Geben Sie für den RuleStatus Parameter an, ob Security Hub die Regel aktivieren und nach der Erstellung auf Ergebnisse anwenden soll. Der Standardwert ist ENABLED, wenn kein Wert angegeben wird. Der Wert von DISABLED bedeutet, dass die Regel nach der Erstellung angehalten wird.

6. Geben Sie für den Criteria Parameter die Kriterien an, nach denen Security Hub Ihre Ergebnisse filtern soll. Die Regelaktion gilt für Ergebnisse, die den Kriterien entsprechen. Eine Liste der unterstützten Kriterien finden Sie unterVerfügbare Regelkriterien und Regelaktionen.

7. Geben Sie für den Actions Parameter die Aktionen an, die Security Hub ausführen soll, wenn eine Übereinstimmung zwischen einem Ergebnis und Ihren definierten Kriterien besteht. Eine Liste der unterstützten Aktionen finden Sie unterVerfügbare Regelkriterien und Regelaktionen.

Mit dem folgenden AWS CLI Beispielbefehl wird eine Automatisierungsregel erstellt, die den Workflow-Status und die Notiz der übereinstimmenden Ergebnisse aktualisiert. Dieses Beispiel ist für Linux, macOS oder Unix formatiert und verwendet den umgekehrten Schrägstrich (\) zur Verbesserung der Lesbarkeit.

$ aws securityhub create-automation-rule \
--actions '[{
 "Type": "FINDING_FIELDS_UPDATE",
 "FindingFieldsUpdate": {
 "Severity": {
 "Label": "HIGH"
 },
 "Note": {
 "Text": "Known issue that is a risk. Updated by automation rules",
 "UpdatedBy": "sechub-automation"
 }
 }
 }]' \
--criteria '{
 "SeverityLabel": [{
 "Value": "INFORMATIONAL",
 "Comparison": "EQUALS"
 }]
 }' \
--description "A sample rule" \
--no-is-terminal \
--rule-name "sample rule" \
--rule-order 1 \
--rule-status "ENABLED" \
--region us-east-1

Eine Automatisierungsregel anhand einer Vorlage erstellen (nur Konsole)

Regelvorlagen spiegeln gängige Anwendungsfälle für Automatisierungsregeln wider. Derzeit unterstützt nur die Security Hub Hub-Konsole Regelvorlagen. Gehen Sie wie folgt vor, um eine Automatisierungsregel aus einer Vorlage in der Konsole zu erstellen.

Um eine Automatisierungsregel aus einer Vorlage (Konsole) zu erstellen

1. Öffnen Sie mit den Anmeldeinformationen des Security Hub-Administrators die AWS Security Hub Konsole unter https://console.aws.amazon.com/securityhub/.

2. Wählen Sie im Navigationsbereich Automations aus.

3. Wählen Sie Regel erstellen aus. Wählen Sie als Regeltyp die Option Regel aus Vorlage erstellen aus.

4. Wählen Sie im Dropdownmenü eine Regelvorlage aus.

5. (Optional) Falls für Ihren Anwendungsfall erforderlich, ändern Sie die Abschnitte Regel, Kriterien und Automatisierte Aktion. Sie müssen mindestens ein Regelkriterium und eine Regelaktion angeben.

   Falls dies für Ihre ausgewählten Kriterien unterstützt wird, zeigt Ihnen die Konsole eine Vorschau der Ergebnisse, die Ihren Kriterien entsprechen.

6. Wählen Sie unter Regelstatus aus, ob die Regel nach ihrer Erstellung aktiviert oder deaktiviert werden soll.

7. (Optional) Erweitern Sie den Abschnitt Zusätzliche Einstellungen. Wählen Sie Nachfolgende Regeln für Ergebnisse ignorieren, die diesen Kriterien entsprechen, wenn diese Regel die letzte Regel sein soll, die auf Ergebnisse angewendet wird, die den Regelkriterien entsprechen.

8. (Optional) Fügen Sie für Tags Tags als Schlüssel-Wert-Paare hinzu, damit Sie die Regel leichter identifizieren können.

9. Wählen Sie Regel erstellen aus.