Edit

Share via

sslCertificate resource type

  • Article

Namespace: microsoft.graph.security

Note

The Microsoft Graph API for Microsoft Defender Threat Intelligence requires an active Defender Threat Intelligence Portal license and API add-on license for the tenant.

Represents an SSL certificate that is a digital certificate that enables secure and encrypted communication between a website and its users, protecting sensitive information. It verifies the identity of a website and encrypts data to ensure privacy and build user trust. When Microsoft Defender Threat Intelligence crawls a website, it indexes SSL certificates so users can search them. Malicious actors can exploit SSL certificates by using fraudulent certificates to create deceptive websites or compromising legitimate certificates to intercept encrypted communications.

Inherits from artifact.

Methods

Method Return type Description
List microsoft.graph.security.sslCertificate collection Get a list of sslCertificate objects and their properties.
Get microsoft.graph.security.sslCertificate Get the properties and relationships of an sslCertificate object.
List related hosts microsoft.graph.security.host collection Get a list of related host resources associated with an sslCertificate.

Properties

Property Type Description
expirationDateTime DateTimeOffset The date and time when a certificate expires. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.
fingerprint String A hash of the certificate calculated on the data and signature.
firstSeenDateTime DateTimeOffset The first date and time when this sslCertificate was observed. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.
id String The system-generated ID for this sslCertificate. Inherited from artifact.
issueDateTime DateTimeOffset The date and time when a certificate was issued. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.
issuer microsoft.graph.security.sslCertificateEntity The entity that grants this certificate.
lastSeenDateTime DateTimeOffset The most recent date and time when this sslCertificate was observed. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.
serialNumber String The serial number associated with an SSL certificate.
sha1 String A SHA-1 hash of the certificate. Note: This is not the signature.
subject microsoft.graph.security.sslCertificateEntity The person, site, machine, and so on, this certificate is for.

Relationships

Relationship Type Description
relatedHosts microsoft.graph.security.host collection The host resources related with this sslCertificate.

JSON representation

The following JSON representation shows the resource type.

{
  "@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"}
}