Skip to Content

Linked Devices

  • Code: ACC-DEV
  • Module: Account
  • Type: System Record

1. Overview

Linked Devices shows all devices currently logged in to the user’s account, along with their approximate location and last activity time. The device in use is marked as This Device. Users can revoke a single device or all devices at once to immediately log out that device.

Expected outcome: users can recognize unfamiliar logins and log them out right away.

2. Problem

Without a list of devices that are logged in, users do not know which devices are accessing their account. As a result:

  • Users often log in on shared devices, such as a cashier computer or a colleague’s phone, and forget to log out.
  • Logins from unfamiliar locations go undetected.
  • When a device is lost, users have no way to log it out remotely.

3. Goals & Non-goals

3.1 Goals

  • Users know which devices are logged in to their account.
  • A login left on a shared device can be ended remotely.
  • An unfamiliar login can be recognized from its location and last activity time.
  • All logins can be revoked at once when a device is lost.

3.2 Non-goals

  • Admins revoking other users’ logins.
  • Automatic notification when a new login happens.
  • Naming devices manually.

4. Business Rules

Business rules are the set of provisions and constraints that apply to Linked Devices across the whole application, on every screen and action involved, whoever performs them. These rules are the single source of truth: if another part of this PRD seems to differ, the rule here applies.

  • BR-01 One device represents one login of the user, and users only see their own devices.
  • BR-02 The device in use is marked This Device and is always shown first. Other devices are sorted from the most recent last activity.
  • BR-03 Location and coordinates come from the IP address, so they are only approximate. Last Activity is updated at most once per minute for each device.
  • BR-04 Users can revoke one other device or all devices at once, and revoking is always confirmed first. The device in use cannot be revoked on its own; the user leaves it through a normal logout.
  • BR-05 Revoking a device immediately ends the login on that device and removes its device notifications. That device must log in again to use the app. Revoking all also logs out the device in use.
  • BR-06 A login that has passed its validity, meaning 7 days without activity (see Authentication), is revoked automatically with the same effect as a manual revoke.
  • BR-07 Search filters the list by device name and only applies to the devices already shown.
  • BR-08 Device logins and device revocations are recorded in the activity log with who did it and when.

5. Flow

5.1 Main Flowchart

  1. Open Linked Devices — The list of devices currently logged in is shown, with This Device first (BR-01, BR-02).
  2. Choose View — The user chooses the Grid or Map view. The choice is remembered in the browser.
  3. Search Devices — The user narrows the list by device name if needed (BR-07).
  4. Choose Action — The user chooses to revoke one device or all devices (BR-04).
  5. Confirm Revoke — The user confirms revoking one device. This Device has no revoke action.
  6. Confirm Revoke All — The user confirms revoking all devices. The user is also logged out of the device in use.
  7. Device Login Ends — That device immediately loses access and must log in again (BR-05).
  8. All Logins End — All devices lose access at once, including this one, then the user is taken to the login page (BR-05).

5.2 Status Lifecycle

StatusDescriptionNext
ActiveThe login is still valid and the device appears in the listRevoked
RevokedThe login has ended, the device disappears from the list and must log in again; logging in again in the same browser reactivates the same device recordActive

6. Document Structure

6.1 General

FieldTypeRequiredDefaultRules
Device NameText—Recognized from the device; if not detected, built from browser and platform, or “Unknown”For example Chrome on macOS. “No Device Name” is shown when the name is empty
This DeviceBoolean—Determined from the login in progressMarks the device in use (BR-02)
Last ActivityDate & Time—Updated by the systemAt most once per minute (BR-03)
Platform, BrowserText—Recognized from the deviceFor example macOS, Chrome
City, CountryText—Derived from the IP addressApproximate only (BR-03)
IP AddressText—Recorded at loginUpdated when the IP address changes
Device TypeEnum—Recognized from the device (smartphone, desktop, tablet), empty if not detectedOnly determines the icon; not shown as text. An empty or other type uses a question mark icon
Location CoordinatesDecimal—Derived from the IP addressLocation point for the map, may be empty (BR-03)
User AgentText—Recognized from the deviceRecorded by the system; not shown in the UI

7. UI Structure

This section defines how Linked Devices is displayed and operated. It only governs presentation and interaction; the rules for content and values still follow Document Structure.

7.1 Grid & Map

Two views, Grid and Map, chosen with a toggle; the choice is stored in the browser. A single search box filters the list by device name (BR-07). Action in the header: Revoke All Devices.

Grid 🚧 Not yet: FE

PartExample ValueComponent
Device Icon—Icon, according to Device Type
Device NameChrome on macOSText
MarkerThis Device or Other DeviceBadge
Last Activity5 minutes agoText
Platform, BrowsermacOS, ChromeText
City, CountryJakarta, IndonesiaText
IP Address103.10.20.1Text
ActionRevokeButton, only on devices other than This Device

Map

PartComponent
MarkerA circle with the Device Type icon, primary color for This Device and muted for others; only devices with Location Coordinates
TooltipDevice Name
PopupSame as the Grid card, with the Revoke action

8. User Stories

US-01 - View linked devices

As a user, I want to see all devices currently logged in to my account, so I know which devices are still signed in.

IDAcceptance criteria
AC-01.1Only the user’s own devices are shown (BR-01).
AC-01.2This Device is shown first and marked; other devices are sorted from the most recent last activity (BR-02).
AC-01.3Each device shows a device type icon, platform, browser, IP, city, country, and last activity; the device type and user agent are not shown as text; empty values show ”-”. 🚧 Not yet: FE
AC-01.4Empty device name — “No Device Name” is shown; undetected device type — a question mark icon is shown.
AC-01.5Search filters the list by device name (BR-07).
AC-01.6A skeleton is shown while data loads.

US-02 - View locations on the map

As a user, I want to see login locations on a map, so suspicious logins are easy to spot.

IDAcceptance criteria
AC-02.1Only devices with location coordinates appear as markers (BR-03).
AC-02.2The map fits all markers; with a single marker, the map centers on it.
AC-02.3Markers have a tooltip and a detail popup with a revoke action for other devices.
AC-02.4A device without coordinates does not appear on the map, but still appears in Grid.
AC-02.5No device has coordinates — the map is shown without markers.
AC-02.6The Grid or Map choice is remembered in the browser.

US-03 - Revoke one device

As a user, I want to log out a specific device.

IDAcceptance criteria
AC-03.1The revoke action is only available for devices other than This Device (BR-04).
AC-03.2Revoking asks for confirmation first (BR-04).
AC-03.3After confirmation, that device’s login ends, a success toast appears, and the list reloads (BR-05).
AC-03.4A device is revoked while in use — its next request is rejected immediately and it is taken to the login page (BR-05).
AC-03.5The revocation is recorded in the activity log (BR-08).

US-04 - Revoke all devices

As a user, I want to log out all devices at once.

IDAcceptance criteria
AC-04.1The Revoke All Devices button is available in the header and asks for confirmation first (BR-04).
AC-04.2The confirmation text states that this device is also logged out.
AC-04.3After success, all logins end including this device, and the user is taken straight to the login page (BR-05).
AC-04.4The revocation is recorded in the activity log (BR-08).

US-05 - Login expires

As a user, I want logins that have not been used for a long time to be revoked automatically, so no login is left behind.

IDAcceptance criteria
AC-05.1A login that passes 7 days without activity is revoked automatically; its device disappears from the list and must log in again (BR-06).

9. User Scenarios

RoleScenario
UserRevokes the login on a shared computer that was left logged in
UserLooks at the map, finds a login from an unfamiliar city, and revokes it
UserLoses their phone and revokes all devices from a laptop
UserAfter changing their password, checks the device list to make sure only their own devices are logged in

10. Permissions & Actions

10.1 Permission by Action

This feature has no permissions; every logged-in user only manages their own devices.

10.2 Action by Device

ActionThis DeviceOther Device
View Details✓✓
Revoke—✓
Included in Revoke All✓✓

11. Notifications

This feature does not trigger any notifications.

12. Dependencies

Related PRDs

  • Authentication — a login from a device not in this list triggers a new-device notification (BR-16 there); logging in creates a device, and a revoked device returns to the login page through the flow there.
  • My Account — changing the password or email logs the user out of all devices.
  • Notifications — device notifications are tied to the device that is logged in and are removed when the device is revoked (BR-05).
  • Activity Logs — records device logins and revocations (BR-08).
Last updated on