In this section · 11 articles

Review and revoke trusted devices

See every device your users have trusted, and force-revoke one so its owner has to verify it again with two-factor authentication.

Applies to
Core 12.0 and later
Who can do this
Platform owner
Permission
feature.core.trusted_device.force_revoke
Where
Configurations › Security › Trusted Devices Audit
On this page

Before you start

  • You need feature.core.trusted_device.list to open the screen and feature.core.trusted_device.force_revoke to revoke a device. Exporting needs feature.core.trusted_device.export. These permissions aren't part of the standard Administrator role, so by default only super admins have them.
  • Devices appear only once Enable trusted devices is on in Security settings. People then see Trust this device when they sign in. A person who uses two-factor authentication isn't asked for a code again on a trusted device.

What the list shows

Each row is one trusted device, for any user. The columns are User, Device, Browser, Platform, IP Address, Last Used and Status. Email and Expires are hidden by default. You can show them from the table's column settings. First Used appears when you view a device. Search finds a device by user, email, device name, browser, platform or IP address.

Status is one of:

StatusMeaning
ActiveThe device is trusted.
ExpiredIts trust period has ended.
RevokedThe user or an administrator revoked it.

You can filter by Browser, Platform and Status. A revoked device stays in the list as part of the audit trail. It's never deleted.

Steps

  1. In the sidebar, open Configurations › Security › Trusted Devices Audit.

  2. Find the device. Search for the user or the IP address, or filter by Status.

  3. Open the row's actions menu.

  4. Select Revoke.

  5. Confirm. The message reads: Force-revoke the selected device(s)? Each user will need to re-verify on their next sign-in.

To revoke several devices at once, select their rows, then choose Revoke in the bar that appears above the table.

To see one device in full, select View from its actions menu. To download the list, choose Export CSV from the table's menu.

What happens next

The device's Status changes to Revoked. The next time its owner signs in on that device, they go through two-factor verification again, and they can choose to trust the device again.