{"id":13644045,"url":"https://github.com/nmikhailov/Validity90","last_synced_at":"2025-04-21T06:32:51.427Z","repository":{"id":41128722,"uuid":"79832229","full_name":"nmikhailov/Validity90","owner":"nmikhailov","description":"Reverse engineering of Validity/Synaptics 138a:0090, 138a:0094, 138a:0097, 06cb:0081, 06cb:009a fingerprint readers protocol","archived":false,"fork":false,"pushed_at":"2020-01-16T20:17:32.000Z","size":1380,"stargazers_count":1852,"open_issues_count":72,"forks_count":113,"subscribers_count":245,"default_branch":"master","last_synced_at":"2025-04-02T06:36:21.393Z","etag":null,"topics":["fingerprint-authentication","fingerprint-scanner","fingerprint-sensor","libfprint","linux","reverse-engineering"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-2.1","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nmikhailov.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-01-23T18:06:49.000Z","updated_at":"2025-03-31T07:56:21.000Z","dependencies_parsed_at":"2022-07-14T08:31:11.809Z","dependency_job_id":null,"html_url":"https://github.com/nmikhailov/Validity90","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nmikhailov%2FValidity90","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nmikhailov%2FValidity90/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nmikhailov%2FValidity90/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nmikhailov%2FValidity90/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nmikhailov","download_url":"https://codeload.github.com/nmikhailov/Validity90/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250008277,"owners_count":21359957,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["fingerprint-authentication","fingerprint-scanner","fingerprint-sensor","libfprint","linux","reverse-engineering"],"created_at":"2024-08-02T01:01:56.829Z","updated_at":"2025-04-21T06:32:46.405Z","avatar_url":"https://github.com/nmikhailov.png","language":"C","funding_links":["https://www.paypal.me/nmikhailov/0usd"],"categories":["C"],"sub_categories":[],"readme":"# Validity90\n\nThis 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.\n\n## Discussions\n\nMain chat of this project: [![Gitter](https://img.shields.io/gitter/room/nwjs/nw.js.svg)](https://gitter.im/Validity90/Lobby?utm_source=share-link\u0026utm_medium=link\u0026utm_campaign=share-link)\n\nlibfrprint issue: [https://gitlab.freedesktop.org/libfprint/libfprint/issues/54](https://gitlab.freedesktop.org/libfprint/libfprint/issues/54)\n\nLenovo 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)\n\n## Notable files\n\n1. [spec.md](spec.md) - Specification draft, the main work goes here right now.\n2. [dissector.lua](dissector.lua) - Wireshark dissector for decrypting communication after key exchange.\n3. ~[libfprint directory](libfprint) - libfprint repo with this driver integrated~ Not ready at the moment.\n4. [prototype](prototype) - Standalone prototype(extremly ugly code, would be completly rewritten for driver)\n\n## Testing\n\n[Prototype](prototype) testers are needed, please share your result and join us in our [Gitter](https://gitter.im/Validity90/Lobby?utm_source=share-link\u0026utm_medium=link\u0026utm_campaign=share-link).\n\n## Status\n\n|   Device  | Status |\n|-----------|--------|\n| 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. |\n| 138a:0097 | Scan, Internal DB check works in prototype |\n| 138a:0094 | Doesn't work yet, but looks promising. I will try to work on it after 90/97 |\n| 06cb:0081 | So far looks identical to 138a:0094 |\n| 06cb:009a | Init works, leds work, scan doesn't work yet |\n| 138a:0091 | Different protocol, out of scope for this project. Check out [Validity91](https://github.com/hmaarrfk/Validity91) which aims to reverse engineer it.|\n\n\n| \t\t      Task       \t\t\t| Specification/Analysis  | Prototype   | Driver \t    |\n|---------------------------|-------------------------|-------------|-------------|\n| Initialization  \t\t      | Done \t\t\t\t\t          | Done\t \t    | Not Started |\n| Configuration/Reconfig    | In progress \t          | In progress | Not Started |\n| Pre TLS key exchange \t    | In progress \t\t\t\t    | Done        | Not Started |\n| TLS \t\t\t                | Done \t\t\t\t\t\t        | Done  \t    | Not Started |\n| 90: Ops: scan, LED, etc| In progress  \t\t\t      | Scan, LED works  | Not Started |\n| 97: Ops: enroll, check, reset, LED, etc| In progress  \t\t\t      | Check works  | Not Started |\n| Image format  \t\t        | In progress  \t\t\t      | Done        | Not Started |\n\n## Donations\n\nPlease consider donating to support the development.  \nWith paypal: [![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://www.paypal.me/nmikhailov/0usd)  \nWith BTC: 1AsoCUGNVniBSBS359u2wKrA2CZiTgKZkM  \nWith ETH: 0x005D8d9b5609b9A3Ec8B3cBd463a949405A8d621  \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnmikhailov%2FValidity90","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnmikhailov%2FValidity90","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnmikhailov%2FValidity90/lists"}