Ressourcentyp detectionRule

Namespace: microsoft.graph.security

Stellt eine benutzerdefinierte Erkennungsregel dar, die im Rahmen der erweiterten Suche geschrieben wurde, um Sicherheitsereignisse automatisch zu erkennen, sobald sie auftreten, und um Warnungen und Reaktionsaktionen auszulösen.

Benutzerdefinierte Erkennungsregeln ermöglichen Ihnen die proaktive Überwachung verschiedener Ereignisse und Systemzustände mithilfe erweiterter Suchabfragen , einschließlich mutmaßlicher Verstoßaktivitäten und falsch konfigurierter Endpunkte. Eine benutzerdefinierte Erkennungsregel erkennt Sicherheitsereignisse automatisch, sobald sie auftreten, und löst Warnungen und Reaktionsaktionen aus. Sie können die Regeln so festlegen, dass sie in regelmäßigen Intervallen ausgeführt werden, Warnungen generieren und bei Übereinstimmungen Gegenmaßnahmen ergreifen.

Erbt von entity.

Methoden

Methode Rückgabetyp Beschreibung
List microsoft.graph.security.detectionRule-Sammlung Rufen Sie eine Liste der detectionRule-Objekte und ihrer Eigenschaften ab.
Create microsoft.graph.security.detectionRule Erstellen Sie ein neues detectionRule-Objekt .
Get microsoft.graph.security.detectionRule Lesen Sie die Eigenschaften und Beziehungen eines detectionRule-Objekts .
Update microsoft.graph.security.detectionRule Aktualisieren Sie die Eigenschaften eines detectionRule-Objekts .
Löschen Keine Löschen Sie ein detectionRule-Objekt .

Eigenschaften

Eigenschaft Typ Beschreibung
createdBy Zeichenfolge Name des Benutzers oder der Anwendung, der bzw. der die Regel erstellt hat. Schreibgeschützt. Unterstützt $filter (eq, ne, not, in, startsWith, endsWith, contains).
createdDateTime DateTimeOffset Zeitstempel der Regelerstellung. Schreibgeschützt. Unterstützt $filter (eq, ne, not, le, ge, ltgt, ) und $orderby.
description Zeichenfolge Eine vom Benutzer bereitgestellte Beschreibung der Erkennungsregel. Unterstützt $filter (eq, ne, not, in, startsWith, endsWith, contains).
detectionAction microsoft.graph.security.detectionAction Die Aktionen, die bei einer Erkennung durch diese Regel ausgeführt werden, einschließlich der erstellten Warnung und aller automatisierten Antwortaktionen. Unterstützt $filter die folgenden geschachtelten alertTemplate-Eigenschaften :
  • Zeichenfolge: detectionAction/alertTemplate/title, detectionAction/alertTemplate/description, detectionAction/alertTemplate/recommendedActions — jeweils unterstützt eq, ne, not, in, startsWithendsWithcontains, .
  • Enum: detectionAction/alertTemplate/severity — unterstützt eq, ne, not, in.
    		•
    displayName Zeichenfolge Der Anzeigename der Regel. Unterstützt $filter (eq, ne, not, in, startsWith, endsWithcontains, ) und $orderby.
    id Zeichenfolge Der vom Client bereitgestellte eindeutige Bezeichner der Regel. Unterstützt $filter (eq, ne, notin, ) und $orderby.
    lastModifiedBy Zeichenfolge Name des Benutzers oder der Anwendung, der die Regel zuletzt aktualisiert hat. Schreibgeschützt. Unterstützt $filter (eq, ne, not, in, startsWith, endsWith, contains).
    lastModifiedDateTime DateTimeOffset Zeitstempel der letzten Aktualisierung der Regel. Schreibgeschützt. Unterstützt $filter (eq, ne, not, le, ge, ltgt, ) und $orderby.
    queryCondition microsoft.graph.security.queryCondition Die Abfrage für die erweiterte Suche, die die Erkennungslogik dieser Regel definiert. Unterstützt $filter für queryCondition/queryText (String) mit eq, ne, not, in, startsWith, endsWith, . contains
    Zeitplan microsoft.graph.security.ruleSchedule Der auslösende Zeitplan für diese Regel. Unterstützt $filternach Zeitplan/Häufigkeit (Dauer) mit eq, ne, not, le, ge, ltgt, . Unterstützt $orderby nach Zeitplan/Häufigkeit.
    status microsoft.graph.security.detectionRuleStatus Der aktuelle Ausführungs-Status der Regel. Mögliche Werte sind: enabled, disabled, autoDisabled, unknownFutureValue. Unterstützt $filter (eq, ne, notin, ) und $orderby.

    Beziehungen

    Keine.

    JSON-Darstellung

    Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

    {
  "@odata.type": "#microsoft.graph.security.detectionRule",
  "id": "String (identifier)",
  "displayName": "String",
  "description": "String",
  "status": "String",
  "createdBy": "String",
  "createdDateTime": "String (timestamp)",
  "lastModifiedBy": "String",
  "lastModifiedDateTime": "String (timestamp)",
  "queryCondition": {
    "@odata.type": "microsoft.graph.security.queryCondition"
  },
  "schedule": {
    "@odata.type": "microsoft.graph.security.ruleSchedule"
  },
  "detectionAction": {
    "@odata.type": "microsoft.graph.security.detectionAction"
  }
}
    • Zuletzt aktualisiert um