List Certificates

netscaler.list_certificates
ActionBusiness appsconnection required

Calls the NetScaler ADC API with the connection's credentials.

List the certificate-and-key pairs on the appliance, or read one by name.

Connection

Required
Yes — the node will not save without one
Auth type
Custom
Providers
NetScaler ADC
Secret shape
{"username": "…", "password": "…"} — or {"sessionid": "…"}
Config it needs
base_url
Resolved by
config.connection_id, else node.connection_id

Configuration

1 field, none required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

FieldTypeRequiredDefaultConstraintsExample
certkey
Read just this pair; leave blank to list every pair on the appliance.
stringNo——wildcard-acme-2026

Example configuration

Every value below is the contract’s own example or default — nothing invented.

{
  "certkey": "wildcard-acme-2026"
}

Output

One shape.

result

FieldTypeExample
certificates
One entry per certificate-and-key pair NITRO returned.
array—
certificates[].certkey
The pair's name on the appliance.
string—
certificates[].cert
The certificate file the pair was built from.
string—
certificates[].key
The private-key file the pair was built from.
string—
certificates[].subject
The certificate's subject distinguished name.
string—
certificates[].issuer
The issuer distinguished name.
string—
certificates[].serial
The certificate's serial number.
string—
certificates[].clientcertnotafter
When the certificate expires, in the appliance's own format.
string—
certificates[].daystoexpiration
How many days remain before the certificate expires.
number—
certificates[].status
Whether the pair is valid, expired or not yet valid.
string—
certificates[].linkcertkeyname
The CA pair this one is linked to, if any.
string—
count
How many pairs the response carried.
number—
{
  "certificates": [
    {
      "cert": "",
      "certkey": "",
      "clientcertnotafter": "",
      "daystoexpiration": 0,
      "issuer": "",
      "key": "",
      "linkcertkeyname": "",
      "serial": "",
      "status": "",
      "subject": ""
    }
  ],
  "count": 0
}

Notes

  • daystoexpiration is what an expiry-alert workflow filters on.

See List Certificates run in a workflow.

In a technical demo we add the NetScaler ADC connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.