List the keys

This key management operation allows the listing of the keys from the repository.

Allowed users

User

Allowed

Master

Not allowed

ExtAuth

Allowed

Required access scope

Main

keymgmt:list

List the keys

GET https://my.ence.do/api/keymgmt/list/:offset/:limit

List the keys stored in the repository with pagination.

Headers

Name	Type	Description
Authorization*	String	Bearer JWT_TOKEN

Request Body

Name	Type	Description
offset	Number	Skip offset entries.
limit	Number	(requiredoffsetto be set) Limit the number of return entries, default is 15 if skipped.

200: OK Operation sucessful

{
  "offset": 0,
  "total": 5,
  "listed": 5,
  "list": [{
	"kid": "d4fda14010b3acd0d5482d9881a03fbf",
	"created": 1647381409,
	"type": "ATT,PKEY,GENERIC_DER",
	"label": "TLS PrivateKey",
	"descr": "RE5TOmlwMTEuZW5jZS5kbw==",
	"updated": 1647381409
  }, {
	"kid": "761bbb76b4dcffd9a78df8b992caa0b6",
	"created": 1647381469,
	"type": "CERT,GENERIC_DER",
	"label": "TLS Certificate",
	"descr": "RE5TOmlwMTEuZW5jZS5kbw==",
	"updated": 1647381469
  }, {
	"kid": "8b7eeb47a28bedb068915bf6513815f1",
	"created": 1647804527,
	"type": "ATT,PKEY,ECDH,CURVE25519",
	"label": "Test key 1",
	"updated": 1647804527
  }, {
	"kid": "aad3eabce0b97242fe328fbb2973b17c",
	"created": 1647804552,
	"type": "ATT,PKEY,ECDH,ExDSA,SECP384R1",
	"label": "Signing key",
	"updated": 1647804552
  }, {
	"kid": "4111bc76291bff8d319a056f15bb46f0",
	"created": 1647802803,
	"type": "ATT,PKEY,ECDH,CURVE448",
	"label": "Chris main Transfer key",
	"descr": "RVRTRlRYNTcyMDc0NzI1MjI1NTE3OWNocmlzQGVuY2Vkby5jb20=",
	"updated": 1647802803
  }]
}

400: Bad Request Incorrect argument(s)

401: Unauthorized Missing or invalid JWT_TOKEN

403: Forbidden Incorrect access scope

406: Not Acceptable Operation failed

409: Conflict Incorrect internal state

418: I'm a Teapot TLS (https) connection required

Response data for successful operation

Name	Type	Description
listed	Number	Number of listed keys
list	Array of objects	An array of keys details
offset	Number	Number of skipped keys (offset)
total	Number	Number of keys in repository
created	Number	Creation timestamp
descr	String	Base64 encoded additional description
kid	String	Key ID, 32 chars hex string
label	String	Key label
type	String	Type of a key
updated	Number	Last update timestamp

Log entries

Event	Result	Source
LOG_TYPE_FAILED_SCOPE_CHECK	LOG_RESULT_FAILED	403