deliveryservices/sslkeys/generate

POST

Generates an SSL certificate, csr, and private key for a Delivery Service

Auth. Required:

Yes

Roles Required:

“admin” or “operations”

Permissions Required:

DS-SECURITY-KEY:CREATE, DELIVERY-SERVICE:READ, DELIVERY-SERVICE:UPDATE

Response Type:

Object (string)

Request Structure

authType:

The certificate provider correlating to an ACME account in cdn.conf or Let’s Encrypt.

businessUnit:

A required field which will represent the business unit for which the SSL certificate was generated

cdn:

A required field which will represent the CDN of the Delivery Service for which keys will be generated

city:

A required field which will represent the resident city of the generated SSL certificate

country:

A required field which will represent the resident country of the generated SSL certificate

deliveryService:

The xml_id of the Delivery Service for which keys will be generated

hostname:

The desired hostname of the Delivery Service

Note

In most cases, this must be the same as the Delivery Service URL’

key:

The xml_id of the Delivery Service for which keys will be generated

organization:

A required field which will represent the organization for which the SSL certificate was generated

state:

A required field which will represent the resident state or province of the generated SSL certificate

version:

An integer that defines the “version” of the key - which may be thought of as the sequential generation; that is, the higher the number the more recent the key

#785 Request Example
POST /api/4.0/deliveryservices/sslkeys/generate HTTP/1.1
Content-Type: application/json

{
    "cdn": "test-cdn",
    "key": "ds-01",
    "businessUnit": "CDN Engineering",
    "version": "3",
    "hostname": "tr.ds-01.mycdn.ciab.test",
    "country": "US",
    "organization": "CDN",
    "city": "Denver",
    "state": "Colorado"
}

Response Structure

#786 Response Example
HTTP/1.1 200 OK
Content-Type: application/json

{ "response": "Successfully created ssl keys for ds-01" }