Documentation 9.0

# Cryptographs Storage

Group of methods to access to enrolled cryptographs, to manage cryptograph`s blocked status and to get list of blocked cryptographs.

# Get Cryptograph information

GET /v1/cryptograph?uuid=<cryptograph uuid>
1

The method returns the cryptograph`s image, expiration date, if applicable, and its blocked status.

The result sample:

{
  "uuid": "UUID FROM QUERY STRING",
  "image": "BASE64",
  "expirationDate": "DATE TIME (ISO 8601) or null",
  "blocked": true or false
}
1
2
3
4
5
6

# Block/unblock a cryptograph

Method to block a cryptograph by uuid

PUT /v1/cryptograph/block?uuid=<cryptograph uuid>
1

Method to unblock a cryptograph by uuid

PUT /v1/cryptograph/unblock?uuid=<cryptograph uuid>
1

# List of blocked cryptographs

Method to get list of blocked cryptographs

GET /v1/cryptograph/blocked/list
1

Method returns:

  • file with blocked cryptographs (in body of the response). See List of blocked cryptographs file format
  • SHA256 hash of the file (in ETag response header)
  • signature of the hash (in Signature response header)
  • date and time when the file was modified last time (in Last-Modified response header)

Method to get information about list of blocked cryptographs

HEAD /v1/cryptograph/blocked/list
1

Unlike GET /v1/cryptograph/blocked/list the method doesn't return a file, but provide information about hash of the file, sinature of the hash and the last modification time.
It allows to determinate when cached list of blocked cryptographs shoud be upgraded.

Method to get X.509 certificate to verify signature of the list hash

GET /v1/cryptograph/blocked/cert
1

WARNING

IDencode just provides list of blocked cryptographs, but does nothing with blocked cryptographs.
IDencode users should decide itself what to do with blocked cryptographs.