type de ressource detectionRule

Espace de noms : microsoft.graph.security

Représente une règle de détection personnalisée écrite dans le cadre du repérage avancé pour reconnaître automatiquement les événements de sécurité lorsqu’ils se produisent et déclencher des alertes et des actions de réponse.

Les règles de détection personnalisées vous permettent de surveiller de manière proactive divers événements et états du système à l’aide de requêtes de repérage avancées , y compris les activités de violation présumées et les points de terminaison mal configurés. Une règle de détection personnalisée reconnaît automatiquement les événements de sécurité lorsqu’ils se produisent et déclenche des alertes et des actions de réponse. Vous pouvez définir les règles pour qu’elles s’exécutent à intervalles réguliers, générant des alertes et effectuant des actions de réponse chaque fois que des correspondances se produisent.

Hérite de l’entité.

Méthodes

Méthode Type de retour Description
List collection microsoft.graph.security.detectionRule Obtenez une liste des objets detectionRule et leurs propriétés.
Create microsoft.graph.security.detectionRule Créez un objet detectionRule .
Obtenir microsoft.graph.security.detectionRule Lire les propriétés et les relations d’un objet detectionRule .
Mettre à jour microsoft.graph.security.detectionRule Mettez à jour les propriétés d’un objet detectionRule .
Supprimer Aucun Supprimez un objet detectionRule .

Propriétés

Propriété Type Description
createdBy String Nom de l’utilisateur ou de l’application qui a créé la règle. En lecture seule. Prend en charge $filter (eq, ne, not, in, startsWith, endsWith, contains).
createdDateTime DateTimeOffset Horodatage de la création de la règle. En lecture seule. Prend en charge (, , , lenot, ltgegt) et $orderby. neeq$filter
description String Description fournie par l’utilisateur de la règle de détection. Prend en charge $filter (eq, ne, not, in, startsWith, endsWith, contains).
detectionAction microsoft.graph.security.detectionAction Les actions effectuées lorsqu’une détection est effectuée par cette règle, y compris l’alerte créée et les actions de réponse automatisées. Prend en charge $filter sur les propriétés alertTemplate imbriquées suivantes :
  • Chaîne : detectionAction/alertTemplate/title, detectionAction/alertTemplate/description, detectionAction/alertTemplate/recommendedActions — each prend en charge eq, nenot, , endsWithinstartsWithcontains, .
  • Enum : detectionAction/alertTemplate/severity — prend en charge eq, ne, not, in.
  • displayName String Nom d’affichage de la règle. Prend en charge (, , , innot, endsWithstartsWithcontains) et $orderby. neeq$filter
    id String Identificateur unique de la règle fourni par le client. Prend en charge (, , notne, in) et $orderby.eq$filter
    lastModifiedBy String Nom de l’utilisateur ou de l’application qui a mis à jour la règle pour la dernière fois. En lecture seule. Prend en charge $filter (eq, ne, not, in, startsWith, endsWith, contains).
    lastModifiedDateTime DateTimeOffset Horodatage de la dernière mise à jour de la règle. En lecture seule. Prend en charge (, , , lenot, ltgegt) et $orderby. neeq$filter
    queryCondition microsoft.graph.security.queryCondition Requête de repérage avancé qui définit la logique de détection de cette règle. Prend en charge $filter sur queryCondition/queryText (chaîne) avec eq, ne, not, inendsWithstartsWithcontains.
    planifier microsoft.graph.security.ruleSchedule Calendrier de déclenchement de cette règle. Prend en charge $filter selon la planification/la fréquence (durée) avec eq, , nenot, ltlegegt. Prend en charge $orderby selon le calendrier et la fréquence.
    status microsoft.graph.security.detectionRuleStatus Le status d’exécution actuel de la règle. Les valeurs possibles sont : enabled, disabled, autoDisabled, unknownFutureValue. Prend en charge (, , notne, in) et $orderby.eq$filter

    Relations

    Aucun.

    Représentation JSON

    La représentation JSON suivante montre le type de ressource.

    {
      "@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"
      }
    }