Agent Device Tokens

The Foxglove Agent authenticates with a device token. You can create a device token from the Devices page, or use the auto-provisioning workflow below.

Auto-provisioning

You can create a device token without associating it to a device upfront. The first time the Foxglove Agent starts with this token, it automatically creates the device and locks the token to it. This method can only be used when the device doesn't yet exist. If you have an existing device, create a token for it directly.

To create an unassociated token, as an admin user:

1. Go to the Device Tokens settings page
2. Select "Create device token"
3. Leave the "Device" blank
4. Click "Create"
5. Save the token, which will be used during the installation of the Foxglove Agent

Device preapproval

Auto-provisioned tokens can be created preapproved or not. If preapproved, the device is immediately usable when the Agent first starts. If not preapproved, an administrator must "Enable" the device on the Devices page before the Agent can perform further actions.

tip

Admins can also create device tokens via the API. Generate an API key with the deviceTokens.create capability from the API key settings page and use it to create device tokens.

note

Each Agent installation requires its own unique device and device token. Multi-compute robots sharing a single device aren't supported.

Next install the Agent on your robot.