Révoquer le certificat

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

Toutes les demandes de révocation doivent être approuvées par un administrateur avant que DigiCert puisse révoquer le certificat. Cette étape d’approbation est obligatoire est ne peut être ignorée.

Appelez ce point de terminaison pour envoyer une demande de révocation pour un certificat unique associé à une commande.

Si vous souhaitez envoyer une demande de révocation de l'ensemble de la commande, appelez le point de terminaison Revoke order certificates(Révoquer les certificats associés à la commande).

Il est impossible de révoquer des certificats dont la commande de réémission est en attente. Pour révoquer un certificat dont la commande est en attente, vous devez soit annuler la réémission soit révoquer le certificat après sa réémission.

Que se passe-t-il si je révoque un certificat associé à une commande ne comportant qu'un seul certificat ?

Lorsque vous révoquez un certificat associé à une commande ne comportant qu'un seul certificat :

  • La commande reste active
  • Vous pouvez toujours réémettre un certificat sur cette commande
  • Aucun remboursement n'est prévu pour un certificat révoqué sur une commande

Si vous ne prévoyez pas de réémettre un certificat pour cette commande, appelez le point de terminaison Revoke order certificates (Révoquer les certificats associés à la commande) afin d'envoyer une demande de révocation de la commande.

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."
}

Paramètres de demande

Nom Obligatoire/facultatif Type Description
comments Facultatif string Message concernant la demande de révocation

Paramètres de réponse

Nom Type Description
id int ID de la demande
date string Horodatage d’envoi de la demande
Format : Fuseau horaire UTC et date ISO 8601
type string Type de demande
Valeurs possibles : revoke
status string Statut de la demande de révocation
Valeurs possibles : submitted, pending, approved, rejected
requester object Détails relatifs à l’utilisateur qui effectué la demande
Consultez la page Structures — Objet Détails de l’utilisateur.
comments string Message concernant la demande de révocation