Workflow-Beispiel 1 - Ausführen und Speichern einer benutzerdefinierten Regel

Duplizieren Sie Ihre erfolgreiche Anfrage „Unternehmensspezifische Regeln abrufen“. Ändern Sie den Anfragetyp in „POST“, benennen Sie sie in „Benutzerdefinierte Regel erstellen“ um und klicken Sie auf Speichern. Dies wird ein POST-Befehl an einen Endpunkt wie https://api.xdr.trendmicro.com/beta/cloudPosture/customRules sein

Unter dem Header "Body" in Postman wählen Sie "Raw" aus, stellen Sie sicher, dass das JSON-Format ausgewählt ist > fügen Sie die untenstehende benutzerdefinierte Regelvorlage ein > klicken Sie auf Speichern. Postman ermöglicht es Ihnen auch, den Anfragetext zu 'verschönern'. Diese Regel ist eine einfache Demoregel, um die Verschlüsselung des S3-Buckets zu überprüfen.

{
    "name": "S3 bucket has any Encryption",
    "description": "We want to demonstrate Custom Rules V1",
    "categories": [
        "security"
    ],
    "riskLevel": "MEDIUM",
    "provider": "aws",
    "enabled": true,
    "service": "S3",
    "resourceType": "s3-bucket",
    "remediationNote": "To remediate, follow these steps:\n1. Step one \n2. Step two\n",
    "attributes": [
        {
            "name": "bucketEncryption",
            "path": "data.Encryption",
            "required": true
        }
    ],
    "eventRules": [
        {
            "conditions": {
                "all": [
                    {
                        "fact": "bucketEncryption",
                        "operator": "notEqual",
                        "value": null
                    }
                ]
            },
            "description": "Bucket has encryption enabled"
        }
    ]
}

Klicken Sie auf Speichern und Senden. Bei Erfolg wird eine 201 HTTP-Antwort zurückgegeben. Sie haben die benutzerdefinierte Regel nun in Ihrer Organisation gespeichert. Die Regel wird nun automatisch im Rahmen des regulären Cloud Risk Management-Durchsuchungsprozesses gegen die Ressourcendaten in jedem Ihrer relevanten Cloud-Konten (in diesem Fall AWS) ausgeführt.

To verify, go back to the previous ‘Get company custom rules’ query and run that request again. You should now see data returned in the response detailing the saved rule.

Optional (umgebungs- und zeitabhängig - andernfalls zum nächsten Abschnitt springen): Sie können das Cloud Risk Management eine Ihrer Cloud-Konten DURCHSUCHEN lassen. Die gespeicherte benutzerdefinierte Regel wird automatisch beim nächsten Scan übernommen und erzeugt Prüfungen im gleichen Format wie jede andere Regel.

Empfohlen (Fehlerbehebungshinweis): Wenn Sie die Überprüfungen in der Konsole anzeigen möchten, aktualisieren Sie das Browserfenster, nachdem Sie die benutzerdefinierte Regel erstellt haben, um sicherzustellen, dass die Cloud Risk Management Webanwendung die notwendigen Daten lädt, um die Überprüfungen korrekt anzuzeigen. Die Cloud Risk Management Anwendung lädt möglicherweise nur einige der notwendigen Daten, um die Überprüfungen korrekt anzuzeigen, ohne diese Aktualisierung.

Nach dem Aktualisieren des Browsers klicken Sie auf das Cloud-Konto auf der Seite Cloud Risk Managementt > Misconfiguration and Compliance und klicken Sie auf „Alle Prüfungen durchsuchen“. Filtern Sie mit der benutzerdefinierten Regel-ID, um Ihre erste benutzerdefinierte Regel live und aktiv in Ihrem Konto zu sehen.

Duplizieren Sie die POST-Anfrage mit dem Namen „Benutzerdefinierte Regel erstellen“, ändern Sie sie in eine PATCH-Anfrage und benennen Sie sie in „Benutzerdefinierte Regel aktualisieren“ um.

Fügen Sie /<custom-rule-id> an die URL an, z. B. https://api.xdr.trendmicro.com/beta/cloudPosture/customRules/CUSTOM-QqVHDF6JVdUE

Ändern Sie den Hauptteil der Regelvorlage, indem Sie: a. Werte für Name (nennen Sie die Regel, wie Sie möchten) und RisikoLevel (z.B. ändern Sie zu NIEDRIG) ändern. b. Unter Regeln → Bedingungen → alle → Operator, ändern Sie notEqual zu equal (dies wird die Logik der Regel umkehren).

Klicken Sie auf Speichern und Senden. Die bestehende Regel wird aktualisiert und in der Antwort angezeigt. Sie können dies bestätigen, indem Sie „Unternehmensspezifische Regeln abrufen“ erneut ausführen.

Testen Sie die neu aktualisierte Regel, indem Sie Test custom rule configuration ausführen - Sie sollten bemerken, dass eine ERFOLG-Prüfung die frühere FEHLER-Prüfung ersetzt. Wenn Sie die Regel mit dem Cloud Risk Management-Durchsuchen ausführen lassen, werden Sie sehen, dass die Daten der Prüfungen aktualisiert werden.

Als abschließende Bereinigung werden wir die gespeicherte Regel deaktivieren und löschen. Zuerst werden wir die gespeicherte Regel deaktivieren, wodurch der Cloud Risk Management-Scan Aufgaben im Zusammenhang mit der Entfernung von Prüfungen übernehmen kann, z. B. das Löschen verwandter Prüfungen, das Aktualisieren von Statistiken, das Schließen erstellter JIRA/ServiceNow-Tickets usw. Wenn keine Prüfungen für die benutzerdefinierte Regel erstellt wurden, fahren Sie mit Schritt 8 fort, um die benutzerdefinierte Regel dauerhaft zu löschen. Ändern Sie den Inhalt der PATCH-Anfrage 'Benutzerdefinierte Regel aktualisieren' und setzen Sie die Eigenschaft 'Aktiviert' auf 'false'.

Klicken Sie auf Senden. Die bestehende Regel wird aktualisiert, wie in der Antwort gezeigt. Sie können dies bestätigen, indem Sie 'Unternehmensspezifische Regeln abrufen' erneut ausführen

Erlauben Sie dem Cloud Risk Management DURCHSUCHEN, einen vollständigen Zyklus über die Konten auszuführen, die mit Ihrer benutzerdefinierten Regel verbunden sind.

Duplizieren Sie die PATCH-Anfrage zum Aktualisieren der gespeicherten Regel, ändern Sie sie in eine DELETE-Anfrage und benennen Sie die neue Anfrage in „Benutzerdefinierte Regel löschen“ um.

Sie können den Textkörper löschen (optional), stellen Sie sicher, dass die URL die benutzerdefinierte Regel-ID enthält, die Sie aus Ihrem Unternehmen löschen möchten, klicken Sie auf Speichern und Senden. Sie können dies überprüfen, indem Sie die Abfrage 'Unternehmensspezifische Regeln abrufen' erneut ausführen, um zu sehen, ob das Array der benutzerdefinierten Regeln leer ist.