TouchID: Difference between revisions

From iPhone Development Wiki
mNo edit summary
mNo edit summary
Line 25: Line 25:


== BiometricKit.framework ==
== BiometricKit.framework ==
 
{{ main|BiometricKit.framework }}
<tt>BiometricKit.framework</tt> is the main TouchID private framework compiled only for arm64. You can also Google "Biokit.h", and from the Gist you can find the headers for the BiometricKit.framework. (You can also dump them yourselves, it is shipped with the iPhoneOS 7.0 SDK on Xcode and of course on an iPhone 5s.) Note that if you decide to use the <tt>BiometricKit</tt> class and the <tt>BiometricKitDelegate</tt> in your own app, the app needs the entitlements of <tt>com.apple.private.biometrickit.allow</tt> and <tt>com.apple.private.bmk.allow</tt>.
 
=== BiometricKitIdentity ===
 
<tt>BiometricKitIdentity</tt> represents the enrolled fingerprints on the device. Properties for the user-defined name and UUID are available. You can get an array of all identities with <tt>[[BiometricKit manager] identities:nil]</tt>.
 
=== BiometricKitMatchInfo ===
 
<tt>BiometricKitMatchInfo</tt> contains presumably the actual fingerprint digital representation with up to 15 "topology nodes", returned from <tt>BiometricKitDelegate</tt>'s <tt>- (void)matchResult:(BiometricKitIdentity *)result withDetails:(BiometricKitMatchInfo *)details</tt>. Both parameters would be <tt>nil</tt> if no match is found.
 
=== Getting scan results ===
 
<tt>- (void)biometricEventMonitor:(SBUIBiometricEventMonitor *) handleBiometricEvent:(unsigned)</tt> from <tt>SBLockScreenManager</tt> would be invoked always after the screen is on and a fingerprint is registered. One exception is when the user enters the TouchID settings under <tt>Preferences.app</tt>, where the app took control of all the callbacks, and we have to lock and unlock the screen again in order to receive messages from the aforementioned callback again.
 
This issue happens if you hook up to the <tt>BiometricKitXPCClient</tt>'s <tt>- (void)matchResult:(BiometricKitIdentity *)result withDictionary:(NSDictionary *)dictionary</tt>; or if you go the good old delegate way with <tt>[BiometricKit manager]</tt>. ''I'm still trying to figure out how to revive that, if you found any way around this please do share with everyone.''


== References ==
== References ==


#http://www.pocket-lint.com/news/123832-apple-s-touch-id-fingerprint-sensor-explained-here-s-what-you-need-to-know
#http://www.pocket-lint.com/news/123832-apple-s-touch-id-fingerprint-sensor-explained-here-s-what-you-need-to-know

Revision as of 13:21, 4 January 2014

This post is still in a 'beta' stage and more information will be added to it as we find out more about Touch ID.

Also see: http://theiphonewiki.com/w/index.php?title=Touch_ID

Apple has embedded a fingerprint sensor into the iPhone 5s's Home Button as a way to bypass the lock screen's passcode. This is Touch ID.

All fingerprint information is encrypted and stored in the A7 chip. Touch ID it does stores "mathematical representation" of fingerprints.

The iPhone 5s has an advanced security architecture called the Secure Enclave - within the A7 chip that protects and verifies fingerprint matches. Apple said the Secure Enclave is "walled off from the rest of A7 and as well as the rest of iOS", meaning only Touch ID has access to fingerprint data.

TouchID has 4 header files:

                                         PSBiometricIdentity.h 
                                         SBUIBiometricEventMonitor.h
                                         SBUIBiometricEventObserver.h
                                         BiometricKitDelegate.h

Which can all be found at: developer.limneos.net.

The main class is BiometricKit which is a singleton class (+manager).

The PSBiometricIdentity.h is responsible for the settings of TouchID which can be found in settings >General > TouchId & Passcode > Touch ID. The 2 SpringBoardUIServices headers are responsible for scanning and detecting the finger on the lock screen; they use the delegate methods to for example match the finger like in the -(void)matchResult:(id)arg1; method.

If you log the argument of that method you will get something around the lines of: -[<SBUIBiometricEventMonitor: 0x17867c3c0> matchResult:<BiometricKitIdentity: 0x1782562f0>] . That <BiometricKitIdentity: 0x1782562f0> is the name of the finger that was just scanned and verified. Now we know from Apple that Touch ID is stored on the A7 Processor chip inside the 5s in a secure enclave. What do we not know? How much storage is their in this secure enclave? Is it variable?...

BiometricKit.framework

References

  1. http://www.pocket-lint.com/news/123832-apple-s-touch-id-fingerprint-sensor-explained-here-s-what-you-need-to-know