latestOpenAPI 3.0.12026-08-102423137.1 KB

80dd46738839

Device binding

Retrieve a specific key registered to a bound device

Returns a key associated with a specific device that was previously registered using the device binding process.

get/v1/mfa/devices/{id}/keys/{key_id}

Path parameters

idstring required

ID of the device that the key is associated with.

key_idstring required

ID of the key to retrieve.

Response

OK

key_idstring

ID of the key.

key_purpose'restricted' | 'unrestricted'

The purpose of the key (either restricted or unrestricted).

key_type'ecdsa-p256'

The type of key pair used for verifying the device and for device signing. At this time, only ecdsa-p256 is supported.

used_atstring

The date and time when the key was last used (e.g., for device signing).

Example response

{
  "key_id": "3e1415b8-901d-4c1a-8950-f3a1083c6c3b",
  "key_purpose": "unrestricted",
  "key_type": "ecdsa-p256",
  "used_at": "2022-03-18T14:55:04Z"
}