Devices

In the console: Agent Authority › Devices

This screen is in the user portal, so it shows what you see when you sign in as a user, not as an admin. It lists the machines where you installed the device sensor, which release each runs, and when each last synced. It shows only your own devices, even when your role grants org-wide access to devices.

Device listCopy Anchor Link

The Sensor column shows one of these update statuses, with details when you hover over it:

• Update pending – a new release was offered and installs on the next sync.
• No sync since offer – a new release was offered, but the device hasn't synced in over 24 hours since.
• Update failed – the new release failed to download, verify, install, or pass its self-test. The device stays on its current release and retries.
• Rolled back – the new release installed but never started capturing, so the previous release was restored.
• Reinstall to update – self-update isn't supported on this platform. Reinstall the sensor to update it.

Search with Search your devices… and filter by OS. Sort by Device, OS or Last seen; the list starts with the most recently seen.

With no devices, the screen shows You haven’t enrolled a device yet.

ActionsCopy Anchor Link

• Enroll this machine – opens a dialog that generates an installer for the computer you're using. It detects your platform from the browser, and you can change it under Platform. Download installer downloads the file and shows the command to run it. The installer is the only copy, can't be shown again, and stops working after the expiry time the dialog shows.
• Enroll device – replaces Enroll this machine when your role can enroll devices for anyone. You also choose an Owner, and Generate installer creates the file to send them.
• Copy device ID and Copy client ID – in each row's actions menu.
• Revoke – in each row's actions menu. The device loses access at once, after you confirm, and needs a new installer to enroll again.

PermissionsCopy Anchor Link

The Devices menu item needs view_devices and the device_sensor feature flag.

• Enroll this machine – enroll_devices for your own devices, and the device_self_enrollment feature flag.
• Enroll device – enroll_devices for all users.
• Revoke – manage_devices.

RelatedCopy Anchor Link

• Endpoint Controls overview – what the device sensor captures
• Install Endpoint Control – install and enroll a sensor