Scan-Details erhalten

GET
https://daas.digicert.com/apicontroller/v1/scan/getScanDetails

Use this endpoint to get information about an existing scan template.

For more information on discovery scan and its details, see Set up and run a scan

cURL
curl --location --request GET 'https://daas.digicert.com/apicontroller/v1/scan/getScanDetails?surveyDefId=292888&accountId=5153184&divisionId=677793' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw ''
200 OK
{
    "error": null,
    "data": {
        "accountId": "5153184",
        "divisionId": 677793,
        "surveyName": "02april2020 01",
        "frequencyType": "daily",
        "surveyDefId": 292888,
        "state": "active",
        "createdTime": 1585829323489,
        "startTime": 52200000,
        "hasVulnerability": true,
        "currentScanJobList": [{
			"startTime": 1628060456025,
			"percentageCompleted": 0.0,
			"state": 10,
			"vulStartTime": null,0
			"vulPercentageCompleted": 0.0,
			"vulState": null,
			"duration": null,
			"vulEnabled": true,
			"jobId": "368173",
			"includedSensors": [{a
				"ipInclusionList":  "www.yahoo.com,www.google.com,www.digicert.com",
				"includedPorts": ["443", "389", "636", "22", "143", "110", "465",  
                                          "8443", "3389"],
				"openPorts": null,
				"ipExclusionList": "",
				"licenseKey": "DBE32EF28E344F97",
				"includeAllSubdomains": ["www.digicert.com"],
				"selectedSubdomains": [{
					"domain": "www.yahoo.com",
					"subdomains": ["accountlink.www.yahoo.com", 
                                                  "secure.www.yahoo.com"]
				}, {
					"domain": "www.google.com",
					"subdomains": ["www.google.com----------------- 
                                                  r.reflectiz.com"]
				}],
				"ipv4Sensor": false,
				"portSelectionChoice": "default"
			}]
		}],
        "vulnerabilityScanOption": "critical",
        "surveyConfigDTO": {
            "sensorWithIpPortDTO": [
                {
                    "ipInclusionList": "www.yahoo.com,www.google.com,www.digicert.com",
                    "includedPorts": ["443", "389", "636", "22", "143", "110", "465", "8443", "3389"],
                    "openPorts": null,
                    "ipExclusionList": "",
                    "licenseKey": "DBE32EF28E344F97",
                    "includeAllSubdomains": ["www.digicert.com"],
                    "selectedSubdomains": [{
					"domain": "www.yahoo.com",
					"subdomains": ["accountlink.www.yahoo.com", 
                                                   "secure.www.yahoo.com"]
		  }, {
					"domain": "www.google.com",
					"subdomains": ["www.google.com-----------------
                                                   r.reflectiz.com"]
		  }],
                    "ipv4Sensor": false,
                    "portSelectionChoice": "default"
                }
            ],
            "startTime": 0,
            "daysToRun": [],
            "disablePing": false,
            "timezone": "5:30#chennai",
            "timeToComplete": 0,
            "vulnerabilityList": "Heartbleed,POODLE (SSLv3),FREAK,LogJam,DROWN,RC4,POODLE (TLS)",
            "emulationScans": false,
            "sni": false,
            "tls13": false,
            "ipv6": false,
            "extraTlsProtocolsDiscovery": false,
            "sshDiscovery": true,
            "osDiscoverable": false,
            "serviceDiscoverable": false,
            "monthlyRecurrenceType": "1st",
            "speed": "medium",
            "refreshHPSInventory": "always",
            "scanOption": "custom"
        },
        "isCipherScan": false,
        "emailAddresses": "cc.admin@cert-testing.com",
        "listFilteredPorts": false,
        "tags": null
    }
}

URL query parameters

Name Req/Opt Type Description
surveyDefId required integer Survey definition ID of the scan.
To get a list of surveyDefId values for your scans, use the scan list endpoint.
accountId required string Account ID.
divisionId required integer Division ID.

Response parameters

Name Type Description
error object Includes the error code if any.
data object Object container for response.
.. accountId string Account ID.
.. divisionId integer Division ID.
surveyName string Friendly name provided for the scan.
Max length: 80 characters.
frequencyType string Allowed values: One Time, Daily, Weekly, Monthly, Cloud
surveyDefId integer Survey definition ID of the scan.
To get a list of surveyDefId values for your scans, use the scan list endpoint.
.. state string Status of the scan.
Possible values: ACTIVE, SUSPENDED, DELETED, INPROGRESS
.. createdTime integer Scan creation time.
.. startTime integer Start time for the scheduled scan.
Format: epoch in millisecond.
Epoch corresponds to 0 hours, 0 minutes, and 0 seconds (00:00:00) Coordinated Universal Time (UTC) on a specific date, which varies from system to system.
Example: 1596781119
Note: startTime value should be 0 when the frequencytype is onetime
.. hasVulnerability boolean If true, vulnerability discovery is enabled for the scan.
.. currentScanJobList object Object container for in-progress scans
.. .. startTime integer Start time of the current scan.
Format: epoch in millisecond.
Epoch corresponds to 0 hours, 0 minutes, and 0 seconds (00:00:00) Coordinated Universal Time (UTC) on a specific date, which varies from system to system.
Example: 1596781119
Note: startTime value should be 0 when the frequencytype is onetime
.. .. percentageCompleted integer Scan percentage completed.
.. .. state integer State of the scan.
.. .. vulStartTime integer Vulnerability discovery start time
Format: Timestamp in milliseconds.
Example: 5:30#chennai
.. .. vulPercentageCompleted integer Vulnerability scan percentage completed.
Possible values: 0-100%
.. .. vulState integer Status of the vulnerability.
.. .. duration integer Duration of the scan in seconds.
.. .. vulEnabled integer Whether vulnerability is enabled.
If true, vulnerability is enabled. Otherwise false.
.. .. jobId string Scan job ID.
.. .. includedSensors object Object container containing IP/port configuration details for the currently running scan.
.. .. .. ipInclusionList string IPs to include in the scan.
Supported formats are individual IPs, IP range, CIDR, and FQDNs.
Example for IP format: 104.20.67.46
Example for FQDN format: digicert.com
Note: Loopback IP "127.0.0.1" is not allowed to scan.
.. .. .. includedPorts array Ports to include in the scan.
It can be individual ports or port range.
.. .. .. openPorts array A list of the open ports scanned.
Used in scenarios where the host is unresponsive to ping.
.. .. .. ipExclusionList string IPs to exclude in the scan.
Supported formats are individual IPs, IP range, CIDR, and FQDNs.
.. .. .. licenseKey string Sensor license key to create scan.
.. .. .. includeAllSubdomains array List of domains to scan all subdomains for. If a domain is in this list, the scan includes all subdomains of that domain.
.. .. .. selectedSubdomains array List of objects that define which subdomains of a given domain are included in the scan.
.. .. .. .. domain string Name of the domain.
.. .. .. .. subdomains array List of subdomains included in the scan for the given domain.
.. .. .. isIPv4Sensor boolean Use true if the operating system of the installed sensor runs on IPv4.
.. .. .. portSelectionChoice string Select the default port or choose from All/custom ports.
.. vulnerabilityScanOption string Setting that defines which vulnerabilities to scan for. 
Allowed values: all, critical.
.. surveyConfigDTO object Object container for scan configuration details.
.. .. sensorWithIpPortDTO object Object container for IP/port configuration details.
.. .. .. ipInclusionList string IPs to include in the scan.
Supported formats are individual IPs, IP range, CIDR, and FQDNs.
Example for IP format: 104.20.67.46
Example for FQDN format: digicert.com
Note: Loopback IP "127.0.0.1" is not allowed to scan.
.. .. .. includedPorts string Ports to include in the scan.
It can be individual ports or port range.
.. .. .. openPorts array A list of the open ports scanned.
Used in scenarios where the host is unresponsive to ping.
.. .. .. ipExclusionList string IPs to exclude in the scan.
Supported formats are individual IPs, IP range, CIDR, and FQDNs.
Example for IP format: 104.20.67.46
Example for FQDN format: digicert.com
Note: Loopback IP "127.0.0.1" is not allowed to scan.
.. .. .. licenseKey string Sensor license key to create scan.
.. .. .. .. includeAllSubdomains array List of domains to scan all subdomains for. If a domain is in this list, the scan includes all subdomains of that domain.
.. .. .. .. selectedSubdomains array List of objects that define which subdomains of a given domain are included in the scan.
.. .. .. .. .. domain string Name of the domain.
.. .. .. .. .. subdomains array List of subdomains included in the scan for the given domain.
.. .. .. .. isIPv4Sensor boolean Use true if the operating system of the installed sensor runs on IPv4.
.. .. .. .. portSelectionChoice string Select the default port or choose from All/custom ports.
.. daysToRun integer Days when the scheduled scan runs.
Possible values: 1, 2, 3, 4, 5, 6,7
Note: 1 being Sunday.
.. disablePing boolean Enable hosts discovery that do not respond to ping.
Note: : If true, openPorts should be provided.
.. timezone string Time zone for the scan.
Format: GMT + your timezone offset.
Example: -8#pacifictime
.. timeToComplete int Wait time to complete the scan. 0 implies no timeout.
.. vulnerabilityList string This is a comma separated list of the vulnerabilities to scan for.
Allowed values: Heartbleed, POODLE(SSLv3), FREAK, LogJam, DROWN, RC4, POODLE(TLS), BEAST, CRIME, BREACH, SWEET32.
.. emulationScans boolean If true, it will exclude Heartbleed and POODLE (TLS) from vulnerability discovery.
.. sni boolean Enable the Server Name Indication (SNI) for your scan.
.. tls13 boolean Enable scan of TLS v1.3 protocol.
Default: false
.. ipv6 boolean Use true if IPv6 addresses are used.
Default: false
.. extraTlsProtocolsDiscovery boolean Enable discovery of extra TLS protocol.
Default: false
.. sshDiscovery boolean Enable SSH key to be discovered.
Default: false
.. osDiscoverable boolean Include or exclude OS information.
Default: false
.. serviceDiscoverable boolean Include or exclude server application information.
Default: false
.. monthlyRecurrenceType string Day of the month specified for recurring scan.
Allowed values: 1st, 2nd, 3rd, 4th, 5th
Note: 1st being the first day of the month.
.. speed string How fast the scan completes.
Default: medium
Allowed values: slow, medium, fast
.. refreshHPSInventory string How often the host inventory will refresh.
1 - always, 2 - monthly, 0 - never
.. scanOption string Configure the scan settings either to custom / optimize.
isCipherScan boolean Enable scan for ciphers configured on server.
Default: false
emailAddress string Email address for the contact associated with the scan.
listFilteredPorts boolean If enabled, scan will list all the closed and filtered ports.
Default: false
tags string Add tags to the scan.
Tags can be a combination of letters (a-z or A-Z), numbers (0-9), number signs (#), or spaces. Entries must be comma-separated. (Maximum 512 characters).
Note: Alphanumeric characters like #, @ and _ are allowed.