endpoint_revoke.txt 960 B

123456789101112131415161718192021222324252627
  1. THE REVOKE ENDPOINT
  2. Endpoint: /api/v1/cfssl/revoke
  3. Method: POST
  4. Required parameters:
  5. * serial: a string specifying the serial number of a certificate in decimal format
  6. * authority_key_id: a string specifying the authority key identifier
  7. of the certificate to be revoked; this is used to distinguish
  8. which private key was used to sign the certificate. Should be formatted without colons and all lowercase.
  9. * reason: a string identifying why the certificate was revoked; see,
  10. for example, ReasonStringToCode in the ocsp package or section
  11. 4.2.1.13 of RFC 5280. The "reasons" used here are the ReasonFlag
  12. names in said RFC.
  13. Result:
  14. The returned result is an empty JSON object
  15. Example:
  16. $ curl -d '{"serial": "7961067322630364137", \
  17. "authority_key_id": "a0b1c2d3e4f5", \
  18. "reason": "superseded"}' \
  19. ${CFSSL_HOST}/api/v1/cfssl/revoke