NSns-api
SSL Certificates

Create SSL certificate for CertManager

Changed on
post/certificates

Request

  • Base URL
    https://ns-api.com/ns-api/v2
  • URL
    https://ns-api.com/ns-api/v2/certificates
  • Auth
    HTTP bearer

Request body

common-namestring hos required

This is the main hostname for the certficate. This must be a FQDN and much post via CNAME or A record to a ip(s) of the cluster

subject-alternative-namestring csv

These are alterntive names that can be included in the certificate, each one comma seperated must be valid and pointed at the cluster

resellerstring required

This is the reseller that owns and has access to the certificate

account-email-addressstring ema required

This is the main email address associated with the certificate request, it will be used to auto create an account with LetsEncrypt

challenge-type'http-01' | 'dns-01'

http-01 or dns-01, for most all requests it will be http-01 and you can leave off requests

default-ssl-cert'yes' | 'no'
replicate-ssl-cert'yes' | 'ndp' | 'no'

For most cases this will be "yes" or "ndp" with the later being used to create ndp/endpoint specific certifcates replicated to those servers only.

Example request

{
  "common-name": "portal.example.com"
}

Response

codeinteger required
messagestring required

Changes

  • bce16087d479Revision changes
    • breaking

      the response's body type changed from array to object for status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status