Analyze Certificate API
Use these API functions to analyze information based on host or IP.
Use this API to retrieve the list of endpoints that are associated with an FQDN in the CertView inventory
Analyze Certificate Information
Input ParametersInput Parameters
|
Parameter |
Mandatory/Optional |
Data Type |
Description |
|---|---|---|---|
|
host |
Mandatory |
String |
Host on which scan is executed, it can be IP For example - www.ssllabs.com, 10.10.10.10 |
|
Authorization |
Mandatory |
String |
Authorization token to authenticate to the Qualys Enterprise TruRisk™ Platform. Prepend token with "Bearer" and one space. For example - Bearer authToken |
Sample - Host is IPSample - Host is IP
API Request
curl-X POST
"<qualys_base_url>/certview/v1/analyze" -H "Accept: application/json"
-H "Content-Type: application/json" -d "{\"host\":\"XXX.XXX.XXX.XXX\"}"
-H "Authorization: Bearer <JWT Token>"
Response
{
"host": "XXX.XXX.XXX.XXX",
"endpoints": [
{
"ipAddress": "XXX.XXX.XXX.XXX",
"port": 443,
"service": "http",
"serverName": "",
"grade": "A",
"gradeTrustIgnored": "A",
"hasWarnings": false,
"exceptional": false
}
]
}
Sample - Host is FQDNSample - Host is FQDN
API Request
curl -X
"<qualys_base_url>/certview/v1/analyze" -H "Accept: application/json" -H "Content-Type: application/json" -d "{\"host\":\"www.qualys.com\"}" -H "Authorization: Bearer <JWT Token>"
Response
{
"host": "www.qualys.com",
"endpoints": [
{
"ipAddress": "XXX.XXX.XXX.XXX",
"port": 443,
"service": "http",
"serverName": "",
"grade": "A",
"gradeTrustIgnored": "A",
"hasWarnings": false,
"exceptional": false
}
]
}