Configure Public Key
The following API is used for configuring the public key of the device, which will be used for validation of custom jwt token when device requests for an operational certificate for the first time or when rotating/renewing operational certificates before expiry.
####API Request
PUT {BaseURL}/configurations/{deviceId}
####Header
- Accept: application/json
- Content-Type: application/json
- Authorization: Bearer {bearer token}. Include Trimble Identity OAuth bearer token for your application.
####Request Body application/json
| Parameter | Data Type | Description |
|---|---|---|
| groupId* | string | Group Id of the device created in IOT system |
| publicKey* | string | Public Key of the device (new line should be explicitly formatted using \n) |
| connectionContext | string | Optional. Unique context of device connection. When a physical device contains multiple devices, this parameter should be configured uniquely for each device. Please refer (Device Connections)(iot-device-bootstrap-device-connections.md) to for more info |
####Response
Status Code 200: When a device configured is successfully accepted.
####Response Model application/json
| Parameter | Data Type | Description |
|---|---|---|
| deviceId* | string | Device Id of the device |
| groupId* | string | Group Id of the device created in IOT system |
| manufacturer* | string | Manufacturer of the device |
| model* | string | Model of the device |
| serialNumber* | string | Serial number of the device |
| publicKey* | string | Public Key of the device |
| status* | string | Status of the device configuration |
| connectionContext | string | (returned if configured)Unique context of device connection. |
- Status Code 400: When an invalid request for creation is sent.
- Status Code 401: When the calling identity is not authorized to create the device.
For more details, refer to API Documentation.