AppViewX Request Objects
AppViewX caConnectorInfo
| Name | Mandatory | Description | Field Type | Constraints |
|---|---|---|---|---|
certificateAuthority
|
Yes | Name of the certificateAuthority that will issue the
certificate. |
String
|
Value should be AppViewX. |
isAutoRenewal
|
No | If enabled, renewal will be triggered before expiry based on
renewBefore days. |
Boolean
|
Should be disabled if autoRegenerateEnabled is
true. |
renewBefore
|
No | Specifies the no of days prior to expiry for triggering the renewal request. |
Integer
|
Value must be provided if isAutoRenewal is
true. |
autoRegenerateEnabled
|
No | If enabled, renewal will be triggered before expiry based on
renewBefore days. |
Boolean
|
Should be disabled if isAutoRenewal is
true. |
regenerateBeforeInDays
|
No | Specifies the no of days prior to expiry for triggering the regenerate request. |
Integer
|
Value must be provided if autoRegenerateEnabled is
true. |
caSettingName
|
Yes | Name of the CASetting that has been created in
AppViewX for the chosen Certificate Authority. |
String
|
NA |
|
|
No | Determines the category of certificate that is being requested. |
String
|
Possible values - Server, Client, CodeSigning Default value - Server. |
description
|
No | Note about the certificate. |
String
|
NA |
csrParameters
|
Yes | Parameters that are necessary for generating the CSR. |
AppViewX csrParameters
|
NA |
genericFields
|
No | Custom fields configured for the CA/Customer. |
genericFields
|
NA |
validityInDays
|
Yes | Specifies the validity in days. |
Integer
|
NA |
validityUnitValue
|
No | Validity value based on validityUnit. For example, if the expected validity is 1 year and validityUnit is Months, then the validityUnitValue should be 12 |
Integer
|
Either validityUnit and validityUnitValue must be provided or validityInDays must be provided |
validityUnit
|
No | Specifies the unit in which the validityUnitValue will be specified |
String
|
Possible values - days, months, years |
name
|
No | Specifies the name for the caConnector |
String
|
NA |
AppViewX csrParameters
| Name | Mandatory | Description | Field Type | Constraints |
|---|---|---|---|---|
commonName
|
Yes | Fully qualified domain name (FQDN) of the server for which certificate is requested. |
String
|
Must be compliant with the common name specified in the policy, if the policy is set as ‘Strict’. |
organization
|
No | Legal name of the organization. |
String
|
Default value - Value configured in the policy. |
organizationUnit
|
No | Division or department of the organization handling the certificate. |
String
|
Default value - Value configured in the policy. |
locality
|
No |
City where the organization is located. This shouldn't be abbreviated. |
String
|
Default value - Value configured in the policy. |
state
|
No | State or region where the organization is located.This shouldn't be abbreviated. |
String
|
Default value - Value configured in the policy. |
country
|
No | The two-letter code for the country where your organization is located. |
String
|
Default value - Value configured in the policy. |
mailAddress
|
No | Email address of the organization. |
String
|
Default value - Value configured in the policy. |
hashFunction
|
No |
Hash function to be used in the Certificate. For example, SHA160. Should be chosen from the possible values configured in the Certificate Policy. |
String
|
Default value - the first value will be chosen from the policy. |
keyType
|
No | Algorithm to be used for Key generation. For example, RSA, DSA, EC. Should be chosen from the possible values configured in the Certificate Policy. |
String
|
Default value - the first value will be chosen from the policy. |
bitLength
|
No | Bit length for the key is dependent on the key type chosen. Should be chosen from the possible values configured in the Certificate Policy. |
String
|
Default value - the first value will be chosen from the policy. |
certificateCategories
|
Yes | Purpose for which the generated certificate will be used. |
Array
|
Possible values - Server, Client, Code Signing, Email. |
ellipticCurve
|
No | If the keyType chosen is EC, then the
ellipticCurve must be specified depending on the
bitlength selected. Should be chosen from the possible values
configured in the Certificate Policy. |
String
|
Default value - the first value will be chosen from the policy. |
enhancedSANTypes
|
No | Subject alternative names for the certificate. |
AppViewX enhancedSANTypes
|
Value provided must be compliant with the Certificate Policy, if the policy is configured as Strict. |
AppViewX enhancedSANTypes
| Name | Mandatory | Description | Field Type | Constraints |
|---|---|---|---|---|
dNSNames
|
No | List of Subject Alternative names for the Certificate. | Array of Sting |
NA |
iPAddresses
|
No | List of IP address to be considered as subject alternative names. | Array of Sting |
NA |