Revocar certificado

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

Un administrador debe aprobar todas las solicitudes de revocación antes de que DigiCert revoque el certificado. Este paso de aprobación es obligatorio y no puede omitirse.

Use este terminal a fin de enviar una solicitud para revocar un solo certificado del pedido.

Si desea enviar una solicitud para revocar todo el pedido, use el terminal Revocar certificados pedidos.

Los certificados que tienen una reemisión pendiente no pueden revocarse. Para revocar un certificado con una reemisión pendiente, cancele la solicitud de reemisión o revoque el certificado después de que se complete la reemisión.

¿Qué sucede si revoco un certificado en un pedido con un solo certificado?

Si revoca un certificado en un pedido con un solo certificado, sucede lo siguiente:

  • El pedido seguirá estando activo
  • Puede volver a emitir el certificado de ese pedido
  • No le daremos un reembolso por un certificado revocado de un pedido

Si no planea volver a emitir el certificado del pedido, use el terminal Revocar certificados pedidos para enviar una solicitud encaminada a revocar el pedido.

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

Parámetros de la solicitud

Nombre Solicitud/opción Tipo Descripción
comments opcional string Mensaje sobre la solicitud de revocación.

Parámetros de la respuesta

Nombre Tipo Descripción
id int Id. de la solicitud.
date string Marca de tiempos de cuando se envió la solicitud.
Formato: Zona horaria UTC y fecha de ISO 8601
type string Tipo de solicitud.
Posibles valores: revoke
status string Estado de la solicitud de revocación.
Posibles valores: submitted, pending, approved, rejected
requester object Detalles sobre el usuario que hizo la solicitud.
Vea Estructuras: objeto de detalles del usuario
comments string Mensaje sobre la solicitud de revocación.