Obtenez le nombre total et la liste de tous les serveurs de points de terminaison dont les certificats ont été détectés par les analyses de CertCentral Discovery. Vous pouvez filtrer les résultats par serveur ou par attributs d'analyse.
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"
}'
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))
}
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);
});
{
"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"
}
]
}
}
Nom | Obligatoire/facultatif | Type | Description |
---|---|---|---|
searchCriteriaList | Facultatif | array | Obtenez des enregistrements pour des critères spécifiques. |
.. key | Facultatif | string |
Paramètre de recherche. Valeurs autorisées : serialNumber , ip , port , scanName , serverSecurity , isCertPresent , cn
|
.. operation | Facultatif | string |
Opération de recherche. Valeurs autorisées : EQUALS
|
.. value | Facultatif | array | Valeurs de recherche. |
accountId | Obligatoire | string | ID de compte |
divisionIds | Facultatif | array | ID de la division. |
startIndex | Facultatif | int |
Commencez à l'index spécifié. Valeur par défaut : 1
|
pageSize | Facultatif | int |
Nombre d'enregistrements par page. Valeur par défaut : 50
|
sortedColumnId | Facultatif | string |
Trier les résultats par paramètre spécifié. Valeurs autorisées : serialNumber , ip , port , scanName , serverSecurity , isCertPresent , cn Valeur par défaut : isCertPresent
|
sortOrder | Facultatif | string |
Trier la direction. Valeurs autorisées : DESC (par ordre décroissant : 9-0, Z-A), ASC (par ordre croissant : 0-9, A-Z)Valeur par défaut : DESC
|
Nom | Type | Description |
---|---|---|
data | object | Conteneur. |
.. totalCount | int | Nombre total d'enregistrements qui correspondent aux critères de recherche. |
.. currentCount | int | Nombre d'enregistrements sur la page actuelle. |
.. onlineIPPortDetailsDTOList | array | Conteneur destiné aux détails des points de terminaison. |
.. .. commonName | string | Nom commun du certificat détecté sur le point de terminaison. |
.. .. port | string | Port sur lequel le certificat a été trouvé. |
.. .. ipAddress | string | Adresse IP du point de terminaison. |
.. .. portStatus | string | Disponibilité ou état de connexion du point de terminaison. |
.. .. isCertPresent | bool | Que le certificat soit ou non installé sur le point de terminaison. |
.. .. serverSecurityRating | string |
Cote de sécurité du serveur , en fonction des paramètres de communication et de sécurité du point de terminaison.
|
.. .. service | string |
Les protocoles de communication, tels que https .
|
.. .. deviceType | string | Type de matériel général, si disponible. |
.. .. serverName | string | Logiciel de serveur, si disponible. |
.. .. serverVersion | string | Version du serveur, si disponible. |
.. .. scanId | string | ID unique pour l'analyse CertCentral Discovery qui a permis de numériser et de récupérer les détails du point de terminaison. |
.. .. scanName | string | Nom personnalisé donné par l'administrateur à l'analyse CertCentral Discovery. |
.. .. domainName | string | Domaine racine du point de terminaison. |
.. .. firstDiscoveredDate | string | Date à laquelle le point de terminaison a été trouvé pour la première fois par l'analyse de CertCentral Discovery. |
.. .. certificateId | string | ID unique généré par DigiCert pour le certificat détecté sur le point de terminaison. Utilisé pour les requêtes API qui le requièrent. |
.. .. os | string | Système d'exploitation. |
.. .. osVersion | string | Version du système d'exploitation, si disponible. |
.. .. vulnerabilityName | string | Vulnérabilités trouvées sur la base de détails de points de terminaison connus. |
.. .. serverId | string | ID du serveur, si disponible. |
.. .. san | string | Noms alternatifs du sujet sur le certificat détecté sur le point de terminaison. |
.. .. org | string | Nom de l'organisation sur le certificat détecté sur le point de terminaison. |
.. .. certExpiryDate | string | Date d'expiration du certificat détecté sur le point de terminaison. |
.. .. certStatus | string |
Statut du certificat détecté sur le point de terminaison.
|
.. .. certRating | string |
Cote de sécurité du certificat , en fonction des normes en vigueur dans l'industrie et des paramètres du certificat.
|
.. .. ca | string | Autorité de certification qui a émis le certificat. |
.. .. serialNumber | string | Numéro de série attribué au certificat lors de son émission. |