Список контрольных точек

POST
https://daas.digicert.com/apicontroller/v1/reports/viewIpPort

Получение общего числа и списка всех серверов конечной точки, которые имеют сертификаты, обнаруженные при сканированиях CertCentral Discovery. Дополнительная фильтрация результатов по атрибутам сервера или сканирования.

cURL
curl -X POST \
  https://daas.digicert.com/apicontroller/v1/reports/viewIpPort \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
    "searchCriteriaList": [
        {
            "key":"serialNumber",
            "operation": "EQUALS",
            "value": [
                "0eb6eab418c873d8f3c031dcdddf18b0"
            ]
        },
        {
            "key":"ip",
            "operation": "EQUALS",
            "value": [
                "www.itc.com","www.digicert.com","www.cert.com","wmart.com","ph.com"
            ]
        },
        {
            "key":"port",
            "operation": "EQUALS",
            "value": [
                3389,636,443,80,389,8443
            ]
        },
        {
            "key":"scanName",
            "operation": "EQUALS",
            "value": [
                "ScanWithAllVul","GtScdlV612Aug19"
            ]
        },
        {
            "key":"serverSecurity",
            "operation": "EQUALS",
            "value": [
                "NO_VULNERABILITY_FOUND"
            ]
        },
        {
            "key":"isCertPresent",
            "operation": "EQUALS",
            "value": [
                true
            ]
        },
        {
            "key":"cn",
            "operation": "EQUALS",
            "value": [
                "www.origin.digicert.com"
            ]
        }
    ],
    "accountId": "126993",
    "divisionIds": [],
    "startIndex": 1,
    "pageSize": 50,
    "sortedColumnId": null,
    "sortOrder": "ASC"
}'
Python
import requests

url = "https://daas.digicert.com/apicontroller/v1/reports/viewIpPort"

payload = "{\n    \"searchCriteriaList\": [\n        {\n            \"key\": \"serialNumber\",\n            \"operation\": \"EQUALS\",\n            \"value\": [\n                \"0eb6eab418c873d8f3c031dcdddf18b0\"\n            ]\n        },\n        {\n            \"key\": \"ip\",\n            \"operation\": \"EQUALS\",\n            \"value\": [\n                \"www.itc.com\",\"www.digicert.com\",\"www.cert.com\",\"wmart.com\",\"ph.com\"\n            ]\n        },\n        {\n            \"key\": \"port\",\n            \"operation\": \"EQUALS\",\n            \"value\": [\n                \"3389\",\"636\",\"443\",\"80\",\"389\",\"8443\"\n            ]\n        },\n        {\n            \"key\": \"scanName\",\n            \"operation\": \"EQUALS\",\n            \"value\": [\n                \"ScanWithAllVul\",\"GtScdlV612Aug19\"\n            ]\n        },\n        {\n            \"key\": \"serverSecurity\",\n            \"operation\": \"EQUALS\",\n            \"value\": [\n                \"NO_VULNERABILITY_FOUND\"\n            ]\n        },\n        {\n            \"key\": \"isCertPresent\",\n            \"operation\": \"EQUALS\",\n            \"value\": [\n                \"true\"\n            ]\n        },\n        {\n            \"key\": \"cn\",\n            \"operation\": \"EQUALS\",\n            \"value\": [\n                \"www.origin.digicert.com\"\n            ]\n        }\n    ],\n    \"accountId\": \"126993\",\n    \"divisionIds\": [],\n    \"startIndex\": 1,\n    \"pageSize\": 50,\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)
Go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://daas.digicert.com/apicontroller/v1/reports/viewIpPort"

	payload := strings.NewReader("{\n    \"searchCriteriaList\": [\n        {\n            \"key\": \"serialNumber\",\n            \"operation\": \"EQUALS\",\n            \"value\": [\n                \"0eb6eab418c873d8f3c031dcdddf18b0\"\n            ]\n        },\n        {\n            \"key\": \"ip\",\n            \"operation\": \"EQUALS\",\n            \"value\": [\n                \"www.itc.com\",\"www.digicert.com\",\"www.cert.com\",\"wmart.com\",\"ph.com\"\n            ]\n        },\n        {\n            \"key\": \"port\",\n            \"operation\": \"EQUALS\",\n            \"value\": [\n                \"3389\",\"636\",\"443\",\"80\",\"389\",\"8443\"\n            ]\n        },\n        {\n            \"key\": \"scanName\",\n            \"operation\": \"EQUALS\",\n            \"value\": [\n                \"ScanWithAllVul\",\"GtScdlV612Aug19\"\n            ]\n        },\n        {\n            \"key\": \"serverSecurity\",\n            \"operation\": \"EQUALS\",\n            \"value\": [\n                \"NO_VULNERABILITY_FOUND\"\n            ]\n        },\n        {\n            \"key\": \"isCertPresent\",\n            \"operation\": \"EQUALS\",\n            \"value\": [\n                \"true\"\n            ]\n        },\n        {\n            \"key\": \"cn\",\n            \"operation\": \"EQUALS\",\n            \"value\": [\n                \"www.origin.digicert.com\"\n            ]\n        }\n    ],\n    \"accountId\": \"126993\",\n    \"divisionIds\": [],\n    \"startIndex\": 1,\n    \"pageSize\": 50,\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))

}
NodeJS
var request = require("request");

var options = { method: 'POST',
  url: 'https://daas.digicert.com/apicontroller/v1/reports/viewIpPort',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' },
  body: 
   { searchCriteriaList: 
      [ { key: 'serialNumber', operation: 'EQUALS', value: [ '0eb6eab418c873d8f3c031dcdddf18b0' ] },
        { key: 'ip', operation: 'EQUALS', value: [ 'www.itc.com','www.digicert.com','www.cert.com','wmart.com','ph.com' ] },
        { key: 'port', operation: 'EQUALS', value: [ '3389','636','443','80','389','8443' ] },
        { key: 'scanName', operation: 'EQUALS', value: [ 'ScanWithAllVul','GtScdlV612Aug19' ] },
        { key: 'serverSecurity', operation: 'EQUALS', value: [ 'NO_VULNERABILITY_FOUND' ] },
        { key: 'isCertPresent', operation: 'EQUALS', value: [ 'true' ] },
        { key: 'cn', operation: 'EQUALS', value: [ 'www.origin.digicert.com' ] } ],
     accountId: '126993',
     divisionIds: [],
     startIndex: 1,
     pageSize: 50,
     sortedColumnId: null,
     sortOrder: 'ASC' },
  json: true };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
200 OK
{
    "data": {
        "totalCount": 728,
        "currentCount": 50,
        "onlineIPPortDetailsDTOList": [
            {
                "commonName": "www.digicert.com",
                "port": 443,
                "ipAddress": "digicert.com",
                "portStatus": null,
                "isCertPresent": true,
                "serverSecurityRating": "Not secure",
                "service": "https",
                "devicetype": "Unavailable",
                "serverName": "Unavailable",
                "serverVersion": "Unavailable",
                "scanId": null,
                "scanName": "Ray test scan",
                "domainName": "digicert.com",
                "firstDiscoveredDate": 1563917837971,
                "certificateId": "041340bf2a9fb794d30fda13395b314ae67df53d",
                "os": "",
                "osVersion": null,
                "vulnerabilityName": "POODLE (TLS)",
                "serverId": 1634548,
                "san": "www.digicert.com,ak-dfw01-www.digicert.com,ak-dal01-www.digicert.com,www.dig-cert.com,digicert.com",
                "org": "DigiCert, Inc.",
                "certExpiryDate": 1581162880000,
                "certStatus": "VALID",
                "certRating": "Very secure",
                "ca": "DigiCert",
                "serialNumber": "3abd311ca0530854676aab23"
            },
            {
                "commonName": "*.stackexchange.com",
                "port": 443,
                "ipAddress": "stackoverflow.com",
                "portStatus": null,
                "isCertPresent": true,
                "serverSecurityRating": "Secure",
                "service": "https",
                "devicetype": "",
                "serverName": "Unavailable",
                "serverVersion": "Unavailable",
                "scanId": null,
                "scanName": "Morpheus",
                "domainName": "stackoverflow.com",
                "firstDiscoveredDate": 1561409075964,
                "certificateId": "390a4684b989444a6d286705acd429415a9c433d",
                "os": "",
                "osVersion": null,
                "vulnerabilityName": "",
                "serverId": 1407732,
                "san": "*.askubuntu.com,*.blogoverflow.com,*.mathoverflow.net,*.meta.stackexchange.com,*.meta.stackoverflow.com,*.serverfault.com,*.sstatic.net,*.stackexchange.com,*.stackoverflow.com,*.stackoverflow.email,*.superuser.com,askubuntu.com,blogoverflow.com,mathoverflow.net,openid.stackauth.com,serverfault.com,sstatic.net,stackapps.com,stackauth.com,stackexchange.com,stackoverflow.blog,stackoverflow.com,stackoverflow.email,stacksnippets.net,superuser.com",
                "org": "",
                "certExpiryDate": 1566927383000,
                "certStatus": "EXPIRED",
                "certRating": "Secure",
                "ca": "Let's Encrypt",
                "serialNumber": "039980940a562af6fb09e8a984d2a14c6ec9"
            }
        ]
    }
}

Параметры запроса

Имя Обязательный/Необязательный Тип Описание
searchCriteriaList необязательный array Получение записей с использованием указанных критериев.
.. key необязательный string Параметр поиска.
Допустимые значения: serialNumber, ip, port, scanName, serverSecurity, isCertPresent, cn
.. operation необязательный string Операция поиска.
Допустимое значение: EQUALS
.. value необязательный array Поиск значений
accountId обязательный string Идентификатор учетной записи.
divisionIds необязательный array Идентификаторы подразделения.
startIndex необязательный int Начало с указанного индекса.
По умолчанию: 1
pageSize необязательный int Число записей на страницу.
По умолчанию: 50
sortedColumnId необязательный string Сортировка результатов по указанному параметру.
Допустимые значения: serialNumber, ip, port, scanName, serverSecurity, isCertPresent, cn
По умолчанию: isCertPresent
sortOrder необязательный string Направление сортировки.
Допустимые значения: DESC (в порядке убывания: 9-0, Z-A), ASC (в порядке возрастания: 0-9, A-Z)
По умолчанию: DESC

Параметры ответного сообщения

Имя Тип Описание
data object Контейнер.
.. totalCount int Общее число записей, соответствующих критериям поиска.
.. currentCount int Число записей на текущей странице.
.. onlineIPPortDetailsDTOList array Контейнер для данных конечной точки.
.. .. commonName string Общее имя сертификата, обнаруженного в конечной точке.
.. .. port string Порт, в котором был обнаружен сертификат.
.. .. ipAddress string IP-адрес конечной точки.
.. .. portStatus string Доступность или состояние подключения конечной точки.
.. .. isCertPresent bool Установлен ли сертификат в конечной точке.
.. .. serverSecurityRating string Рейтинг безопасности сервера, с учетом настроек подключения и безопасности конечной точки.
.. .. service string Связной протокол, например, https.
.. .. deviceType string Аппаратные средства общего типа, если указаны.
.. .. serverName string Программное обеспечение сервера, если указано.
.. .. serverVersion string Версия сервера, если указана.
.. .. scanId string Уникальный идентификатор для сканирования CertCentral Discovery, в результате которого были отсканированы и получены данные для конечной точки.
.. .. scanName string Понятное для пользователя имя, которое администратор присвоил сканированию CertCentral Discovery.
.. .. domainName string Корневой домен конечной точки.
.. .. firstDiscoveredDate string Конечная точка данных была в первый раз обнаружена при сканировании CertCentral Discovery.
.. .. certificateId string Уникальный идентификатор, сгенерированный DigiCert для сертификата, обнаруженного в конечной точке. Используется для запросов API, требующих данного идентификатора.
.. .. os string Операционная система.
.. .. osVersion string Версия операционной системы, если указана.
.. .. vulnerabilityName string Обнаруженные уязвимости с учетом известных данных о конечной точке.
.. .. serverId string Идентификатор сервера, если указан.
.. .. san string Альтернативные имена пользователей в сертификате, обнаруженном в конечной точке.
.. .. org string Имя организации в сертификате, обнаруженном в конечной точке.
.. .. certExpiryDate string Окончание срока действия сертификата, обнаруженного в конечной точке.
.. .. certStatus string Статус сертификата, обнаруженного в конечной точке.
.. .. certRating string Рейтинг безопасности сертификата, с учетом промышленных стандартов и настроек сертификата.
.. .. ca string Центр сертификации, выпустивший сертификат.
.. .. serialNumber string Серийный номер, назначенный сертификату при выпуске.