Utiliser les API Microsoft Graph pour Microsoft Threat Intelligence

Les organisations qui effectuent une analyse de l’infrastructure des menaces et collectent des informations sur les menaces peuvent utiliser les API Microsoft Threat Intelligence sur Microsoft Graph 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 de renseignement sur les cybermenaces. Ces API fournissent 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.

Remarque

Les API Microsoft Threat Intelligence sont disponibles pour tous les clients disposant d’une licence Microsoft Defender XDR et/ou Microsoft Sentinel. Aucune licence distincte n’est requise pour accéder à ces API.

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.

Autorisations requises

Les autorisations suivantes sont requises pour accéder aux API Microsoft Threat Intelligence :

Type d’autorisation	Autorisations
Délégué (compte professionnel ou scolaire)	ThreatIntelligence.Read
Application	ThreatIntelligence.Read.All

En outre, le rôle Lecteur de sécurité doit être attribué au minimum à l’utilisateur appelant.

Cas d’utilisation courants

Les API de renseignement sur les menaces appartiennent à quelques catégories principales :

• 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 que Microsoft Threat Intelligence a 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 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

Étapes suivantes

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.