Request Structure
API: /certificate/revoke
Method: PUT
URL: https://<APPVIEWX_GATEWAY_IP>:<APPVIEWX_GATEWAY_PORT>/avxapi/certificate/revoke?gwkey=f000ca01&gwsource=external&isSync=true&ttl=300
|
Name |
Type |
Mandatory |
Field Type |
Description |
Constraints |
|---|---|---|---|---|---|
|
|
Header |
Yes |
|
Username that is configured in AppViewX. | |
|
|
Header |
Yes |
String
|
Password of that user. |
|
|
|
Header |
Yes |
|
Payload content-type with application/json value. |
The value must be application/json. |
|
|
Queryparam |
Yes |
|
Tenant Key. This is needed only in case of multi tenant installations and can be ignored in other type of installations. |
|
|
|
Queryparam |
Yes |
|
Source, from which the request is triggered. For example, external. | |
|
|
Queryparam |
No |
|
The possible values are true and false. If you want to use sync API, set the value as true. If you want to use the async API, set the value as false. Note: Default value is false.
|
Must be a valid boolean value: true or false. |
|
|
Queryparam |
No |
|
Time to live for a response in seconds. Default value is 300 seconds. | Must be a positive integer. |
|
|
Body |
Yes |
|
Refer to the sample request body. |
SyncRevokeRequest
| Name |
Mandatory
|
Description
|
Field Type |
Constraints
|
|---|---|---|---|---|
|
|
Yes
|
Mongo Id of the certificate in the AppViewX database. Note: It refers to the ‘resourceId’ field in the create certificate response. It can be found using the search API using commonName, serial No. or other search parameters.
|
|
Either resourceId or serialNumber and commonName is mandatory.
|
|
|
Yes
|
Common name of the certificate.
|
|
|
serialNumber
|
Yes | Serial number of the certificate. |
String
|
|
reason
|
Yes | Reason for revoke. |
String
|
|
comments
|
Yes | Comments for Revocation |
String
|
Comments field is mandatory for some revoke reasons alone. Refer Valid Reason for CAs table. |
Valid Reason for CAs
|
Certificate Authority |
Reasons |
Comments Required |
|---|---|---|
|
Entrust |
Superseded |
No |
|
Cessation of operation |
No |
|
|
Affiliation Changed |
No |
|
|
Key compromised |
Yes |