Skip to main content

View IP port

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

Get a total count and list of all the IPs and ports that have certificates found through CertCentral Discovery scans. Optionally filter results by server or scan attributes.

Example requests and responses

Request parameters

Name

Req/Opt

Type

Description

searchCriteriaList

optional

array

Filter results by specified values. The array includes key, operation and value.

Example:

searchCriteriaList:[
  {
    "key":"port",
    "operation":"EQUALS",
    "value":[443]
  }
]

Allowed values: scanName, division, port, ip, serverSecurity, isCertPresent, cn, serialNumber, status, keyAlgo, scanName, serverSecurityRating, daysToExpire, protocols, sshKeyFingerprint, source

accountId

required

string

Account ID.

divisionIds

optional

array

Division IDs.

startIndex

optional

integer

Index of the first result.

Default: 1

pageSize

optional

integer

Number of records per page.

Allowed values: 0 to 512,

Default: 1

filterSelected

required

string

The value to show in the results for each IP/port that meets the search criteria.

sortedColumnId

optional

string

Sort results by specified parameter.

Allowed values: cn, org, status, serialNum, securityRating, ca, daysToExpire

Default: isCertPresent with sortOrder as DESC

sortOrder

optional

string

Sort direction.

Allowed values: DESC (descending: 9-0, Z-A), ASC (ascending: 0-9, A-Z)

Default: ASC

Response parameters

Name

Type

Description

error

object

Includes error codes, if any.

data

object

Object with information about the filter results.

.. totalCount

integer

Total number of records that match search criteria.

.. currentCount

integer

Number of records on current page.

.. onlineIPPortDetailsDTOList

array

Container for the IP/port details.

.. .. commonName

string

Common name of certificate found on the IP/port.

.. .. port

string

Port that the certificate was found on.

.. .. ipAddress

string

IP address details.

.. .. isCertPresent

boolean

Whether or not certificate is installed at the IP/port.

.. .. serverSecurityRating

string

Server security rating, based on the endpoint's communication and security settings.

.. .. service

string

Communication protocol, such as https.

.. .. deviceType

string

General hardware type, if available.

.. .. serverName

string

Server software, if available.

.. .. serverVersion

string

Server version, if available.

.. .. scanId

string

Unique ID for the CertCentral Discovery scan that scanned and retrieved details for the IP/port.

.. .. scanName

string

Friendly name the admin gave to the CertCentral Discovery scan.

.. .. domainName

string

Root domain of the IP/port.

.. .. firstDiscoveredDate

integer

Date endpoint was first found by CertCentral Discovery 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: 1855828800000

.. .. certificateId

string

Unique DigiCert-generated ID for the certificate found on the endpoint. Use for API requests that require it.

.. .. os

string

Operating system.

.. .. osVersion

string

Operating system version, if available.

.. .. vulnerabilityName

string

Vulnerabilities found based on known IP/port details.

.. .. serverId

string

Server ID that uniquely identifies the record.

.. .. san

string

Subject alternative names on the certificate

.. .. org

string

Organization name on the certificate

.. .. certExpiryDate

integer

Expiration date of the certificate found on the endpoint.

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: 1855828800000

.. .. certStatus

string

Status of the certificate found on the IP/port.

.. .. certRating

string

Certificate security rating, based on industry standards and the certificate's settings.

.. .. ca

string

Certificate Authority that issued the certificate.

.. .. serialNumber

string

Serial number assigned to the certificate on issuance.

.. .. protocols

string

Protocol used to set up an encrypted connection between the systems to communicate over the internet.Possible values: SSH1, SSH2.

.. .. certType

string

Type of the certificate.

Possible values: EXTENDED_VERIFICATION, ORGANIZATION_VERIFICATION, DOMAIN_VERIFICATION

.. .. status

string

HTTP response status return from server (IP:PORT).

.. .. redirect

string

Whether the server is redirected to any other URL.

Possible values: Yes, No.

.. .. certValidFrom

integer

Date and time from when the certificate is valid.

.. .. actions

object

Action performed on the certificate associated with the IP/port.

.. .. .. primaryActions

string

Primary action performed.

.. .. .. secondaryActions

string

Secondary action performed.

.. .. source

string

The source used to identify the IP/port.

Possible values: Agent, Sensor,Cloud,Automation upload,Manuel upload.