Edit

sslCertificate resource type

  • Article

Namespace: microsoft.graph.security

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

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 sslCertificates microsoft.graph.security.sslCertificate collection Get a list of sslCertificate objects and their properties.
Get sslCertificate microsoft.graph.security.sslCertificate Get the properties and relationships of an sslCertificate object.

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 hosts related with this sslCertificate.

JSON representation

The following is a JSON representation of the resource.

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