Utiliser les API Microsoft Graph pour Microsoft Defender Threat Intelligence
Remarque
Microsoft API Graph pour Microsoft Defender Threat Intelligence nécessite une licence active du portail Defender Threat Intelligence et une licence de module complémentaire d’API pour le locataire.
Les organisations qui effectuent une analyse de l’infrastructure des menaces et collectent des informations sur les menaces peuvent utiliser Microsoft Defender Threat Intelligence (Defender TI) pour simplifier le triage, la réponse aux incidents, la chasse aux menaces, la gestion des vulnérabilités et les flux de travail des analystes du renseignement sur les cybermenaces. En outre, vous pouvez utiliser les API exposées par Microsoft Defender Threat Intelligence sur Microsoft Graph pour fournir des informations sur les menaces de classe mondiale qui vous aident à protéger vos organization contre les cybermenaces modernes. Vous pouvez identifier les adversaires et leurs opérations, accélérer la détection et la correction, et améliorer vos investissements et workflows de sécurité.
Ces API de renseignement sur les menaces vous permettent d’opérationnaliser l’intelligence trouvée dans l’interface utilisateur. Cela inclut l’intelligence terminée sous la forme d’articles et de profils intel, l’intelligence machine, y compris les indicateurs de compromission (IOC) et les verdicts de réputation, et enfin, les données d’enrichissement, y compris le DNS passif, les cookies, les composants et les suivis.
Autorisation
Pour appeler les API de renseignement sur les menaces dans Microsoft Graph, votre application doit acquérir un jeton d’accès. Pour plus d’informations sur les jetons d’accès, reportez-vous à l’article Obtenir des jetons d’accès pour appeler Microsoft Graph. Votre application a également besoin des autorisations appropriées. Pour plus d’informations, consultez Autorisations de renseignement sur les menaces.
Cas d’utilisation courants
Les API de renseignement sur les menaces appartiennent à quelques catégories main :
- Détails écrits sur une menace ou un acteur de menace, tels que article et intelligenceProfile.
- Propriétés relatives à un hôte, telles que hostCookie, passiveDns ou whois.
Le tableau suivant répertorie certains cas d’usage courants pour les API de renseignement sur les menaces.
| Cas d'utilisation | Ressources REST | Voir aussi |
|---|---|---|
| Lisez des articles sur le renseignement sur les menaces. | Article | Méthodes de l’article |
| Lisez des informations sur un hôte qui est actuellement ou était précédemment disponible sur Internet et qui Microsoft Defender Threat Intelligence détecté. Vous pouvez obtenir plus de détails sur un hôte, notamment les cookies associés, les entrées DNS passives, la réputation, etc. |
hôte, hostCookie, passiveDnsRecord, hostReputation |
Méthodes de l’hôte |
| Lire des informations sur les composants web observés sur un hôte. | hostComponent | Méthodes de hostComponent |
| Lire des informations sur les cookies observés sur un hôte. | hostCookie | Méthodes de hostCookie |
| Découvrez les paires d’hôtes référentielles observées à propos d’un hôte. Les paires d’hôtes incluent des détails tels que des informations sur les redirections HTTP, la consommation de CSS ou d’images à partir d’un hôte, etc. | hostPair | Méthodes de hostPair |
| Découvrez des informations sur les ports que Microsoft Defender Threat Intelligence a observés sur un hôte, y compris les composants de ces ports, le nombre de fois où un port a été observé et ce que contient chaque réponse de bannière de port hôte. |
hostPort, hostPortComponent, hostPortBanner |
Méthodes de hostPort |
| Lire les données de certificat SSL observateures sur un hôte. Ces données incluent des informations sur le certificat SSL et la relation entre l’hôte et le certificat SSL. |
hostSslCertificate, sslCertificate |
Méthodes de hostSslCertificate |
| Lire les suivis Internet observés sur un hôte. | hostTracker | Méthodes de hosttracker |
| Lisez les profils de renseignement sur les acteurs des menaces et les outils courants de compromission. |
intelligenceProfile, intelligenceProfileIndicator |
Méthodes d’intelligenceProfile |
| Lire les enregistrements DNS passifs (PDNS) d’un hôte. | passiveDnsRecord | Méthodes de passiveDnsRecord |
| Lire les données de certificat SSL. Ces informations sont autonomes à partir des détails sur la façon dont le certificat SSL est lié à un hôte. | sslCertificate | Méthodes de sslCertificate |
| Lire les détails du sous-domaine d’un hôte. | Sous-domaine | Méthodes du sous-domaine |
| Lisez les détails d’une vulnérabilité. | Vulnérabilité | Méthodes de vulnérabilité |
| Lire les détails WHOIS d’un hôte. | whoisRecord | Méthodes de whoisRecord |
Prochaines étapes
Les API de renseignement sur les menaces dans Microsoft Graph peuvent vous aider à protéger vos organization contre les cybermenaces modernes. Pour en savoir plus :
- En accédant aux données détaillées des méthodes et des propriétés des ressources les plus utiles pour votre cas.
- Essayez l’API dans l’Afficheur Graph.