Back to Content

webRequest.CertificateInfo

files/en-us/mozilla/add-ons/webextensions/api/webrequest/certificateinfo/index.md

latest2.4 KB
Original Source

An object describing a single X.509 certificate.

The {{WebExtAPIRef("webRequest.SecurityInfo", "SecurityInfo")}} object returned from the {{WebExtAPIRef("webRequest.getSecurityInfo()")}} API includes a certificates property which is an array of these objects.

Type

Values of this type are objects. They contain the following properties:

  • fingerprint

    • : Object. An object with the following properties:
      • sha1
        • : String. SHA-1 hash of the certificate's DER encoding.
      • sha256
        • : String. SHA-256 hash of the certificate's DER encoding.
  • isBuiltInRoot

    • : Boolean. true if the certificate is one of the trust roots installed in the browser, false otherwise.
  • issuer

    • : String. The Distinguished Name of the entity that issued the certificate, formatted as a comma-separated list of Relative Distinguished Names, each of the form "type=value".

      For example: "CN=DigiCert SHA2 Secure Server CA,O=DigiCert Inc,C=US".

  • rawDER

    • : Array of Number. If webRequest.getSecurityInfo() was called with the rawDER option present and set to true, this will contain the DER encoding of the certificate.
  • serialNumber

  • subject

    • : String. The Distinguished Name of the entity to which the certificate was issued, formatted as a comma-separated list of Relative Distinguished Names, each of the form "type=value".

      For example: "CN=*.cdn.mozilla.net,O=Mozilla Corporation,L=Mountain View,ST=California,C=US".

  • subjectPublicKeyInfoDigest

    • : Object. An object containing the following properties:
      • sha256
        • : String. Base64 encoded SHA-256 hash of the DER-encoded public key info.
  • validity

    • : Object. Validity period for the certificate. An object containing the following properties:

{{WebExtExamples}}

Browser compatibility

{{Compat}}