Search a key

This key management operation allows searching the repository for a key based on the key 'descr' field.

Allowed users

User

Allowed

Master

Not allowed

ExtAuth

Allowed

Required access scope

Main

keymgmt:searchIf the configuration option allow_keysearch is true search is possible without the Authorization header under the condition of having minimum first 6 bytes of descr field.

Search for a key(s)

POST https://my.ence.do/api/keymgmt/search

Search the keys stored in the repository by pattern.

Headers

Name	Type	Description
Authorization	String	Bearer JWT_TOKEN
Content-Type*	String	application/json

Request Body

Name	Type	Description
descr*	String	Pattern to search for.
offset	Number	Skip offset entries.
limit	Number	Limit number of return entries, default is 15 if skipped.

200: OK Operation sucessful

{
  "offset": 0,
  "total": 5,
  "listed": 1,
  "list": [{
  	"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

This operation returns the same data as "List the keys". Check for details here.

Log entries

Event	Result	Source
LOG_TYPE_FAILED_SCOPE_CHECK	LOG_RESULT_FAILED	403