*** WARNING - RESEARCH BELOW IS ONGOING - READ AT YOUR OWN RISK ***
...just kidding...its actually kinda interesting.
I did want to show the complexity of this database therefore I decided to post this as some readers might find it interesting, however don't take my word on this - I can be wrong. In encourage everyone to do their own testing!
This is where it becomes less clear and more research will need to be done. In the Scaler table at any given moment there are many entries that contain the keyword “fingerprint” for all sorts data. I've listed some of the more interesting keys below.
- com.apple.fingerprintMain.enabled – Binary value – 1 = Enabled, 0 = Not enabled
- com.apple.fingerprint.countimagesForProcessing – This appears to be the number of times that TouchID was used (whether or not it was used to unlock the device).
- com.apple.fingerprint.match.autonomousAttempts & com.apple.fingerprint.match.attempts - Match attempts (Not entirely sure the difference as of yet – I think one may be for unlocks (autonomous) and others for other TouchID functions.)
- com.apple.fingerprint.unlock.touchesTouchIDNotAllowed – How many times a TouchID was attempted but not allowed for some reason, perhaps fingers were the wrong ones or greasy from a hamburger! (c’mon, we’ve all been there)
- com.apple.fingerprint.unlock.bioLockouts – I found this key to be incremented when I attempted to unlock the device with the wrong finger too many times.
- com.apple.fingerprint.unlock.passcodeUnlocksNonMandatory – The user put in the passcode, however they were not required to do so.
Enrolling Fingerprints
- com.apple.fingerprint.enroll.attempts – Fingerprints “enrolled”
- com.apple.fingerprint.enroll.popup.tooLittleMoves – Apparently I didn’t move my finger enough when enrolling.
TouchID Passes – Various keys that I’ve seen that show the specifics of how a TouchID match was passed. Many of these are hard to test to explain.
- com.apple.fingerprint.match.autonomousPassesAfterHomeButton – Incremented when a match was made after the home button was pressed.
- com.apple.fingerprint.match.autonomousPassesAfterPowerButton – Incremented after boot when TouchID was used (after passcode of course).
- com.apple.fingerprint.match.autonomousPassesButtonDown – Incremented after the home button was pressed or “pressed” if you have an solid state button.
- com.apple.fingerprint.match.autonomousPassesButtonLifting
- com.apple.fingerprint.match.autonomousPassesButtonUp
- com.apple.fingerprint.match.autonomousPassesButtonUpWithPressureMitigation
- com.apple.fingerprint.match.autonomousPassesHumid – I assume this one has to do if you are a live body or not.
- com.apple.fingerprint.match.passesButtonDown
- com.apple.fingerprint.match.passesButtonUp
TouchID Fails – On the flip side, if a fingerprint fails – we have many keys with many reasons, many with the same characteristics as above but failed.
- com.apple.fingerprint.match.autonomousFailsBadImageBadBlocks
- com.apple.fingerprint.match.autonomousFailsCancels
- com.apple.fingerprint.match.autonomousFailsFingerOffAfterHomeButton
- com.apple.fingerprint.match.autonomousFailsNoMatchAfterHomeButton
- com.apple.fingerprint.match.autonomousFailsNoMatchAfterPowerButton
- com.apple.fingerprint.match.autonomousFailsNoMatchButtonDown
- com.apple.fingerprint.match.autonomousFailsNoMatchButtonLifting
- com.apple.fingerprint.match.autonomousFailsNoMatchButtonUp
- com.apple.fingerprint.match.autonomousFailsNoMatchButtonUpWithPressureMitigation
- com.apple.fingerprint.match.autonomousFailsNoMatchHumid – I guess I might have been a bit under the weather? ;)
- com.apple.fingerprint.match.failsNoMatchButtonUp
- com.apple.fingerprint.match.failsNoMatchHumid
Getting specific, TouchID unlocks appear to be recorded in the ‘com.apple.fingerprintMain.unlock.unlocksByFinger*’ keys.
As far as as I can tell the keys containing “unlocksByFinger” (colored below in yellow) contain the actual number of unlocks, however in the example below the total unlocks were 11, not 22. I am not sure why there are two entries – I’m sure they record different items, however I cannot find documentation to sort out each one. I would rely on the ‘com.apple.fingerprintMain.unlock.unlocksByFinger#Fail’ entries. (As an aside, it’s worth noting that if you get ‘Finger2’ entries, they have an ‘s’ appended ie: com.apple.fingerprintMain.unlock.unlocksByFinger2Fails, maybe a strange type in the code?)
The ‘fail’ in the key would seem to suggest it records “failed” attempts however my testing shows these are in the green highlighted ‘unlocksCanceled’ entries instead.
What’s the ‘QT’ stand for? I have no idea. I tried looking through Apple documentation to find out, but I’ve got nothin’. Suggestions are welcome!