Skip to content

malwatte/cordova-plugin-touchid

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Touch ID Plugin for Apache Cordova

Cordova Plugin to leverage the iOS local authentication framework to allow in-app user authentication using Touch ID.

Important: You must target a real device when building. If you target the simulator, the build will fail.

Install

Latest published version on npm (with Cordova CLI >= 5.0.0)

cordova plugin add cordova-plugin-touchid

Latest version from GitHub

cordova plugin add https://github.com/leecrossley/cordova-plugin-touchid.git

Usage

You do not need to reference any JavaScript, the Cordova plugin architecture will add a touchid object to your root automatically when you build.

Ensure you use the plugin after your deviceready event has been fired.

Authenticate

Pass the following arguments to the authenticate() function, to prompt the user to authenticate via TouchID:

  1. Success callback (called on successful authentication)
  2. Failure callback (called on error or if authentication fails)
  3. Localised text explaining why the app needs authentication*
touchid.authenticate(successCallback, failureCallback, text);

*NOTE: The localised text you present to the user should provide a clear reason for why you are requesting they authenticate themselves, and what action you will be taking based on that authentication.

Check support

Although the authenticate() function will return an error if the user is unable to authenticate via Touch ID, you may wish to check support without prompting the user to authenticate. This can be done by passing following arguments to the checkSupport() function:

  1. Success callback (called if authentication is possible)
  2. Not supported callback (called if policy can not be evaluated, with error message)
touchid.checkSupport(successCallback, notSupportedCallback);

Platforms

iOS 8+

License

MIT License

About

Cordova / PhoneGap Touch ID Plugin for Apache Cordova >= 3.0.0

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Objective-C 88.6%
  • JavaScript 11.4%