capacitor-secure-storage-plugin
    TypeScript icon, indicating that this package has built-in type declarations

    0.6.2 • Public • Published

    capacitor-secure-storage-plugin

    Capacitor plugin for storing string values securly on iOS and Android.

    How to install

    For Capacitor v3

    npm install capacitor-secure-storage-plugin
    

    For Capacitor v2 - install with fixed version 0.5.1

    npm install capacitor-secure-storage-plugin@0.5.1
    

    Usage

    For Capacitor v3

    In a component where you want to use this plugin add to or modify imports:

    import { SecureStoragePlugin } from 'capacitor-secure-storage-plugin';
    

    For Capacitor v2

    In a component where you want to use this plugin add to or modify imports:

    import 'capacitor-secure-storage-plugin';
    import { Plugins } from '@capacitor/core';
    
    const { SecureStoragePlugin } = Plugins;
    

    First line is needed because of web part of the plugin (current behavior of Capacitor, this may change in future releases).

    Android

    In Android you have to register plugins manually in MainActivity class of your app.

    https://capacitor.ionicframework.com/docs/plugins/android/#export-to-capacitor

    import com.whitestein.securestorage.SecureStoragePlugin;
    
    ...
    
    public class MainActivity extends BridgeActivity {
      @Override
      public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
    
        // Initializes the Bridge
        this.init(savedInstanceState, new ArrayList<Class<? extends Plugin>>() {{
          // Additional plugins you've installed go here
          // Ex: add(TotallyAwesomePlugin.class);
          add(SecureStoragePlugin.class);
        }});
      }
    }
    

    Methods

    • get(options: { key: string }): Promise<{ value: string }>
      • if item with specified key does not exist, throws an Error
    • keys(): Promise<{ value: string[] }>
    • set(options: { key: string; value: string }): Promise<{ value: boolean }>
    • remove(options: { key: string }): Promise<{ value: boolean }>
    • clear(): Promise<{ value: boolean }>
      • set, remove and clear return true in case of success and false in case of error
    • getPlatform(): Promise<{ value: string }>
      • returns which implementation is used - one of 'web', 'ios' or 'android'

    Example

    const key = 'username';
    const value = 'hellokitty2';
    
    SecureStoragePlugin.set({ key, value })
      .then(success => console.log(success))
    
    const key = 'username';
    SecureStoragePlugin.get({ key })
      .then(value => {
        console.log(value);
      })
      .catch(error => {
        console.log('Item with specified key does not exist.');
      });
    
    async getUsername(key: string) {
      return await SecureStoragePlugin.get({ key });
    }
    

    Platform specific information

    iOS

    This plugin uses SwiftKeychainWrapper under the hood for iOS.

    Warning

    Up to version v0.4.0 there was standard keychain used. Since v0.5.0 there is separate keychain wrapper, so keys() method returns only keys set in v0.5.0 or higher version.

    Android

    On Android it is implemented by AndroidKeyStore and SharedPreferences. Source: Apriorit

    Warning

    For Android API < 18 values are stored as simple base64 encoded strings.

    Web

    There is no secure storage in browser (not because it is not implemented by this plugin, but it does not exist at all). Values are stored in LocalStorage, but they are at least base64 encoded. Plugin adds 'capsec' prefix to keys to avoid conflicts with other data stored in LocalStorage.

    Install

    npm i capacitor-secure-storage-plugin

    DownloadsWeekly Downloads

    5,067

    Version

    0.6.2

    License

    MIT

    Unpacked Size

    3.04 MB

    Total Files

    231

    Last publish

    Collaborators

    • martinkasa