latestOpenAPI 3.0.12026-08-102423137.1 KB

80dd46738839

Device binding

Verify device binding signature challenge

Verifies the signature from a customer's device in order to verify their ownership of the device. To create the signature: 1. Create a hash (SHA256) with the OTP/activation_code. 2. Sign the hash with the private key. 3. Encode the signature in ASN.1 format. 4. Hex-encode the ASN.1-formatted signature. 5. Send the signature in the request body.

put/v1/mfa/challenges/signatures/{id}

Path parameters

idstring required

Request body

signaturestring

The hex-encoded signature for the challenge.

device_datastring

Any device-specific string provided by the calling client.

Example request

{
  "signature": "3045022100bdbebd8ba5e4ea23a4ab3d852cbf0968cbc7319c7c4388e0c54bf34e896d19d802205880fca38bf5450bff73d41c675e1444b8e3c75dc8bf764d5c0e9282bd150ade",
  "device_data": "YW55IHN0cmluZyBwcm92aWRlZCBieSB0aGUgY2xpZW50Cg=="
}

Response

Challenge successful