GoDaddy

GoDaddy Request Objects

Table 1. GoDaddy caConnectorInfo
Name	Description
certificateAuthority	(Mandatory) Name of the certificate authority that issues the certificate. Type: String Constraint: The value should be GoDaddy.
isAutoRenewal	(Optional) Determines whether the certificate will be renewed before its expiration date. If enabled (true), renewal is initiated before the expiry date, following the specified number of days in "renewBefore." Type: Boolean Constraint: The value should be disabled (false) if autoRegenerateEnabled is true.
renewBefore	(Optional) Specifies the number of days prior to expiration when the renewal request should be triggered. Type: Integer Constraint: The value must be provided if isAutoRenewal is true.
autoRegenerateEnabled	(Optional) Determines whether the certificate will be regenerated before its expiration date, as indicated by the "regenerateBeforeInDays" field. If enabled (true), regeneration occurs before expiry, according to the specified number of days in "regenerateBeforeInDays." Type: Boolean Constraint: The value should be disabled (false) if isAutoRenewal is true.
regenerateBeforeInDays	(Optional) Specifies the number of days prior to expiration when the regenerate request should be triggered. Type: Integer
caSettingName	(Mandatory) Name of the CASetting created in AppViewX for the chosen certificate authority. Type: String
description	(Optional) Information about the certificate. Type: String
csrParameters	(Optional) Parameters required for generating a CSR. Type: GoDaddy CSR Parameters
vendorSpecificDetails	(Optional) Data specific to the GoDaddy vendor. Type: GoDaddy vendorSpecificDetails
name	(Optional) Name for the CA connector. Type: String

Table 2. GoDaddy CSR Parameters
Name	Description
commonName	(Mandatory) A fully qualified domain name (FQDN) of the server for which certificate is requested. Type: String Constraint: It must be compliant with the common name specified in the policy, if the policy is set as ‘Strict.’
organization	(Optional) Legal name of the organization. Type: String Constraint: Default value - the value configured in the policy.
organizationUnit	(Optional) Division or department of the organization handling the certificate. Type: String Constraint: Default value - the value configured in the policy.
locality	(Optional) City where the organization is located. The value should not be abbreviated. Type: String Constraint: Default value - the value configured in the policy.
state	(Optional) State or region where the organization is located. The value should not be abbreviated. Type: String Constraint: Default value - the value configured in the policy.
country	(Optional) A two-letter code for the country where the organization is located. Type: String Constraint: Default value - the value configured in the policy.
mailAddress	(Optional) Email address of the organization. Type: String
hashFunction	(Optional) The hash function to be used in the Certificate, e.g. SHA160. It should be chosen from the possible values configured in the certificate policy. Type: String Constraint: Default value - the first value will be chosen from the policy.
keyType	(Optional) The algorithm to be used for key generation, e.g. RSA, DSA, or EC. It should be chosen from the possible values configured in the certificate policy. Type: String Constraint: Default value - the first value will be chosen from the policy.
bitLength	(Optional) The bit length for the key is dependent on the key type chosen. It should be chosen from the possible values configured in the certificate policy. Type: String Constraint: Default value - the first value will be chosen from the policy
certificateCategories	(Mandatory) Purpose or intended use of the generated certificate Type: Array of string Possible value: Server, Client, Code Signing, and Email Recommendation: Assign only one of the possible values as the input. For example, if intended certificate category is client, set this parameter to Client.
ellipticCurve	(Optional) If the keyType chosen is EC, then the ellipticCurve must be specified depending on the bit length selected. It should be chosen from the possible values configured in the certificate policy. Type: String Constraint: Default value - the first value will be chosen from the policy
enhancedSANTypes	(Optional) The subject alternative names (SAN) for the certificate. The sub-parameter is dNSNames.
dNSNames `enhancedSANTypes`	(Optional) List of subject alternative names for the certificate. Type: Array of String

Table 3. GoDaddy vendorSpecificDetails
Name	Description
firstName	(Optional) User’s first name as configured in GoDaddy. Type: String
lastName	(Optional) User’s last name as configured in GoDaddy. Type: String
emailAddress	(Optional) Email address of the user to be configured at the CA. Type: String Constraint: It should be a valid email address.
phone	(Optional) Phone number of the user. Type: String
apiKey	(Mandatory) API key to be used for GoDaddy CA communication. Type: String
apiSecret	(Mandatory) API secret to be used for GoDaddy CA communication. Type: String
customerNumber	(Mandatory) Customer number obtained from the user’s GoDaddy portal. Type: String
url	(Mandatory) Base URL to be used for GoDaddy CA communication. Type: String

Sample Request/Response

Request Payload

 {
 "certificateGroup": {
 "name": "Default"
 },
 "caConnectorInfo": {
 "name": "GoDaddy Deluxe UCC SSL SAN UCC OV SSL connector",
 "description": "",
 "certificateUuid": "",
 "certificateAuthority": "GoDaddy",
 "certificateType": "Deluxe UCC SSL - SAN (UCC_OV_SSL)",
 "csrParameters": {
 "commonName": "testgodaddy",
 "organization": "",
 "locality": "",
 "country": "",
 "enhancedSANTypes": {
 "dnsnames": [
 "testgodaddy"
 ],
 "dNSNames": [
 "testgodaddy"
 ]
 },
 "organizationUnit": "",
 "state": "",
 "mailAddress": "",
 "keyType": "RSA",
 "bitLength": "1024",
 "hashFunction": "SHA160",
 "ellipticCurve": "",
 "encryptedChallengePassword": "",
 "certificateCategories": [
 "Server",
 ]
 },
 "renewBefore": 0,
 "autoRegenerateEnabled": false,
 "regenerateBeforeInDays": 0,
 "inheritedFromGroup": false,
 "caSettingName": "Godaddy",
 "validityInDays": 365,
 "vendorSpecificDetails": {
 "slotSize": "10",
 "orderId": ""
 },
 "whiteLabelledCA": false,
 "existingUuid": "",
 "validityUnit": "years",
 "validityUnitValue": 1,
 "certificateCategory": "Server and Client",
 "isAutoRenewal": false
 },
 "csrGenerationSource": "appviewx",
 "fileIds": []
 }

Response

{ 
  "response": { 
  "resourceId": "60630a762be80b7ea8f03c06", 
  "requestId": "155" 
  }, 
  "message": "Certificate submission triggered successfully.", 
  "appStatusCode": null, 
  "tags": {}, 
  "headers": null 
 }