Microsoft Sentinel
In diesem Dokument finden Sie eine Anleitung zum Einbinden von Microsoft Sentinel in Google SecOps.
Diese Integration verwendet eine oder mehrere Open-Source-Komponenten. Sie können eine ZIP-Datei des vollständigen Quellcodes dieser Integration aus dem Cloud Storage-Bucket herunterladen.
Anwendungsfälle
- In Sentinel erstellte Benachrichtigungen überwachen und prüfen, die auf Ereignissen von lokalen Hosts und cloudbasierten Microsoft-Diensten wie Microsoft 365 und Microsoft 365 Cloud App Security basieren.
- Verwenden Sie in Sentinel erfasste und korrelierte Daten für Anreicherungen, während Sie einen bestimmten Vorfall untersuchen. Analysten können die in Sentinel erfassten und gespeicherten Daten für Untersuchungen verwenden, z. B. um bestimmte Informationen genauer zu untersuchen (z. B. Benachrichtigungsdaten oder Syslog-Protokolle) oder um Aktivitäten in einem bestimmten Zeitraum oder von bestimmten Hosts abzufragen.
Vorbereitung
Sie benötigen eine Autorisierung in Microsoft Entra ID, um es zuerst zu konfigurieren, damit Sie Anfragen an die Microsoft Security Insights API senden können. Sie müssen Berechtigungen konfigurieren:
- Erstellen Sie die Microsoft Entra-Anwendung.
- Erstellen Sie einen Clientschlüssel.
- Gewähren Sie der registrierten Microsoft Entra-Anwendung Zugriff auf den Microsoft Sentinel-Arbeitsbereich.
- Verwenden Sie die Microsoft Entra-Anwendung, um ein Zugriffstoken abzurufen.
Microsoft Entra-Anwendung erstellen
Melden Sie sich im Azure-Portal als Nutzeradministrator oder Passwortadministrator an.
Wählen Sie Microsoft Entra ID aus.
Rufen Sie App-Registrierungen > Neue Registrierung auf.
Geben Sie den Namen der App ein.
Wählen Sie den entsprechenden unterstützten Kontotyp aus.
Klicken Sie auf Registrieren.
Speichern Sie die Werte für Anwendungs-ID (Client) und Verzeichnis-ID (Mandant), um sie später beim Konfigurieren der Integrationsparameter zu verwenden.
Clientschlüssel erstellen
Rufen Sie Zertifikate und Secrets > Neuer Clientschlüssel auf.
Geben Sie eine Beschreibung für einen Clientschlüssel an und legen Sie ein Ablaufdatum fest.
Klicken Sie auf Hinzufügen.
Speichern Sie den Wert des Clientschlüssels (nicht die Secret-ID), um ihn beim Konfigurieren der Integration als Parameterwert für
Client Secretzu verwenden. Der Clientschlüsselwert wird nur einmal angezeigt.
Registrierter Microsoft Entra-Anwendung Zugriff auf den Microsoft Sentinel-Arbeitsbereich gewähren
Rufen Sie die Microsoft Sentinel-Übersichtsseite auf.
Klicken Sie auf Einstellungen.
Klicken Sie auf Zugriffssteuerung (IAM).
Klicken Sie im Bereich Rollenzuweisung hinzufügen auf Hinzufügen.
Konfigurieren Sie die folgenden Parameter:
Rolle =
Azure Sentinel Contributor.Zugriff zuweisen zu =
default, Microsoft Entra ID user group, or service principal.
Geben Sie im Abschnitt Auswählen eine Suchbedingung ein, um Ihre Anwendung zu finden, und fügen Sie eine Rollenzuweisung für Ihre Anwendung hinzu.
Rufen Sie die Seite mit den Microsoft Sentinel-Arbeitsbereichen auf. Suchen und konfigurieren Sie die folgenden Parameter:
Azure Resource GroupAzure Sentinel Workspace Name
Microsoft Sentinel in Google SecOps SOAR einbinden
Eine detaillierte Anleitung zum Konfigurieren einer Integration in Google Security Operations finden Sie unter Integrationen konfigurieren.
Integrationsparameter
Verwenden Sie die folgenden Parameter, um die Integration zu konfigurieren:
| Anzeigename des Parameters | Typ | Standardwert | Ist obligatorisch | Beschreibung |
|---|---|---|---|---|
| Instanzname | String | – | Nein | Name der Instanz, für die Sie die Integration konfigurieren möchten. |
| Beschreibung | String | – | Nein | Beschreibung der Instanz. |
| Azure-Abo-ID | String | – | Ja | Microsoft Azure-Abo-ID, die im Azure-Portal > „Abonnements“ > „<Ihr Abo>“ > „Abo-ID“ angezeigt wird. |
| Azure Active Directory-ID | String | – | Ja | Die Microsoft Entra-Mandanten-ID finden Sie unter „Microsoft Entra“ > „App-Registrierung“ > „<Anwendung, die Sie für Ihre Integration konfiguriert haben>“ > „Verzeichnis-ID (Mandant)“. |
| API-Stamm | String | https://management.azure.com | Ja | Management.azure.com-API-Stamm-URL, die mit der Integration verwendet werden soll. |
| Azure-Ressourcengruppe | String | – | Ja | Name der Azure-Ressourcengruppe, in der sich Microsoft Sentinel befindet. |
| Name des Azure Sentinel-Arbeitsbereichs | String | – | Ja | Name des Microsoft Sentinel-Arbeitsbereichs, mit dem Sie arbeiten möchten. Kann im Azure-Portal unter „Microsoft Sentinel“ > „Microsoft Sentinel-Arbeitsbereiche“ aufgerufen werden. |
| Client-ID | String | – | Ja | Client-ID (Anwendungs-ID), die für die App-Registrierung in Microsoft Entra für diese Integration hinzugefügt wurde. |
| Clientschlüssel | Passwort | – | Ja | Ein Secret, das für die Azure Sentinel-Anwendungsregistrierung eingegeben wurde. |
| Remote ausführen | Kästchen | Deaktiviert | Nein | Klicken Sie das Feld an, um die konfigurierte Integration remote auszuführen. Nachdem Sie das Häkchen gesetzt haben, wird die Option zum Auswählen des Remote-Nutzers (Agenten) angezeigt. |
Aktionen
Ping
Testen Sie die Verbindung zum Microsoft Sentinel-Arbeitsbereich mit den Parametern, die auf der Seite für die Integrationskonfiguration im Google SecOps Content Hub angegeben sind.
Anwendungsfälle
Die Aktion wird verwendet, um die Konnektivität auf der Seite „Integrationskonfiguration“ im Google SecOps Content Hub zu testen. Sie kann als manuelle Aktion ausgeführt werden, die nicht in Playbooks verwendet wird.
Ausführen am
Diese Aktion wird für alle Entitäten ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Skriptergebnisses | Wertoptionen | Beispiel |
|---|---|---|
| is_success | Wahr/falsch | is_success:False |
Fall-Repository
| Ergebnistyp | Wert / Beschreibung | Typ |
|---|---|---|
| Ausgabenachricht* | Bei Erfolg: „Successfully connected to the Microsoft Sentinel Workspace with the provided connection parameters!“ wird ausgegeben. Wenn nicht erfolgreich: „Failed to connect to the Microsoft Sentinel Workspace! Fehler ist {0}".format(exception.stacktrace). |
Allgemein |
Vorfälle auflisten
Microsoft Sentinel-Vorfälle anhand der angegebenen Suchkriterien auflisten.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Ist obligatorisch | Beschreibung |
|---|---|---|---|---|
| Zeitraum | Ganzzahl | 3 | Nein | Geben Sie einen Zeitraum in Stunden an, für den Vorfälle abgerufen werden sollen. |
| Status | String | Neu, Aktiv, Geschlossen | Nein | Geben Sie die Status der Vorfälle an, nach denen gesucht werden soll. Der Parameter akzeptiert mehrere Werte als kommagetrennten String. |
| Schweregrad | String | Hinweis, Niedrig, Mittel, Hoch | Nein | Geben Sie die Schweregrade der Vorfälle an, nach denen gesucht werden soll. Der Parameter akzeptiert mehrere Werte als kommagetrennten String. |
| Anzahl der abzurufenden Vorfälle | Ganzzahl | 200 | Nein | Anzahl der abzurufenden Vorfälle. Standardmäßig werden die letzten 200 Vorfälle zurückgegeben. |
Anwendungsfälle
Mit der Aktion können Microsoft Sentinel-Vorfälle aus dem Google SecOps-Playbook aufgelistet werden.
Ausführen am
Diese Aktion wird für alle Entitäten ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Skriptergebnisses | Wertoptionen | Beispiel |
|---|---|---|
| is_success | Wahr/falsch | is_success:False |
JSON-Ergebnis
{
"value": [
{
"id": "/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.OperationalInsights/workspaces/WORKSPACE/providers/Microsoft.SecurityInsights/Cases/323032be-5b0d-4661-944f-ff9557597e50",
"name": "323032be-5b0d-4661-944f-ff9557597e50",
"etag": "\"2100e65a-0000-0d00-0000-5de3b1bf0000\"",
"type": "Microsoft.SecurityInsights/Cases",
"properties": {
"title": "Suspicious process injection observed",
"description": "A process abnormally injected code into another process, As a result, unexpected code may be running in the target process memory. Injection is often used to hide malicious code execution within a trusted process. \nAs a result, the target process may exhibit abnormal behaviors such as opening a listening port or connecting to a command and control server.",
"severity": "Medium",
"status": "New",
"labels": ["add_tag"],
"endTimeUtc": "2019-11-29T03:42:05Z",
"startTimeUtc": "2019-11-29T03:42:05Z",
"owner": {
"objectId": null
},
"lastUpdatedTimeUtc": "2019-12-01T12:27:43Z",
"createdTimeUtc": "2019-11-29T07:13:32.0266519Z",
"relatedAlertIds": ["2462474c-b6d9-6937-17ee-c2a62671c2f8"],
"relatedAlertProductNames": ["Microsoft Defender Advanced Threat Protection"],
"caseNumber": 2276,
"totalComments": 0,
"metrics": {
"SecurityAlert": 1
},
"firstAlertTimeGenerated": "2019-11-29T07:13:31.961602Z",
"lastAlertTimeGenerated": "2019-11-29T07:13:31.961602Z"
}
},{
"id": "/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.OperationalInsights/workspaces/WORKSPACE/providers/Microsoft.SecurityInsights/Cases/c7939be8-32fb-415c-9f7c-c13325d6c48b",
"name": "c7939be8-32fb-415c-9f7c-c13325d6c48b",
"etag": "\"1900f5e2-0000-0d00-0000-5de0c5110000\"",
"type": "Microsoft.SecurityInsights/Cases",
"properties": {
"title": "Suspicious Power Shell command line",
"description": "A suspicious PowerShell activity was observed on the machine. \nThis behavior may indicate that PowerShell was used during installation, exploration, or in some cases in lateral movement activities which are used by attackers to invoke modules, download external payloads, or get more information about the system. Attackers usually use PowerShell to bypass security protection mechanisms by executing their payload in memory without touching the disk and leaving any trace.\r\nOur algorithms found the behaviors of this process to be suspicious due to the following factors:\nSuspicious memory activity\nExecutes suspicious PowerShell commands",
"severity": "Medium",
"status": "New",
"labels": [],
"endTimeUtc": "2019-11-29T03:42:04.9552017Z",
"startTimeUtc": "2019-11-29T03:42:04.9552017Z",
"owner": {
"objectId": null
},
"lastUpdatedTimeUtc": "2019-11-29T07:13:21Z",
"createdTimeUtc": "2019-11-29T07:13:21.6858164Z",
"relatedAlertIds": [
"d053f17e-6153-d171-9f4d-82389442aa35"
],
"relatedAlertProductNames": [
"Microsoft Defender Advanced Threat Protection"
],
"caseNumber": 2275,
"totalComments": 0,
"metrics": {
"SecurityAlert": 1
},
"firstAlertTimeGenerated": "2019-11-29T07:13:21.5885314Z",
"lastAlertTimeGenerated": "2019-11-29T07:13:21.5885314Z"
}
}
],
"nextLink": "https://management.azure.com:443/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.OperationalInsights/workspaces/WORKSPACE/providers/Microsoft.SecurityInsights/Cases?api-version=2019-01-01-preview&$skipToken=H4sIAAAAAAAEAE1VTVMiSxD8MR45LIstukbsIbvnqxmGcRgR2xsiFqA44soiHt5vf1nzfOwaQUg31fWRlVnVGfvo8p-Jf5jhavBejW1_jQvon5OfP0_G15ffT67H7rLX7fIQXQ4P64vB583efZqXUSo7zGaRvS4-inWzK9Z-V3ze3RSfxfko8ufFdfy7jIpu8Snd8vkXTnx9c9k78XF52T87O-2fJFdXlxCZfMUDItN-zflJ2m9o-EmRx13Efi52cvw9Fnf2LBmvkW0-aBJwK8kUSYPp0R88pm_m9s-5gg2uKx9y9PMMu1yuOqgNaklrOGPfBDtMAu4FfawNZpJ2EDXWChZYGCwl2iBt7EpQovKARD1k3pb6u_Vqt4ELdqy_nw7mhSQ7pN5e6RnGbQQ9PDUYSNpHEnAjaQzUtiM2x71HLoMNoXCVoMZMz4wHg6FkueaXCrZYBHiJWYG3tEuRVke8Dog69ccs9uJ2wNxaJJ55OsASmmDvBB3F7VaQoarQ0XzjyiKOe4gDluo0laO_HN752wa_5a6-Ow3x_R88BYU_yOt7b1B6PPyN-_Ps6fHv8_ez7vLv876R1fFs2fftaLqsFjgPUV9GNevPzqRc4D1EvyXvYGPYN2yHfv9_XnYBt7A77ddgh-fgSin6tM_mEh3sqcFaHrb4HqI7sStrGvcm-RafjTMy7GHl7d262WDR2B-Sl9g27pcMD3gI2TfGsYx_LqMF3kJUSdnjO2QyP-DdR5EMd1gaPB3zT0E_5Uz9PjXsc1TiNtieDDroBdr73AafXMg0tXUTL-Wxr_cdGfUYN5qITzEPvXu51fjOyjDFKkSPks6Ytw1S9e0oJE4ea4xDZsgje9bikdqdd-eS7zA49p_0Sxb-1KdP4nd4CW4pfoVNg0TmM-JD-0GNZXAHGXbw4l0jWY1n40T9rIx7krRXLrwbiZ_ixdAuW9A-Wio-pyZKJT_gYNyH5n0d0ldJOuxnJFLMGMd2xYWjvgbChG5XSWPcWP3Q316GW5SGOEe5fQxJLVXqbkzcl3pnfcjexP3R5w9KvfkgPw3GcLHyc6p-Jh5d1ZElXwUrXDX4IW6hI8SL7ek82JIHuDKq4xWyVrf6X_WZwXueaVc2eBe3Jf8hjufU41yiVOPYPa9UD3oeNvgU6sex7-JKeMN41OWQI-br_lTiKUaN6qqGb_W9UOndq95co_lu4APIx43ml4lVnmMjrsbIMB5lmhvOA94XBhOxrBfVs7gp-45X9RMFjj47o36t0zmVCGXrVVH4T5AxgmAILdDZVOfUTmTl8yM_CNLryj4aFzSfNGgczolf0FkQZ4orpcU4HIZWtVqJc_qSw3elcWDhUATOI-LP_DPBTOvjHDogC4j2joOWqei7rFGdMNv2HVxpiBftaB8RX1bIy2SF2qOnOHLOpWKd4hjEliyWzxolAeMRp0x5gIHmfa15JgbcC6nyICiuxOmpzXdOXPh-oPOSc5D2Y62F9U2UF8OAR84FjRfpPGU_K-0reVBVbqV822nfuU_4Tir2s5R4q3lM27447gX6rwxG4gqlJhQh8uWXuI32nfypHPMrxXW03y-ijPb8nXhfeRjtq9V-sq_s00RxoX2u8xzKD3fQep-Ur2xFrf1ivE_pLLJXk1SSpyga9bsD56KNW9nJN9UBeeR4pa2qFNdE9wd5ETOBmPyhXu7b-i-YpDYV1VL3j2_76cA7r3WQ13eKD_F0MXk58Lj6wtdXxD1S3nP_MQ-397E2vmr3o2e-xIlbhfEP2s_f4mbah1jrJL573a_EdSRc2eTDWnXoW35wL7X17rT-i5YXc8ut1Oqzrzrm3nRfOA0Vp6TlH3kvvrUbNHhWnCOv_c25l6lL8iXlnod6t1i1um9QtHwMzIP99OrHFvTrFBTV1rnyKt4zb8VJ9cX6klYPFR2pJJzydy12q3ik6geqa-ojbeeItbTnHnfUVfXzX2qVoX91CQAA"
}
Fall-Repository
| Ergebnistyp | Wert/ Beschreibung | Typ |
|---|---|---|
| Ausgabenachricht* | Wenn der Vorgang erfolgreich ist und Daten abgerufen werden: „Microsoft Sentinel-Vorfälle erfolgreich zurückgegeben“ ausgeben. Wenn nichts gefunden wurde: „Aktion konnte keine Vorfälle finden“ ausgeben. if error: print "Failed to list Microsoft Sentinel incidents! Fehler ist {0}".format(exception.stacktrace). |
Allgemein |
| Tabelle | Tabellentitel: Gefundene Microsoft Sentinel-Vorfälle: Spalten: incident_number, incident_id, title, description, severity, status, labels, assigned to, alert product names, created time, last updated time |
Allgemein |
| Anhänge | List_Incidents.json – enthält technische JSON-Daten, die von der Aktion zurückgegeben werden. | Allgemein |
JSON-Viewer |
JSON-Viewer für das Abfrageergebnis anzeigen. | Allgemein |
Details zum Vorfall aktualisieren
Microsoft Sentinel-Vorfall aktualisieren
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Ist obligatorisch | Beschreibung |
|---|---|---|---|---|
| Fallnummer des Vorfalls | Ganzzahl | – | Ja | Geben Sie die zu aktualisierende Azure Sentinel-Vorfallsnummer an. |
| Titel | String | – | Nein | Geben Sie einen neuen Titel für den Azure Sentinel-Vorfall an. |
| Schweregrad | DDL | Nicht aktualisiert (mögliche Werte: Nicht aktualisiert, Information, Niedrig, Mittel, Hoch) |
Nein | Geben Sie einen neuen Schweregrad für den Azure Sentinel-Vorfall an. |
| Beschreibung | String | – | Nein | Geben Sie eine neue Beschreibung für den Azure Sentinel-Vorfall an. |
| Zugewiesen zu | String | – | Nein | Geben Sie den Nutzer an, dem der Vorfall zugewiesen werden soll. |
| Status | DDL | Nicht aktualisiert (mögliche Werte: Nicht aktualisiert, Neu, Aktiv, Geschlossen) | Nein | Geben Sie einen neuen Status für den Azure Sentinel-Vorfall an. |
| Grund für Schließung | DDL | Nicht aktualisiert (mögliche Werte: |
Nein | Wenn der Status des Vorfalls auf „Geschlossen“ gesetzt ist, geben Sie einen Grund für das Schließen des Vorfalls an. |
| Schlussbemerkung | String | – | Nein | Optionaler abschließender Kommentar für den geschlossenen Azure Sentinel-Vorfall. |
| Anzahl der Wiederholungsversuche | Ganzzahl | 1 | Ja | Geben Sie die Anzahl der Wiederholungsversuche an, die die Aktion ausführen soll, wenn die Vorfallaktualisierung nicht erfolgreich war. |
| Wiederholen alle | Ganzzahl | 20 | Ja | Geben Sie den Zeitraum an, den die Aktion zwischen den Wiederholungsversuchen für Vorfallaktualisierungen warten soll. |
Anwendungsfälle
Mit der Aktion kann ein Microsoft Sentinel-Vorfall über das Google SecOps-Playbook aktualisiert werden. Sie kann als resultierende Aktion in einem Workflow verwendet werden, der die Analyse eines Microsoft Sentinel-Vorfalls umfasst. Nachdem Vorfälle in Google SecOps verarbeitet wurden, können sie aktualisiert werden, um den Fortschritt der Analyse des Vorfalls anzugeben (z. B. „assignedTo“ festlegen, Status auf „inProgress“ setzen usw.).
Ausführen am
Diese Aktion wird für alle Entitäten ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Skriptergebnisses | Wertoptionen | Beispiel |
|---|---|---|
| is_success | Wahr/falsch | is_success:False |
JSON-Ergebnis
Für Anfrage 2 wird ein JSON-Ergebnis zurückgegeben, das die folgenden aktualisierten Vorfalldetails enthält:
{
"id": "/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.OperationalInsights/workspaces/WORKSPACE/providers/Microsoft.SecurityInsights/Cases/9e5c0afc-b7a6-4eac-8164-9242ad710a66",
"name": "9e5c0afc-b7a6-4eac-8164-9242ad710a66",
"etag": "\"12002b5c-0000-0d00-0000-5dde83730000\"",
"type": "Microsoft.SecurityInsights/Cases",
"properties": {
"title": "Activity from a Tor IP address",
"description": "A failed sign in was detected from a Tor IP addressThe Tor IP address 203.0.113.200 was used by Example User - Test User Spec (user@example.com).",
"severity": "Informational",
"status": "InProgress",
"assignedTo": "test@example.com",
"labels": [],
"closeReason": "Resolved",
"endTimeUtc": "2019-11-27T01:56:03.4651258Z",
"startTimeUtc": "2019-11-27T01:56:03.4651258Z",
"owner": {
"objectId": null,
"email": "test@example.com"
},
"lastUpdatedTimeUtc": "2019-11-27T14:08:51Z",
"createdTimeUtc": "2019-11-27T05:01:11.1139394Z",
"relatedAlertIds": [
"2a96343c-e551-4529-96f1-18d6f734470d"
],
"relatedAlertProductNames": [
"Azure Sentinel"
],
"caseNumber": 2274,
"totalComments": 0,
"metrics": {
"SecurityAlert": 1
},
"firstAlertTimeGenerated": "2019-11-27T05:01:10.2574659Z",
"lastAlertTimeGenerated": "2019-11-27T05:01:10.2574659Z"
}
}
Fall-Repository
| Ergebnistyp | Wert / Beschreibung | Typ |
|---|---|---|
| Ausgabenachricht* | Bei Erfolg: print "Successfully updated Microsoft Sentinel incident {0}".format(IncidentID). Wenn der Vorfall nicht anhand der angegebenen Fallnummer gefunden werden kann: Geben Sie „Microsoft Sentinel-Vorfall mit der Fallnummer {0} wurde nicht gefunden!“ aus.format(incident_case_number). If error: print "Failed to update Microsoft Sentinel incident! Fehler ist {0}".format(exception.stacktrace). |
Allgemein |
Vorfalllabels aktualisieren
Labels für einen bestimmten Microsoft Sentinel-Vorfall aktualisieren
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Ist obligatorisch | Beschreibung |
|---|---|---|---|---|
| Fallnummer des Vorfalls | Ganzzahl | 2273 | Ja | Geben Sie die Azure Sentinel-Vorfallsnummer an, die mit neuen Labels aktualisiert werden soll. |
| Labels | String | Malware | Ja | Geben Sie neue Labels an, die dem Vorfall angehängt werden sollen. Der Parameter akzeptiert mehrere Werte als kommagetrennten String. |
| Anzahl der Wiederholungsversuche | Ganzzahl | 1 | Ja | Geben Sie die Anzahl der Wiederholungsversuche an, die die Aktion ausführen soll, wenn die Vorfallaktualisierung nicht erfolgreich war. |
| Wiederholen alle | Ganzzahl | 20 | Ja | Geben Sie an, wie lange die Aktion zwischen den Wiederholungsversuchen für die Vorfallaktualisierung warten soll. |
Anwendungsfälle
Mit der Aktion können Microsoft Sentinel-Vorfalls-Labels über das Google SecOps-Playbook aktualisiert werden. Nutzer können diese Aktion verwenden, um bestimmten Vorfällen bei Bedarf bestimmte Tags (Labels) zuzuweisen. Wenn beispielsweise bestimmte Hosts Teil dieses Vorfalls sind, sollte ein bestimmtes Label vorhanden sein.
Ausführen am
Diese Aktion wird für alle Entitäten ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Skriptergebnisses | Wertoptionen | Beispiel |
|---|---|---|
| is_success | Wahr/falsch | is_success:False |
JSON-Ergebnis
Für Anfrage 2 wird ein JSON-Ergebnis mit aktualisierten Vorfalldetails zurückgegeben:
{
"id": "/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.OperationalInsights/workspaces/WORKSPACE/providers/Microsoft.SecurityInsights/Cases/9e5c0afc-b7a6-4eac-8164-9242ad710a66",
"name": "9e5c0afc-b7a6-4eac-8164-9242ad710a66",
"etag": "\"12002b5c-0000-0d00-0000-5dde83730000\"",
"type": "Microsoft.SecurityInsights/Cases",
"properties": {
"title": "Activity from a Tor IP address",
"severity": "Informational",
"status": "InProgress",
"labels": [
"malware",
"trojan"
],
"endTimeUtc": "2019-11-27T01:56:03.4651258Z",
"startTimeUtc": "2019-11-27T01:56:03.4651258Z",
"owner": {
"objectId": null,
},
"lastUpdatedTimeUtc": "2019-11-27T14:08:51Z",
"createdTimeUtc": "2019-11-27T05:01:11.1139394Z",
"relatedAlertIds": [
"2a96343c-e551-4529-96f1-18d6f734470d"
],
"relatedAlertProductNames": [
"Azure Sentinel"
],
"caseNumber": 2274,
"totalComments": 0,
"metrics": {
"SecurityAlert": 1
},
"firstAlertTimeGenerated": "2019-11-27T05:01:10.2574659Z",
"lastAlertTimeGenerated": "2019-11-27T05:01:10.2574659Z"
}
}
Fall-Repository
| Ergebnistyp | Wert/ Beschreibung | Typ |
|---|---|---|
| Ausgabenachricht* | Bei Erfolg: „Successfully updated Microsoft Sentinel incident {0} with the following labels: {1}“.format(IncidentID, [labels_list]).
Wenn der Vorfall anhand der angegebenen Fallnummer nicht gefunden werden kann: „Microsoft Sentinel-Vorfall mit der Fallnummer {0} wurde nicht gefunden!“.format(incident_case_number). Wenn der Nutzer ein Label angegeben hat, das bereits im Vorfall vorhanden ist (isSuccess=False): „The following labels were not added to the Microsoft Sentinel labels for incident {0} because they already exist: {1}“.format(IncidentID, [labels_list]) Wenn Fehler: „Failed to update Microsoft Sentinel incident labels! Fehler ist {0}".format(exception.stacktrace). |
Allgemein |
Vorfallstatistiken abrufen
Azure Sentinel-Vorfallsstatistiken abrufen.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Ist obligatorisch | Beschreibung |
|---|---|---|---|---|
| Zeitraum | Ganzzahl | 3 | Nein | Geben Sie den Zeitraum an, für den die Statistiken angezeigt werden sollen. |
Anwendungsfälle
Mit der Aktion können Google SecOps-Playbook-Berichte für Microsoft Sentinel-Ereignisse angezeigt werden. Diese Aktion ist Teil des Playbooks, in dem ein Nutzer mit dem Alarm von Microsoft Sentinel interagiert, der erstellt wird, wenn beispielsweise eine Warnung verarbeitet und entfernt wurde. Diese Aktion kann implementiert werden, um ein Ergebnis von Microsoft Sentinel-Vorfällen auf der Seite „Lessons Learned“ aufzurufen.
Umgekehrt kann es auch als Schnittstellenmethode für Nutzer dienen, die in Google SecOps bleiben möchten, anstatt die Windows Sentinel-Anwendung zu verwenden.
Ausführen am
Diese Aktion wird für alle Entitäten ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Skriptergebnisses | Wertoptionen | Beispiel |
|---|---|---|
| is_success | Wahr/falsch | is_success:False |
JSON-Ergebnis
{
"id": "/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.OperationalInsights/workspaces/WORKSPACE/providers/Microsoft.SecurityInsights/Aggregations/Cases",
"name": "Cases",
"type": "Microsoft.SecurityInsights/Aggregations",
"kind": "CasesAggregation",
"properties": {
"aggregationBySeverity": {
"totalCriticalSeverity": 1,
"totalHighSeverity": 2,
"totalMediumSeverity": 554,
"totalLowSeverity": 1714,
"totalInformationalSeverity": 1
},
"aggregationByStatus": {
"totalNewStatus": 2268,
"totalInProgressStatus": 4,
"totalResolvedStatus": 1,
"totalDismissedStatus": 0,
"totalTruePositiveStatus": 2,
"totalFalsePositiveStatus": 1
}
}
}
Fall-Repository
| Ergebnistyp | Wert / Beschreibung | Typ |
|---|---|---|
| Ausgabenachricht* | Wenn erfolgreich und Daten abgerufen werden: „Microsoft Sentinel-Vorfallsstatistiken erfolgreich zurückgegeben“ ausgeben. If error: print "Failed to get Microsoft Sentinel incident statistics! Fehler: {0}".format(exception.stacktrace). |
Allgemein |
| Tabelle 1 | Tabellentitel: Microsoft Sentinel-Vorfallsstatistiken nach Schweregrad: Spalten: Kritisch (zugeordnet zu totalCriticalSeverity), Hoch (zugeordnet zu totalHighSeverity), Mittel (zugeordnet zu totalMediumSeverity), Niedrig(zugeordnet zu totalLowSeverity) , Informativ(zugeordnet zu totalInformationalSeverity) |
Allgemein |
| Tabelle 2 | Tabellentitel: Microsoft Sentinel-Vorfallsstatistiken nach Status: Spalten: New(zugeordnet zu totalNewStatus), InProgress(zugeordnet zu totalInProgressStatus), Resolved(zugeordnet zu totalResolvedStatus), Dismissed(zugeordnet zu totalDismissedStatus), TruePositive(zugeordnet zu totalTruePositiveStatus), FalsePositive(zugeordnet zu totaFalsePositiveStatus) |
Allgemein |
JSON-Viewer |
JSON-Viewer für das Abfrageergebnis anzeigen. | Allgemein |
Benachrichtigungsregeln auflisten
Liste der geplanten Azure Sentinel-Regeln abrufen.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Ist obligatorisch | Beschreibung |
|---|---|---|---|---|
| Schweregrad der Benachrichtigungsregel | String | Information, Niedrig, Mittel, Hoch, Kritisch | Nein | Geben Sie die Schweregrade der Benachrichtigungsregeln an, nach denen gesucht werden soll. Der Parameter akzeptiert mehrere Werte als kommagetrennten String. |
| Bestimmte Benachrichtigungsregeltypen abrufen | String | – | Nein | Geben Sie an, welche Meldungstypen die Aktion zurückgeben soll. Der Parameter akzeptiert mehrere Werte als kommagetrennten String. Wenn kein Wert angegeben ist, werden alle möglichen Benachrichtigungstypen zurückgegeben. |
| Taktiken für bestimmte Benachrichtigungsregeln abrufen | String | – | Nein | Geben Sie an, was die Taktikaktion der Benachrichtigungsregel zurückgeben soll. Der Parameter akzeptiert mehrere Werte als kommagetrennten String. Wenn der Wert nicht angegeben ist, werden alle möglichen Benachrichtigungstypen zurückgegeben. |
| Nur aktivierte Benachrichtigungsregeln abrufen? | Kästchen | Deaktiviert | Nein | Geben Sie an, ob die Aktion nur aktivierte Benachrichtigungsregeln zurückgeben soll. |
| Maximale Anzahl der zurückzugebenden Regeln | Ganzzahl | – | Nein | Wie viele geplante Benachrichtigungsregeln die Aktion zurückgeben soll, z. B. 50. |
Anwendungsfälle
Mit der Aktion können Microsoft Sentinel-Benachrichtigungsregeln aus dem Google SecOps-Playbook aufgelistet werden. Sie können Benachrichtigungsregeln auflisten, um sicherzustellen, dass Sie für jede Art von Bedrohung und Anomalie, die in Ihrer Umgebung verdächtig ist, eine Benachrichtigungsregel vorbereitet haben. Wenn Sie feststellen, dass einige Situationen nicht ordnungsgemäß behandelt werden, können Sie eine vorhandene Benachrichtigungsregel sofort aktualisieren oder eine neue erstellen. Die Microsoft Sentinel-Benachrichtigungsregel sorgt dafür, dass Sie sofort benachrichtigt werden, damit Sie die Bedrohungen priorisieren, untersuchen und beheben können.
Ausführen am
Diese Aktion wird für alle Entitäten ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Skriptergebnisses | Wertoptionen | Beispiel |
|---|---|---|
| is_success | Wahr/falsch | is_success:False |
JSON-Ergebnis
{
"value": [
{
"id": "/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.OperationalInsights/workspaces/WORKSPACE/providers/Microsoft.SecurityInsights/alertRules/4bdce24d-7837-4f02-9f7a-10824f376517",
"name": "4bdce24d-7837-4f02-9f7a-10824f376517",
"etag": "\"00002f05-0000-0d00-0000-5d9db9970000\"",
"type": "Microsoft.SecurityInsights/alertRules",
"kind": "MicrosoftSecurityIncidentCreation",
"properties": {
"productFilter": "Azure Active Directory Identity Protection",
"severitiesFilter": null,
"displayNamesFilter": null,
"displayName": "Create incidents based on Azure Active Directory Identity Protection alerts",
"enabled": true,
"description": "Create incidents based on all alerts generated in Azure Active Directory Identity Protection",
"tactics": null,
"alertRuleTemplateName": "532c1811-79ee-4d9f-8d4d-6304c840daa1",
"lastModifiedUtc": "2019-10-09T10:42:31.5264376Z"
}
},
{
"id": "/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.OperationalInsights/workspaces/WORKSPACE/providers/Microsoft.SecurityInsights/alertRules/540f68c9-9397-49c7-8953-8efce08d6e62",
"name": "540f68c9-9397-49c7-8953-8efce08d6e62",
"etag": "\"00003105-0000-0d00-0000-5d9db9ad0000\"",
"type": "Microsoft.SecurityInsights/alertRules",
"kind": "MicrosoftSecurityIncidentCreation",
"properties": {
"productFilter": "Azure Security Center",
"severitiesFilter": null,
"displayNamesFilter": null,
"displayName": "Create incidents based on Azure Security Center alerts",
"enabled": true,
"description": "Create incidents based on all alerts generated in Azure Security Center",
"tactics": null,
"alertRuleTemplateName": "90586451-7ba8-4c1e-9904-7d1b7c3cc4d6",
"lastModifiedUtc": "2019-10-09T10:42:53.9014288Z"
}
}
]
}
Fall-Repository
| Ergebnistyp | Wert / Beschreibung | Typ |
|---|---|---|
| Ausgabenachricht* | Bei Erfolg: „Successfully listed Microsoft Sentinel Benachrichtigungsregeln configured“ wird ausgegeben. Bei Fehler: „Fehler beim Auflisten der Microsoft Sentinel-Benachrichtigungsregeln! Fehler: {0}".format(exception.stacktrace). |
Allgemein |
| Tabelle | Tabellentitel: Gefundene Microsoft Sentinel-Benachrichtigungsregeln: Spalten: AlertID (zugeordnet zu „name“), Name (zugeordnet zu „displayName“), Enabled, Description, Tactics, Last Modification Time (zugeordnet zu „lastModificationUtc“) |
Allgemein |
| Anhänge | List_AlertRules.json: Enthält die von der Aktion zurückgegebenen technischen JSON-Daten. | Allgemein |
JSON-Viewer |
JSON-Viewer für das Abfrageergebnis anzeigen. | Allgemein |
Details zu Benachrichtigungsregeln abrufen
Rufen Sie Details zur geplanten Benachrichtigungsregel von Azure Sentinel ab.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Ist obligatorisch | Beschreibung |
|---|---|---|---|---|
| AlertRuleID | String | – | Ja | Geben Sie die ID der Benachrichtigungsregel an. |
Anwendungsfälle
Mit der Aktion können Sie Details zur Microsoft Sentinel-Benachrichtigungsregel aus dem Google SecOps-Playbook abrufen. Wenn Sie beispielsweise feststellen, dass einige Benachrichtigungen häufiger auftreten und die meisten davon falsch positiv sind, oder wenn eine Benachrichtigungsregel zu viele Situationen abdeckt und Sie diese trennen möchten, um die Bedrohung leichter zu identifizieren, können Sie diese Aktion verwenden, um die Konfiguration der Benachrichtigungsregel richtig zu verstehen. Anhand der Ergebnisse der Benachrichtigungsregel können Sie entscheiden, ob Sie sie aktualisieren, löschen oder unverändert lassen möchten.
Ausführen am
Diese Aktion wird für alle Entitäten ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Skriptergebnisses | Wertoptionen | Beispiel |
|---|---|---|
| is_success | Wahr/falsch | is_success:False |
JSON-Ergebnis
{
"id": "/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.OperationalInsights/workspaces/WORKSPACE/providers/Microsoft.SecurityInsights/alertRules/8dce4dbd-0ba6-4c93-943a-8da49f7d0aa4",
"name": "8dce4dbd-0ba6-4c93-943a-8da49f7d0aa4",
"etag": "\"0200c767-0000-0d00-0000-5ddf3b160000\"",
"type": "Microsoft.SecurityInsights/alertRules",
"kind": "Scheduled",
"properties": {
"severity": "High",
"query": "SecurityEvent\r\n| where Activity startswith \"4625\"\r\n| summarize count() by IpAddress, Computer\r\n| where count_ >3\r\n| extend HostCustomEntity = Computer\r\n| extend IPCustomEntity = IpAddress",
"queryFrequency": "PT1H",
"queryPeriod": "P5D",
"triggerOperator": "GreaterThan",
"triggerThreshold": 0,
"suppressionDuration": "PT5H",
"suppressionEnabled": false,
"displayName": "Multiple failed login attempts from the same IP",
"enabled": false,
"description": "",
"tactics": [
"InitialAccess"
],
"alertRuleTemplateName": null,
"lastModifiedUtc": "2019-11-28T03:12:21.9276927Z"
}
}
Fall-Repository
| Ergebnistyp | Wert / Beschreibung | Typ |
|---|---|---|
| Ausgabenachricht* | Wenn erfolgreich und Daten abgerufen werden: „Successfully returned Microsoft Sentinel Benachrichtigungsregel {0} details“.format(AlertRuleID) ausgeben. Wenn die Benachrichtigungsregel anhand der angegebenen AlertID nicht gefunden werden kann: Ausgabe:
"Microsoft Sentinel alert rule with ID "{0}" was not found!".format(AlertRuleID).
If error: print "Failed to get details about Microsoft Sentinel alert rule! Fehler ist {0}".format(exception.stacktrace). |
Allgemein |
| Tabelle | Tabellentitel: Details zur Microsoft Sentinel-Benachrichtigungsregel: Spalten: AlertID (zugeordnet zu „name“), Name (zugeordnet zu „displayName“), Enabled, Description, Query, Frequency(zugeordnet zu „queryFrequency“), Period of Lookup data(zugeordnet zu „queryPeriod“), Trigger (zugeordnet als Kombination aus „triggerOperator“ und „triggerThreshold“), Tactics, Enable Suppression(zugeordnet als „suppressionEnabled“), Suppression Duration(zugeordnet als „suppressionDuration“), Last Modification Time (zugeordnet zu „lastModificationUtc“) |
Allgemein |
JSON-Viewer |
JSON-Viewer für das Abfrageergebnis anzeigen. | Allgemein |
Benachrichtigungsregel erstellen
Erstellen Sie eine geplante Azure Sentinel-Benachrichtigungsregel.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Ist obligatorisch | Beschreibung |
|---|---|---|---|---|
| Benachrichtigungsregel aktivieren | DDL | – | Ja | Geben Sie an, ob Sie diese Benachrichtigungsregel deaktivieren oder aktivieren möchten. |
| Name | String | – | Ja | Geben Sie den Anzeigenamen der Benachrichtigungsregel an. |
| Schweregrad | DDL | – | Ja | Geben Sie den Schweregrad dieser Benachrichtigungsregel an. |
| Abfrage | String | – | Ja | Geben Sie die Abfrage für diese Benachrichtigungsregel an. |
| Häufigkeit | String | – | Ja | Geben Sie an, wie oft die Abfrage ausgeführt werden soll. Verwenden Sie dazu das folgende Format: PT + Zahl + (M, H, D). wobei M für Minuten, H für Stunden und D für Tage steht. Das Minimum beträgt 5 Minuten, das Maximum 14 Tage. |
| Zeitraum der Suchdaten | String | – | Ja | Geben Sie den Zeitpunkt der letzten Suchdaten im folgenden Format an: P + Zahl + (M, H, D). wobei M für Minuten, H für Stunden und D für Tage steht. Das Minimum beträgt 5 Minuten, das Maximum 14 Tage. |
| Triggeroperator | DDL | – | Ja | Geben Sie den Triggeroperator für diese Benachrichtigungsregel an. |
| Triggerschwellenwert | Ganzzahl | – | Ja | Geben Sie den Auslösergrenzwert für diese Benachrichtigungsregel an. |
| Unterdrückung aktivieren | DDL | – | Ja | Geben Sie an, ob die Ausführung der Abfrage beendet werden soll, nachdem die Benachrichtigung generiert wurde. |
| Dauer der Unterdrückung | String | – | Ja | Geben Sie an, wie lange die Abfrage nach dem Generieren der Benachrichtigung nicht mehr ausgeführt werden soll. Verwenden Sie dazu das folgende Format: PT + Zahl + (M, H, D). wobei M – Minuten, H – Stunden, D – Tage Beispiele: P1M – 1 Minute P10H – 10 Stunden P2D – 2 Tage. Das Minimum beträgt 5 Minuten, das Maximum 14 Tage. |
| Beschreibung | String | – | Nein | Geben Sie die Beschreibung für diese Benachrichtigungsregel an. |
| Taktik | String | – | Nein | Geben Sie Taktiken für diese Benachrichtigungsregel an. Der Parameter kann mehrere durch Kommas getrennte Werte annehmen. |
Anwendungsfälle
Mit der Aktion können Microsoft Sentinel-Benachrichtigungsregeln aus dem Google SecOps-Playbook erstellt werden. Sie können benutzerdefinierte Benachrichtigungsregeln erstellen, um nach den Arten von Bedrohungen und Anomalien zu suchen, die in Ihrer Umgebung verdächtig sind. Die Microsoft Sentinel-Benachrichtigungsregel sorgt dafür, dass Sie sofort benachrichtigt werden, damit Sie die Bedrohungen einstufen, untersuchen und beheben können.
Ausführen am
Diese Aktion wird für alle Entitäten ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Skriptergebnisses | Wertoptionen | Beispiel |
|---|---|---|
| is_success | Wahr/falsch | is_success:False |
Fall-Repository
| Ergebnistyp | Wert / Beschreibung | Typ |
|---|---|---|
| Ausgabenachricht* | Bei Erfolg: „Microsoft Sentinel-Benachrichtigungsregel erfolgreich erstellt!“ ausgeben. If error: print "Failed to create Microsoft Sentinel alert rule! Fehler ist {0}".format(exception.stacktrace). |
Allgemein |
Benachrichtigungsregel aktualisieren
Geplante Benachrichtigungsregel für Azure Sentinel aktualisieren.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Ist obligatorisch | Beschreibung |
|---|---|---|---|---|
| AlertRuleID | String | – | Ja | Geben Sie die AlertRuleID der Benachrichtigungsregel an. |
| Name | String | – | Nein | Geben Sie den Anzeigenamen der Benachrichtigungsregel an. |
| Benachrichtigungsregel aktivieren | DDL | – | Nein | Geben Sie an, ob Sie diese Benachrichtigungsregel deaktivieren oder aktivieren möchten. |
| Schweregrad | DDL | – | Nein | Geben Sie den Schweregrad dieser Benachrichtigungsregel an. |
| Abfrage | String | – | Nein | Geben Sie die Abfrage für diese Benachrichtigungsregel an. |
| Häufigkeit | String | – | Nein | Geben Sie an, wie oft die Abfrage ausgeführt werden soll. Verwenden Sie dazu das folgende Format: PT + Zahl + (M, H, D). wobei M für Minuten, H für Stunden und D für Tage steht. Beispiele: PT1M – Abfrage jede Minute ausführen PT10H: Abfrage alle 10 Stunden ausführen PT2D: Abfrage alle 2 Tage ausführen. Das Minimum beträgt 5 Minuten, das Maximum 14 Tage. |
| Zeitraum der Suchdaten | String | – | Nein | Geben Sie den Zeitpunkt der letzten Suchdaten im folgenden Format an: P + Zahl + (M, H, D). wobei M für Minuten, H für Stunden und D für Tage steht. . Beispiele: P1M – 1 Minute P10H – 10 Stunden P2D – 2 Tage. Das Minimum beträgt 5 Minuten, das Maximum 14 Tage. |
| Triggeroperator | DDL | – | Nein | Geben Sie den Triggeroperator für diese Benachrichtigungsregel an. |
| Triggerschwellenwert | Ganzzahl | – | Nein | Geben Sie den Auslösergrenzwert für diese Benachrichtigungsregel an. |
| Unterdrückung aktivieren | DDL | – | Nein | Geben Sie an, ob die Ausführung der Abfrage beendet werden soll, nachdem die Benachrichtigung generiert wurde. |
| Dauer der Unterdrückung | String | – | Nein | Geben Sie an, wie lange die Abfrage nach dem Generieren der Benachrichtigung nicht mehr ausgeführt werden soll. Verwenden Sie dazu das folgende Format: PT + Zahl + (M, H, D). wobei M – Minuten, H – Stunden, D – Tage Beispiele: P1M – 1 Minute P10H – 10 Stunden P2D – 2 Tage. Das Minimum beträgt 5 Minuten, das Maximum 14 Tage. |
| Beschreibung | String | – | Nein | Geben Sie die Beschreibung für diese Benachrichtigungsregel an. |
| Taktik | String | Keine | Nein | Geben Sie Taktiken für diese Benachrichtigungsregel an. Der Parameter akzeptiert mehrere durch Kommas getrennte Werte. |
Anwendungsfälle
Mit der Aktion können Microsoft Sentinel-Benachrichtigungsregeln über das Google SecOps-Playbook aktualisiert werden. Wenn Sie beispielsweise feststellen, dass einige Benachrichtigungen häufiger auftreten und die meisten davon falsch-positive Ergebnisse sind, können Sie mit dieser Aktion die Konfiguration der Benachrichtigungsregel an Ihre Anforderungen und Wünsche anpassen. Die Microsoft Sentinel-Benachrichtigungsregel sorgt dafür, dass Sie sofort benachrichtigt werden, damit Sie die Bedrohungen einstufen, untersuchen und beheben können.
Ausführen am
Diese Aktion wird für alle Entitäten ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Skriptergebnisses | Wertoptionen | Beispiel |
|---|---|---|
| is_success | Wahr/falsch | is_success:False |
Fall-Repository
| Ergebnistyp | Wert / Beschreibung | Typ |
|---|---|---|
| Ausgabenachricht* | Bei Erfolg: „Successfully updated Microsoft Sentinel Benachrichtigungsregel with ID {0}“ ausgeben.format(AlertRuleID). Wenn keine Benachrichtigungsregel mit der angegebenen AlertID gefunden werden kann: Ausgabe: „Microsoft Sentinel-Benachrichtigungsregel mit der ID „{0}“ wurde nicht gefunden!“.format(AlertRuleID). If error: print "Failed to update Microsoft Sentinel alert rule! Error is {0}".format(exception.stacktrace). |
Allgemein |
Benachrichtigungsregel löschen
Geplante Azure Sentinel-Benachrichtigungsregel löschen.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Ist obligatorisch | Beschreibung |
|---|---|---|---|---|
| AlertRuleID | String | – | Ja | Geben Sie die ID der zu löschenden Benachrichtigungsregel an. |
Anwendungsfälle
Mit der Aktion kann eine Microsoft Sentinel-Benachrichtigungsregel aus Google SecOps gelöscht werden. Wenn eine Benachrichtigungsregel sehr veraltet ist und ihren Zweck nicht erfüllt oder wenn eine Regel nur falsch positive Ergebnisse liefert, können Sie sie mit dieser Aktion löschen.
Ausführen am
Diese Aktion wird für alle Entitäten ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Skriptergebnisses | Wertoptionen | Beispiel |
|---|---|---|
| is_success | Wahr/falsch | is_success:False |
Fall-Repository
| Ergebnistyp | Wert / Beschreibung | Typ |
|---|---|---|
| Ausgabenachricht* | Bei Erfolg: „Successfully deleted Microsoft Sentinel Benachrichtigungsregel {0}“ ausgeben.format(AlertRuleID). Wenn die Benachrichtigungsregel anhand der angegebenen AlertID nicht gefunden werden kann: „Microsoft Sentinel alert rule with ID "{0}" was not found!“ ausgeben.format(AlertRuleID). If error: print "Failed to delete Microsoft Sentinel alert rule! Error is {0}".format(exception.stacktrace). |
Allgemein |
Benutzerdefinierte Regeln für den Scan auflisten
Liste der benutzerdefinierten Regeln für den Scan von Azure Sentinel abrufen.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Ist obligatorisch | Beschreibung |
|---|---|---|---|---|
| Namen der zurückzugebenden Regeln für den Scan | String | – | Nein | Geben Sie Namen für die Regeln für den Scan an, die die Aktion zurückgeben soll. Der Parameter akzeptiert mehrere Werte als kommagetrennten String. Wenn der Wert nicht angegeben ist, werden alle möglichen Benachrichtigungstypen zurückgegeben. |
| Spezifische Taktiken für die Regel für den Scan abrufen | String | – | Nein | Geben Sie an, was die Taktikaktion der Regel für den Scan zurückgeben soll. Der Parameter akzeptiert mehrere Werte als kommagetrennten String. Wenn der Wert nicht angegeben ist, werden alle möglichen Benachrichtigungstypen zurückgegeben. |
| Maximale Anzahl der zurückzugebenden Regeln | Ganzzahl | – | Nein | Wie viele geplante Benachrichtigungsregeln die Aktion zurückgeben soll, z. B. 50. |
Anwendungsfälle
Mit der Aktion können benutzerdefinierte und bevorzugte Regeln für den Scan des Google SecOps-Playbooks für Microsoft Sentinel aufgelistet werden. Damit Sie alle Regeln für den Scan für Daten zu den seltensten, aber sehr kritischen Prozessen in Ihrem Netzwerk festgelegt haben, sollten Sie benutzerdefinierte und bevorzugte Regeln für den Scan erwähnen. Sie können vorhandene Regeln für den Scan sofort aktualisieren und erstellen, wenn Sie feststellen, dass einige Situationen nicht korrekt behandelt werden.
Ausführen am
Diese Aktion wird für alle Entitäten ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Skriptergebnisses | Wertoptionen | Beispiel |
|---|---|---|
| is_success | Wahr/falsch | is_success:False |
JSON-Ergebnis
{
"__metadata": {},
"value": [
{
"id": "subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.OperationalInsights/workspaces/WORKSPACE/savedSearches/0c5bd7e1-0e13-4e7d-9e32-88baf9589192",
"etag": "W/\"datetime'2019-12-02T10%3A14%3A10.5299491Z'\"",
"properties": {
"Category": "Hunting Queries",
"DisplayName": "Hunting Query 1",
"Query": "\r\nlet timeframe = 7d;\r\nAWSCloudTrail\r\n| where TimeGenerated >= ago(timeframe)\r\n| where EventName in~ (\"AttachGroupPolicy\", \"AttachRolePolicy\", \"AttachUserPolicy\", \"CreatePolicy\",\r\n\"DeleteGroupPolicy\", \"DeletePolicy\", \"DeleteRolePolicy\", \"DeleteUserPolicy\", \"DetachGroupPolicy\",\r\n\"PutUserPolicy\", \"PutGroupPolicy\", \"CreatePolicyVersion\", \"DeletePolicyVersion\", \"DetachRolePolicy\", \"CreatePolicy\")\r\n| project TimeGenerated, EventName, EventTypeName, UserIdentityAccountId, UserIdentityPrincipalid, UserAgent, \r\nUserIdentityUserName, SessionMfaAuthenticated, SourceIpAddress, AWSRegion, EventSource, AdditionalEventData, ResponseElements\r\n| extend timestamp = TimeGenerated, IPCustomEntity = SourceIpAddress, AccountCustomEntity = UserIdentityAccountId\r\n",
"Tags": [
{
"Name": "description",
"Value": "1234"
},
{
"Name": "tactics",
"Value": "DefenseEvasion"
},
{
"Name": "createdTimeUtc",
"Value": "12/02/2019 09:21:18"
}
],
"Version": 2
},
"name": "0c5bd7e1-0e13-4e7d-9e32-88baf9589192"
},
{
"id": "subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.OperationalInsights/workspaces/WORKSPACE/savedSearches/30a94796-a573-4e6e-9385-fb96d0aa5ea2",
"etag": "W/\"datetime'2019-12-02T10%3A10%3A18.4761379Z'\"",
"properties": {
"Category": "Hunting Queries",
"DisplayName": "Hunting Query 1",
"Query": "\r\nlet timeframe = 7d;\r\nAWSCloudTrail\r\n| where TimeGenerated >= ago(timeframe)\r\n| where EventName in~ (\"AttachGroupPolicy\", \"AttachRolePolicy\", \"AttachUserPolicy\", \"CreatePolicy\",\r\n\"DeleteGroupPolicy\", \"DeletePolicy\", \"DeleteRolePolicy\", \"DeleteUserPolicy\", \"DetachGroupPolicy\",\r\n\"PutUserPolicy\", \"PutGroupPolicy\", \"CreatePolicyVersion\", \"DeletePolicyVersion\", \"DetachRolePolicy\", \"CreatePolicy\")\r\n| project TimeGenerated, EventName, EventTypeName, UserIdentityAccountId, UserIdentityPrincipalid, UserAgent, \r\nUserIdentityUserName, SessionMfaAuthenticated, SourceIpAddress, AWSRegion, EventSource, AdditionalEventData, ResponseElements\r\n| extend timestamp = TimeGenerated, IPCustomEntity = SourceIpAddress, AccountCustomEntity = UserIdentityAccountId\r\n",
"Tags": [
{
"Name": "description",
"Value": "1234"
},
{
"Name": "tactics",
"Value": "DefenseEvasion"
},
{
"Name": "createdTimeUtc",
"Value": "12/02/2019 09:21:18"
}
],
"Version": 2
},
"name": "30a94796-a573-4e6e-9385-fb96d0aa5ea2"
}
]
}
Fall-Repository
| Ergebnistyp | Wert/Beschreibung | Typ |
|---|---|---|
| Ausgabenachricht* | Bei Erfolg: „Microsoft Sentinel-Regeln für den Scan wurden zurückgegeben“ wird ausgegeben. If error: print "Failed to list Microsoft Sentinel hunting rules! Fehler ist {0}".format(exception.stacktrace). |
Allgemein |
| Tabelle | Tabellentitel: Gefundene Microsoft Sentinel-Regeln für den Scan: Spalten: HuntingRuleID(zugeordnet zu „name“), title (zugeordnet zu „displayName“), category, description (zugeordnet zum Parameter „description“ im Wörterbuch „tags“), tactics(zugeordnet zum Parameter „tactics“ im Wörterbuch „tags“), query, creation time (zugeordnet zum Parameter „CreatedTimeUtc“ im Wörterbuch „tags“) |
Allgemein |
| Anhänge | List_HuntingRules.json: Enthält die von der Aktion zurückgegebenen technischen JSON-Daten. | Allgemein |
JSON-Viewer |
JSON-Viewer für das Abfrageergebnis anzeigen. | Allgemein |
Details zu benutzerdefinierten Hunting-Regeln abrufen
Details zur benutzerdefinierten Hunting-Regel von Azure Sentinel abrufen.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Ist obligatorisch | Beschreibung |
|---|---|---|---|---|
| HuntingRuleID | String | – | Ja | Geben Sie die ID der Regel für den Scan an. |
Anwendungsfälle
Informationen zu den Standard- oder bevorzugten Regeln für den Scan von Microsoft Sentinel finden Sie im Google SecOps-Playbook. Verwenden Sie dieses Tool beispielsweise, wenn Sie Details aus Regeln für den Scan erhalten, die für die Analyse nicht geeignet sind, oder wenn Sie prüfen möchten, ob Ihre Regel für den Scan richtig konfiguriert ist. Anhand der Ergebnisse entscheiden Sie, ob Sie die Daten bearbeiten, entfernen oder unverändert lassen.
Ausführen am
Diese Aktion wird für alle Entitäten ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Skriptergebnisses | Wertoptionen | Beispiel |
|---|---|---|
| is_success | Wahr/falsch | is_success:False |
JSON-Ergebnis
{
"id": "subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.OperationalInsights/workspaces/WORKSPACE/savedSearches/30a94796-a573-4e6e-9385-fb96d0aa5ea2",
"etag": "W/\"datetime'2019-12-02T10%3A14%3A10.5299491Z'\"",
"properties": {
"Category": "Log Management",
"DisplayName": "Multiple Password Reset by user",
"Query": "\nlet timeframe = 7d;\nAWSCloudTrail\n| where TimeGenerated >= ago(timeframe)\n| where EventName in~ (\"AttachGroupPolicy\", \"AttachRolePolicy\", \"AttachUserPolicy\", \"CreatePolicy\",\n\"DeleteGroupPolicy\", \"DeletePolicy\", \"DeleteRolePolicy\", \"DeleteUserPolicy\", \"DetachGroupPolicy\",\n\"PutUserPolicy\", \"PutGroupPolicy\", \"CreatePolicyVersion\", \"DeletePolicyVersion\", \"DetachRolePolicy\", \"CreatePolicy\")\n| project TimeGenerated, EventName, EventTypeName, UserIdentityAccountId, UserIdentityPrincipalid, UserAgent, \nUserIdentityUserName, SessionMfaAuthenticated, SourceIpAddress, AWSRegion, EventSource, AdditionalEventData, ResponseElements\n| extend timestamp = TimeGenerated, IPCustomEntity = SourceIpAddress, AccountCustomEntity = UserIdentityAccountId\n",
"Tags": [
{
"Name": "description",
"Value": "Identity and Access Management (IAM) securely manages access to AWS services and resources."
},
{
"Name": "tactics",
"Value": "DefenseEvasion"
},
{
"Name": "createdTimeUtc",
"Value": "12/02/2019 09:21:18"
}
],
"Version": 2
}
}
Fall-Repository
| Ergebnistyp | Wert / Beschreibung | Typ |
|---|---|---|
| Ausgabenachricht* | Bei Erfolg: „Successfully returned Microsoft Sentinel hunting rule {0} details“.format(HuntingRuleID) ausgeben. Wenn die Benachrichtigungsregel anhand der angegebenen AlertID nicht gefunden werden kann: Geben Sie „Microsoft Sentinel hunting rule with ID "{0}" was not found!“ aus.format(HuntingRuleID). If error: print "Failed to get details about Microsoft Sentinel hunting rule! Fehler ist {0}".format(exception.stacktrace). |
Allgemein |
| Tabelle | Tabellentitel: Details zur Microsoft Sentinel-Regel für den Scan: Spalten: HuntingRuleID (zugeordnet zu „name“), Name (zugeordnet zu „displayName“), Description, Query, Tactic,Creation TIme |
Allgemein |
| Anhänge | List_HuntingRules.json: Enthält die von der Aktion zurückgegebenen technischen JSON-Daten. | Allgemein |
JSON-Viewer |
JSON-Viewer für das Abfrageergebnis anzeigen. | Allgemein |
Benutzerdefinierte Regel für den Scan erstellen
Benutzerdefinierte Azure Sentinel-Regel für den Scan erstellen.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Ist obligatorisch | Beschreibung |
|---|---|---|---|---|
| Abfrage | String | – | Ja | Geben Sie die Abfrage an, die in dieser Regel für den Scan ausgeführt werden soll. |
| Anzeigename | String | – | Ja | Geben Sie den Anzeigenamen für die Regel für den Scan an. |
| Beschreibung | String | – | Nein | Geben Sie eine Beschreibung für die Regel für den Scan an. |
| Taktik | String | – | Nein | Geben Sie Taktiken für diese Regel für den Scan an. Der Parameter akzeptiert mehrere CSV-Werte. |
Anwendungsfälle
Mit der Aktion kann eine neue Microsoft Sentinel-Regel für den Scan aus dem Google SecOps-Playbook erstellt werden. Regeln für den Scan enthalten beispielsweise eine Abfrage, die Daten zu den ungewöhnlichsten Prozessen liefern kann, die in Ihrer Infrastruktur ausgeführt werden. Sie möchten nicht jedes Mal benachrichtigt werden, wenn sie ausgeführt werden, da sie völlig harmlos sein können. Sie möchten sich die Abfrage aber vielleicht gelegentlich ansehen, um zu prüfen, ob etwas Ungewöhnliches vorliegt. Das bedeutet, dass sie verwendet werden können, um mehr Informationen aus Ihrer Netzwerkumgebung zu erfassen.
Ausführen am
Diese Aktion wird für alle Entitäten ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Skriptergebnisses | Wertoptionen | Beispiel |
|---|---|---|
| is_success | Wahr/falsch | is_success:False |
Fall-Repository
| Ergebnistyp | Wert / Beschreibung | Typ |
|---|---|---|
| Ausgabenachricht* | Bei Erfolg: „Successfully created Microsoft Sentinel hunting rule“ wird ausgegeben. Bei Fehler: „Failed to create Microsoft Sentinel hunting rule! Fehler ist {0}".format(exception.stacktrace). |
Allgemein |
Benutzerdefinierte Hunting-Regel aktualisieren
Benutzerdefinierte Azure Sentinel-Regel für den Scan aktualisieren.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Ist obligatorisch | Beschreibung |
|---|---|---|---|---|
| HuntingRuleID | String | – | Ja | Geben Sie die ID der Regel für den Scan an. |
| Anzeigename | String | – | Nein | Geben Sie den Anzeigenamen für die Regel für den Scan an. |
| Abfrage | String | – | Nein | Geben Sie die Abfrage an, die in dieser Regel für den Scan ausgeführt werden soll. |
| Beschreibung | String | – | Nein | Geben Sie eine Beschreibung an. |
| Taktik | String | – | Nein | Geben Sie Taktiken für diese Regel für den Scan an. Der Parameter kann mehrere durch Kommas getrennte Werte annehmen. |
Anwendungsfälle
Mit der Aktion kann eine benutzerdefinierte Microsoft Sentinel-Regel für den Scan aus dem Google SecOps-Playbook aktualisiert werden. Verwenden Sie diese Aktion, wenn Sie beispielsweise der Meinung sind, dass eine Regel für den Scan sehr veraltet ist, und Sie mehrere Parameter wie eine Abfrage oder Beschreibung aktualisieren möchten. Informationen sind bei der Untersuchung von Vorfällen entscheidend. Daher sollte jede Regel für den Scan aktualisiert werden, um relevante Informationen anzuzeigen.
Ausführen am
Diese Aktion wird für alle Entitäten ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Skriptergebnisses | Wertoptionen | Beispiel |
|---|---|---|
| is_success | Wahr/falsch | is_success:False |
Fall-Repository
| Ergebnistyp | Wert / Beschreibung | Typ |
|---|---|---|
| Ausgabenachricht* | Bei Erfolg: „Successfully updated Microsoft Sentinel hunting rule with ID {0}“ ausgeben.format(HuntingRuleID). Wenn die Regel für den Scan anhand der angegebenen HuntingRuleID nicht gefunden werden kann: Ausgabe: „Microsoft Sentinel-Regel für den Scan mit der ID „{0}“ wurde nicht gefunden!“.format(HuntingRuleID). Bei Fehler: „Failed to update Microsoft Sentinel hunting rule!“ ausgeben Fehler ist {0}".format(exception.stacktrace). |
Allgemein |
Benutzerdefinierte Regel für den Scan löschen
Benutzerdefinierte Azure Sentinel-Regel für den Scan löschen.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Ist obligatorisch | Beschreibung |
|---|---|---|---|---|
| HuntingRuleID | String | – | Ja | Geben Sie die ID der zu löschenden Regel für den Scan an. |
Anwendungsfälle
Mit der Aktion kann eine benutzerdefinierte Microsoft Sentinel-Regel für den Scan aus Google SecOps gelöscht werden. Wenn Sie beispielsweise der Meinung sind, dass eine Regel für den Scan sehr veraltet ist und für den Untersuchungsprozess nicht benötigt wird, sollten Sie sie löschen.
Ausführen am
Diese Aktion wird für alle Entitäten ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Skriptergebnisses | Wertoptionen | Beispiel |
|---|---|---|
| is_success | Wahr/falsch | is_success:False |
Fall-Repository
| Ergebnistyp | Wert / Beschreibung | Typ |
|---|---|---|
| Ausgabenachricht* | Bei Erfolg: „Successfully deleted Microsoft Sentinel hunting rule with ID {0}“ ausgeben.format(HuntingRuleID). Wenn die Regel für den Scan anhand der angegebenen HuntingRuleID nicht gefunden werden kann: Ausgabe: „Microsoft Sentinel-Regel für den Scan mit der ID „{0}“ wurde nicht gefunden!“.format(HuntingRuleID). Bei Fehler: „Failed to delete Microsoft Sentinel hunting rule!“ ausgeben. Fehler ist {0}".format(exception.stacktrace). |
Allgemein |
Benutzerdefinierte Regel für den Scan ausführen
Benutzerdefinierte oder bevorzugte Microsoft Sentinel-Regel für den Scan ausführen.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Ist obligatorisch | Beschreibung |
|---|---|---|---|---|
| HuntingRuleID | String | – | Ja | Geben Sie die ID der Regel für den Scan an. |
| Zeitüberschreitung | Ganzzahl | – | Nein | Der Parameter, mit dem ein Zeitlimitwert für den API-Aufruf der Azure Sentinel-Regel für den Scan angegeben wird. |
Anwendungsfälle
Mit der Aktion können Sie Microsoft Sentinel-Regeln für den Scan über das Google SecOps-Playbook ausführen. Wenn Sie eine Abfrage mit einer Regel für den Scan ausführen, erhalten Sie Daten zu den ungewöhnlichsten Prozessen, die in Ihrer Infrastruktur ausgeführt werden. Sie möchten nicht jedes Mal benachrichtigt werden, wenn sie ausgeführt werden, da sie völlig harmlos sein könnten. Sie sollten sich die Abfrage jedoch gelegentlich ansehen, um festzustellen, ob etwas Ungewöhnliches vorliegt. Das bedeutet, dass damit mehr Informationen aus Ihrer Netzwerkumgebung erfasst werden können, die Ermittlern helfen, alle Nuancen eines Vorfalls zu verstehen und weitere Entscheidungen zu treffen.
Ausführen am
Diese Aktion wird für alle Entitäten ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Skriptergebnisses | Wertoptionen | Beispiel |
|---|---|---|
| is_success | Wahr/falsch | is_success:False |
JSON-Ergebnis
{
"tables": [
{
"name": "PrimaryResult",
"columns": [
{
"name": "timerange",
"type": "datetime"
},
{
"name": "AppDisplayName",
"type": "string"
},
{
"name": "UserPrincipalName",
"type": "string"
},
{
"name": "threeDayWindowLocationCount",
"type": "long"
},
{
"name": "locationList",
"type": "dynamic"
},
{
"name": "timestamp",
"type": "datetime"
},
{
"name": "AccountCustomEntity",
"type": "string"
}
],
"rows": [
[
"2019-11-29T00:00:00Z",
"WindowsDefenderATP Portal",
"user@example.com",
2,
"[\"US/Florida/Miami;\",\"AM/Kotayk'/Abovyan;\"]",
"2019-11-29T00:00:00Z",
"user@example.com"
],
[
"2019-12-02T00:00:00Z",
"WindowsDefenderATP Portal",
"user@example.com",
1,
"[\"US/Florida/Miami;\"]",
"2019-12-02T00:00:00Z",
"user@example.com"
],
[
"2019-11-29T00:00:00Z",
"Azure Portal",
"example@example.com",
1,
"[\"UA/Kyiv Misto/Kyiv;\"]",
"2019-11-29T00:00:00Z",
"example@example.com"
],
[
"2019-12-02T00:00:00Z",
"Azure Portal",
"example@example.com",
2,
"[\"UA/Kyiv Misto/Kyiv;\",\"UA/Kyivs'ka Oblast'/Boryspil';\"]",
"2019-12-02T00:00:00Z",
"example@example.com"
],
[
"2019-11-29T00:00:00Z",
"Azure Portal",
"user@example.com",
1,
"[\"RU/Sverdlovskaya Oblast'/Yekaterinburg;\"]",
"2019-11-29T00:00:00Z",
"user@example.com"
],
[
"2019-12-02T00:00:00Z",
"Azure Portal",
"user@example.com",
1,
"[\"RU/Sverdlovskaya Oblast'/Yekaterinburg;\"]",
"2019-12-02T00:00:00Z",
"user@example.com"
]
]
}
]
}
Fall-Repository
| Ergebnistyp | Wert / Beschreibung | Typ |
|---|---|---|
| Ausgabenachricht* | Bei Erfolg: „Regel für den Scan erfolgreich ausgeführt“ wird ausgegeben. Wenn die Regel für den Scan anhand der angegebenen HuntingRuleID nicht gefunden werden kann: print "Microsoft Sentinel hunting rule with ID "{0}" was not found!".format(HuntingRuleID) Wenn nichts gefunden wurde: Ausgabe: „Regel für den Scan wurde erfolgreich ausgeführt, hat aber keine Ergebnisse zurückgegeben.“
if error: print "Hunting rule didn't completed due to error:
{0}".format(exception.stacktrace) Bei Zeitüberschreitung: „Hunting rule didn't completed due to timeout: {0}“ ausgeben.format(exception.stacktrace)
Wenn die Abfrageergebnisse gekürzt wurden: Geben Sie „Die Ergebnisse der Regel für den Scan haben die Limits überschritten und wurden gekürzt. Bitte schreiben Sie Ihre Abfrage um!“ aus. |
Allgemein |
| Tabelle | Tabellentitel: Ergebnisse der Microsoft Sentinel-Regeln für den Scan Spalten: Spalten werden dynamisch basierend auf dem Abfrageergebnis generiert. |
Allgemein |
| Anhänge | Run_Hunting_rule_{HuntingRuleID}_response.json: Enthält technische JSON-Daten, die von der Aktion zurückgegeben werden. | Allgemein |
JSON-Viewer |
JSON-Viewer für das Abfrageergebnis anzeigen. | Allgemein |
KQL-Abfrage ausführen
Führen Sie eine Azure Sentinel-KQL-Abfrage basierend auf den bereitgestellten Aktionseingabeparametern aus.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Ist obligatorisch | Beschreibung |
|---|---|---|---|---|
| KQL-Abfrage | String | – | Ja | Eine KQL-Abfrage, die in Azure Sentinel ausgeführt werden soll. Wenn Sie beispielsweise in Sentinel verfügbare Sicherheitswarnungen abrufen möchten, lautet die Abfrage „SecurityAlert“. Verwenden Sie andere Eingabeparameter für die Aktion (Zeitraum, Limit), um die Abfrageergebnisse zu filtern. Beispiele für KQL-Abfragen finden Sie auf der Sentinel-Webseite „Logs“. |
| Zeitspanne | String | – | Nein | Geben Sie den Zeitraum an, in dem gesucht werden soll. Der Zeitwert muss ISO 8601-konform sein und kann beispielsweise verwendet werden, um die Suche auf die letzten 10 Stunden oder ein bestimmtes Zeitintervall zu beschränken. Verwenden Sie das folgende Format: PT + Zahl + (M, H, D), wobei M für Minuten, H für Stunden und D für Tage steht. |
| Zeitüberschreitung bei Abfragen | Ganzzahl | 180 | Nein | Zeitlimitwert für den API-Aufruf der Azure Sentinel-Regel für den Scan. Beachten Sie, dass das Zeitlimit für den Python-Prozess der Google SecOps-Aktion entsprechend für diesen Parameter angepasst werden sollte, damit die Aktion nicht aufgrund des Zeitlimits für den Python-Prozess früher als der angegebene Wert abläuft. |
| Datensatzlimit | Ganzzahl | 100 | Nein | Wie viele Datensätze abgerufen werden sollen. Optionaler Parameter, der, wenn er festgelegt ist, der KQL-Abfrage ein „| limit x“ hinzufügt, wobei x der für das Datensatzlimit festgelegte Wert ist. Kann entfernt werden, wenn „limit“ bereits in der KQL-Abfrage festgelegt ist oder nicht benötigt wird. |
Anwendungsfälle
Ausführen erweiterter Abfragen während der Untersuchung des Falls.
Ausführen am
Diese Aktion wird für alle Entitäten ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Skriptergebnisses | Wertoptionen | Beispiel |
|---|---|---|
| is_success | Wahr/falsch | is_success:False |
JSON-Ergebnis
{
"tables": [
{
"name": "PrimaryResult",
"columns": [
{
"name": "Reason",
"type": "string"
},
{
"name": "StartTimeUtc",
"type": "datetime"
},
{
"name": "EndTimeUtc",
"type": "datetime"
},
{
"name": "count_",
"type": "long"
},
{
"name": "timestamp",
"type": "datetime"
}
],
"rows": [
[
"Incorrect password",
"2019-10-22T06:38:30.837Z",
"2019-10-22T11:57:00.003Z",
28,
"2019-10-22T06:38:30.837Z"
],
[
"Account name does not exist",
"2019-10-21T15:19:33.727Z",
"2019-10-22T06:40:13.51Z",
3,
"2019-10-21T15:19:33.727Z"
]
]
}
]
}
Fall-Repository
| Ergebnistyp | Wert / Beschreibung | Typ |
|---|---|---|
| Ausgabenachricht* | Bei Erfolg: „Query executed successfully“ wird ausgegeben. Wenn nichts gefunden wurde: Geben Sie „Abfrage erfolgreich ausgeführt, aber keine Ergebnisse zurückgegeben“ aus. Bei Fehler: „Query didn't completed due to error: {0}“.format(exception.stacktrace) ausgeben. If timeout: print "Query didn't completed due to timeout:
{0}".format(exception.stacktrace). Wenn die Abfrageergebnisse gekürzt wurden:Gib „Die Abfrageergebnisse haben die Limits überschritten und wurden gekürzt. Bitte schreibe deine Abfrage um!“ aus. |
|
| Tabelle | Tabellentitel: KQL-Abfrageergebnisse Spalten: Spalten werden dynamisch anhand des Abfrageergebnisses generiert. |
Allgemein |
| Anhänge | Run_KQL_query_response.json: Enthält die von der Aktion zurückgegebenen technischen JSON-Daten. | Allgemein |
JSON-Viewer |
JSON-Viewer für das Abfrageergebnis anzeigen. | Allgemein |
Kommentar zu Vorfall hinzufügen
Fügen Sie dem Azure Sentinel-Vorfall einen Kommentar hinzu.
Parameter
| Anzeigename des Parameters | Typ | Standardwert | Ist obligatorisch | Beschreibung |
|---|---|---|---|---|
| Nummer des Vorfalls | Ganzzahl | – | Ja | Geben Sie die Vorfallnummer an, zu der Sie einen Kommentar hinzufügen möchten. |
| Kommentar hinzufügen | String | – | Ja | Kommentar angeben, der dem Vorfall hinzugefügt werden soll |
Ausführen am
Diese Aktion wird nicht für Entitäten ausgeführt.
Aktionsergebnisse
Scriptergebnis
| Name des Skriptergebnisses | Wertoptionen | Beispiel |
|---|---|---|
| is_success | Wahr/falsch | is_success:False |
JSON-Ergebnis
{
"id": "/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.OperationalInsights/workspaces/WORKSPACE/providers/Microsoft.SecurityInsights/Incidents/00cfebdc-c677-463f-8355-cb7f23472c06/Comments/f0f31d1a-d32b-4774-a21d-3279240c7c33",
"name": "f0f31d1a-d32b-4774-a21d-3279240c7c33",
"etag": "\"7e000812-0000-0c00-0000-606fc83f0000\"",
"type": "Microsoft.SecurityInsights/Incidents/Comments",
"properties": {
"message": "Some message",
"createdTimeUtc": "2021-04-09T03:21:35.0894288Z",
"lastModifiedTimeUtc": "2021-04-09T03:21:35.0894288Z",
"author": {
"objectId": "f6ce2f43-6f77-4b30-9a4a-de1a069b2560",
"email": null,
"name": "Comment created from external application - log_analytics_rest_api_for_sentinel",
"userPrincipalName": null
}
}
}
Fall-Repository
| Ergebnistyp | Wert / Beschreibung | Typ |
|---|---|---|
| Ausgabenachricht* | Die Aktion sollte die Ausführung eines Playbooks weder fehlschlagen lassen noch stoppen:
Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden:
|
Allgemein |
Connectors
Weitere Informationen zum Konfigurieren von Connectors in Google SecOps finden Sie unter Daten aufnehmen (Connectors).
Microsoft Azure Sentinel Incidents Connector – verworfen
In Google SecOps SOAR werden mit dem Microsoft Azure Sentinel Incidents Connector Vorfälle aus dem spezifischen Microsoft Sentinel-Arbeitsbereich als Benachrichtigungen über die Azure Security Insights API aufgenommen.
Der Connector verwendet Funktionen, die den Aktionen Vorfälle auflisten und Vorfalldetails abrufen ähneln, und stellt eine Verbindung zum Azure Security Insights-Endpunkt her, um eine Liste der Vorfälle abzurufen, die während eines bestimmten Zeitraums generiert wurden.
Anwendungsfall für Connector
Mit dem Connector können Sie Microsoft Sentinel-Arbeitsbereiche auf neue Vorfälle überwachen und diese in den Google SecOps SOAR-Server aufnehmen.
Fügen Sie den Daten-Connector zu Microsoft Sentinel hinzu, um den Fluss bestimmter Ereignistypen zu ermöglichen. Wenn Sie beispielsweise Sicherheitsereignisse von Windows-Hosts als einen der Daten-Connectors hinzufügen möchten, installieren Sie einen Microsoft Sentinel-Agent auf einem Windows-Host und konfigurieren Sie, welche Arten von Ereignissen aufgenommen werden sollen: Sicherheitsereignisse, Firewall-Ereignisse, DNS-Ereignisse oder andere.
Wenn Sie Benachrichtigungen basierend auf bestimmten Bedingungen generieren möchten, definieren Sie Benachrichtigungsregeln mithilfe von Regelabfragen. Wenn Benachrichtigungsregeln Warnungen erstellen, wird Microsoft Sentinel ausgelöst, um Ereignisse zu generieren, Datenunfälle zu speichern und Vorfälle auf der Seite „Vorfälle“ im Portal anzuzeigen.
Wenn Sie Vorfalldaten programmatisch lesen und schreiben möchten, verwenden Sie die Security Insights REST API.
Connector-Parameter
Verwenden Sie die folgenden Parameter, um den Connector zu konfigurieren:
| Parameter | |
|---|---|
Product Field Name |
Erforderlich
Name des Feldes, in dem der Produktname gespeichert ist. Der Standardwert ist |
Event Field Name |
Erforderlich
Name des Felds, in dem der Ereignisname gespeichert ist. Der Standardwert ist |
Environment Field Name |
Optional
Name des Felds, in dem der Umgebungsname gespeichert ist. Wenn das Feld „environment“ nicht gefunden wird, wird die Standardumgebung verwendet. Der Standardwert ist |
Environment Regex Pattern |
Optional
Ein Muster für reguläre Ausdrücke, das für den im Feld Der Standardwert Mit dem Parameter können Sie das Feld „environment“ mithilfe der Logik für reguläre Ausdrücke bearbeiten. Wenn das Muster des regulären Ausdrucks null oder leer ist oder der Umgebungswert null ist, ist das endgültige Umgebungsergebnis die Standardumgebung. |
Azure Subscription ID |
Erforderlich ID des Azure-Abos. |
Azure Active Directory ID |
Erforderlich Microsoft Entra-Mandanten-ID. |
Api Root |
Erforderlich Die Stamm-URL der management.azure.com-API, die für die Integration verwendet werden soll. Der Standardwert ist |
Azure Resource Group |
Erforderlich Name der Azure-Ressourcengruppe, in der sich Microsoft Sentinel befindet. |
Azure Sentinel Workspace Name |
Erforderlich Name des Microsoft Sentinel-Arbeitsbereichs, mit dem Sie arbeiten möchten. |
Client ID |
Erforderlich Microsoft Entra-Anwendungs-ID (Client-ID), die für diese Integration verwendet wird. |
Client Secret |
Erforderlich Microsoft Entra-Clientschlüsselwert. |
Script Timeout (Seconds) |
Erforderlich Zeitlimit für den Python-Prozess, der das aktuelle Script ausführt. Der Standardwert beträgt 180 Sekunden. |
Offset Time In Hours |
Erforderlich
Anzahl der Stunden vor dem aktuellen Zeitpunkt, ab dem Vorfälle abgerufen werden sollen. Der Standardwert ist 24 Stunden. |
Incident Statuses to Fetch |
Erforderlich
Status der abzurufenden Vorfälle. Dieser Parameter akzeptiert mehrere Werte als kommagetrennten String. Der Standardwert ist |
Incident Severities to Fetch |
Erforderlich
Schweregrade der abzurufenden Vorfälle. Dieser Parameter akzeptiert mehrere Werte als kommagetrennten String. Der Standardwert ist |
Max Incidents per Cycle |
Erforderlich
Anzahl der Vorfälle, die während einer Connector-Ausführung verarbeitet werden sollen. Dieser Parameter akzeptiert mehrere Werte als kommagetrennten String. Der Standardwert ist 10. |
Proxy Server Address |
Optional
Adresse des zu verwendenden Proxyservers. |
Proxy Server Username |
Optional
Proxy-Nutzername für die Authentifizierung. |
Proxy Server Password |
Optional
Proxy-Passwort für die Authentifizierung. |
Connector-Regeln
Der Connector unterstützt keine Sperrlisten und dynamischen Listen.
Der Connector unterstützt Proxys.
Microsoft Azure Sentinel Incident Connector v2
Microsoft Azure Sentinel Incidents Connector v2 ist ein empfohlener Connector für die Arbeit mit Microsoft Sentinel. Zu den wichtigsten Änderungen gehören die Umstellung auf die neuen Vorfallsendpunkte in der Microsoft Sentinel API und die Einführung der Logik für die Verarbeitung und das Parsen von Connector-Entitäten. Wenn Sie bestimmte Microsoft Sentinel-Vorfälle filtern und anhand von Vorfallnamen abrufen möchten, verwenden Sie die dynamische Liste.
Es ist möglich, dass die Microsoft Sentinel-Benutzeroberfläche die Vorfallentitäten anzeigt, die API sie jedoch nicht zurückgibt (die Entitätsliste ist leer). Daher benötigt der Connector mehr Zeit, um solche Vorfälle aufzunehmen, und fragt sie im Backlog für die folgenden Connector-Ausführungen ab. Sobald die Informationen zu den Entitäten in der API-Antwort verfügbar sind, werden die Vorfälle vom Connector aufgenommen.
Verarbeitung geplanter und nicht geplanter Sentinel-Warnungen
Um ein Problem im Microsoft Azure Sentinel Incidents Connector zu beheben, bei dem Entitäten für alle Benachrichtigungen außer den geplanten Azure Sentinel-Benachrichtigungen fälschlicherweise angezeigt wurden, fügt der Microsoft Azure Sentinel Incidents Connector v2 für jede Entität ein zusätzliches Ereignis hinzu.
Wenn der Connector also eine IP-, Konto- oder Hostname-Entität im Google SecOps-Ereignis empfängt, fügt er für jede gefundene Entität ein zusätzliches Google SecOps-Ereignis hinzu. Das neu erstellte Ereignis kann verwendet werden, um Entitäten zu erstellen und Entitätsattribute in Google SecOps SOAR zuzuordnen. Die ursprünglichen Ereignisse bleiben erhalten. Neue Ereignisse werden nur der Google SecOps-Benachrichtigung hinzugefügt. Andere Entitätstypen sind von dieser Logik nicht betroffen und verbleiben im ursprünglichen Ereignis, ohne dass zusätzliche Ereignisse für sie erstellt werden.
Damit zusätzliche Ereignisse erstellt werden können, verwendet der Connector den Sentinel API-Endpunkt entity, um die Daten abzurufen. Sowohl geplante als auch NRT-Benachrichtigungen werden standardmäßig mithilfe von KQL-Abfragen für die Loganalyse aufgenommen, um Benachrichtigungs- und Ereignisdaten abzurufen. Wenn diese Option ausgewählt ist, wird für den Parameter Use the same approach with event creation for all alert types? in der Connector-Konfiguration derselbe entitätsbasierte Ansatz für alle Benachrichtigungen verwendet, einschließlich geplanter und nicht geplanter Benachrichtigungen. Wir empfehlen, diese Option mit Vorsicht zu verwenden.
Connector-Parameter
Verwenden Sie die folgenden Parameter, um den Connector zu konfigurieren:
| Parameter | |
|---|---|
Product Field Name |
Erforderlich
Name des Feldes, in dem der Produktname gespeichert ist. Der Standardwert ist |
Event Field Name |
Erforderlich
Name des Felds, in dem der Ereignisname gespeichert ist. Der Standardwert ist |
Environment Field Name |
Optional
Name des Felds, in dem der Umgebungsname gespeichert ist. Wenn das Feld „environment“ nicht gefunden wird, wird die Standardumgebung verwendet. Der Standardwert ist |
Environment Regex Pattern |
Optional
Ein Muster für reguläre Ausdrücke, das für den im Feld Der Standardwert Mit dem Parameter können Sie das Feld „environment“ mithilfe der Logik für reguläre Ausdrücke bearbeiten. Wenn das Muster des regulären Ausdrucks null oder leer ist oder der Umgebungswert null ist, ist das endgültige Umgebungsergebnis die Standardumgebung. |
Azure Subscription ID |
Erforderlich ID des Azure-Abos. |
Azure Active Directory ID |
Erforderlich Microsoft Entra-Mandanten-ID. |
Api Root |
Erforderlich Die Stamm-URL der API, die mit der Integration verwendet werden soll. Der Standardwert ist |
OAUTH2 Login Endpoint Url |
Erforderlich Endpunkt-URL, die für die OAuth 2.0-Authentifizierung verwendet werden soll. |
Azure Resource Group |
Erforderlich Name der Azure-Ressourcengruppe, in der sich Microsoft Sentinel befindet. |
Azure Sentinel Workspace Name |
Erforderlich Name des Microsoft Sentinel-Arbeitsbereichs, mit dem Sie arbeiten möchten. |
Client ID |
Erforderlich Microsoft Entra-Anwendungs-ID (Client-ID), die für diese Integration verwendet wird. |
Client Secret |
Erforderlich Microsoft Entra-Clientschlüsselwert. |
Script Timeout (Seconds) |
Erforderlich Zeitlimit für den Python-Prozess, der das aktuelle Script ausführt. Der Standardwert beträgt 180 Sekunden. |
Offset Time In Hours |
Erforderlich
Anzahl der Stunden vor dem aktuellen Zeitpunkt, ab dem Vorfälle abgerufen werden sollen. Der Standardwert ist 24 Stunden. |
Incident Statuses to Fetch |
Erforderlich
Status der abzurufenden Vorfälle. Dieser Parameter akzeptiert mehrere Werte als kommagetrennten String. Der Standardwert ist |
Incident Severities to Fetch |
Erforderlich
Schweregrade der abzurufenden Vorfälle. Dieser Parameter akzeptiert mehrere Werte als kommagetrennten String. Der Standardwert ist |
Use the same approach with event creation for all alert types?
|
Optional Wenn diese Option aktiviert ist, verwendet der Connector für alle Benachrichtigungstypen denselben Ansatz. Wenn das Häkchen nicht gesetzt ist, verwendet der Connector einen anderen Ansatz für den geplanten Azure Sentinel-Benachrichtigungstyp und versucht, Ereignisse abzurufen, die die Benachrichtigung ausgelöst haben, indem er die in den Benachrichtigungsdetails angegebene Abfrage ausführt. Standardmäßig deaktiviert. |
Use whitelist as a blacklist |
Erforderlich
Wenn das Häkchen gesetzt ist, wird die dynamische Liste als Sperrliste verwendet. Standardmäßig deaktiviert. |
Proxy Server Address |
Optional
Adresse des zu verwendenden Proxyservers. |
Proxy Server Username |
Optional
Proxy-Nutzername für die Authentifizierung. |
Proxy Server Password |
Optional
Proxy-Passwort für die Authentifizierung. |
Max Backlog Incidents per Cycle |
Erforderlich
Anzahl der Vorfälle, die während einer Connector-Ausführung aus dem Backlog abgerufen werden sollen. Der Standardwert ist 10. |
StartTimeFallback |
Erforderlich
Durch Kommas getrennte Liste von Vorfall- oder Benachrichtigungsattributen, die als Fallback für das Benachrichtigungsfeld Wenn keines der Fallback-Felder gefunden wird, verwendet der Connector das Attribut Der Standardwert ist |
EndTimeFallback |
Erforderlich
Durch Kommas getrennte Liste von Vorfall- oder Benachrichtigungsattributen, die als Fallback für das Benachrichtigungsfeld Wenn keines der Fallback-Felder gefunden wird, verwendet der Connector das Attribut Der Standardwert ist |
Enable Fallback Logic Debug? |
Optional
Wenn das Häkchen gesetzt ist, fügt der Connector den erstellten Ereignissen Debug-Felder mit den Werten hinzu, die für den Fallback verwendet werden. Standardmäßig deaktiviert. |
VendorFieldFallback |
Erforderlich
Durch Kommas getrennte Liste von Vorfallattributen, die als Fallback für das Feld Der Standardwert ist |
ProductFieldFallback |
Erforderlich
Durch Kommas getrennte Liste von Vorfallattributen, die als Fallback für das Feld Der Standardwert ist |
EventFieldFallback |
Erforderlich
Durch Kommas getrennte Liste von Vorfallattributen, die als Fallback für den Parameter Der Standardwert ist |
Max New Incidents per cycle |
Erforderlich
Anzahl der Vorfälle, die in einem Connector-Durchlauf verarbeitet werden sollen. Der Standardwert ist 10. |
Wait For Scheduled/NRT Alert Object |
Optional
Wenn diese Option aktiviert ist, wartet der Connector, bis ein geplantes/NRT-Benachrichtigungsobjekt verfügbar ist. |
Scheduled Alerts Events Limit to Ingest |
Optional
Maximale Anzahl von Ereignissen, die für eine einzelne geplante Azure Sentinel-Benachrichtigung oder NRT-Benachrichtigung aufgenommen werden sollen. Der Standardwert ist 100. |
Incidents Padding Period (minutes) |
Optional
Zeitraum in Minuten, in dem der Connector Vorfälle abruft und zurückgibt. Diese Vorfälle sind nicht in chronologischer Reihenfolge aufgeführt. |
Create Siemplify Alerts for Sentinel incidents that do not have
entities? |
Optional
Wenn diese Option aktiviert ist, erstellt der Connector Google SecOps-Benachrichtigungen aus Microsoft Sentinel-Vorfällen, die keine Entitäten haben. Andernfalls erstellt der Connector Google SecOps-Benachrichtigungen nur für geplante und NRT-Benachrichtigungen und überspringt alle anderen Microsoft Sentinel-Vorfälle. Standardmäßig deaktiviert. |
Incident's Alerts Limit to Ingest |
Optional
Maximale Anzahl von Benachrichtigungen, die für jeden Microsoft Sentinel-Vorfall aufgenommen werden sollen. |
Alert Name Template |
Optional
Wenn angegeben, verwendet der Connector diesen Wert aus den Vorfalldaten, die in der Microsoft Sentinel API-Antwort zurückgegeben werden, um das Feld Sie können einen Platzhalter im folgenden Format angeben: Die maximale Länge für das Feld beträgt 256 Zeichen. Wenn kein Wert angegeben wird oder Sie eine ungültige Vorlage angeben, verwendet der Connector den Standardnamen für Benachrichtigungen. |
Rule Generator Template |
Optional
Wenn angegeben, verwendet der Connector diesen Wert aus den Vorfalldaten, die in der Microsoft Sentinel API-Antwort zurückgegeben werden, um das Feld Sie können einen Platzhalter im folgenden Format angeben: Die maximale Länge für das Feld beträgt 256 Zeichen. Wenn kein Wert angegeben wird oder Sie eine ungültige Vorlage angeben, verwendet der Connector den Standardwert für den Regelgenerator. |
Felder „Benachrichtigungsname“ und „Regelgenerator“ anpassen
Mit dem Connector können Sie die Feldwerte Siemplify-Meldungsname und Regelgenerator mithilfe der Parameter Vorlage für Meldungsname und Vorlage für Regelgenerator anpassen. Bei Vorlagen ruft der Connector Informationen aus den Microsoft Sentinel-Vorfalldaten ab, die von der API zurückgegeben werden.
Im folgenden Beispiel werden die Vorfalldaten so angezeigt, wie sie von der API zurückgegeben werden. Dabei wird auf die Felder verwiesen, die in der Benachrichtigung verfügbar sind und für Vorlagen verwendet werden können:
{
"id": "/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.OperationalInsights/workspaces/WORKSPACE/providers/Microsoft.SecurityInsights/Incidents/d4f632be-0689-93f7-57a6-f27bfabbbad1",
"name": "d4f632be-0689-93f7-57a6-f27bfabbbad1",
"etag": "\"79004534-0000-0d00-0000-63590d610000\"",
"type": "Microsoft.SecurityInsights/Incidents",
"properties": {
"title": "Incident title",
"description": "",
"severity": "Low",
"status": "New",
"owner": {
"objectId": null,
"email": null,
"assignedTo": null,
"userPrincipalName": null
},
"labels": [],
"firstActivityTimeUtc": "2022-10-26T07:00:09.3857965Z",
"lastActivityTimeUtc": "2022-10-26T09:07:02.1083312Z",
"lastModifiedTimeUtc": "2022-10-26T10:35:13.0254798Z",
"createdTimeUtc": "2022-10-26T10:34:55.7454638Z",
"incidentNumber": 380925,
"additionalData": {
"alertsCount": 102,
"bookmarksCount": 0,
"commentsCount": 0,
"alertProductNames": [
"Azure Sentinel"
],
"tactics": [
"InitialAccess",
"Persistence"
]
},
"relatedAnalyticRuleIds": [
"/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.OperationalInsights/workspaces/WORKSPACE/Microsoft.SecurityInsights/alertRules/8a3ca5c5-7875-466e-accd-3bcb2881cdb0"
],
"incidentUrl": "https://portal.azure.com/#asset/Microsoft_Azure_Security_Insights/Incident/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.OperationalInsights/workspaces/WORKSPACE/Microsoft.SecurityInsights/Incidents/d4f632be-0689-93f7-57a6-f27bfabbbad1",
"providerName": "Azure Sentinel",
"providerIncidentId": "380925"
}
}
Connector-Regeln
Der Connector unterstützt die Sperrliste und die dynamische Liste.
Der Connector unterstützt Proxys.
Microsoft Sentinel Incident Tracking Connector
Mit dem Microsoft Sentinel Incident Tracking Connector können Sie mit Microsoft Sentinel-Vorfällen arbeiten und Aktualisierungen der Sentinel-Vorfälle als neue Google SecOps-Benachrichtigungen abrufen. Mit der dynamischen Liste können Sie die Namen der Vorfälle angeben, die abgerufen werden sollen. Für diesen Connector empfehlen wir, die Gruppierung von Google SecOps-Benachrichtigungen anhand des Parameters SourceGroupIdentifier zu konfigurieren.
Connector-Eingaben
Verwenden Sie die folgenden Parameter, um den Connector zu konfigurieren:
| Parameter | |
|---|---|
Product Field Name |
Erforderlich
Name des Feldes, in dem der Produktname gespeichert ist. Der Standardwert ist |
Event Field Name |
Erforderlich
Name des Felds, in dem der Ereignisname gespeichert ist. Der Standardwert ist |
Environment Field Name |
Optional
Name des Felds, in dem der Umgebungsname gespeichert ist. Wenn das Feld „environment“ nicht gefunden wird, wird die Standardumgebung verwendet. Der Standardwert ist |
Environment Regex Pattern |
Optional
Ein Muster für reguläre Ausdrücke, das für den im Feld Der Standardwert Mit dem Parameter können Sie das Feld „environment“ mithilfe der Logik für reguläre Ausdrücke bearbeiten. Wenn das Muster des regulären Ausdrucks null oder leer ist oder der Umgebungswert null ist, ist das endgültige Umgebungsergebnis die Standardumgebung. |
Azure Subscription ID |
Erforderlich ID des Azure-Abos. |
Entra ID Directory ID |
Erforderlich Microsoft Entra-Mandanten-ID. |
Api Root |
Erforderlich Die Stamm-URL der API, die mit der Integration verwendet werden soll. Der Standardwert ist |
OAUTH2 Login Endpoint Url |
Erforderlich Endpunkt-URL, die für die OAuth 2.0-Authentifizierung verwendet werden soll. |
Azure Resource Group |
Erforderlich Name der Azure-Ressourcengruppe, in der sich Microsoft Sentinel befindet. |
Azure Sentinel Workspace Name |
Erforderlich Name des Microsoft Sentinel-Arbeitsbereichs, mit dem Sie arbeiten möchten. |
Client ID |
Erforderlich Microsoft Entra-Anwendungs-ID (Client-ID), die für diese Integration verwendet wird. |
Client Secret |
Erforderlich Microsoft Entra-Clientschlüsselwert. |
Script Timeout (Seconds) |
Erforderlich Zeitlimit für den Python-Prozess, der das aktuelle Script ausführt. Der Standardwert beträgt 480 Sekunden. |
Verify SSL |
Optional Wenn diese Option ausgewählt ist, wird bei der Integration geprüft, ob das SSL-Zertifikat für die Verbindung zum Microsoft-Server gültig ist. Standardmäßig ausgewählt. |
Max Hours Backwards |
Erforderlich
Die Anzahl der Stunden vor der ersten Connector-Iteration, aus der die Vorfälle abgerufen werden sollen. Dieser Parameter gilt nur einmal für die erste Connector-Iteration, nachdem Sie den Connector zum ersten Mal aktiviert haben. Der Standardwert ist 24 Stunden. |
Incident Statuses to Fetch |
Erforderlich
Status der abzurufenden Vorfälle. Dieser Parameter akzeptiert mehrere Werte als kommagetrennten String. Der Standardwert ist |
Incident Severities to Fetch |
Erforderlich
Schweregrade der abzurufenden Vorfälle. Dieser Parameter akzeptiert mehrere Werte als kommagetrennten String. Der Standardwert ist |
Max Incidents per Cycle |
Erforderlich
Die Anzahl der Vorfälle, die während einer Connector-Ausführung aus dem Backlog abgerufen werden sollen. Der Standardwert ist 10. |
Use the same approach with event creation for all alert types?
|
Optional Wenn diese Option ausgewählt ist, verwendet der Connector für alle Benachrichtigungstypen denselben Ansatz. Wenn diese Option nicht ausgewählt ist, verwendet der Connector einen anderen Ansatz für den geplanten Microsoft Sentinel-Benachrichtigungstyp und versucht, Ereignisse abzurufen, die die Benachrichtigung verursacht haben, indem er die in den Benachrichtigungsdetails angegebene Abfrage ausführt. Standardmäßig nicht ausgewählt. |
Incidents Tags To Ingest |
Optional
Eine durch Kommas getrennte Liste von Vorfall-Tags, die aufgenommen werden sollen. Der Connector ignoriert Vorfälle, die nicht die Tags aus dieser Liste haben. |
Use whitelist as a blacklist |
Erforderlich
Wenn diese Option ausgewählt ist, wird die dynamische Liste als Sperrliste verwendet. Standardmäßig nicht ausgewählt. |
Backlog Expiration Timer |
Erforderlich
Ein Zeitraum in Minuten, für den der Connector die Vorfälle in einem Backlog aufbewahrt. Der Standardwert ist 60 Minuten. |
StartTimeFallback |
Erforderlich
Eine durch Kommas getrennte Liste von Vorfall- oder Benachrichtigungsattributen, die als Fallback für das Benachrichtigungsfeld Wenn keines der Fallback-Felder gefunden wird, verwendet der Connector das Attribut Der Standardwert ist |
EndTimeFallback |
Erforderlich
Eine durch Kommas getrennte Liste von Vorfall- oder Benachrichtigungsattributen, die als Fallback für das Benachrichtigungsfeld Wenn keines der Fallback-Felder gefunden wird, verwendet der Connector das Attribut Der Standardwert ist |
Enable Fallback Logic Debug? |
Optional
Wenn diese Option ausgewählt ist, fügt der Connector den erstellten Ereignissen Debug-Felder mit den Werten hinzu, die für den Fallback verwendet werden. Standardmäßig nicht ausgewählt. |
VendorFieldFallback |
Erforderlich
Eine durch Kommas getrennte Liste von Vorfallattributen, die als Fallback für das Feld Der Standardwert ist |
ProductFieldFallback |
Erforderlich
Eine durch Kommas getrennte Liste von Vorfallattributen, die als Fallback für das Feld Der Standardwert ist |
EventFieldFallback |
Erforderlich
Eine durch Kommas getrennte Liste von Vorfallattributen, die als Fallback für den Parameter Der Standardwert ist |
Max Backlog Incidents per cycle |
Erforderlich
Die Anzahl der Vorfälle, die in einem Connector-Ausführungsvorgang aus dem Backlog abgerufen werden sollen. Der Standardwert ist 10. |
Disable Overflow |
Optional Wenn diese Option ausgewählt ist, deaktiviert der Connector einen Ereignisüberlauf. Standardmäßig nicht ausgewählt. |
Total Number of Scheduled Alerts Events Limit to Ingest |
Optional
Die maximale Anzahl von Ereignissen, die für eine einzelne geplante Microsoft Sentinel-Benachrichtigung oder eine NRT-Benachrichtigung aufgenommen werden sollen. Der Standardwert ist 100. |
Create Chronicle SOAR Alerts for Sentinel incidents that do not
have entities? |
Optional
Wenn diese Option ausgewählt ist, erstellt der Connector Google SecOps-Benachrichtigungen aus Microsoft Sentinel-Vorfällen, die keine Entitäten haben. Andernfalls erstellt der Connector Google SecOps-Benachrichtigungen nur für geplante und NRT-Benachrichtigungen und überspringt alle anderen Microsoft Sentinel-Vorfälle. Standardmäßig nicht ausgewählt. |
Incident's Alerts Limit to Ingest |
Optional
Die maximale Anzahl von Benachrichtigungen, die für jeden Microsoft Sentinel-Vorfall aufgenommen werden sollen. |
Incidents Padding Period (minutes) |
Optional
Zeitraum in Minuten vor dem aktuellen Zeitpunkt, für den der Connector Vorfälle abrufen und zurückgeben soll. Der Connector gibt Vorfälle nicht in chronologischer Reihenfolge zurück. |
Alert Name Template |
Optional
Wenn angegeben, verwendet der Connector diesen Wert aus den Vorfalldaten, die in der Microsoft Sentinel API-Antwort zurückgegeben werden, für einen Google SecOps SOAR-Benachrichtigungsnamen. Sie können einen Platzhalter im folgenden Format angeben: Die maximale Länge für das Feld beträgt 256 Zeichen. Wenn kein Wert angegeben wird oder Sie eine ungültige Vorlage angeben, verwendet der Connector den Standardnamen für Benachrichtigungen. |
Rule Generator Template |
Optional
Wenn angegeben, verwendet der Connector diesen Wert aus den Vorfalldaten, die in der Microsoft Sentinel API-Antwort für einen Google SecOps SOAR-Regelgenerator zurückgegeben werden. Sie können einen Platzhalter im folgenden Format angeben: Die maximale Länge für das Feld beträgt 256 Zeichen. Wenn kein Wert angegeben wird oder Sie eine ungültige Vorlage angeben, verwendet der Connector den Standardwert für den Regelgenerator. |
How many hours to track ingested incident for updates |
Erforderlich
Ein Zeitraum, in dem der Connector die bereits aufgenommenen Sentinel-Vorfälle auf Aktualisierungen wie das Hinzufügen neuer Ereignisse oder Entitäten oder Vorfalldetails prüft. Der Standardwert ist 24 Stunden. |
Wait For Scheduled/NRT Alert Object |
Optional
Wenn diese Option aktiviert ist, wartet der Connector, bis ein geplantes/NRT-Benachrichtigungsobjekt verfügbar ist. |
Proxy Server Address |
Optional
Adresse des zu verwendenden Proxyservers. |
Proxy Server Username |
Optional
Proxy-Nutzername für die Authentifizierung. |
Proxy Server Password |
Optional
Proxy-Passwort für die Authentifizierung. |
Incident Creation Time Filter (days) |
Optional
Die Anzahl der Tage vor der aktuellen Zeit, für die Vorfälle abgerufen werden sollen. Wenn angegeben, ruft der Connector nur Vorfälle ab, die innerhalb dieses Zeitraums erstellt wurden. Dieser Wert muss eine gültige positive Ganzzahl sein. Dies ist ein erweiterter Parameter. |
Connector-Regeln
Der Microsoft Sentinel Incident Tracking Connector unterstützt Sperrlisten und dynamische Listen.
Jobs
Weitere Informationen zu Jobs finden Sie unter Neuen Job konfigurieren und Erweiterte Planung.
Verworfen: Microsoft Sentinel – Vorfälle synchronisieren
Verwenden Sie den Job Microsoft Sentinel – Vorfälle synchronisieren, um Google SecOps-Benachrichtigungen mit Microsoft Sentinel-Vorfällen zu synchronisieren. So werden Kommentare, Status und Tags zwischen den beiden Systemen synchronisiert.
Damit der Job die richtigen Informationen identifizieren kann, muss der Google SecOps-Fall das Tag Microsoft Sentinel Incident haben. Wenn eine Benachrichtigung nicht von Microsoft Azure Sentinel Incident Connector v2 stammt, müssen Sie dem Fall einen Incident_ID-Kontextwert hinzufügen, damit der Job die richtigen Informationen findet.
Jobverhalten
Dieser Job besteht aus zwei Hauptteilen:
- Der Job synchronisiert Benachrichtigungsstatus, Kommentare und Tags von Microsoft Sentinel mit Google SecOps.
- Der Job synchronisiert alle Aktualisierungen von Google SecOps zurück mit Microsoft Sentinel.
Der Job verarbeitet pro Iteration eine maximale Anzahl von Fällen, um eine stabile Leistung zu gewährleisten. Dabei wird die Zeit der letzten Änderung eines Falls herangezogen, um sicherzustellen, dass keine Aktualisierungen übersehen werden.
Wenn eine Benachrichtigung in einem der Systeme geschlossen wird, wird die Schließung durch den Job synchronisiert. Die Statuszuordnung sieht so aus:
Maliciouswird einem Microsoft Sentinel-Status vonClosedmit dem GrundTrue Positivezugeordnet.Not Maliciouswird einem Microsoft Sentinel-Status vonClosedmit dem GrundFalse Positivezugeordnet.- Jeder andere Schließungswert wird einem Microsoft Sentinel-Status von
Closedmit dem GrundUnknownzugeordnet.
Wichtige Hinweise zur API-Ratenbegrenzung
Bei diesem Job wird die Microsoft Graph API verwendet, um Vorfälle zu verwalten. Die Ratenbegrenzung liegt bei 20 Anfragen pro Minute. Um das Risiko zu verringern, dass dieses Limit erreicht wird, wird dringend empfohlen, eine separate Microsoft Entra ID-Anwendung speziell für diesen Job mit der Berechtigung SecurityIncident.ReadWrite.All einzurichten.
Jobparameter
Für den Job Microsoft Sentinel – Vorfälle synchronisieren sind die folgenden Parameter erforderlich:
| Parameter | Beschreibung |
|---|---|
Environment Name |
Erforderlich. Der Name der Umgebung, aus der Vorfälle synchronisiert werden sollen.Der Standardwert ist |
Azure Active Directory ID |
Erforderlich. Ihre eindeutige Verzeichnis-ID in Azure (Mandanten-ID). |
OAUTH2 Login Endpoint Url |
Erforderlich. Die URL für den OAuth 2.0-Endpunkt.Der Standardwert ist |
API Root |
Erforderlich. Die Basis-URL für die Graph API.Der Standardwert ist |
Client ID |
Erforderlich. Die eindeutige ID der in Azure Active Directory registrierten Anwendung. |
Client Secret |
Erforderlich. Der vertrauliche Schlüssel, der mit demClient ID verwendet wird.
|
Max Hours Backwards |
Erforderlich. Die Anzahl der Stunden in der Vergangenheit, für die Vorfälle synchronisiert werden sollen.Der Standardwert ist |
Verify SSL |
Erforderlich. Prüft das SSL-Zertifikat für den Microsoft Sentinel-Server.Standardmäßig aktiviert. |
Microsoft Sentinel – Vorfälle synchronisieren V2
Verwenden Sie den Job Sync Incidents V2, um Google SecOps-Benachrichtigungen mit Microsoft Sentinel-Vorfällen zu synchronisieren. Mit diesem Job werden Kommentare, Status und Tags bidirektional zwischen beiden Systemen synchronisiert.
Jobverhalten
Voraussetzungen: Damit der Job die richtigen Informationen identifizieren kann, muss der Google SecOps-Fall das Tag
Microsoft Sentinel Incidenthaben. Dieser Job funktioniert nur für Benachrichtigungen vom Microsoft Azure Sentinel Incident Connector v2.Anfängliche Logik: Bei der ersten Iteration wird
Max Hours Backwardsverwendet, um Benachrichtigungen abzufragen, deren Startzeit größer oder gleich der aktuellen Zeit abzüglich der angegebenen Stunden ist. Bei nachfolgenden Ausführungen wird diestart_timeder zuletzt verarbeiteten Benachrichtigung verwendet.Statussynchronisierung: Der Job überwacht beide Systeme auf Statusänderungen. Wenn ein Vorfall in Microsoft Sentinel geschlossen wird, werden der Google SecOps-Fall und der Benachrichtigungsstatus automatisch aktualisiert.
Wenn der Grund für Microsoft Sentinel
True positive - Suspicious activityist, wird der Grund für das Schließen in Google SecOps aufMaliciousgesetzt.Wenn der Microsoft Sentinel-Grund entweder
False Positive - Incorrect Alert LogicoderFalse Positive - Inaccurate Dataist, wird der Google SecOps-Grund für das Schließen aufNot Maliciousgesetzt.Alle anderen Werte führen zu einem Google SecOps-Schließungsgrund von
Inconclusive.
Diese Synchronisierung funktioniert auch von Google SecOps zu Microsoft Sentinel.
Kommentarsynchronisierung: Kommentare von Sentinel zu Google SecOps verwenden die folgende Struktur:
Microsoft Sentinel IncidentINCIDENT_NUMBER:COMMENT.Kommentare von Google SecOps an Sentinel haben die folgende Struktur:
Google SecOps CaseCASE_ID:COMMENT.Tag-Synchronisierung: Tags werden mit bestimmten Präfixen synchronisiert, um die Quelle klar zu kennzeichnen.
- Google SecOps-Tags:
Google SecOps:TAG. - Microsoft Sentinel-Tags:
Microsoft Sentinel:TAG.
- Google SecOps-Tags:
Synchronisierung von Schweregrad und zugewiesener Person: Microsoft Sentinel dient als Source of Truth für diese Felder. Die Synchronisierung von Schweregrad und zugewiesener Person erfolgt ausschließlich von Microsoft Sentinel zu Google SecOps.
Steuerung der Synchronisierung von Zuständigen Personen: Wenn
Sync Assigneedeaktiviert ist, wird die zuständige Person nicht von Microsoft Sentinel mit Google SecOps synchronisiert.
Jobparameter
Für den Job Sync Incidents V2 sind die folgenden Parameter erforderlich:
| Parameter | Beschreibung |
|---|---|
Environment Name |
Erforderlich. Der Name der Umgebung, aus der Vorfälle synchronisiert werden sollen. Der Standardwert ist |
Azure Subscription ID |
Erforderlich. Die ID des Azure-Abos, das den Sentinel-Arbeitsbereich enthält. |
Azure Active Directory ID |
Erforderlich. Ihre eindeutige Verzeichnis-ID in Azure, auch als Mandanten-ID bezeichnet. |
OAUTH2 Login Endpoint Url |
Erforderlich. Die URL für den OAuth 2.0-Endpunkt, an dem der Job ein Authentifizierungstoken anfordert. Der Standardwert ist |
Management API Root |
Erforderlich. Die Basis-URL für die Management API. Der Job hängt bestimmte API-Aufrufe an diese Stamm-URL an, um Daten abzurufen. Der Standardwert ist |
Azure Resource Group |
Erforderlich. Der Name der Azure-Ressourcengruppe, in der sich der Sentinel-Arbeitsbereich befindet. |
Azure Sentinel Workspace Name |
Erforderlich. Der Name des Microsoft Sentinel-Arbeitsbereichs. |
Client ID |
Erforderlich. Die eindeutige ID der in Azure Active Directory registrierten Anwendung, der Berechtigungen für den Zugriff auf Microsoft Sentinel gewährt werden. |
Client Secret |
Erforderlich. Der vertrauliche Schlüssel für die Anwendung, der in Verbindung mit |
Max Hours Backwards |
Erforderlich. Die Anzahl der Stunden, für die Vorfälle vor der aktuellen Zeit synchronisiert werden sollen. Der Standardwert ist |
Sync Assignee |
Optional. Wenn diese Option ausgewählt ist, wird der zugewiesene Nutzer von Microsoft Sentinel mit Google SecOps synchronisiert. |
Verify SSL |
Erforderlich. Wenn diese Option ausgewählt ist, validiert die Integration das SSL-Zertifikat, wenn eine Verbindung zumStandardmäßig aktiviert. |
Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten