Device API

The device API is used for updating device information registered with our IoT identity provider.

Update Public Key Endpoint

Use this endpoint to update the public key of a registered device. To ensure that only a genuine device can update its public key, the device has to authenticate by providing a private key JWT. Furthermore the device has to provide a proof of possession (PoP) object to demonstrate possession of the private key corresponding to the public key it tries to update.

For additional details about the JWT and the PoP object visit our developer guide.

Refresh public key

POST https://iot-idp.demo.apps.iothentix.io/device/update/pubkey

Headers

Name	Type	Description
Authorization*	String	Private key JWT containing the new public key.

Request Body

Name	Type	Description
pop*	String	Proof of Possession object

200: OK Successful update of the registered public key.

{
    "Success": "Public key updated"
}

400: Bad Request The request format was incorrect.

{
    // TODO
}

401: Unauthorized The private key JWT was missing or invalid.

{
    "error": {
        "code": 401,
        "status": "Unauthorized",
        "request": "<REQUEST_ID>",
        "message": "The request could not be authorized"
    }
}

500: Internal Server Error Internal error in the IdP infrastructure.

{
    "error": 
    {
        "code": 500,
        "status": "Internal Server Error",
        "request": "<REQUEST_ID>",
        "message": "An internal server error occurred, please contact the system administrator"
    }
}

404: Not Found The resource could not be found or the wrong HTTP method was used.

{
    "error": {
        "code": 404,
        "status": "Not Found",
        "request": "<REQUEST_ID>",
        "message": "The requested resource could not be found"
    }
}

403: Forbidden The device is not allowed to update its public key.

{
    "error": {
        "code": 403,
        "status": "Forbbiden",
        "request": "<REQUEST_ID>",
        "message": "Forbidden"
    }
}