cert

The cert command maintains the certificates used for HTTPS and Secure WebSocket, meaning the encryption of traffic to and from the DisplayNet Manager application and the DisplayNet API WebSocket.

Command Type	DisplayNet
Minimum Version	2.x.x

Requires the Admin role

Usage

cert list
cert addcert <name> <cert> <key>
cert set <name>
cert retrieve <name>
cert remove <name>

Subcommands

Subcommand	Description
list	Lists the available SSL certificates
addcert	Adds a new SSL certificate to the library
set	Makes a certificate active by name, replacing the currently active certificate
retrieve	Retrieves details about a certificate by name
remove	Removes a certificate from the library by name

Arguments

Argument	Required	Description
name	All except list	The common name of the certificate and key.
cert	addcert	A base64-encoded certificate file.
key	addcert	A base64-encoded certificate key.

Activation validates the pair

For set to succeed, both a key and certificate of the same name must exist. Activating a certificate validates the pair and attaches it to the HTTPS instance.

Examples

Add a certificate to the library (values truncated)
cert addcert dvigear-cert bGphc2w7ZGZraiBhc2w7ZGtYXNsO2Rma... gYXNsO2Rma2phc2w7a2Rmtqd28=...

Make it the active certificate
cert set dvigear-cert

Remove an old certificate
cert remove custom-cert

Return value

cert list
{
  "status": "SUCCESS",
  "request_id": null,
  "result": {
    "certificates": [
      {
        "name": "dvigear",
        "IsActive": true,
        "ValidTo": "7/15/2026, 2:54:56 PM",
        "Subject": "E=support@dvigear.com, CN=dvigear.com, OU=Development, O=DVIGear, L=Marietta, S=Georgia, C=US"
      },
      {
        "name": "dvigear2",
        "IsActive": false,
        "ValidTo": "7/15/2026, 2:54:56 PM",
        "Subject": "E=support@dvigear.com, CN=10.1.1.5, OU=Development, O=DVIGear, L=Marietta, S=Georgia, C=US"
      }
    ]
  },
  "error": null
}

REST API

Endpoint type	DisplayNet API command
Address	POST /api/displaynet/<operation>, or name the operation in the body of a POST /api/displaynet. See Sending commands.
Role	Admin

Subcommand	Operation	Parameters
addcert	cert_addcert	name cert64 key64
list	cert_list	—
remove	cert_remove	name
retrieve	cert_retrieve	name
set	cert_set	name

See also

• Connecting to the API: HTTPS and Secure WebSocket endpoints