CertConfigureCert


Definition

Add or update certificate information in preparation to submit to Certificate Authority.

Usage

Use this command to add or update certificate information in preparation to submit to Certificate Authority.

Availability

All resellers have access to this command.

Implementation on eNom.com

Log on to resellertest.enom.com with Login ID resellid, password resellpw.

https://resellertest.enom.com/secure/ConfigureCerts.asp?CertID=289

The save changes button calls the CertConfigureCert command.

Constraints

The query must meet the following requirements:

  • The login ID and password must be valid.
  • The cert must belong to this account.

Input parameters

Build the query string using this syntax:

https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
&paramname=paramvalue&nextparamname=nextparamvalue

 

Parameter Status Description Max Size
UID Required Account login ID 20
PW Required Account password 20
CertID Required ID number for this individual certificate. Retrieve this number using CertGetCerts 8
DomainListNumber For UCC type, this parameter is Required Number of domains to be added to the list 3
UCCDomainListX X=1 to maximum 100 For UCC type, this parameter is Required Domain name 64
UCCEmailListX X=1 to maximum 100 For UCC type, this parameter is Required Approver email 64
WebServerType (GeoTrust, RapidSSL, and VeriSign certs on this page; Comodo below) Required Type of Web server on which this cert will be installed. Permitted values for GeoTrust, RapidSSL, and VeriSign certs:
1 Apache + MOD SSL
2 Apache + Raven
3 Apache + SSLeay
4 C2Net Stronghold
7 IBM HTTP
8 iPlanet Server 4.1
9 Lotus Domino Go 4.6.2.51
10 Lotus Domino Go 4.6.2.6+
11 Lotus Domino 4.6+
12 Microsoft IIS 4.0
13 Microsoft IIS 5.0
14 Netscape Enterprise/FastTrack
17 Zeus v3+
18 Other
20 Apache + OpenSSL
21 Apache 2
22 Apache + ApacheSSL
23 Cobalt Series
24 Cpanel
25 Ensim
26 Hsphere
27 Ipswitch
28 Plesk
29 Jakart-Tomcat
30 WebLogic (all versions)
31 O’Reilly WebSite Professional
32 WebStar
33 Microsoft IIS 6.0
4
WebServerType (Comodo certs on this page; GeoTrust, RapidSSL, and VeriSign certs above) Required Type of web server on which this cert will be installed. Permitted vabe installed. Permitted values for Comodo certs:
1000 Otherold
1001 AOL
1002 Apache/ModSSL
1003 Apache-SSL (Ben-SSL, not Strong-hold)
1004 C2Net Strongholdold
1005 Cobalt Raq
1006 Covalent Server Software
1007 IBM HTTP Server
1008 IBM Internet Connection Server
1009 iPlanet
1010 Java Web Server (Javasoft / Sun)
1011 Lotus Domino
1012 Lotus Domino Go!
1013 Microsoft IIS 1.x to 4.x
1014 Microsoft IIS 5.x and later
1015 Netscape Enterprise Server
1016 Netscape FastTrack
1017 Novell Web Server
1018 Oracle
1019 Quid Pro Quo
1020 R3 SSL Server
1021 Raven SSL
1022 RedHat Linux
1023 SAP Web Application Server
1024 Tomcat
1025 Website Professional
1026 WebStar 4.x and later
1027 Web Ten ( from Tenon)
1028 Zeus Web Server
1029 Ensim
1030 Plesk
1031 WHM/cPanel
1032 H-Sphere
4
CSR Required Certificate Signing Request. We recommend saving this value to use again in the CertParseCSR command. Click on the links to for more information about CSR: GeoTrust certs RapidSSL certs VeriSign certs EV certs require a 2048-bit CSR. When creating a CSR for a wildcard cert, be sure to submit the domain name as *.sld.tld 4500
ContactTypeFName Optional overall—the default for a cert Admin is the Admin contact for this account; defaults for the cert Tech and Billing contacts are the cert Admin contact. If you supply information for a ContactType, this param is Required Given name of this ContactGiven name of this ContactType for this cert. Permitted ContactTypes are Admin, Tech, and Billing. For example, AdminFName=John 60
ContactTypeLName If you supply information for a ContactType, this param is Required Family name of this ContacFamily name of this ContactType for this cert. For example, AdminLName=Doe 60
ContactTypeOrgName If you supply information for a ContactType, this param is Optional Organization name of this ContactType for this cert 60
ContactTypeJobTitle If you supply information for a ContactType, this param is Optional Job title of this ContactType for this cert 60
ContactTypeAddress1 If you supply information for a ContactType, this param is Required Address, line 1, of this ContactType for this cert 60
ContactTypeAddress2 If you supply information for a ContactType, this param is Optional Address, line 2, of this ContactType for this cert 60
ContactTypeCity If you supply information for a ContactType, this param is Required City for this ContactType for this cert 60
ContactTypeState Either State or Province is Required for each ContactType State for this ContactType for this cert 2
ContactTypeProvince Either State or Province is Required for each ContactType Province for this ContactType for this cert 60
ContactTypeStateProvinceChoice If you supply information for a ContactType, this param is Optional Is this cert ContactType’s location a state or province. Permitted values are:
S state
P province
1
ContactTypePostalCode If you supply information for a ContactType, this param is Required Postal code for this ContactType for this cert 16
ContactTypeCountry If you supply information for a ContactType, this param is Required Country for this ContactType for this cert, in two-letter country code format 2
ContactTypePhone If you supply information for a ContactType, this param is Required Phone for this this ContactType for this cert. Required format is +CountryCode.PhoneNumber, where CountryCode and PhoneNumber use only numeric characters and the + is URL-encoded as a plus sign (%2B). 17
ContactTypePhoneExt If you supply information for a ContactType, this param is Optional Phone extension for this this ContactType for this cert 8
ContactTypeFax If you supply information for a ContactType, this param is Optional Fax number for this ContactType for this cert. Required format is +CountryCode.PhoneNumber, where CountryCode and PhoneNumber use only numeric characters and the + is URL-encoded as a plus sign (%2B). 17
ContactTypeEmailAddress If you supply information for a ContactType, this param is Required Email address for this ContactType for this cert. Use format Name@DomainName.com 128
ResponseType Optional Format of response. Permitted values are Text (default), HTML, or XML. 4

 

Returned parameters and values

Parameter Description
CertID Identification number of this individual cert
Success Has this cert been configured successfully?
Organization Organization embedded in this CSR
DomainName Domain name embedded in this CSR
Email Email addresss embedded in this CSR
HasBadExtensions Any bad extensions?
IsValidQuickDomainName Valid quick domain name?
IsValidTrueDomainName Valid true domain name?
Locality Locality embedded in this CSR
OrganizationUnit Organization unit embedded in this CSR
State State embedded in this CSR
Country Country embedded in this CSR
ApproverType Type of this approver
ApproverEmail Email address of this approver
Command Name of command executed
ErrCount The number of errors if any occurred. If greater than 0 check the Err(1 to ErrCount) values.
ErrX Error messages explaining the failure. These can be presented as is back to the client.
Done True indicates this entire response has reached you successfully.

 

Notes

  • Because the required parameters for this command exceed the length limits for many browser address bars, you should submit your HTTP request using the “post” instead of “get” method.
  • The default response format is plain text. To receive the response in HTML or XML format, send
  • ResponseType=HTML or ResponseType=XML in your request.
  • Check the return parameter ErrCount. If greater than 0 the transaction failed. The parameter
  • Err(ErrCount) can be presented to the client. Otherwise process the returned parameters as defined above.

Example