Skip to content

v3.3.0: security fixes, config UI login, safer stop/start

Latest

Choose a tag to compare

@Asimmimx Asimmimx released this 19 Nov 15:56

Security fixes. MicroLink, the project TailTiny was forked from, published a security audit on 2026-11-17 (GHSA-jxrh-hg4w-g4rm), as did wireguard-lwip and two of its forks. Every item was checked against TailTiny; this release fixes the ones that were still open here, including the cookie-reply case that MicroLink #46 tests. Update if you use 3.2.0 or older.

Read this first

  • The config web UI needs a password now (user admin; CONFIG_ML_CONFIG_HTTPD_PASSWORD, or a random one printed in the boot log as Config UI login: ...) and only answers on the device's tailnet address, opened by IP (http://100.x.y.z/). POST and DELETE need Content-Type: application/json. It's off by default; the cellular, failover and rebind examples and basic_connect on the ESP32-S3 turn it on.
  • ml_cellular_init() refuses an APN, SIM PIN or PPP login that could inject AT commands.
  • tailtiny_stop() returns ESP_ERR_TIMEOUT if a task outlives it (the instance then refuses to start), and tailtiny_send() returns ESP_ERR_NOT_SUPPORTED (it sent data outside WireGuard).

Highlights

  • Security: forged WireGuard cookie replies and DISCO pongs can no longer redirect a peer's traffic; a tailnet peer can no longer crash the device by naming a tailnet address as its endpoint; DISCO packets from unknown keys and unsolicited STUN replies are dropped; WireGuard receive-path fixes (short plaintext, inner IPv6, replay window, session wipe after 540 s); X25519 now passes RFC 7748's test vectors; control-plane parsing hardened.
  • Reliability: the 90 s handshake limit works again after a rekey; start after stop brings the tunnel back; UDP close from a callback is safe; network switching no longer stays offline after both links failed once; control reads are bounded in time.
  • Faster relay: DERP sends each packet as one TLS record with Nagle off.
  • Docs: Headscale/Ionscale aren't supported (the docs said they were); new SECURITY.md, NOTICE.md and a CI workflow.

Checked on

ESP32-C3 without PSRAM, against 3.2.0 with the same test firmware: same delivery in three boots (149/150), light sleep 71.4% → 74.6%, 30/30 echoes after idle, rebind and stop/start, the config web UI's 11 access checks. All examples build without warnings on ESP-IDF 5.3.2 for esp32, esp32c3, esp32s3, esp32c6, esp32s2 and esp32c2. Nine host tests, including a port of MicroLink's WireGuard roaming regression test.

Full details: CHANGELOG.md