@atroo/capacitor-secure-storage-plugin

Securely store secrets such as usernames, passwords, tokens, certificates or other sensitive information (strings) on iOS & Android

Install

npm install @atroo/capacitor-secure-storage-plugin
npx cap sync

Notes

Android

AutoBackup

To stay secure you need to handle the Auto Backup rules in Android. Please refer to this document.

Java 17

The plugin requires Java 17 to run. You can set it using the following options:

• changing the IDE settings.
• changing the JAVA_HOME environment variable.
• changing org.gradle.java.home in gradle.properties.

API

• get(...)
• getAccessibility(...)
• set(...)
• remove(...)
• clear()
• keys()
• getPlatform()
• Interfaces
• Type Aliases

The SecureStoragePlugin plugin interface

get(...)

get(options: { key: string; }) => Promise<{ value: string; }>

gets the value for the given key

| Param | Type | Description | | ------------- | ----------------------------- | -------------------- | | options | { key: string; } | key to get value for |

Returns: Promise<{ value: string; }>

getAccessibility(...)

getAccessibility(options: { key: string; }) => Promise<{ value: string | undefined; }>

gets the accessibility for the given key

| Param | Type | Description | | ------------- | ----------------------------- | ---------------------------- | | options | { key: string; } | key to get accessibility for |

Returns: Promise<{ value: string; }>

set(...)

set(options: SetDataOptions) => Promise<{ value: boolean; }>

sets the value for the given key

| Param | Type | Description | | ------------- | --------------------------------------------------------- | -------------------- | | options | SetDataOptions | key and value to set |

Returns: Promise<{ value: boolean; }>

remove(...)

remove(options: { key: string; }) => Promise<{ value: boolean; }>

removes the value for the given key

| Param | Type | Description | | ------------- | ----------------------------- | ----------------------- | | options | { key: string; } | key to remove value for |

Returns: Promise<{ value: boolean; }>

clear()

clear() => Promise<{ value: boolean; }>

clears all values

Returns: Promise<{ value: boolean; }>

keys()

keys() => Promise<{ value: string[]; }>

gets all keys

Returns: Promise<{ value: string[]; }>

getPlatform()

getPlatform() => Promise<{ value: string; }>

gets the platform

Returns: Promise<{ value: string; }>

Interfaces

SetDataOptions

allows to define how properties can be accessed on iOS

| Prop | Type | | ------------------- | ------------------------------------------------------- | | key | string | | value | string | | accessibility | Accessibility |

Type Aliases

Accessibility

allows to define how properties can be accessed on iOS

'afterFirstUnlock' | 'afterFirstUnlockThisDeviceOnly' | 'whenUnlocked' | 'whenUnlockedThisDeviceOnly' | 'always' | 'alwaysThisDeviceOnly' | 'whenPasscodeSetThisDeviceOnly'