type de ressource d’alerte (déconseillé)
Espace de noms: microsoft.graph
Remarque
L’API d’alertes héritées est déconseillée et sera supprimée d’ici avril 2026. Nous vous recommandons de migrer vers la nouvelle API d’alertes et d’incidents .
Cette ressource correspond à la première génération d’alertes dans l’API de sécurité Microsoft Graph, représentant des problèmes de sécurité potentiels au sein du locataire d’un client identifiés par Microsoft ou une solution de sécurité partenaire.
Ce type d’alertes fédère l’appel des fournisseurs de sécurité Azure et Microsoft 365 Defender pris en charge répertoriés dans Utiliser l’API de sécurité Microsoft Graph. Il regroupe les données d’alerte courantes entre les différents domaines pour permettre aux applications d’unifier et de simplifier la gestion des problèmes de sécurité dans toutes les solutions intégrées.
Pour plus d’informations, voir les exemples de requêtes dans l’Explorateur Graph.
Remarque
Cette ressource est l’un des deux types d’alertes qu’offre la version v1.0 de l’API de sécurité Microsoft Graph. Pour plus d’informations, consultez alertes.
Méthodes
| Méthode | Type renvoyé | Description |
|---|---|---|
| Obtenir une alerte | alert | Lire les propriétés et les relations d’un objet alerte. |
| Mettre à jour une alerte | alert | Mettre à jour un objet alerte. |
| Répertorier les alertes | collectionalert | Obtient une collection d’objets alerte. |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| activityGroupName | Chaîne | Nom ou alias du groupe activité (utilisateur malveillant) auquel cette alerte est attribuée. |
| assignedTo | String | Nom de l’analyste auquel l’alerte est affectée pour tri, examen ou remédiation (prend en charge mettre à jour). |
| azureSubscriptionId | Chaîne | ID de l’abonnement Azure, présent si cette alerte est liée à une ressource Azure. |
| azureTenantId | Chaîne | Microsoft Entra l’ID de locataire. Obligatoire. |
| category | String | Catégorie de l’alerte (par exemple, credentialTheft, ransomware). |
| closedDateTime | DateTimeOffset | Heure à laquelle l’alerte a été fermée. Le type Horodatage représente les informations de date et d’heure au moyen du format ISO 8601 et est toujours indiqué au format UTC. Par exemple, le 1er janvier 2014 à minuit UTC est représenté comme suit : 2014-01-01T00:00:00Z (mise à jour prise en charge). |
| cloudAppStates | CollectioncloudAppSecurityState | Informations de sécurité générées par le fournisseur sur l’application/s cloud liée à cette alerte. |
| commentaires | Collection de chaîne | Commentaires client fournis sur alerte (pour la gestion alerte client) (prend en charge mise à jour). |
| confiance | Int32 | Confiance de la logique de détection (pourcentage entre 1 et 100). |
| createdDateTime | DateTimeOffset | Heure à laquelle l’alerte a été créé par le fournisseur d’alerte. Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z. Obligatoire. |
| description | String | Description de l’alerte. |
| detectionIds | Collection de chaîne | Ensemble d’alertes relatives à cette entité alerte (chaque alerte est transmise au SIEM comme enregistrement séparé). |
| eventDateTime | DateTimeOffset | Heure à laquelle l’événement ou les événements qui ont servi de déclencheur pour générer l’alerte se sont produits. Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z. Obligatoire. |
| commentaires | alertFeedback | Commentaires analyste sur l’alerte. Les valeurs possibles sont les suivantes : unknown, truePositive, falsePositive, benignPositive. Prend en charge la mise à jour. |
| fileStates | collectionfileSecurityState | Informations de sécurité générées par le fournisseur sur le(s) fichier(s) lié(s) à cette alerte. |
| hostStates | collectionhostSecurityState | Informations de sécurité générées par le fournisseur sur l’hôte(s) lié(s) à cette alerte. |
| id | String | Identificateur unique/GUID généré par le fournisseur. En lecture seule. Obligatoire. |
| incidentIds | String collection | IDs des incidents liés à l’alerte actuelle. |
| lastModifiedDateTime | DateTimeOffset | Heure à laquelle l’entité alerte a été modifié en dernier. Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z. |
| malwareStates | collectionmalwareState | Veille contre les menaces relatives aux programmes malveillants liés à cette alerte. |
| networkConnections | collectionnetworkConnection | Informations de sécurité générées par le fournisseur sur la connexion réseau liée à cette alerte. |
| Processus | collectionprocessus | Informations de sécurité générées par le fournisseur sur le(s) processus lié(s) à cette alerte. |
| recommendedActions | Collection de chaîne | Action(s) recommandée(s) vendeur/fournisseur suite à l’alerte (par exemple, machine isoler, enforce2FA, créer nouvelle image). |
| registryKeyStates | collectionregistryKeyState | Informations de sécurité générées par le fournisseur sur les clés de registre liées à cette alerte. |
| securityResources | colldectkion securityResource | Ressources liées à l’alerte actuelle. Par exemple, pour certaines alertes, cette valeur peut avoir la valeur Ressource Azure. |
| Sévérité | alertSeverity | Gravité d’alerte - définie par vendeur/fournisseur. Les valeurs possibles sont les suivantes : unknown, informational, low, medium, high. Obligatoire. |
| sourceMaterials | Collection de chaîne | Liens hypertexte (URI) vers le matériel source lié à l’alerte, par exemple l’interface utilisateur du fournisseur pour les alertes ou la recherche dans les journaux. |
| statut | alertStatus | État d’alerte sur le cycle de vie (étape). Les valeurs possibles sont les suivantes : unknown, newAlert, inProgress, resolved. (prend en charge mettre à jour) Obligatoire. |
| étiquettes | String collection | Étiquettes définissables par l’utilisateur qui peuvent être appliquées à une alerte et peuvent servir de conditions de filtre (par exemple, « HVA », « SAW ») (prend en charge la mise à jour). |
| title | String | Titre de l’alerte. Obligatoire. |
| Déclencheurs | collectionalertTrigger | Informations de sécurité sur les propriétés spécifiques qui ont déclenché l’alerte (propriétés s’affichant dans l’alerte). Les alertes peuvent contenir des informations sur plusieurs utilisateurs, hosts, fichiers, adresses ip. Ce champ indique quelles propriétés déclenchent la génération d’alerte. |
| userStates | collectionuserSecurityState | Informations de sécurité générées par le fournisseur sur les comptes utilisateurs liés à cette alerte. |
| vendorInformation | securityVendorInformation | Type complexe contenant des détails sur le fournisseur produit/service de sécurité, le fournisseur et sous-fournisseur (par exemple, vendeur = Microsoft ; fournisseur = Windows Defender ATP ; sous-fournisseur = AppLocker). Obligatoire. |
| vulnerabilityStates | collectionvulnerabilityState | Veille contre les menaces relatives à une ou plus vulnérabilités liées à cette alerte. |
Relations
Aucun.
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"activityGroupName": "String",
"assignedTo": "String",
"azureSubscriptionId": "String",
"azureTenantId": "String",
"category": "String",
"closedDateTime": "String (timestamp)",
"cloudAppStates": [{"@odata.type": "microsoft.graph.cloudAppSecurityState"}],
"comments": ["String"],
"confidence": 1024,
"createdDateTime": "String (timestamp)",
"description": "String",
"detectionIds": ["String"],
"eventDateTime": "String (timestamp)",
"feedback": "@odata.type: microsoft.graph.alertFeedback",
"fileStates": [{"@odata.type": "microsoft.graph.fileSecurityState"}],
"hostStates": [{"@odata.type": "microsoft.graph.hostSecurityState"}],
"id": "String (identifier)",
"incidentIds": ["String"],
"lastModifiedDateTime": "String (timestamp)",
"malwareStates": [{"@odata.type": "microsoft.graph.malwareState"}],
"networkConnections": [{"@odata.type": "microsoft.graph.networkConnection"}],
"processes": [{"@odata.type": "microsoft.graph.process"}],
"recommendedActions": ["String"],
"registryKeyStates": [{"@odata.type": "microsoft.graph.registryKeyState"}],
"securityResources": [{"@odata.type": "microsoft.graph.securityResource"}],
"severity": "@odata.type: microsoft.graph.alertSeverity",
"sourceMaterials": ["String"],
"status": "@odata.type: microsoft.graph.alertStatus",
"tags": ["String"],
"title": "String",
"triggers": [{"@odata.type": "microsoft.graph.alertTrigger"}],
"userStates": [{"@odata.type": "microsoft.graph.userSecurityState"}],
"vendorInformation": {"@odata.type": "microsoft.graph.securityVendorInformation"},
"vulnerabilityStates": [{"@odata.type": "microsoft.graph.vulnerabilityState"}]
}