Skip to main content

App Devices

App Devices are VPN client device registrations — the smartphones, laptops, and desktops that connect to your network through the SecureLink VPN. Each device is registered with the orchestrator and assigned to an edge for VPN connectivity.

Navigate to Equipment > Devices in the sidebar.

How Devices Are Registered

Devices register with the orchestrator in one of two ways:

  1. VPN Client App — The SecureLinkVPN app automatically registers the device during setup. The app generates a device fingerprint, authenticates via SSO, and receives its VPN configuration.

  2. Manual Registration — Navigate to /app-devices/register to manually register a device. You provide the device name, WireGuard public key, and platform. After registration, a WireGuard configuration file is generated that can be imported into any WireGuard client.

Devices Page

Info Banner

The top of the page shows a banner with your tenant configuration:

  • Tenant Code — Your organization's tenant identifier
  • Protocol — The VPN protocol configured for your tenant (WireGuard or IKEv2)

Stat Cards

CardDescription
Total DevicesTotal number of registered devices
ActiveDevices with active status
ConnectedDevices currently connected to an edge
SuspendedDevices that have been suspended

Table Columns

ColumnDescription
Device NameName and platform icon (color-coded by OS)
PlatformOperating system (iOS, Android, Windows, macOS, Linux)
StatusOnline, Disconnect (suspended), or Offline (inactive)
VPN IPAssigned tunnel IP address, or "Not connected"
ProtocolWireGuard or IKEv2
Connected ToEdge name with activity indicator, or "Not connected"
Data TransferDownload and upload totals
Last SeenMost recent activity timestamp
GroupDevice group assignment (Assigned or Unassigned)

Click any device row to open its detail page.

Actions

  • Invite VPN Users — Send VPN setup invitations to users via email
  • Refresh — Reload the device list

Device Detail

The device detail page shows comprehensive information about a single device.

Status Cards

Four cards at the top show: Status, Platform + OS Version, App Version, and Last Seen.

Device Information

FieldDescription
Device IDUnique identifier
OwnerThe user who registered the device (name and email)
FingerprintUnique device fingerprint
Device GroupCurrent group assignment with a Change link to reassign
Tunnel ProtocolWireGuard or IKEv2
Tenant CodeOrganization identifier
Created / UpdatedRegistration and modification timestamps

Routing Policies

Displays globally-enabled routing policies that apply to this device. If the device is assigned to a device group, group-level routing policies are also shown.

Active Connection

When the device is currently connected, this section shows:

  • VPN IP Address — Assigned tunnel IP
  • Connected Edge — Which edge the device is connected to
  • Allowed IPs — Subnets accessible through the tunnel
  • Connected Since — Connection start time
  • Downloaded / Uploaded — Data transfer counters
  • Last Handshake — Most recent WireGuard handshake time

VPN Peers

Lists all peer entries for this device. A device may have peers on multiple edges if it has been reassigned.

ColumnDescription
Peer IDPeer identifier
EdgeThe edge this peer is configured on
VPN IPAssigned IP for this peer
StatusOnline or Offline
Connected / DisconnectedConnection state timestamps
Data TransferPer-peer transfer counters

Connection History

A chronological log of connection and disconnection events:

ColumnDescription
EventConnected (green) or Disconnected (red)
TimeWhen the event occurred
VPN IPIP address used during the connection
EndpointSource IP and port of the client
Data TransferBytes transferred during the session
ReasonDisconnect reason (if applicable)

Actions

  • Edit — Update the device name
  • Change Group — Assign or reassign the device to a device group
  • Delete Device — Permanently remove the device and all its VPN peers
warning

Deleting a device removes all its connection peers. The device will need to re-register to reconnect.

Manual Device Registration

Navigate to Devices > Register or click the registration link. The registration form requires:

FieldRequiredDescription
Device NameYesA friendly name for the device
WireGuard Public KeyYes44-character base64 public key (generate with wg genkey | tee privatekey | wg pubkey > publickey)
PlatformYesiOS, Android, Windows, macOS, or Linux
OS VersionNoOperating system version
App VersionNoVPN client version

After registration, you receive a WireGuard configuration file containing the [Interface] and [Peer] sections. Import this into your WireGuard client to connect.

info

The private key is not stored by the server. You must add your private key to the generated configuration file before importing it.