Get all known values for server attributes found through CertCentral Discovery scans. For example, get all scan names that performed scans or get IP addresses found through Discovery scans.
Known values allow you to populate valid information for end users to choose, instead of users needing to know exact values beforehand.
curl -X POST \
https://daas.digicert.com/apicontroller/v1/reports/filter \
-H 'Content-Type: application/json' \
-H 'X-DC-DEVKEY: {{api_key}}' \
-d '{
"searchCriteriaList": [
{
"key":"cn",
"operation": "STARTS_WITH",
"value": [
"www","digi"
]
}
],
"accountId": "126993",
"divisionIds": [],
"startIndex": 1,
"pageSize": 50,
"filterSelected": "ip",
"sortedColumnId": null,
"sortOrder": "ASC"
}'
import requests
url = "https://daas.digicert.com/apicontroller/v1/reports/filter"
payload = "{\n \"searchCriteriaList\": [\n {\n \"key\": \"cn\",\n \"operation\": \"STARTS_WITH\",\n \"value\": [\n \"www\",\"digi\"\n ]\n }\n ],\n \"accountId\": \"126993\",\n \"divisionIds\": [],\n \"startIndex\": 1,\n \"pageSize\": 50,\n \"filterSelected\": \"ip\",\n \"sortedColumnId\": null,\n \"sortOrder\": \"ASC\"\n}"
headers = {
'X-DC-DEVKEY': "{{api_key}}",
'Content-Type': "application/json",
}
response = requests.request("POST", url, data=payload, headers=headers)
print(response.text)
package main
import (
"fmt"
"strings"
"net/http"
"io/ioutil"
)
func main() {
url := "https://daas.digicert.com/apicontroller/v1/reports/filter"
payload := strings.NewReader("{\n \"searchCriteriaList\": [\n {\n \"key\": \"cn\",\n \"operation\": \"STARTS_WITH\",\n \"value\": [\n \"www\",\"digi\"\n ]\n }\n ],\n \"accountId\": \"126993\",\n \"divisionIds\": [],\n \"startIndex\": 1,\n \"pageSize\": 50,\n \"filterSelected\": \"ip\",\n \"sortedColumnId\": null,\n \"sortOrder\": \"ASC\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-DC-DEVKEY", "{{api_key}}")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}
var request = require("request");
var options = { method: 'POST',
url: 'https://daas.digicert.com/apicontroller/v1/reports/filter',
headers:
{ 'Content-Type': 'application/json',
'X-DC-DEVKEY': '{{api_key}}' },
body:
{ searchCriteriaList:
[ { key: 'cn', operation: 'STARTS_WITH', value: [ 'www','digi' ] } ],
accountId: '126993',
divisionIds: [],
startIndex: 1,
pageSize: 50,
filterSelected: 'ip',
sortedColumnId: null,
sortOrder: 'ASC' },
json: true };
request(options, function (error, response, body) {
if (error) throw new Error(error);
console.log(body);
});
{
"data": {
"filterName": "ip",
"displayName": "ip",
"values": [
"103.23.108.107",
"104.154.127.47",
"104.19.194.29",
"104.19.195.29",
"104.199.240.211",
"104.199.64.136",
"104.215.148.63",
"104.236.66.94",
"104.244.42.1",
"104.244.42.129",
"104.244.42.133",
"104.244.42.193",
"104.244.42.197",
"106.11.186.1",
"106.11.186.25",
"106.120.159.68",
"107.150.101.156",
"107.23.104.215",
"108.174.10.10",
"109.71.161.200",
"110.75.129.5",
"110.75.139.5",
"111.161.64.40",
"111.161.64.48",
"121.42.17.238",
"121.42.17.239",
"123.125.114.144",
"123.125.116.28",
"123.126.157.222",
"123.126.55.41",
"125.209.222.141",
"125.209.222.142",
"13.107.21.200",
"13.225.214.41",
"13.35.78.123",
"13.35.78.38",
"13.35.78.43",
"13.35.78.87"
]
}
}
Name | Req/Opt | Type | Description |
---|---|---|---|
searchCriteriaList | optional | array | Filter results by specified values. |
.. key | optional | string |
Filter parameter. Allowed values: cn , serialNumber , ip , port , scanName , serverSecurity , isCertPresent
|
.. operation | optional | string |
Filter operation. Allowed value: STARTS_WITH
|
.. value | optional | array | Filter values. |
accountId | required | string | Account ID. |
divisionIds | optional | array | Division IDs. |
startIndex | optional | int |
Start at the specified index. Default: 1
|
pageSize | optional | int |
Number of records per page. Default: 50 , Max: 100
|
filterSelected | required | string |
Data type you want to retrieve. Allowed values: cn , serialNumber , ip , port , scanName , serverSecurity , isCertPresent
|
sortedColumnId | optional | string |
Sort results by specified parameter. Allowed value: isCertPresent
|
sortOrder | optional | string |
Sort direction. Allowed values: DESC (descending: 9-0, Z-A), ASC (ascending: 0-9, A-Z)Default: DESC
|
Name | Type | Description |
---|---|---|
data | object | Container. |
.. filterName | string | Specified filter ID. |
.. displayName | string | Friendly filter name. |
.. values | array | Matching results. |