Skip to content
Back to search

UnTouchID

Use your phone's Face ID or fingerprint to approve sudo and unlock your Mac. QR pairing, encrypted BLE, Secure Enclave signing — keys never leave your phone. Works with iPhone, Android, Apple Watch, Wear OS, or any browser. No $199 Magic Keyboard needed.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hmakt99--untouchid/badge.svg)](/listings/hmakt99--untouchid)

HTML

<a href="/listings/hmakt99--untouchid"><img src="/api/listings/hmakt99--untouchid/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

<p align="center"> </p>

brew tap HMAKT99/touchbridge
brew install --cask touchbridge

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 101 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # TouchBridge
  2. Use an iPhone's Face ID or Touch ID to approve Mac authentication. The privileged
  3. PAM module verifies the phone's signature; the user daemon transports evidence.
  4. **v2.0.0 is a breaking protocol v2 security release.** Upgrading from 1.x means
  5. rebuilding the iPhone app, re-pairing, and explicitly enrolling verified
  6. public-key fingerprints.
  7. ## Install with Homebrew
  8. ```bash
  9. brew tap HMAKT99/touchbridge
  10. brew trust HMAKT99/touchbridge # Homebrew 7+ only loads trusted third-party taps
  11. brew install --cask touchbridge
  12. ```
  13. ## Build and install from source
  14. Requires macOS 13+, Xcode with iOS SDK, and a physical iPhone for biometric use.
  15. Homebrew installs Mac tools, not the iPhone companion App.
  16. ```bash
  17. cd daemon && swift build -c release --jobs 2
  18. cd .. && make -C pam
  19. sudo bash scripts/install.sh
  20. ```
  21. The installer retires legacy hooks before replacing privileged code, uses
  22. `/Library/Security/TouchBridge`, and leaves PAM disabled until explicit enrollment.
  23. Do not disable SIP or change shared Homebrew directory ownership. Keep an
  24. independent password/admin recovery route during migration; do not authorize
  25. root enrollment using the vulnerable legacy phone-approval path.
  26. ## Pair and activate
  27. Build `companion/TouchBridge.xcodeproj` for a USB-connected iPhone with your own
  28. signing team. Stop the normal daemon while `touchbridge-test pair` owns BLE,
  29. then scan its QR with the App. Verify the Mac and phone fingerprints on the
  30. phone before administrator enrollment. See [setup](docs/setup.md) for commands.
  31. ```bash
  32. sudo bash /Library/Security/TouchBridge/patch-pam.sh
  33. touchbridged serve
  34. ```
  35. PAM independently verifies the complete [canonical evidence](docs/pam-evidence-v2.md)
  36. against root-managed, per-UID trust. There is no automatic user Keychain import.
  37. V1 peers, bare success strings, and unsigned metadata fail closed.
  38. ## Diagnostics and lifecycle
  39. `--simulator`, `--interactive`, and `--web` are diagnostic only; none can approve
  40. real PAM. There is no no-phone sudo demo. Web uses HTTP bearer tokens and must
  41. not be exposed to untrusted networks. Browser diagnostics do not replace OS or
  42. website authentication.
  43. `--auto-lock` tracks verified companions; the last one leaving starts the delay.
  44. Verified reconnect cancels it. The controller checks actual lock state and reports
  45. permission errors or unconfirmed results. Without CGSession, the documented Lock
  46. Screen shortcut may require Automation/Accessibility permissions.
  47. Unpair stops scans/reconnects and pending approvals, clears session state, and
  48. invalidates the signing capability. Failed cleanup leaves approval disabled and
  49. can be retried. Revoke the Mac's root-enrolled key separately as well.
  50. ## Validation and limits
  51. ```bash
  52. make -C pam test
  53. cd protocol && swift test --jobs 2
  54. cd ../daemon && swift test --jobs 2
  55. ```
  56. Tests use isolated sockets/software keys. Physical BLE, Secure Enclave, privileged
  57. migration/password fallback and actual screen locking require native acceptance.
  58. `tests/e2e-validation.sh` now runs only isolated suites. Older release versions
  59. change real daemon/socket/policy/sudo state and must not be used.
  60. V2 targets iPhone/macOS. Android, Watch, browser autofill and Authorization Plugin
  61. are not accepted privileged v2 paths; the plugin fails closed. FileVault preboot,
  62. Apple Pay and hardware-bound Mac Keychain items remain outside scope. Read
  63. [security](SECURITY.md), [architecture](docs/architecture.md) and
  64. [limitations](docs/limitations.md).
  65. ## Uninstall
  66. ```bash
  67. sudo bash /Library/Security/TouchBridge/uninstall.sh
  68. ```
  69. Hooks are removed before modules; unrelated PAM entries and backups are preserved.
  70. ## Contributing
  71. See [CONTRIBUTING.md](CONTRIBUTING.md). Follow [SECURITY.md](SECURITY.md) for private
  72. vulnerability reporting.
  73. ## License
  74. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.