Service: Device Credentials

This API is not yet officially released nor maintained.

Set device credentials for the secure TLS connection of the Qb2 device.

Table 1. Available methods
Method Request Response

Set

DeviceCredentialsSetRequest

google.protobuf.Empty

GetCertificates

google.protobuf.Empty

DeviceCredentialsGetCertificatesResponse

Clear

google.protobuf.Empty

google.protobuf.Empty

Set

Set device credentials.

This will override the factory SSL certificate which is provided by the device. It will cause problems with inter-device communication, authentication, and Blickfeld client libraries. Blickfeld client libraries expect a root certificate which is signed by the Blickfeld device root authority. The expected root certificate must then be manually provided via configuration options in the client libraries.

Request

Request with device credentials

Table 2. Available fields in blickfeld.secure.services.DeviceCredentialsSetRequest
Field Type Default Unit

device_credentials

config.DeviceCredentials

-

-

Cryptographic device credentials used to establish secured TLS connection between client and Qb2 device.

GetCertificates

Get device credentials certificates.

Response

Response message which delivers public device certificate

Table 3. Available fields in blickfeld.secure.services.DeviceCredentialsGetCertificatesResponse
Field Type Default Unit

certificates

repeated config.Certificate

-

-

Certificate chain which is deployed at Qb2 device and is used during the TLS handshake.

Clear

Clear device credentials. The device credentials will reset to the factory device credentials.