Device Tokens

Team

Enterprise

Device tokens authenticate the Foxglove Agent to the rest of the system.

There are two different methods to manage device tokens:

Create the device first

In this method you create a device first, then create a device token corresponding to that device. The device token is locked to that particular device and can be used immediately.

To use this method, as an admin user:

1. Go to the Devices page
2. Create a new device or select an existing device
3. Select the "Agent" tab
4. Select "Create new token" to generate a secret token
5. Save the token, which will be used during the installation of the Foxglove Agent

tip

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

Create the token first

In this method you create a device token in the Device Token Settings page, and don't associate a device with it. The first time the device token is used by the Foxglove Agent, it will create that device and the device token will be locked to that device. To prevent unintended behavior, this method can only be used when the device does not yet exist. If you have an existing device you want to create a device token for, use the other method.

To use this method, as an admin user:

1. Go to the Device Tokens settings page
2. Select "Create device token" to create a new 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

When creating device tokens using this method, they can be created preapproved or not. If the device token is preapproved, then when the Foxglove Agent starts up the first time and creates the device, the device is immediately able to be used. If the device token is not preapproved, then an administrator needs to "Enable" the device on the Devices page before the Foxglove Agent is allowed to perform further actions.

tip

Admins can also create device tokens via the API. Generate an API key with the deviceTokens.create capabilities 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.