How HandyPeer keeps sessions private

What our server does and doesn't do

Our server gives every device an ID and introduces two devices to each other. It tells each side the other's network addresses and then steps out. Normally the session (screen, input, sound, files) never passes through it.

There is one exception. When a direct connection can't be made and one side has a Pro or Team plan, the session runs through our relay server. The relay only forwards packets that are already encrypted. The keys exist only on the two devices. The relay can't see the screen, input, sound, files or the unattended-access password. We don't record or store relayed traffic. The viewer's top bar shows a Relayed badge during such a session.

The connection

  1. Both computers send small UDP packets to each other's addresses. This opens a path through home routers (NAT hole punching).
  2. The path carries a QUIC connection, which handles congestion and lost packets.
  3. Inside it, both sides exchange fresh X25519 keys for this session, each signed with the device's own Ed25519 key. Each side checks the signature against the key the server announced for that ID.
  4. When an unattended-access password is used, a SPAKE2 exchange mixes it into the session key. The password never crosses the network. A wrong one can't build a working channel.
  5. Every message is encrypted with ChaCha20-Poly1305.

Stopping impostors

  • Device keys are remembered. After the first accepted session, each side stores the other's key. If the same ID comes back with a different key, the connection is refused. That catches anyone, including someone posing as our server, who tries to sit in the middle.
  • Fingerprints. The connection request shows a short key fingerprint you can compare over the phone.
  • Names are labeled. A device's name is what it says about itself. The request says so.

Stopping abuse

  • Every connection asks for approval unless an unattended-access password is set.
  • Rejected and unanswered requests are slowed down. Wrong passwords lock a device out for longer each time. Many wrong passwords switch password access off for everyone for 10 minutes.
  • Files: a computer only accepts downloads it asked for, at most 8 transfers run at a time and an existing file is never overwritten.

Signed apps

The Windows installer is signed by HandyCafe, LLC. The macOS app is signed with an Apple Developer ID and notarized by Apple.

We don't claim HandyPeer is more secure than tools that use relays. TeamViewer and AnyDesk also encrypt their relayed sessions end to end. The difference is that a HandyPeer session normally has nothing in the middle at all. Our relay carries a session only when a direct connection can't be made on a Pro or Team plan.