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
Remarque
Les API Microsoft Threat Intelligence sont disponibles pour tous les clients disposant d’une licence Microsoft Defender XDR ou Microsoft Sentinel. Aucune licence distincte n’est requise pour accéder à ces API.
Représente un certificat SSL, c’est-à-dire un certificat numérique qui permet une communication sécurisée et chiffrée entre un site web et ses utilisateurs, protégeant ainsi les informations sensibles. Il vérifie l’identité d’un site web et chiffre les données pour garantir la confidentialité et renforcer la confiance des utilisateurs. Lorsque Microsoft Defender Threat Intelligence analyse un site web, il indexe les certificats SSL afin que les utilisateurs puissent y effectuer des recherches. Les acteurs malveillants peuvent exploiter les certificats SSL en utilisant des certificats frauduleux pour créer des sites Web trompeurs ou en compromettant des certificats légitimes pour intercepter les communications chiffrées.
Hérite de l’artefact.
Méthodes
| Méthode | Type de retour | Description |
|---|---|---|
| List | microsoft.graph.security.sslCollection de certificats | Obtenez une liste des objets sslCertificate et de leurs propriétés. |
| Obtenir | microsoft.graph.security.sslCertificate | Obtenez les propriétés et les relations d’un objet sslCertificate . |
| Répertorier les hôtes associés | Microsoft.Graph.Security.Host collection | Obtenez une liste des ressources hôtes associées à un certificat ssl. |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| expirationDateTime | DateTimeOffset | Date et heure d’expiration d’un certificat. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z. |
| empreinte digitale | String | Hachage du certificat calculé sur les données et la signature. |
| firstSeenDateTime | DateTimeOffset | La première date et la première heure à laquelle ce certificat SSL a été observé. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z. |
| id | String | ID généré par le système pour ce certificat ssl. Hérité de l’artefact. |
| issueDateTime | DateTimeOffset | Date et heure d’émission d’un certificat. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z. |
| de l’émetteur | microsoft.graph.security.sslCertificateEntity | Entité qui accorde ce certificat. |
| lastSeenDateTime | DateTimeOffset | Date et heure les plus récentes auxquelles ce certificat SSL a été observé. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z. |
| serialNumber | String | Numéro de série associé à un certificat SSL. |
| SHA1 | String | Hachage SHA-1 du certificat. Remarque : Ce n’est pas la signature. |
| sujet | microsoft.graph.security.sslCertificateEntity | La personne, le site, l’ordinateur, etc., auxquels ce certificat est destiné. |
Relations
| Relation | Type | Description |
|---|---|---|
| relatedHosts | Microsoft.Graph.Security.Host collection | Ressources de l’hôte liées à ce certificat ssl. |
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"@odata.type": "#microsoft.graph.security.sslCertificate",
"expirationDateTime": "String (timestamp)",
"fingerprint": "String",
"firstSeenDateTime": "String (timestamp)",
"id": "String (identifier)",
"issueDateTime": "String (timestamp)",
"issuer": {"@odata.type": "microsoft.graph.security.sslCertificateEntity"},
"lastSeenDateTime": "String (timestamp)",
"serialNumber": "String",
"sha1": "String",
"subject": {"@odata.type": "microsoft.graph.security.sslCertificateEntity"}
}