Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 :eq, nenot, , endsWithinstartsWithcontains, .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"
}
}