Fetch Certificate Discovery Results by Discovery Name

The API enables users to fetch the discovered certificates from a particular discovery instance using the discovery name.

Before you begin

  • The user should have the ACF permission to view the certificate discovery.

Request Structure

Endpoint: /certificate/discovery/instance?discoveryName=<name>
Type: GET
Sample URL:
https://<IP/HostName/TenantName>:<GWPORT>/avxapi/certificate/discovery/instance?discoveryName=<name>&gwsource=external

To understand the elements of the sample URL, click here.

Headers
Content-Type: application/json
Table 1. Input Parameters
Name Description
sessionId

Header

(Mandatory) Session ID received after login.

Type: String

Constraints: Required if username and password are not provided.
userName

Header

(Mandatory) Username that is configured in AppViewX.

Type: String

password

Header

(Mandatory) Password of that user.

Type: String

content-type

Header

(Mandatory) Payload content-type with application/json value.

Type: String

Constraint: The value must be application/json.

gwsource

Query

(Mandatory) The source from which the request is triggered, e.g., external.

Type: String

PayloadBody Contains all the parameters to be sent in the request body for the post request.

Type: Payload

Payload

Table 2. Payload
Name Description
name (Mandatory) Name of the discovery instance to be created.

Type: String

searchTextValue (Optional) Query the fetched results based on the provided search value.
startIndex (Optional) specify the start index from where the certificate data has to be fetched.
sortColumn (Optional) specifies the column on which the sort has to be applied.
sortOrder (Optional) specifies the sort order to be applied.

Constraint: Possible values : 1, -1, asc, desc

maxSize (Optional) specifies the maximum number of results that can be retrieved.

Constraint : Possible values in the range 1 to 1000.

Response Structure

Response returns string of type application/json with the following body parameters:

Table 3. Parameters
Name Description
response Contains the response attributes.

Type: A JSON object

search null
totalRecords Total number of records in the specified discoveryInstance.
data Certificate metadata.

Type: Array of Certificate json String

autoSuggest null
executionTime Execution time of the request.
iTotalDisplayRecords Total number of records in the specified discoveryInstance.
message

If matching records are found for the search query - null. If no records are available for the search query - No matching records found.

Type: String

appStatusCode Application specific status code for the response. It is a non-null value for a failure response.

Type: String

Status Codes

HTTP Code appStatusCode Response Message
202 Accepted NA Accepted.
400 Bad Request ERR_DISC_DISCOVERY_HISTORY_RETRIVAL Error while retrieving discovery history.

Remediation: Discovery name passed in the request should be present in the database.

400 Bad Request NO_RECORDS_FOUND No matching records found.

Remediation: Discovery name passed in the request should be present in the system.

417 Expectation failed MANDATORY_QUERY_PARAM_MISSING Mandatory query param is missing or invalid.

Remediation: The parameter <discoveryName> must be present in the URL request.

417 Expectation failed CERT-FV-001 Invalid query param found for discoveryName.

Remediation: The discoveryName value should be a minimum of 2 characters.

500 Internal Server Error avx-common-011 Error while processing.

Sample Request/Response

Request Payload
{
   "searchTextValue": "",
   "startIndex": 0,
   "sortColumn": "none",
   "sortOrder": "desc",
   "name": "test #1",
   "maxSize": 5
}
Response
{
   "response": {
       "search": null,
       "totalRecords": 6,
       "data": [
           {
               "commonName": "pe-cert-swat-n12.lab.appviewx.net-ca@1749432603",
               "serialNumber": "61:14:84:02:1B:C9:73:8F",
               "serialNumberHex": "611484021bc9738f",
               "issuerCommonName": "pe-cert-swat-n12.lab.appviewx.net-ca@1749432603",
               "status": null,
               "avxStatus": "Discovered",
               "associatedObjects": [],
               "discoverySources": [
                   "pe-cert-swat-120.lab.appviewx.net:10250"
               ],
               "subjectOrganization": "",
               "subjectOrganizationUnit": "",
               "subjectLocality": "",
               "subjectState": "",
               "subjectCountry": "",
               "issuerOrganization": "",
               "issuerOrganizationUnit": "",
               "issuerLocality": "",
               "issuerState": "",
               "issuerCountry": "",
               "version": "3",
               "validFrom": 1749429003000,
               "validTo": 1780965003000,
               "firstDiscoveryDate": 1749446451605,
               "lastBeforeDiscoveryDate": 1749446451605,
               "lastDiscoveryDate": 1749446451605,
               "firstDiscoveryDateStr": null,
               "lastBeforeDiscoveryDateStr": null,
               "validFor": "364 day(s) 18 hr(s) 52 min(s)",
               "keyAlgorithmAndSize": "RSA 2048",
               "signatureAlgorithm": "SHA256withRSA",
               "signatureHashAlgorithm": null,
               "keyUsage": "DigitalSignature, KeyEncipherment, keyCertSign",
               "extendedKeyUsage": "",
               "basicConstraints": "Subject Type=CA, Path Length=none",
               "group": null,
               "subjectAlternativeNames": [],
               "complianceStatus": "",
               "applications": [
                   "192.168.220.120:10250"
               ],
               "policyIdentifiers": [],
               "expiryStatus": "Valid",
               "permission": null,
               "category": "Root CA",
               "uuid": "35357988706e58f8ce0da089df6b8e21dc0ca26b",
               "id": null,
               "certificateAuthority": "OTHERS",
               "authorityKeyIdentifier": "",
               "subjectKeyIdentifier": "BF:DD:9E:7F:86:30:9F:9C:8D:05:5C:CB:33:4B:9B:65:14:71:23:A6",
               "issuerSerialNumber": null,
               "authorityInfoAccess": [],
               "certificatePolicies": [],
               "crlDistributionPoints": [],
               "thumbprintAlgorithm": null,
               "thumbPrint": "50:7C:CD:47:DB:65:32:92:B8:C7:0B:BC:87:05:5F:7F:9D:D2:5F:96",
               "type": "Self Signed",
               "genericFields": null,
               "certAttributes": null,
               "customAttributes": null,
               "validFromDate": null,
               "validToDate": null,
               "discoveredFileNames": [],
               "issuingTemplate": null,
               "csrGenerationSource": null,
               "certificateHSMDetails": null,
               "deviceDetails": null,
               "newConnectors": [
                   "192.168.220.120:10250:absecon"
               ],
               "csrAvailable": false,
               "enhancedSANTypes": null,
               "autoRenewDate": null,
               "autoRegenDate": null,
               "missingParamsForAutoRenew": null,
               "base64ImageContent": null,
               "caConnectorName": null,
               "caSettingName": null,
               "suspendedCertificate": false,
               "comments": null,
               "mailAddress": "",
               "streetAddress": null,
               "postalCode": null,
               "publicKeyModulus": null,
               "requestIds": null,
               "orderId": null,
               "publicKey": "30:82:01:0A:02:82:01:01:00:F5:B0:8E:D0:15:51:02:5B:06:64:06:1C:14:50:41:1A:C1:FE:6F:D5:0A:2E:49:FE:49:3B:9D:6A:3A:92:07:6D:15:50:06:AB:B3:18:D4:D4:7F:E3:88:DD:EA:19:70:7B:56:90:0D:02:0D:25:1D:95:20:61:9A:4A:CD:4A:DE:C6:C1:C1:E3:94:EA:5D:BB:28:FA:89:25:82:2C:55:97:5A:48:5C:F8:B2:6C:DF:5A:01:C0:C0:C9:DF:33:B2:50:F3:35:A8:46:5A:44:66:7B:36:E8:62:7F:C3:6B:94:A5:60:D6:F2:CD:FD:55:29:1F:5A:6B:F4:86:4F:3B:19:EC:26:90:FB:AC:39:90:94:DD:A7:D3:75:E1:A5:C3:13:42:64:66:1C:ED:35:87:91:B0:E5:E1:A5:4E:54:EA:47:C8:51:53:B6:BA:F4:FA:67:EB:39:82:CF:F5:7B:B5:B4:E5:00:8B:31:74:3C:BA:17:93:02:D0:E0:1D:92:F6:DC:A4:B6:1A:30:D4:DB:23:1A:B4:91:5E:ED:D7:79:A8:65:4A:3C:24:55:12:88:BF:56:B1:50:CC:2B:52:0E:62:09:D2:93:4B:4F:22:0F:D2:5B:28:64:95:89:15:5C:12:33:0F:AC:A9:A1:EC:56:E2:58:29:AD:AF:64:81:F0:94:BF:B0:D3:02:03:01:00:01",
               "ellipticCurve": null,
               "issuedByRootCertificate": false,
               "cumulativeSanCount": 0,
               "chainPriority": 0,
               "caCertificateType": null,
               "templateProfile": null,
               "certificateTags": null,
               "resourceTags": null,
               "ocspStatus": null,
               "enrollmentMethod": null,
               "kubeService": null,
               "subject": "CN=pe-cert-swat-n12.lab.appviewx.net-ca@1749432603",
               "discoveryTypes": null,
               "certLifeCycleAction": null,
               "certLifeCycleActionTimestamp": 0,
               "isSsoActive": null,
               "customExtensions": null,
               "privatekeyAvaliable": false,
               "cvss": null
           },
           {
               "commonName": "kube-apiserver",
               "serialNumber": "4D:81:8A:DF:5A:7C:C2:1E",
               "serialNumberHex": "4d818adf5a7cc21e",
               "issuerCommonName": "kubernetes",
               "status": null,
               "avxStatus": "Discovered",
               "associatedObjects": [],
               "discoverySources": [
                   "pe-cert-swat-120.lab.appviewx.net:6443"
               ],
               "subjectOrganization": "",
               "subjectOrganizationUnit": "",
               "subjectLocality": "",
               "subjectState": "",
               "subjectCountry": "",
               "issuerOrganization": "",
               "issuerOrganizationUnit": "",
               "issuerLocality": "",
               "issuerState": "",
               "issuerCountry": "",
               "version": "3",
               "validFrom": 1749432296000,
               "validTo": 1780968596000,
               "firstDiscoveryDate": 1749446451563,
               "lastBeforeDiscoveryDate": 1749446451563,
               "lastDiscoveryDate": 1749446451563,
               "firstDiscoveryDateStr": null,
               "lastBeforeDiscoveryDateStr": null,
               "validFor": "364 day(s) 19 hr(s) 52 min(s)",
               "keyAlgorithmAndSize": "RSA 2048",
               "signatureAlgorithm": "SHA256withRSA",
               "signatureHashAlgorithm": null,
               "keyUsage": "DigitalSignature, KeyEncipherment",
               "extendedKeyUsage": "Server Authentication(1.3.6.1.5.5.7.3.1) ",
               "basicConstraints": "Subject Type=End entity, Path Length=none",
               "group": null,
               "subjectAlternativeNames": [
                   "DNS : kubernetes, kubernetes.default, kubernetes.default.svc, kubernetes.default.svc.cluster.local, pe-cert-swat-n12.lab.appviewx.net",
                   "IP Address : 10.96.0.1, 192.168.220.120"
               ],
               "complianceStatus": "",
               "applications": [
                   "192.168.220.120:6443"
               ],
               "policyIdentifiers": [],
               "expiryStatus": "Valid",
               "permission": null,
               "category": "Server",
               "uuid": "9a68c5f9c0302f0bae673baa4d2fe23f66f213ee",
               "id": null,
               "certificateAuthority": "OTHERS",
               "authorityKeyIdentifier": "64:B5:37:9B:3B:ED:7E:74:9A:41:FA:8B:7F:E1:6B:49:A5:9A:93:0E",
               "subjectKeyIdentifier": "",
               "issuerSerialNumber": null,
               "authorityInfoAccess": [],
               "certificatePolicies": [],
               "crlDistributionPoints": [],
               "thumbprintAlgorithm": null,
               "thumbPrint": "3E:4C:F9:1C:A0:24:CD:19:58:F1:81:D6:59:34:F5:25:AF:A5:A2:BA",
               "type": "Others",
               "genericFields": null,
               "certAttributes": null,
               "customAttributes": null,
               "validFromDate": null,
               "validToDate": null,
               "discoveredFileNames": [],
               "issuingTemplate": null,
               "csrGenerationSource": null,
               "certificateHSMDetails": null,
               "deviceDetails": null,
               "newConnectors": [
                   "192.168.220.120:6443:absecon"
               ],
               "csrAvailable": false,
               "enhancedSANTypes": null,
               "autoRenewDate": null,
               "autoRegenDate": null,
               "missingParamsForAutoRenew": null,
               "base64ImageContent": null,
               "caConnectorName": null,
               "caSettingName": null,
               "suspendedCertificate": false,
               "comments": null,
               "mailAddress": "",
               "streetAddress": null,
               "postalCode": null,
               "publicKeyModulus": null,
               "requestIds": null,
               "orderId": null,
               "publicKey": "30:82:01:0A:02:82:01:01:00:A6:46:A0:B7:26:5A:B6:E3:07:91:1B:C2:12:8B:C2:F3:ED:77:D0:38:67:88:55:F4:B1:17:12:4C:58:BA:1F:93:F4:C8:FC:72:7F:C6:95:84:00:B7:7E:45:3B:21:A8:F3:0A:01:F7:CD:6E:EE:46:4D:9D:2C:D4:75:72:49:34:12:9C:9E:ED:BC:5E:20:24:DA:9E:A4:59:F9:47:3E:20:6F:6C:83:19:73:50:7E:F9:5D:72:85:11:37:38:4C:8E:5D:34:76:9D:D4:EC:6E:B3:C0:B6:E5:54:FA:B8:BF:80:6B:E2:A6:CA:9A:6F:9D:7F:C6:AB:55:3C:54:02:6F:97:C1:26:5F:75:1C:B7:7F:6D:F3:6D:E6:3A:33:4D:49:A0:15:E4:A7:52:DE:7A:B6:A8:C7:0E:C9:90:61:77:E9:94:AB:3E:58:CE:B1:12:8C:0A:3A:DE:92:2E:B3:03:AE:93:B7:38:3F:50:0F:46:16:E6:BE:F2:08:91:0F:1F:97:86:23:A5:6F:08:32:A4:80:43:49:07:2F:EE:1D:B7:6F:B6:5A:9D:A8:3A:E8:00:2C:3C:47:32:66:AE:D5:F8:5A:F9:5C:53:5C:40:59:D3:F1:34:74:9E:57:30:32:8B:87:FF:8C:18:B6:32:E1:DC:C5:21:01:BF:2D:B0:7F:60:A5:77:01:02:03:01:00:01",
               "ellipticCurve": null,
               "issuedByRootCertificate": false,
               "cumulativeSanCount": 7,
               "chainPriority": 0,
               "caCertificateType": null,
               "templateProfile": null,
               "certificateTags": null,
               "resourceTags": null,
               "ocspStatus": null,
               "enrollmentMethod": null,
               "kubeService": null,
               "subject": "CN=kube-apiserver",
               "discoveryTypes": null,
               "certLifeCycleAction": null,
               "certLifeCycleActionTimestamp": 0,
               "isSsoActive": null,
               "customExtensions": null,
               "privatekeyAvaliable": false,
               "cvss": null
           },
           {
               "commonName": "pe-cert-swat-n12.lab.appviewx.net",
               "serialNumber": "30:46:50:C9:E5:D2:BC:F2",
               "serialNumberHex": "304650c9e5d2bcf2",
               "issuerCommonName": "etcd-ca",
               "status": null,
               "avxStatus": "Discovered",
               "associatedObjects": [],
               "discoverySources": [
                   "pe-cert-swat-120.lab.appviewx.net:2379"
               ],
               "subjectOrganization": "",
               "subjectOrganizationUnit": "",
               "subjectLocality": "",
               "subjectState": "",
               "subjectCountry": "",
               "issuerOrganization": "",
               "issuerOrganizationUnit": "",
               "issuerLocality": "",
               "issuerState": "",
               "issuerCountry": "",
               "version": "3",
               "validFrom": 1749432296000,
               "validTo": 1780968596000,
               "firstDiscoveryDate": 1749446451563,
               "lastBeforeDiscoveryDate": 1749446451563,
               "lastDiscoveryDate": 1749446451563,
               "firstDiscoveryDateStr": null,
               "lastBeforeDiscoveryDateStr": null,
               "validFor": "364 day(s) 19 hr(s) 52 min(s)",
               "keyAlgorithmAndSize": "RSA 2048",
               "signatureAlgorithm": "SHA256withRSA",
               "signatureHashAlgorithm": null,
               "keyUsage": "DigitalSignature, KeyEncipherment",
               "extendedKeyUsage": "Server Authentication(1.3.6.1.5.5.7.3.1) Client Authentication(1.3.6.1.5.5.7.3.2) ",
               "basicConstraints": "Subject Type=End entity, Path Length=none",
               "group": null,
               "subjectAlternativeNames": [
                   "DNS : localhost, pe-cert-swat-n12.lab.appviewx.net",
                   "IP Address : 192.168.220.120, 127.0.0.1, 0:0:0:0:0:0:0:1"
               ],
               "complianceStatus": "",
               "applications": [
                   "192.168.220.120:2379"
               ],
               "policyIdentifiers": [],
               "expiryStatus": "Valid",
               "permission": null,
               "category": "Server",
               "uuid": "b00604248e42ca27619267cb4be53c423f352f79",
               "id": null,
               "certificateAuthority": "OTHERS",
               "authorityKeyIdentifier": "EC:4C:44:44:4B:62:6D:08:DD:06:33:69:12:2B:9C:2E:06:89:61:C8",
               "subjectKeyIdentifier": "",
               "issuerSerialNumber": null,
               "authorityInfoAccess": [],
               "certificatePolicies": [],
               "crlDistributionPoints": [],
               "thumbprintAlgorithm": null,
               "thumbPrint": "3B:F3:5D:78:C4:F7:82:9D:46:33:BE:B4:14:56:C2:96:D3:92:62:DE",
               "type": "Others",
               "genericFields": null,
               "certAttributes": null,
               "customAttributes": null,
               "validFromDate": null,
               "validToDate": null,
               "discoveredFileNames": [],
               "issuingTemplate": null,
               "csrGenerationSource": null,
               "certificateHSMDetails": null,
               "deviceDetails": null,
               "newConnectors": [
                   "192.168.220.120:2379:absecon"
               ],
               "csrAvailable": false,
               "enhancedSANTypes": null,
               "autoRenewDate": null,
               "autoRegenDate": null,
               "missingParamsForAutoRenew": null,
               "base64ImageContent": null,
               "caConnectorName": null,
               "caSettingName": null,
               "suspendedCertificate": false,
               "comments": null,
               "mailAddress": "",
               "streetAddress": null,
               "postalCode": null,
               "publicKeyModulus": null,
               "requestIds": null,
               "orderId": null,
               "publicKey": "30:82:01:0A:02:82:01:01:00:B4:FF:0B:D2:38:0C:ED:F4:1A:52:46:FF:21:35:1F:1B:45:81:86:85:39:55:46:7C:E1:00:6B:A2:7C:33:79:21:57:6E:14:C0:3D:F2:AA:59:9D:0B:F0:82:BF:01:4D:86:47:4A:5F:81:D9:45:73:CC:FE:6D:D0:39:F4:17:1D:5E:60:B4:FA:2F:C9:23:EE:2F:47:FA:29:62:E1:D6:66:F6:D3:A5:92:74:25:FE:A1:DC:82:45:72:52:9E:C3:99:C5:BD:07:61:54:07:EC:93:BF:B0:5D:6F:F3:39:73:F5:B0:07:B4:CE:51:96:41:73:F3:AC:51:19:0A:1D:02:79:4A:41:82:7E:D6:3C:B2:B2:B4:53:16:8F:C0:84:0B:D4:64:42:C6:22:83:51:94:B2:B2:88:36:8C:ED:D3:25:1F:EC:D4:5D:8F:2F:C1:99:87:EE:D2:60:4B:47:00:25:57:9C:BD:51:D2:CA:4B:B6:D3:04:51:D1:E6:3B:1D:3F:3B:7E:5A:02:67:69:40:25:46:21:69:B4:BF:49:67:FD:1C:D7:39:21:03:14:AB:81:06:F2:83:85:F2:F1:B7:DC:85:2F:E9:8D:54:85:C0:F2:69:93:9C:41:99:8E:FA:C1:74:E6:FE:26:88:0B:DD:DF:99:23:94:CF:96:03:D1:9E:B1:B3:02:03:01:00:01",
               "ellipticCurve": null,
               "issuedByRootCertificate": false,
               "cumulativeSanCount": 5,
               "chainPriority": 0,
               "caCertificateType": null,
               "templateProfile": null,
               "certificateTags": null,
               "resourceTags": null,
               "ocspStatus": null,
               "enrollmentMethod": null,
               "kubeService": null,
               "subject": "CN=pe-cert-swat-n12.lab.appviewx.net",
               "discoveryTypes": null,
               "certLifeCycleAction": null,
               "certLifeCycleActionTimestamp": 0,
               "isSsoActive": null,
               "customExtensions": null,
               "privatekeyAvaliable": false,
               "cvss": null
           },
           {
               "commonName": "pe-cert-swat-n12.lab.appviewx.net@1749432603",
               "serialNumber": "0E:ED:A6:17:67:F1:F1:B0",
               "serialNumberHex": "0eeda61767f1f1b0",
               "issuerCommonName": "pe-cert-swat-n12.lab.appviewx.net-ca@1749432603",
               "status": null,
               "avxStatus": "Discovered",
               "associatedObjects": [],
               "discoverySources": [
                   "pe-cert-swat-120.lab.appviewx.net:10250"
               ],
               "subjectOrganization": "",
               "subjectOrganizationUnit": "",
               "subjectLocality": "",
               "subjectState": "",
               "subjectCountry": "",
               "issuerOrganization": "",
               "issuerOrganizationUnit": "",
               "issuerLocality": "",
               "issuerState": "",
               "issuerCountry": "",
               "version": "3",
               "validFrom": 1749429003000,
               "validTo": 1780965003000,
               "firstDiscoveryDate": 1749446451563,
               "lastBeforeDiscoveryDate": 1749446451563,
               "lastDiscoveryDate": 1749446451563,
               "firstDiscoveryDateStr": null,
               "lastBeforeDiscoveryDateStr": null,
               "validFor": "364 day(s) 18 hr(s) 52 min(s)",
               "keyAlgorithmAndSize": "RSA 2048",
               "signatureAlgorithm": "SHA256withRSA",
               "signatureHashAlgorithm": null,
               "keyUsage": "DigitalSignature, KeyEncipherment",
               "extendedKeyUsage": "Server Authentication(1.3.6.1.5.5.7.3.1) ",
               "basicConstraints": "Subject Type=End entity, Path Length=none",
               "group": null,
               "subjectAlternativeNames": [
                   "DNS : pe-cert-swat-n12.lab.appviewx.net"
               ],
               "complianceStatus": "",
               "applications": [
                   "192.168.220.120:10250"
               ],
               "policyIdentifiers": [],
               "expiryStatus": "Valid",
               "permission": null,
               "category": "Server",
               "uuid": "7553cccc7a03ef070e5fb22132bd885433335ec7",
               "id": null,
               "certificateAuthority": "OTHERS",
               "authorityKeyIdentifier": "BF:DD:9E:7F:86:30:9F:9C:8D:05:5C:CB:33:4B:9B:65:14:71:23:A6",
               "subjectKeyIdentifier": "",
               "issuerSerialNumber": null,
               "authorityInfoAccess": [],
               "certificatePolicies": [],
               "crlDistributionPoints": [],
               "thumbprintAlgorithm": null,
               "thumbPrint": "C2:85:2C:5A:1B:F3:F5:1B:FF:17:B7:43:84:DA:64:4B:8E:50:3C:2E",
               "type": "Others",
               "genericFields": null,
               "certAttributes": null,
               "customAttributes": null,
               "validFromDate": null,
               "validToDate": null,
               "discoveredFileNames": [],
               "issuingTemplate": null,
               "csrGenerationSource": null,
               "certificateHSMDetails": null,
               "deviceDetails": null,
               "newConnectors": [
                   "192.168.220.120:10250:absecon"
               ],
               "csrAvailable": false,
               "enhancedSANTypes": null,
               "autoRenewDate": null,
               "autoRegenDate": null,
               "missingParamsForAutoRenew": null,
               "base64ImageContent": null,
               "caConnectorName": null,
               "caSettingName": null,
               "suspendedCertificate": false,
               "comments": null,
               "mailAddress": "",
               "streetAddress": null,
               "postalCode": null,
               "publicKeyModulus": null,
               "requestIds": null,
               "orderId": null,
               "publicKey": "30:82:01:0A:02:82:01:01:00:B0:B6:FB:AF:F0:96:B5:19:0C:B5:3E:4B:F3:73:0A:A0:15:3E:5F:69:05:CB:23:75:2A:3B:2E:DF:B2:55:10:5D:2E:AB:6F:43:D7:6B:12:3C:03:B3:F8:D7:0F:F1:54:3A:7A:38:2D:F6:66:CA:45:F4:91:FD:0B:A4:4B:B3:E5:48:F5:99:35:28:52:68:11:93:02:44:82:03:46:74:BF:AB:1B:F1:64:B5:01:82:7C:AC:C4:D7:3E:8F:7B:CB:C1:A8:C4:21:BA:E5:90:3A:89:20:B6:E1:9B:60:C3:2F:98:42:18:70:AB:78:6F:9E:AD:09:95:DE:EC:18:1B:74:72:4F:F8:32:45:B8:4C:C6:9B:12:DD:DD:CA:8F:4E:22:A2:52:E6:AC:96:D5:6E:85:08:F0:DA:44:DD:4E:DA:A5:9D:C1:91:45:1A:D0:DC:91:90:9B:51:9C:74:FB:F6:EE:55:EE:41:F1:57:FD:3A:72:B7:92:AB:F6:D5:02:88:E9:69:4F:E3:38:E3:FB:8B:67:5E:06:2B:D6:33:C4:FE:5D:5E:BD:E3:6C:8D:0F:BA:1D:5D:09:55:E2:23:EF:46:DF:8A:8B:F1:D6:7B:34:00:56:52:C5:63:E9:A7:E2:48:58:D3:D9:B7:C9:BC:0E:B9:EF:BE:1E:A4:24:90:0F:E2:E5:2E:87:02:03:01:00:01",
               "ellipticCurve": null,
               "issuedByRootCertificate": false,
               "cumulativeSanCount": 1,
               "chainPriority": 0,
               "caCertificateType": null,
               "templateProfile": null,
               "certificateTags": null,
               "resourceTags": null,
               "ocspStatus": null,
               "enrollmentMethod": null,
               "kubeService": null,
               "subject": "CN=pe-cert-swat-n12.lab.appviewx.net@1749432603",
               "discoveryTypes": null,
               "certLifeCycleAction": null,
               "certLifeCycleActionTimestamp": 0,
               "isSsoActive": null,
               "customExtensions": null,
               "privatekeyAvaliable": false,
               "cvss": null
           },
           {
               "commonName": "appviewx.onpremise.com",
               "serialNumber": "4E:00:31:6D:38:BA:CF:4A:D9:20:41:B0:2C:6B:01:BF",
               "serialNumberHex": "4e00316d38bacf4ad92041b02c6b01bf",
               "issuerCommonName": "appviewx.onpremise.com",
               "status": null,
               "avxStatus": "Discovered",
               "associatedObjects": [],
               "discoverySources": [
                   "pe-cert-swat-120.lab.appviewx.net:31443"
               ],
               "subjectOrganization": "",
               "subjectOrganizationUnit": "",
               "subjectLocality": "",
               "subjectState": "",
               "subjectCountry": "",
               "issuerOrganization": "",
               "issuerOrganizationUnit": "",
               "issuerLocality": "",
               "issuerState": "",
               "issuerCountry": "",
               "version": "3",
               "validFrom": 1749432506000,
               "validTo": 2064792506000,
               "firstDiscoveryDate": 1749446451563,
               "lastBeforeDiscoveryDate": 1749446451563,
               "lastDiscoveryDate": 1749446451563,
               "firstDiscoveryDateStr": null,
               "lastBeforeDiscoveryDateStr": null,
               "validFor": "3649 day(s) 19 hr(s) 51 min(s)",
               "keyAlgorithmAndSize": "RSA 2048",
               "signatureAlgorithm": "SHA256withRSA",
               "signatureHashAlgorithm": null,
               "keyUsage": "DigitalSignature, KeyEncipherment",
               "extendedKeyUsage": "Server Authentication(1.3.6.1.5.5.7.3.1) Client Authentication(1.3.6.1.5.5.7.3.2) ",
               "basicConstraints": "Subject Type=End entity, Path Length=none",
               "group": null,
               "subjectAlternativeNames": [],
               "complianceStatus": "",
               "applications": [
                   "192.168.220.120:31443"
               ],
               "policyIdentifiers": [],
               "expiryStatus": "Valid",
               "permission": null,
               "category": "Server",
               "uuid": "ed9d0ee0ef80c3f914627e712bd586bb3c818114",
               "id": null,
               "certificateAuthority": "OTHERS",
               "authorityKeyIdentifier": "",
               "subjectKeyIdentifier": "",
               "issuerSerialNumber": null,
               "authorityInfoAccess": [],
               "certificatePolicies": [],
               "crlDistributionPoints": [],
               "thumbprintAlgorithm": null,
               "thumbPrint": "1B:68:CF:26:DA:59:1A:7B:AD:DA:79:33:61:27:25:5E:F9:73:B7:53",
               "type": "Self Signed",
               "genericFields": null,
               "certAttributes": null,
               "customAttributes": null,
               "validFromDate": null,
               "validToDate": null,
               "discoveredFileNames": [],
               "issuingTemplate": null,
               "csrGenerationSource": null,
               "certificateHSMDetails": null,
               "deviceDetails": null,
               "newConnectors": [
                   "192.168.220.120:31443:absecon"
               ],
               "csrAvailable": false,
               "enhancedSANTypes": null,
               "autoRenewDate": null,
               "autoRegenDate": null,
               "missingParamsForAutoRenew": null,
               "base64ImageContent": null,
               "caConnectorName": null,
               "caSettingName": null,
               "suspendedCertificate": false,
               "comments": null,
               "mailAddress": "",
               "streetAddress": null,
               "postalCode": null,
               "publicKeyModulus": null,
               "requestIds": null,
               "orderId": null,
               "publicKey": "30:82:01:0A:02:82:01:01:00:EF:4C:46:3B:34:C6:41:97:77:36:C3:BA:FA:0F:8A:2B:A8:C6:3A:8F:7E:E1:E9:83:BD:C0:58:B5:66:29:E5:3A:5D:9D:3F:0E:B8:8D:E8:4D:CC:D2:64:04:6D:6D:D1:2F:17:60:DC:AC:7D:BF:85:05:17:4F:05:06:51:8F:8C:22:48:1F:49:20:F0:4C:15:40:E4:1E:83:17:C0:E6:69:AE:36:FC:7C:55:2D:E0:59:E8:3F:63:51:60:17:B1:C8:0B:55:1D:82:E9:FB:28:E4:45:88:8F:CA:8E:95:85:52:79:C8:93:B5:F5:31:03:1B:36:FA:B8:CF:05:4A:D8:0E:06:EE:10:FC:64:7E:4C:E4:A6:B0:24:A1:7A:DF:D7:3A:45:E5:DE:2A:0D:3B:AE:A1:BE:F5:C4:41:D6:43:4A:8B:2C:86:9C:DF:AD:CD:82:1A:D6:58:59:9D:9C:2F:D8:78:17:51:02:74:FA:0A:88:1B:04:B9:DE:93:02:FB:08:E8:57:6B:C4:F7:1C:71:DA:50:1D:26:25:57:26:9E:0C:B6:F8:BD:73:6F:31:86:99:12:74:E9:6C:1B:E1:09:D8:7D:19:CF:CF:15:5A:F6:AE:35:B0:44:4F:E7:1E:35:8A:A7:D6:66:5D:3B:FA:8B:B4:74:51:E8:8A:21:1C:44:79:87:D5:02:03:01:00:01",
               "ellipticCurve": null,
               "issuedByRootCertificate": false,
               "cumulativeSanCount": 0,
               "chainPriority": 0,
               "caCertificateType": null,
               "templateProfile": null,
               "certificateTags": null,
               "resourceTags": null,
               "ocspStatus": null,
               "enrollmentMethod": null,
               "kubeService": null,
               "subject": "CN=appviewx.onpremise.com",
               "discoveryTypes": null,
               "certLifeCycleAction": null,
               "certLifeCycleActionTimestamp": 0,
               "isSsoActive": null,
               "customExtensions": null,
               "privatekeyAvaliable": false,
               "cvss": null
           }
       ],
       "autoSuggest": null,
       "executionTime": 1749447433,
       "iTotalDisplayRecords": 6
   },
   "message": null,
   "appStatusCode": null,
   "tags": null,
   "headers": null
}

References

Understanding the sample URL
  • IP/HostName/TenantName: Replace with the actual IP address, hostname, or tenant name based on the specific configuration in AppViewX.
    • IP: A unique identifier assigned to each device connected to a computer network that uses the Internet Protocol for communication

      The IP address will be included in the endpoint URL for an on-prem deployment.

    • HostName: A human-readable label assigned to a device (host) on a network

      The hostname will be included in the endpoint URL for an on-prem deployment.

    • TenantName: An identifier label for a tenant given to indicate which tenant's data the API request will access/modify

      The tenant name will be included in the endpoint URL for a SaaS deployment.

  • GWPORT: AppViewX gateway port

    A gateway port refers to a network port through which data is sent and received to communicate with a gateway in an on-prem deployment.

    Example: 31443

  • avxapi: Path parameter value (static) that is part of the endpoint's URL
  • Endpoint: Endpoint of the API, for example: execute-hook
  • gwsource: Source or origin of a gateway, for example: external.