@flowmoco/capacitor-biometric-keychain
TypeScript icon, indicating that this package has built-in type declarations

2.0.0 • Public • Published

capacitor-biometric-keychain

Uses Keychain and Keystore on ios and android respectively to give a secure localStorage like API that uses a biometric lock for read and update operations

Capacitor v5 Android minSdkVersion 23 iOS min version 13.0

Install

npm install @flowmoco/capacitor-biometric-keychain
npx cap sync

iOS

To enable FaceID, you must set the the NSFaceIDUsageDescription key.

<key>NSFaceIDUsageDescription</key>
<string>[Reason why your app needs FaceID]</string>

Import

import { BiometricNative } from "@flowmoco/capacitor-biometric-keychain";

API

getItem(...)

getItem(options: { key: string; }) => Promise<{ value: string; error?: any; }>

Async get an item from the secure storage. Will invoke device biometric authentication.

Param Type
options { key: string; }

Returns: Promise<{ value: string; error?: any; }>


setItem(...)

setItem(options: { key: string; value: string; }) => Promise<{ error?: any; }>

Async set an item in secure storage. Will invoke device biometric authentication on Android and only on iOS if overwriting an existing key.

Param Type
options { key: string; value: string; }

Returns: Promise<{ error?: any; }>


removeItem(...)

removeItem(options: { key: string; }) => Promise<{ error?: any; }>

Async remove an item from the secure storage. Will not invoke device biometric authentication either platform.

Param Type
options { key: string; }

Returns: Promise<{ error?: any; }>


Readme

Keywords

Package Sidebar

Install

npm i @flowmoco/capacitor-biometric-keychain

Weekly Downloads

3

Version

2.0.0

License

MIT

Unpacked Size

44 kB

Total Files

32

Last publish

Collaborators

  • charlieflowmo
  • idesignpixels
  • flowmoco-ben