Skip to content

Latest commit

 

History

History
79 lines (57 loc) · 3.03 KB

README.md

File metadata and controls

79 lines (57 loc) · 3.03 KB
Raw

cordova-plugin-kunder-accountmanager

This cordova plugin enables you to use Android Account Manager and iOS Keychain to manage accounts of one user and share with other applications of the same company (e.g google apps like gmail, youtube, etc).

It's possible to moddify this plugins to allow multiple accounts.

By default, this plugin cypher the key and message before setting data into Account Manager with AES 256 bits (Android only).

Installation

cordova plugin add https://github.com/kunder-lab/cordova-plugin-kunder-accountmanager.git#1.0.1 (the lastest stable version)

Account Manager settings

You need to add the following settings in your config.xml file for Android Account Manager to work:

<preference name="AccountManagerLabel" value="Your Label Here" />
<preference name="AccountManagerIconUrl" value="your_icon_url_here.png" />
<preference name="AccountManagerType" value="your.unique.identifier" />

Supported Platforms

  • Android
  • iOS

Methods

  • initWithKey: register the encryptionKey for AES encryption. It must be called before other Account Manager methods
  • registerAccount: register an user in Account Manager
  • removeAccount: remove an account from Account Manager (Android) and remove all data from keychain (iOS)
  • getUserAccount: returns an String with account name if account exist
  • getPassword: returns password if account exist
  • getDataFromKey: returns data from specified key
  • setUserData: set object with information into Account Manager or Keychain
  • setPassword: update account password
  • resetPassword: update account password with String "0000"

Key Parameters

  • accountType: the same account type unique identifier set in config.xml file
  • group (Nullable): group identifier. Only for iOS shared keychain
  • data: key-value object
  • encryptionKey: the key used to encrypt/decrypt key and value data.

Notes

  • You can not delete user data from Account Manager. Use "setUserData" to change value to empty.
  • You can delete account from Account Manager.
  • removeAccount remove all keychain data from your app.
  • You can not set user data to Account Manager if it doesn't have an account for your identifier.
  • You need to call initWithKey method before other Account Manager method, otherwise it will not work (Android only).

License

MIT