Retrieve device configuration

Overview

Retrieve the complete configuration for a registered device, including credentials and connection details.

Retrieve Device Configuration

Endpoint: GET /device/retrieve-device-configuration/{deviceIdentifier}

Authentication: Required (Authorization token obtained from the step)

Path Parameters

Parameter	Type	Required	Description
`deviceIdentifier`	string	Yes	The unique device identifier

Response Fields

Field	Description
`device-identifier`	Unique device identifier
`client-id`	OAuth client ID for device authentication
`client-secret`	OAuth client secret for device authentication
`rabbit-user`	RabbitMQ username for message queue access
`rabbit-pass`	RabbitMQ password for message queue access
`rabbit-host`	RabbitMQ server host address
`rabbit-port`	RabbitMQ server port number

Use Case

Use this endpoint to retrieve all configuration details necessary for a device to connect and communicate with Privicore. The response includes:

OAuth Credentials: Client ID and secret for device authentication

Message Queue Configuration: RabbitMQ connection details for receiving encrypted data (Storage devices) and ballots (Authenticator devices)

Storage devices use the RabbitMQ configuration to listen for incoming encrypted data when data tokens are exchanged. Authenticator devices use it to receive ballots for voting workflows.

Store all credentials securely on the device
Client secret and RabbitMQ credentials are sensitive - treat as passwords
RabbitMQ connection enables real-time communication between Privicore and devices
Configuration is required for device to become operational

Responses

🟢200Success

application/json

Body

Example

{
    "device-identifier": "example_device_identifier",
    "client-id": "example_client_id",
    "client-secret": "example_client_secret",
    "rabbit-user": "rabbit_username",
    "rabbit-pass": "rabbit_password",
    "rabbit-host": "rabbit_host",
    "rabbit-port": "rabbit_port"
}

🟠403403

🟠404404

Retrieve device configuration

Overview