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)

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.

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

Parametri richiesta

Parametri di risposta

Informazioni