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
- Open Linked Devices — The list of devices currently logged in is shown, with This Device first (BR-01, BR-02).
- Choose View — The user chooses the Grid or Map view. The choice is remembered in the browser.
- Search Devices — The user narrows the list by device name if needed (BR-07).
- Choose Action — The user chooses to revoke one device or all devices (BR-04).
- Confirm Revoke — The user confirms revoking one device. This Device has no revoke action.
- Confirm Revoke All — The user confirms revoking all devices. The user is also logged out of the device in use.
- Device Login Ends — That device immediately loses access and must log in again (BR-05).
- 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
| Status | Description | Next |
|---|---|---|
| Active | The login is still valid and the device appears in the list | Revoked |
| Revoked | The 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 record | Active |
6. Document Structure
6.1 General
| Field | Type | Required | Default | Rules |
|---|---|---|---|---|
| Device Name | Text | — | 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 Device | Boolean | — | Determined from the login in progress | Marks the device in use (BR-02) |
| Last Activity | Date & Time | — | Updated by the system | At most once per minute (BR-03) |
| Platform, Browser | Text | — | Recognized from the device | For example macOS, Chrome |
| City, Country | Text | — | Derived from the IP address | Approximate only (BR-03) |
| IP Address | Text | — | Recorded at login | Updated when the IP address changes |
| Device Type | Enum | — | Recognized from the device (smartphone, desktop, tablet), empty if not detected | Only determines the icon; not shown as text. An empty or other type uses a question mark icon |
| Location Coordinates | Decimal | — | Derived from the IP address | Location point for the map, may be empty (BR-03) |
| User Agent | Text | — | Recognized from the device | Recorded 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
| Part | Example Value | Component |
|---|---|---|
| Device Icon | — | Icon, according to Device Type |
| Device Name | Chrome on macOS | Text |
| Marker | This Device or Other Device | Badge |
| Last Activity | 5 minutes ago | Text |
| Platform, Browser | macOS, Chrome | Text |
| City, Country | Jakarta, Indonesia | Text |
| IP Address | 103.10.20.1 | Text |
| Action | Revoke | Button, only on devices other than This Device |
Map
| Part | Component |
|---|---|
| Marker | A circle with the Device Type icon, primary color for This Device and muted for others; only devices with Location Coordinates |
| Tooltip | Device Name |
| Popup | Same 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.
| ID | Acceptance criteria |
|---|---|
| AC-01.1 | Only the user’s own devices are shown (BR-01). |
| AC-01.2 | This Device is shown first and marked; other devices are sorted from the most recent last activity (BR-02). |
| AC-01.3 | Each 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.4 | Empty device name — “No Device Name” is shown; undetected device type — a question mark icon is shown. |
| AC-01.5 | Search filters the list by device name (BR-07). |
| AC-01.6 | A 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.
| ID | Acceptance criteria |
|---|---|
| AC-02.1 | Only devices with location coordinates appear as markers (BR-03). |
| AC-02.2 | The map fits all markers; with a single marker, the map centers on it. |
| AC-02.3 | Markers have a tooltip and a detail popup with a revoke action for other devices. |
| AC-02.4 | A device without coordinates does not appear on the map, but still appears in Grid. |
| AC-02.5 | No device has coordinates — the map is shown without markers. |
| AC-02.6 | The 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.
| ID | Acceptance criteria |
|---|---|
| AC-03.1 | The revoke action is only available for devices other than This Device (BR-04). |
| AC-03.2 | Revoking asks for confirmation first (BR-04). |
| AC-03.3 | After confirmation, that device’s login ends, a success toast appears, and the list reloads (BR-05). |
| AC-03.4 | A device is revoked while in use — its next request is rejected immediately and it is taken to the login page (BR-05). |
| AC-03.5 | The 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.
| ID | Acceptance criteria |
|---|---|
| AC-04.1 | The Revoke All Devices button is available in the header and asks for confirmation first (BR-04). |
| AC-04.2 | The confirmation text states that this device is also logged out. |
| AC-04.3 | After success, all logins end including this device, and the user is taken straight to the login page (BR-05). |
| AC-04.4 | The 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.
| ID | Acceptance criteria |
|---|---|
| AC-05.1 | A 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
| Role | Scenario |
|---|---|
| User | Revokes the login on a shared computer that was left logged in |
| User | Looks at the map, finds a login from an unfamiliar city, and revokes it |
| User | Loses their phone and revokes all devices from a laptop |
| User | After 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
| Action | This Device | Other 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).