Black Friday SALE - Up to -30% OFF Time left:

Submit CSR

Description

Submit CSR for an SSL.


Parameters

Name Data Type Status Description
auth-id Integer  Required Authentication parameter 
auth-password String  Required Authentication parameter 
ssl-id Integer Required SSL ID. You can see this ID with the method List certificates
mail String Required E-mail address of the owner 
csr String Required Generated CSR key 
country String Optional For EV SSL. Country in which the organizaton was incorporated. Cannot be changed later. 
agreement-mail String Optional For EV SSL. Email address of the individual, authorized to accept Comodo agreements. Cannot be changed later.
address String Optional For EV SSL. Address of the organization.
zip String Optional For EV SSL. ZIP/Post code of the organization.

Return: Array with submission status and description.


Errors

When the authentication of API user is not correct, any API request will fail with the following status and statusDescription:

{"status":"Failed","statusDescription":"Invalid authentication, incorrect auth-id or auth-password."}

If you have entered an invalid ID for SSL Certificate, the following status will be returned:

{"status":"Failed","statusDescription":"Missing SSL certificate"}

If you have entered an invalid verification email address, the following status will be returned:

{"status":"Failed","statusDescription":"Invalid field: Verification mail"}

If the entered CSR is invalid, the following status will be returned:

{"status":"Failed","statusDescription":"Invalid field: CSR"}

If the entered Ageement email is invalid, the following status will be returned:

{"status":"Failed","statusDescription":"Invalid field: Agreement mail"}

Note: These are example errors in JSON format, and these are not the only errors that can be displayed.


Example for Positive and Wildcard SSL

URL JSON: https://api.cloudns.net/ssl/submit-csr.json
POST/GET: auth-id=0&auth-password=password&ssl-id=0&mail=admin@domain.com&csr=-----BEGIN CERTIFICATE REQUEST-----.......-----END CERTIFICATE REQUEST-----
POST/GET: sub-auth-id=0&auth-password=password&ssl-id=0&mail=admin@domain.com&csr=-----BEGIN CERTIFICATE REQUEST-----.......-----END CERTIFICATE REQUEST-----

URL XML: https://api.cloudns.net/ssl/submit-csr.xml
POST/GET: auth-id=0&auth-password=password&ssl-id=0&mail=admin@domain.com&csr=-----BEGIN CERTIFICATE REQUEST-----.......-----END CERTIFICATE REQUEST-----
POST/GET: sub-auth-id=0&auth-password=password&ssl-id=0&mail=admin@domain.com&csr=-----BEGIN CERTIFICATE REQUEST-----.......-----END CERTIFICATE REQUEST-----

Example for EV SSL

URL JSON: https://api.cloudns.net/ssl/submit-csr.json
POST/GET: auth-id=0&auth-password=password&ssl-id=0&address=example 0&zip=0&country=US&agreement-mail=agreement@example.com&mail=mail@example.com&csr=-----BEGIN CERTIFICATE REQUEST-----.......-----END CERTIFICATE REQUEST-----
POST/GET: sub-auth-id=0&auth-password=password&ssl-id=0&address=example 0&zip=0&country=US&agreement-mail=agreement@example.com&mail=mail@example.com&csr=-----BEGIN CERTIFICATE REQUEST-----.......-----END CERTIFICATE REQUEST-----

URL XML: https://api.cloudns.net/ssl/submit-csr.xml
POST/GET: auth-id=0&auth-password=password&ssl-id=0&address=example 0&zip=0&country=US&agreement-mail=agreement@example.com&mail=mail@example.com&csr=-----BEGIN CERTIFICATE REQUEST-----.......-----END CERTIFICATE REQUEST-----
POST/GET: sub-auth-id=0&auth-password=password&ssl-id=0&address=example 0&zip=0&country=US&agreement-mail=agreement@example.com&mail=mail@example.com&csr=-----BEGIN CERTIFICATE REQUEST-----.......-----END CERTIFICATE REQUEST-----


Cookies help us deliver our services. By using our services, you agree to our use of cookies. Learn more