Get a public key

This key management operation allows retrieving the public key of an asymmetric key stored inside the device's secure repository.

Allowed users

User

Allowed

Master

Not allowed

ExtAuth

Allowed

Required access scope

Main

keymgmt:get

Alternative

keymgmt:use:<KID>

where <KID> is a Key ID as 32 chars hexadecimal string

Get a public key

GET https://my.ence.do/api/keymgmt/get/:kid

Get a public key from asymmetric key only

Query Parameters

Name	Type	Description
kid*	String	Key ID, 32 chars hex string

Headers

Name	Type	Description
Authorization*	String	Bearer JWT_TOKEN

200: OK Operation sucessful

{
  "type": "CURVE25519",
  "pubkey": "IYBby9t5R6aiQ13CE0RJ7Z0jIMOIXGLN+U9Tebo3/CU=",
  "updated": 1647787070
}

400: Bad Request Incorrect argument(s)

401: Unauthorized Missing or invalid JWT_TOKEN

403: Forbidden Incorrect access scope

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

409: Conflict Incorrect internal state

406: Not Acceptable Operation failed

Response data for successful operation

Name	Type	Description
pubkey	String	Base64 encoded public key
type	String	Type of a key
updated	String	Last update timestamp

Log entries

Event	Result	Source
LOG_TYPE_FAILED_SCOPE_CHECK	LOG_RESULT_FAILED	403