Scans aktivieren

PUT

https://www.digicert.com/services/v2/vulnerability-assessment/{{order_id}}/scan

Verwenden Sie diesen Endpunkt, um Schwachstellenanalysen für einen Auftrag zu aktivieren.

Ersetzen Sie {{order_id}} in der Abfrage-URL durch die ID des Auftrags. Um die ID-Werte für Aufträge in Ihrem Konto zu erhalten, verwenden Sie den Endpunkt Aufträge auflisten.

Wenn Sie Schwachstellenanalysen für einen Auftrag aktivieren, stellt der Scan-Dienst automatisch die in Frage kommenden Domänen auf dem Zertifikat in die Warteschlange für den Scan. Wenn der Scan abgeschlossen ist, verwenden Sie den Endpunkt Ergebnisse herunterladen, um eine PDF-Datei mit den Bewertungsergebnissen herunterzuladen.

Beispielabfragen und -antworten

cURL

curl -X PUT \
https://www.digicert.com/services/v2/vulnerability-assessment/{{order_id}}/scan \
-H 'Content-Type: application/json' \
-H 'X-DC-DEVKEY: {{api_key}}'

Python

import requests

url = "https://www.digicert.com/services/v2/vulnerability-assessment/{{order_id}}/scan"

payload = {}
headers = {
  'Content-Type': 'application/json',
  'X-DC-DEVKEY': '{{api_key}}'
}

response = requests.request("PUT", url, headers=headers, data = payload)

print(response.text.encode('utf8'))

package main

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

func main() {

  url := "https://www.digicert.com/services/v2/vulnerability-assessment/{{order_id}}/scan"
  method := "PUT"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
  }
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("X-DC-DEVKEY", "api_key")

  res, err := client.Do(req)
  defer res.Body.Close()
  body, err := ioutil.ReadAll(res.Body)

  fmt.Println(string(body))
}

NodeJS

var request = require('request');
var options = {
  'method': 'PUT',
  'url': 'https://www.digicert.com/services/v2/vulnerability-assessment/{{order_id}}/scan',
  'headers': {
    'Content-Type': 'application/json',
    'X-DC-DEVKEY': '{{api_key}}'
  }
};
request(options, function (error, response) { 
  if (error) throw new Error(error);
  console.log(response.body);
});

204 No Content

// empty

404 Not Found

{
  "errors": [
    {
      "code": "not_found|route",
      "message": "The specified route was not found."
    }
  ]
}

403 Access permission

{
  "errors": [
    {
      "code": "access_denied",
      "message": "You do not have permission to manage this request."
    }
  ]
}

400 Invalid order status

{
  "errors": [
    {
      "code": "va_not_eligible_order",
      "message": "Invalid order status. Order must be issued, not revoked, expired, or pending."
    }
  ]
}

400 Invalid product type

{
  "errors": [
    {
      "code": "va_not_eligible_product",
      "message": "Invalid certificate type. Vulnerability assessment is only available for Secure Site EV and Secure Site Pro certificates."
    }
  ]
}

Beispielabfragen und -antworten

Über