Solutions
NicSRS industry solutions tailored to meet the specific needs of corporations, accelerate cloud applications construction.
Web Security Support
NicSRS API
POST
https://portal.nicsrs.com/ssl/replace
Use this endpoint to replace the existing
certificate with a new SSL certificate that has different information, such as
a different common name, CSR, or signature hash. Only the issued certificate
can be available to be replaced.
Fields explanation:
▪ R – Required
▪ O – Optional
Name |
Type |
Req/Opt |
Description |
|
api_token |
String |
R |
Authentication credentials (User token). To get token, please
contact NicSRS technical support. |
|
certId |
String |
R |
Certificate ID provided by
nicsrs.com. |
|
refId |
String |
O |
The unique customer order ID
provided by reseller. |
|
params |
Json |
R |
The information to replace is as
follows: |
|
-csr |
String |
R |
Certificate Signing Request (CSR). ▪ Use openssl to generate Base-64 encoded
CSR. ▪ Visit the
link to generate CSR. https://www.nicsrs.com/generate-csr Note: please
keep your private key properly. |
|
-uniqueValue |
String |
O |
Value only for
Sectigo products (Please set the value within 1-20 characters from a-z, A-Z,
0-9.) |
|
-domainInfo |
Json |
R |
Domain name
information. A standard certificate includes only a piece of information. e.g.
[ {
"dcvEmail": "[email protected]",
"dcvMethod": "EMAIL",
"domainName": "www.xxx.com" }, {
"dcvEmail": "[email protected]",
"dcvMethod": "EMAIL",
"domainName": "aaa.com" }, {
"dcvEmail": "[email protected]",
"dcvMethod": "EMAIL",
"domainName": "nicsrs.com" } ] More parameters are
as follows. |
|
--dcvMethod |
String |
R |
Domain control validation
(DCV) methods. When performing domain control validation, you must choose one
of four methods below. EMAIL (Approver Email Method) HTTP_CSR_HASH (HTTP Based Validation Method) CNAME_CSR_HASH (DNS Based Validation Method) HTTPS_CSR_HASH (https Based Validation Method) |
|
--dcvEmail |
String |
O |
Domain validation emails
are sent to these email addresses: Use one of five addresses below. admin@ administrator@ postmaster@ webmaster@ hostmaster@ |
|
--domainName |
String |
R |
The domain name. |
|
-organizationInfo |
Json |
O |
Organization information to modify. |
|
--organizationCity |
String |
O |
The city where
organization is located. |
|
--organizationName |
String |
O |
Organization name. |
|
--organizationMobile |
String |
O |
Organization phone number that can be searched in the
third authority. |
|
--organizationAddress |
String |
O |
Organization address. |
|
--organizationCountry |
String |
O |
Organization Country Name. See Appendix - Country codes. |
|
--organizationPostCode |
String |
O |
Organization Postal Code. |
|
Name |
Type |
Req/Opt |
Description |
code |
Int |
R |
Response status codes. A response code identifies a specific
status. See Appendix - Response Codes. |
errors |
Array or String |
O |
|
data |
Json |
O |
Response data. For more information,
see the resource section below. |
-certId |
String |
O |
Certificate
ID. Note: please
save the value that will be used in other endpoints. |