Chapter 87: Controller: /siteworx/overview Up Part III: SiteWorx API Spec Chapter 89: Controller: /siteworx/ssl/chain 

88 Controller: /siteworx/ssl

Required Permissions "SSL"
Required Options SSL Access
Action: generateLetsEncrypt
Added in version 5.1.4-1042
Description Generates SSL certs via LetsEncrypt.
Input Parameters
Name Type Notes Required?
domain string Example Values
example.com, secondary.com
Yes
commonName struct (string) Help Entry
Please select the domain name (common name) this certificate will use. If you do not see your desired domain, you will first need to add it as a pointerdomain or as a subdomain in SiteWorx.<br/><br/>Note that ’www.domain.com’ is <strong>not</strong> the same as ’domain.com’.<br/><br/>A wildcard domain begins with an asterisk, ’*’, and is valid for all subdomains. For example, a Common Name of ’*.domain.com’ would create a CSR that is valid for ’domain.com’, ’sub1.domain.com’, ’sub2.domain.com’, and so on.
Example Values
example.com, mail.example.com, ftp.example.com, sub.example.com, www.example.com
No*
emailAddress string Description
Used for urgent notices and lost key recovery.
Help Entry
Please enter the email address that is associated with this certificate.
Example Default Value
user@example.com
No*
* indicates that it’s actually required, but probably already has a valid default value
Action: install
Added in version 4.7.0-339
Description Installs SSL to vhost config.
Input Parameters
Name Type Notes Required?
domain string Example Values
example.com, secondary.com
Yes
chain integer Example Values
1, 0
Yes
cascade_to_nodes integer Help Entry
Selecting this option causes the action to be replayed on all nodes of the cluster automatically, as if you had logged in to each node manually
Example Values
1
No
Action: uninstall
Added in version 4.7.0-339
Description Removes SSL from vhost config.
Input Parameters
Name Type Notes Required?
domain string Example Values
example.com, secondary.com
Yes
cascade_to_nodes integer Help Entry
Selecting this option causes the action to be replayed on all nodes of the cluster automatically, as if you had logged in to each node manually
Example Values
1
No
 Chapter 87: Controller: /siteworx/overview Up Part III: SiteWorx API Spec Chapter 89: Controller: /siteworx/ssl/chain 

(C) 2017 by InterWorx LLC