Certificate: Read Node

The Certificate: Read Node returns a given certificate's public key and metadata information.

Node Properties

The Certificate: Read Node's configuration is split into two sections ...

Configuration

First, choose a Certificate Type, which determines from where to read the certificate. Options are:

• Enter Local File Path Template: In Edge Workflows only, you may provide a file path to where the certificate is stored in a volume mounted within the agent's container.
• Enter String Template: If selected, provide a string template resolving to a certificate.
• Enter Payload Path: If selected, provide a payload path pointing to the certificate on the workflow payload.

Result Path

Next, define a Result Path, which is a payload path defining where to place the certificate's public key and metadata on the payload. This field is required.

If the node is successful and is reading a single certificate, the result will be an object with a publicKey property and an info property with details about the certificate. If the certificate is invalid, an error object will be put on the payload with a message property giving a reason for the failure.

When reading a certificate bundle, the result will be an array of objects, with one entry for each certificate in the bundle following the format described above. For example, if there are three certificates in the provided bundle and the second certificate is invalid, items 0 and 2 will be objects of the form { info, publicKey } and item 1 will be an object of the form { error: { message } }.

Node Example

Given the following certificate ...

-----BEGIN CERTIFICATE-----
MIICbTCCAhOgAwIBAgIUC0SBjYceqcdOjv5VETWOZXYuxRUwCgYIKoZIzj0EAwIw
gYsxCzAJBgNVBAYTAlVTMRAwDgYDVQQIDAdJbmRpYW5hMRMwEQYDVQQHDApaaW9u
c3ZpbGxlMQ8wDQYDVQQKDAZMb3NhbnQxFDASBgNVBAsMC0VuZ2luZWVyaW5nMQ4w
DAYDVQQDDAV3b3JkczEeMBwGCSqGSIb3DQEJARYPZm9vQGV4YW1wbGUuY29tMB4X
DTI2MDMzMTIwMzIwNFoXDTI3MDMzMTIwMzIwNFowgYsxCzAJBgNVBAYTAlVTMRAw
DgYDVQQIDAdJbmRpYW5hMRMwEQYDVQQHDApaaW9uc3ZpbGxlMQ8wDQYDVQQKDAZM
b3NhbnQxFDASBgNVBAsMC0VuZ2luZWVyaW5nMQ4wDAYDVQQDDAV3b3JkczEeMBwG
CSqGSIb3DQEJARYPZm9vQGV4YW1wbGUuY29tMFkwEwYHKoZIzj0CAQYIKoZIzj0D
AQcDQgAEVzjtO71ClwB9lMMjABGA2qnGNsQ1ZvDI9SsL1+ejcuLe2MkRa9jlzPvO
Iob6ctfiIkwpLS+NwxuID95/puQjqqNTMFEwHQYDVR0OBBYEFCH8uMaONdJh39na
eR0aUaqNb2O3MB8GA1UdIwQYMBaAFCH8uMaONdJh39naeR0aUaqNb2O3MA8GA1Ud
EwEB/wQFMAMBAf8wCgYIKoZIzj0EAwIDSAAwRQIgPUKMxzXMDTrg5haDXk1McN+K
XEW9zRbpj7gziO2y470CIQCvb9oCPkbgiZp9L10gzGMWBFYY+oGP0NMekkQVQ/QF
bA==
-----END CERTIFICATE-----

... the Certificate: Read Node will place the following on the payload at the defined Result Path:

{
  "publicKey": "-----BEGIN PUBLIC KEY-----\nMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEVzjtO71ClwB9lMMjABGA2qnGNsQ1\nZvDI9SsL1+ejcuLe2MkRa9jlzPvOIob6ctfiIkwpLS+NwxuID95/puQjqg==\n-----END PUBLIC KEY-----",
  "info": {
    "serial": "0b:44:81:8d:87:1e:a9:c7:4e:8e:fe:55:11:35:8e:65:76:2e:c5:15",
    "country": "US",
    "state": "Indiana",
    "locality": "Zionsville",
    "organization": "Losant",
    "organizationUnit": "Engineering",
    "commonName": "words",
    "emailAddress": "foo@example.com",
    "notValidBefore": "2026-03-31T20:32:04.000Z",
    "notValidAfter": "2027-03-31T20:32:04.000Z",
    "issuerName": "words",
    "fingerprint": "75:04:D3:5F:64:7C:16:47:2E:38:9F:7C:60:5F:78:2A:D6:0E:7D:95"
  }
}

Node Errors

Given an invalid certificate provided to the Certificate: Read Node, the following will be placed on the payload at the provided Result Path:

{
  "error": {
    "message": "Certificate is in an invalid format."
  }
}

Related Nodes

• Certificate: Create Node