Revoca certificato

PUT
https://www.digicert.com/services/v2/certificate/{{certificate_id}}/revoke

Tutte le richieste di revoca devono essere approvate da un amministratore prima che DigiCert revochi il certificato. Questa fase di approvazione è necessaria e non può essere saltata.

Usa questo endpoint per inviare una richiesta per revocare un solo certificato sull’ordine.

Se vuoi inviare una richiesta per revocare l’intero ordine, usa l’endpoint Revoca certificati ordine.

Non è possibile revocare i certificati con un ordine di riemissione in sospeso. Per revocare un certificato con una riemissione in sospeso, annulla la riemissione o revoca il certificato al termine della riemissione.

Cosa succede se revoco un certificato su un ordine con un solo certificato singolo?

Quando revochi un certificato su un ordine con un solo certificato singolo:

  • L’ordine è ancora attivo
  • Puoi ancora riemettere un certificato su tale ordine
  • Non viene fornito alcun rimborso per un certificato revocato su un ordine

Se non pianifichi di riemettere un certificato per l’ordine, usa l’endpoint Revoca certificati ordine per inviare una richiesta per revocare l’ordine.

cURL
curl -X PUT \
  'https://www.digicert.com/services/v2/certificate/{{certificate_id}}/revoke' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
  "comments": "I no longer need this cert."
}'
Python
import requests

url = "https://www.digicert.com/services/v2/certificate/{{certificate_id}}/revoke"

payload = "{\n  \"comments\": \"I no longer need this cert.\"\n}"
headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/json"
    }

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

print(response.text)
Go
package main

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

func main() {

	url := "https://www.digicert.com/services/v2/certificate/{{certificate_id}}/revoke"

	payload := strings.NewReader("{\n  \"comments\": \"I no longer need this cert.\"\n}")

	req, _ := http.NewRequest("PUT", 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: 'PUT',
  url: 'https://www.digicert.com/services/v2/certificate/{{certificate_id}}/revoke',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' },
  body: { comments: 'I no longer need this cert.' },
  json: true };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
201 Created
{
  "id": 1,
  "date": "2016-02-10T17:06:15+00:00",
  "type": "revoke",
  "status": "pending",
  "requester": {
    "id": 14,
    "first_name": "John",
    "last_name": "Smith",
    "email": "john.smith@digicert.com"
  },
  "comments": "I no longer need this cert."
}

Parametri richiesta

Nome Rich/Opz Tipo Descrizione
comments facoltativo string Messaggio sulla richiesta di revoca richiesta.

Parametri di risposta

Nome Tipo Descrizione
id int ID richiesta
date string Indicazione di data e ora di quando è stata inviata la richiesta.
Formato: Fuso orario UTC e data ISO 8601
type string Tipo di richiesta.
Valori possibili: revoke
status string Stato della richiesta di revoca.
Valori possibili: submitted, pending, approved, rejected
requester object Dettagli sull’utente che ha effettuato la richiesta.
Consulta Strutture — Oggetto dettagli utente.
comments string Messaggio sulla richiesta di revoca richiesta.