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

  1. 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.
  2. 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

  1. Melden Sie sich im Azure-Portal als Nutzeradministrator oder Passwortadministrator an.

  2. Wählen Sie Microsoft Entra ID aus.

  3. Rufen Sie App-Registrierungen > Neue Registrierung auf.

  4. Geben Sie den Namen der App ein.

  5. Wählen Sie den entsprechenden unterstützten Kontotyp aus.

  6. Klicken Sie auf Registrieren.

  7. 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

  1. Rufen Sie Zertifikate und Secrets > Neuer Clientschlüssel auf.

  2. Geben Sie eine Beschreibung für einen Clientschlüssel an und legen Sie ein Ablaufdatum fest.

  3. Klicken Sie auf Hinzufügen.

  4. Speichern Sie den Wert des Clientschlüssels (nicht die Secret-ID), um ihn beim Konfigurieren der Integration als Parameterwert für Client Secret zu verwenden. Der Clientschlüsselwert wird nur einmal angezeigt.

Registrierter Microsoft Entra-Anwendung Zugriff auf den Microsoft Sentinel-Arbeitsbereich gewähren

  1. Rufen Sie die Microsoft Sentinel-Übersichtsseite auf.

  2. Klicken Sie auf Einstellungen.

  3. Klicken Sie auf Zugriffssteuerung (IAM).

  4. Klicken Sie im Bereich Rollenzuweisung hinzufügen auf Hinzufügen.

  5. Konfigurieren Sie die folgenden Parameter:

    • Rolle = Azure Sentinel Contributor.

    • Zugriff zuweisen zu = default, Microsoft Entra ID user group, or service principal.

  6. 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.

  7. Rufen Sie die Seite mit den Microsoft Sentinel-Arbeitsbereichen auf. Suchen und konfigurieren Sie die folgenden Parameter:

    • Azure Resource Group
    • Azure 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
(Nur wenn die Tabelle nicht optional ist)

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:
Nicht aktualisiert, Richtig positiv – verdächtige Aktivität, Gutartig positiv – verdächtig, aber erwartet,
Falsch positiv – falsche Benachrichtigungslogik, Falsch positiv – ungenaue Daten, Unbestimmt)

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
(Nur wenn die Tabelle nicht optional ist)

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
(Nur wenn die Tabelle nicht optional ist)

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
(Nur wenn die Tabelle nicht optional ist)

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
(Nur wenn die Tabelle nicht optional ist)

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
(Nur wenn die Tabelle nicht optional ist)

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
(Nur wenn die Tabelle nicht optional ist)

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
(Nur wenn die Tabelle nicht optional ist)

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:

  • Bei Erfolg: „Successfully added a comment to Microsoft Sentinel incident {0}“.format(Incident number).

  • Wenn der Vorfall anhand der angegebenen Vorfallnummer nicht gefunden werden kann: „Microsoft Sentinel-Vorfall {0} wurde nicht gefunden!“. format(incident_case_number).

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

  • Bei schwerwiegendem Fehler, z. B. falschen Anmeldedaten: „Failed to add a comment to Microsoft Sentinel incident! Fehler ist {0}".format(exception.stacktrace).
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 ProductName.

Event Field Name Erforderlich

Name des Felds, in dem der Ereignisname gespeichert ist.

Der Standardwert ist AlertName.

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 Environment Field Name gefundenen Wert ausgeführt werden soll.

Der Standardwert .* fängt alle ab und gibt den Wert unverändert zurück.

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 https://management.azure.com.

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 Active, New, Closed.

Incident Severities to Fetch Erforderlich

Schweregrade der abzurufenden Vorfälle. Dieser Parameter akzeptiert mehrere Werte als kommagetrennten String.

Der Standardwert ist Informational, Low, Medium, High.

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 product_type.

Event Field Name Erforderlich

Name des Felds, in dem der Ereignisname gespeichert ist.

Der Standardwert ist event_type.

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 Environment Field Name gefundenen Wert ausgeführt werden soll.

Der Standardwert .* fängt alle ab und gibt den Wert unverändert zurück.

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 https://management.azure.com.

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 Active, New, Closed.

Incident Severities to Fetch Erforderlich

Schweregrade der abzurufenden Vorfälle. Dieser Parameter akzeptiert mehrere Werte als kommagetrennten String.

Der Standardwert ist Informational, Low, Medium, High.

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 Start Time in absteigender Reihenfolge verwendet werden sollen. Außerdem wird erstellten Ereignissen ein neues Siemplify_Start_Time-Attribut hinzugefügt. Das erste Attribut hat die höchste Priorität. Wenn das nächste Attribut im Ereignis nicht vorhanden oder leer ist, wird auf den nächsten Prioritätswert aus der Liste zurückgegriffen.

Wenn keines der Fallback-Felder gefunden wird, verwendet der Connector das Attribut createdTimeUTC. Wenn kein createdTimeUTC-Attribut vorhanden ist, verwendet der Connector die Zeit, zu der die Benachrichtigung in Google SecOps SOAR aufgenommen wurde.

Der Standardwert ist properties_firstActivityTimeGenerated, properties_startTimeUtc,properties_createdTimeUtc, properties_firstAlertTimeGenerated.

EndTimeFallback Erforderlich

Durch Kommas getrennte Liste von Vorfall- oder Benachrichtigungsattributen, die als Fallback für das Benachrichtigungsfeld End Time in absteigender Reihenfolge verwendet werden sollen. Außerdem wird erstellten Ereignissen ein neues Siemplify_End_Time-Attribut hinzugefügt. Das erste Attribut hat die höchste Priorität. Wenn das nächste Attribut im Ereignis nicht vorhanden oder leer ist, wird auf den nächsten Prioritätswert aus der Liste zurückgegriffen.

Wenn keines der Fallback-Felder gefunden wird, verwendet der Connector das Attribut createdTimeUTC. Wenn kein createdTimeUTC-Attribut vorhanden ist, verwendet der Connector die Zeit, zu der die Benachrichtigung in Google SecOps SOAR aufgenommen wurde.

Der Standardwert ist properties_lastActivityTimeGenerated, properties_endTimeUtc,properties_createdTimeUtc, properties_lastAlertTimeGenerated.

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 DeviceVendor in absteigender Reihenfolge verwendet werden sollen. Das erste Attribut hat die höchste Priorität. Wenn das nächste Attribut im Ereignis nicht vorhanden oder leer ist, wird auf den nächsten Prioritätswert aus der Liste zurückgegriffen.

Der Standardwert ist vendorName.

ProductFieldFallback Erforderlich

Durch Kommas getrennte Liste von Vorfallattributen, die als Fallback für das Feld DeviceVendor in absteigender Reihenfolge verwendet werden sollen. Das erste Attribut hat die höchste Priorität. Wenn das nächste Attribut im Ereignis nicht vorhanden oder leer ist, wird auf den nächsten Prioritätswert aus der Liste zurückgegriffen.

Der Standardwert ist ProductName.

EventFieldFallback Erforderlich

Durch Kommas getrennte Liste von Vorfallattributen, die als Fallback für den Parameter Event Field Name in absteigender Reihenfolge verwendet werden sollen. Das erste Attribut hat die höchste Priorität. Wenn das nächste Attribut im Ereignis nicht vorhanden oder leer ist, wird auf den nächsten Prioritätswert aus der Liste zurückgegriffen.

Der Standardwert ist kind.

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 Siemplify Alert Name zu füllen.

Sie können einen Platzhalter im folgenden Format angeben: [name of the field], z. B. Sentinel incident - [title].

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 Siemplify Rule Generator zu füllen.

Sie können einen Platzhalter im folgenden Format angeben: [name of the field], z. B. Sentinel incident - [severity].

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 product_type.

Event Field Name Erforderlich

Name des Felds, in dem der Ereignisname gespeichert ist.

Der Standardwert ist event_type.

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 Environment Field Name gefundenen Wert ausgeführt werden soll.

Der Standardwert .* fängt alle ab und gibt den Wert unverändert zurück.

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 https://management.azure.com.

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 Active, New, Closed.

Incident Severities to Fetch Erforderlich

Schweregrade der abzurufenden Vorfälle. Dieser Parameter akzeptiert mehrere Werte als kommagetrennten String.

Der Standardwert ist Informational, Low, Medium, High.

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 Start Time in absteigender Reihenfolge verwendet werden sollen. Außerdem gilt für erstellte Ereignisse ein neues SecOps_Start_Time-Attribut. Das erste Attribut hat die höchste Priorität. Wenn das folgende Attribut im Ereignis nicht vorhanden oder leer ist, wird auf den nächsten Prioritätswert aus der Liste zurückgegriffen.

Wenn keines der Fallback-Felder gefunden wird, verwendet der Connector das Attribut createdTimeUTC. Wenn kein createdTimeUTC-Attribut vorhanden ist, verwendet der Connector die Zeit, zu der die Benachrichtigung in Google SecOps SOAR aufgenommen wurde.

Der Standardwert ist properties_firstActivityTimeGenerated, properties_startTimeUtc,properties_createdTimeUtc, properties_firstAlertTimeGenerated.

EndTimeFallback Erforderlich

Eine durch Kommas getrennte Liste von Vorfall- oder Benachrichtigungsattributen, die als Fallback für das Benachrichtigungsfeld End Time in absteigender Reihenfolge verwendet werden sollen. Außerdem wird erstellten Ereignissen ein neues SecOps_End_Time-Attribut hinzugefügt. Das erste Attribut hat die höchste Priorität. Wenn das nächste Attribut im Ereignis nicht vorhanden oder leer ist, wird auf den nächsten Prioritätswert aus der Liste zurückgegriffen.

Wenn keines der Fallback-Felder gefunden wird, verwendet der Connector das Attribut createdTimeUTC. Wenn kein createdTimeUTC-Attribut vorhanden ist, verwendet der Connector die Zeit, zu der die Benachrichtigung in Google SecOps SOAR aufgenommen wurde.

Der Standardwert ist properties_lastActivityTimeGenerated, properties_endTimeUtc,properties_createdTimeUtc, properties_lastAlertTimeGenerated.

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 DeviceVendor in absteigender Reihenfolge verwendet werden sollen. Das erste Attribut hat die höchste Priorität. Wenn das folgende Attribut im Ereignis nicht vorhanden oder leer ist, wird auf den nächsten Prioritätswert aus der Liste zurückgegriffen.

Der Standardwert ist vendorName.

ProductFieldFallback Erforderlich

Eine durch Kommas getrennte Liste von Vorfallattributen, die als Fallback für das Feld DeviceVendor in absteigender Reihenfolge verwendet werden sollen. Das erste Attribut hat die höchste Priorität. Das folgende Attribut, falls im Ereignis nicht vorhanden oder leer, greift auf den nächsten Prioritätswert aus der Liste zurück.

Der Standardwert ist ProductName.

EventFieldFallback Erforderlich

Eine durch Kommas getrennte Liste von Vorfallattributen, die als Fallback für den Parameter Event Field Name in absteigender Reihenfolge verwendet werden sollen. Das erste Attribut hat die höchste Priorität. Wenn das nächste Attribut im Ereignis nicht vorhanden oder leer ist, wird auf den nächsten Prioritätswert aus der Liste zurückgegriffen.

Der Standardwert ist kind.

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: [name of the field], z. B. Sentinel incident - [title].

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: [name of the field], z. B. Sentinel incident - [severity].

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:

  1. Der Job synchronisiert Benachrichtigungsstatus, Kommentare und Tags von Microsoft Sentinel mit Google SecOps.
  2. 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:

  • Malicious wird einem Microsoft Sentinel-Status von Closed mit dem Grund True Positive zugeordnet.
  • Not Malicious wird einem Microsoft Sentinel-Status von Closed mit dem Grund False Positive zugeordnet.
  • Jeder andere Schließungswert wird einem Microsoft Sentinel-Status von Closed mit dem Grund Unknown zugeordnet.

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 Default Environment.

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 https://login.microsoftonline.com.

API Root

Erforderlich.

Die Basis-URL für die Graph API.

Der Standardwert ist https://graph.microsoft.com.

Client ID

Erforderlich.

Die eindeutige ID der in Azure Active Directory registrierten Anwendung.
Client Secret

Erforderlich.

Der vertrauliche Schlüssel, der mit dem Client 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 24.

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 Incident haben. Dieser Job funktioniert nur für Benachrichtigungen vom Microsoft Azure Sentinel Incident Connector v2.

  • Anfängliche Logik: Bei der ersten Iteration wird Max Hours Backwards verwendet, um Benachrichtigungen abzufragen, deren Startzeit größer oder gleich der aktuellen Zeit abzüglich der angegebenen Stunden ist. Bei nachfolgenden Ausführungen wird die start_time der 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 activity ist, wird der Grund für das Schließen in Google SecOps auf Malicious gesetzt.

    • Wenn der Microsoft Sentinel-Grund entweder False Positive - Incorrect Alert Logic oder False Positive - Inaccurate Data ist, wird der Google SecOps-Grund für das Schließen auf Not Malicious gesetzt.

    • 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 Incident INCIDENT_NUMBER: COMMENT.

    Kommentare von Google SecOps an Sentinel haben die folgende Struktur: Google SecOps Case CASE_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.
  • 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 Assignee deaktiviert 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 Default Environment.

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 https://login.microsoftonline.com.

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 https://management.azure.com.

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 Client ID zur Authentifizierung und Autorisierung des Jobs verwendet wird.

Max Hours Backwards

Erforderlich.

Die Anzahl der Stunden, für die Vorfälle vor der aktuellen Zeit synchronisiert werden sollen.

Der Standardwert ist 24.

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 zum

Standardmäßig aktiviert.

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