Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nmikhailov/Validity90
Reverse engineering of Validity/Synaptics 138a:0090, 138a:0094, 138a:0097, 06cb:0081, 06cb:009a fingerprint readers protocol
https://github.com/nmikhailov/Validity90
fingerprint-authentication fingerprint-scanner fingerprint-sensor libfprint linux reverse-engineering
Last synced: about 21 hours ago
JSON representation
Reverse engineering of Validity/Synaptics 138a:0090, 138a:0094, 138a:0097, 06cb:0081, 06cb:009a fingerprint readers protocol
- Host: GitHub
- URL: https://github.com/nmikhailov/Validity90
- Owner: nmikhailov
- License: lgpl-2.1
- Created: 2017-01-23T18:06:49.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2020-01-16T20:17:32.000Z (almost 5 years ago)
- Last Synced: 2024-11-03T05:30:20.583Z (7 days ago)
- Topics: fingerprint-authentication, fingerprint-scanner, fingerprint-sensor, libfprint, linux, reverse-engineering
- Language: C
- Homepage:
- Size: 1.32 MB
- Stars: 1,851
- Watchers: 248
- Forks: 113
- Open Issues: 72
-
Metadata Files:
- Readme: README.md
- License: COPYING
Awesome Lists containing this project
README
# Validity90
This project aims on reverse engineering protocol of Validity 138a:0090, 138a:0094, 138a:0097, 06cb:0081, 06cb:009a fingerprint readers, creating specification and FLOSS libfprint driver.
## Discussions
Main chat of this project: [](https://gitter.im/Validity90/Lobby?utm_source=share-link&utm_medium=link&utm_campaign=share-link)
libfrprint issue: [https://gitlab.freedesktop.org/libfprint/libfprint/issues/54](https://gitlab.freedesktop.org/libfprint/libfprint/issues/54)
Lenovo forums: [https://forums.lenovo.com/t5/Linux-Discussion/Validity-Fingerprint-Reader-Linux/td-p/3352145](https://forums.lenovo.com/t5/Linux-Discussion/Validity-Fingerprint-Reader-Linux/td-p/3352145)
## Notable files
1. [spec.md](spec.md) - Specification draft, the main work goes here right now.
2. [dissector.lua](dissector.lua) - Wireshark dissector for decrypting communication after key exchange.
3. ~[libfprint directory](libfprint) - libfprint repo with this driver integrated~ Not ready at the moment.
4. [prototype](prototype) - Standalone prototype(extremly ugly code, would be completly rewritten for driver)
## Testing
[Prototype](prototype) testers are needed, please share your result and join us in our [Gitter](https://gitter.im/Validity90/Lobby?utm_source=share-link&utm_medium=link&utm_campaign=share-link).
## Status
| Device | Status |
|-----------|--------|
| 138a:0090 | Scan, Image output, Internal DB check works in prototype. There is also a match-on-host [libfprint driver](https://github.com/3v1n0/libfprint) by @3v1n0 based on prototype source(138a:0090 only). You can use it untill proper unified driver is available. |
| 138a:0097 | Scan, Internal DB check works in prototype |
| 138a:0094 | Doesn't work yet, but looks promising. I will try to work on it after 90/97 |
| 06cb:0081 | So far looks identical to 138a:0094 |
| 06cb:009a | Init works, leds work, scan doesn't work yet |
| 138a:0091 | Different protocol, out of scope for this project. Check out [Validity91](https://github.com/hmaarrfk/Validity91) which aims to reverse engineer it.|
| Task | Specification/Analysis | Prototype | Driver |
|---------------------------|-------------------------|-------------|-------------|
| Initialization | Done | Done | Not Started |
| Configuration/Reconfig | In progress | In progress | Not Started |
| Pre TLS key exchange | In progress | Done | Not Started |
| TLS | Done | Done | Not Started |
| 90: Ops: scan, LED, etc| In progress | Scan, LED works | Not Started |
| 97: Ops: enroll, check, reset, LED, etc| In progress | Check works | Not Started |
| Image format | In progress | Done | Not Started |
## Donations
Please consider donating to support the development.
With paypal: [](https://www.paypal.me/nmikhailov/0usd)
With BTC: 1AsoCUGNVniBSBS359u2wKrA2CZiTgKZkM
With ETH: 0x005D8d9b5609b9A3Ec8B3cBd463a949405A8d621