Endpunkte auflisten

POST

https://daas.digicert.com/apicontroller/v1/reports/delete

Rufen Sie eine Liste und die Gesamtzahl aller Endpunktserver auf, die Zertifikate durch CertCentral Discovery-Scans gefunden haben. Optional können Sie die Ergebnisse nach Server- oder Scan-Attributen filtern.

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)

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"
            }
        ]
    }
}

Antragsparameter

Name	Antr./Opt.	Typ	Beschreibung
searchCriteriaList	optional	array	Aufzeichnungen der angegebenen Kriterien abrufen.
.. key	optional	string	Suchparameter. Zulässige Werte: `serialNumber`, `ip`, `port`, `scanName`, `serverSecurity`, `isCertPresent`, `cn`
.. operation	optional	string	Suchoperation Zulässige Wert: `EQUALS`
.. value	optional	array	Suchwerte
accountId	erforderlich	string	Konto-ID
divisionIds	optional	array	Abteilungs-IDs
startIndex	optional	int	Beim angegebenen Index beginnen Standard: `1`
pageSize	optional	int	Anzahl der Einträge pro Seite Standard: `50`
sortedColumnId	optional	string	Ergebnisse nach angegebenem Parameter sortieren Zulässige Werte: `serialNumber`, `ip`, `port`, `scanName`, `serverSecurity`, `isCertPresent`, `cn` Standard: `isCertPresent`
sortOrder	optional	string	Sortierrichtung Zulässige Werte: `DESC` (absteigend: 9-0, Z-A), `ASC` (aufsteigend: 0-9, A-Z) Standard: `DESC`

Reaktionsparameter

Name	Typ	Beschreibung
data	object	Container.
.. totalCount	int	Gesamtzahl der Einträge, die den Suchkriterien entsprechen
.. currentCount	int	Anzahl der Einträge auf der aktuellen Seite
.. onlineIPPortDetailsDTOList	array	Container für Endpunktdetails
.. .. commonName	string	Allgemeiner Name des am Endpunkt gefundenen Zertifikats
.. .. port	string	Port, an dem das Zertifikat gefunden wurde.
.. .. ipAddress	string	IP-Adresse des Endpunkts
.. .. portStatus	string	Verfügbarkeit oder Verbindungsstatus des Endpunkts
.. .. isCertPresent	bool	Ist das Zertifikat am Endpunkt installiert oder nicht?
.. .. serverSecurityRating	string	`Sicherheitsbewertung des Servers`, basierend auf den Kommunikations- und Sicherheitseinstellungen des Endpunkts.
.. .. service	string	Kommunikationsprotokoll, z. B. `https`
.. .. deviceType	string	Allgemeiner Hardwaretyp, falls verfügbar
.. .. serverName	string	Serversoftware, falls verfügbar
.. .. serverVersion	string	Serverversion, falls verfügbar
.. .. scanId	string	Eindeutige ID des CertCentral Discovery-Scans, der Details für den Endpunkt gescannt and abgerufen hat.
.. .. scanName	string	Anzeigename, den der Administrator dem CertCentral Discovery-Scan gegeben hat
.. .. domainName	string	Stammdomäne des Endpunkts
.. .. firstDiscoveredDate	string	Datum, zu dem der Endpunkt erstmalig vom CertCentral Discovery-Scan gefunden wurde.
.. .. certificateId	string	Eindeutige DigiCert-generierte ID für das am Endpunkt gefundene Zertifikat Für API Anfragen verwenden, die sie benötigen.
.. .. os	string	Betriebssystem
.. .. osVersion	string	Version des Betriebssystems, falls verfügbar
.. .. vulnerabilityName	string	Schwachstellen gefunden, basierend auf bekannten Endpunktdetails
.. .. serverId	string	Server-ID, falls verfügbar
.. .. san	string	SANs (Alternative Namen) auf dem Zertifikat am Endpunkt gefunden
.. .. org	string	Organisationsname auf dem Zertifikat am Endpunkt gefunden
.. .. certExpiryDate	string	Ablaufdatum des Zertifikats am Endpunkt gefunden
.. .. certStatus	string	`Status` des Zertifikats am Endpunkt gefunden
.. .. certRating	string	`Sicherheitsbewertung für das Zertifikat`, basierend auf Branchenstandards und den Zertifikatseinstellungen.
.. .. ca	string	Zertifizierungsstelle, die das Zertifikat ausgestellt hat
.. .. serialNumber	string	Die dem Zertifikat bei Ausstellung zugewiesene Seriennummer

Antragsparameter

Reaktionsparameter

Über