RNSecureStorage

!GitHub license

Secure Storage for React Native (Android & iOS) - Keychain & Keystore

#### If you like this library, please consider supporting my work by buying me a coffee


$3

Please read my disclaimer about maintaining this library here

For Android I need your reviews

Getting Started

With NPM

``
npm install --save rn-secure-storage
`

With YARN

`
yarn add rn-secure-storage
`

$3

- Rewritten Android module with enhanced security features.
- Android minSdkVersion is now 23 (Android 6.0 Marshmallow)
- iOS module redeveloped using Swift and updated APIs.
- Comprehensive renaming and expansion of APIs.
- Modifications to the return types of some APIs.
- Added clear for comprehensive data clearance.
- Introduced getAllKeys for retrieving all stored keys.
- Implemented multiSet for setting multiple values simultaneously.
- New multiGet feature for fetching multiple values at once.
- multiRemove added for bulk deletion of items.
- getSupportedBiometryType introduced for iOS (supports biometric authentication types).

$3

- setItem
- getItem
- removeItem
- exists
- getAllKeys
- clear
- multiSet
- multiGet
- multiRemove

$3

To set the item, you need to pass the key and value as parameters. You can also pass the options as a third parameter. If the key exists,
the value will be updated, otherwise, it will be created. You can use the exists method to check if the key exists. You can also pass
the accessible option to set the accessibility of the keychain item (only for IOS).

`js
import RNSecureStorage, {ACCESSIBLE} from 'rn-secure-storage';

RNSecureStorage.setItem("key", "value", {accessible: ACCESSIBLE.WHEN_UNLOCKED}).then((res) => {
console.log(res);
}).catch((err) => {
console.log(err);
});
`

$3

To get the item, you need to pass the key as a parameter. If the key exists, the value will be returned, otherwise, it will return an error.

`js
RNSecureStorage.getItem("key").then((res) => {
console.log(res);
}).catch((err) => {
console.log(err);
});
`

$3

To remove the item, you need to pass the key as a parameter. If the key exists, the value will be removed, otherwise, it will return an
error.

`js
RNSecureStorage.removeItem("key").then((res) => {
console.log(res);
}).catch((err) => {
console.log(err);
});
`

$3

To check if the item exists, you need to pass the key as a parameter. If the key exists it will return true, otherwise, it will
return false. Mostly you don't need to use this method because getItem will return an error if the key doesn't exist. But for
performance you can just check if the key exists before calling getItem.

`js
RNSecureStorage.exist("key").then((res) => {
console.log(res ? "exists" : "does not exist");
}).catch((err) => {
console.log(err);
});
`

$3

To get all keys, you need to call getAllKeys method. It will return an array of keys.

`js
RNSecureStorage.getAllKeys().then((res) => {
console.log(res);
}).catch((err) => {
console.log(err);
});
`

$3

To clear all data, you need to call clear method. It will return true if the operation is successful. Otherwise, it will return
remaining keys.

`js
RNSecureStorage.clear().then((res) => {
console.log(res);
}).catch((err) => {
console.log(err);
});
`

$3

Multi set is a new feature that allows you to set multiple values simultaneously. You need to pass an object as the first parameter

`js
import RNSecureStorage, {ACCESSIBLE} from 'rn-secure-storage';

const items = {"key_1": "multi key 1", "key_2": "multi key 2"};
RNSecureStorage.multiSet(items, {accessible: ACCESSIBLE.WHEN_UNLOCKED}).then((res) => {
console.log(res);
}).catch((err) => {
console.log(err);
});
`

$3

With multi get you can fetch multiple values at once. You need to pass an array of keys as the first parameter.

`js
RNSecureStorage.multiGet(["key_1", "key_2"]).then((res) => {
console.log(res);
}).catch((err) => {
console.log(err);
});
`

$3

With multi remove you can delete multiple values at once. You need to pass an array of keys as the first parameter. If your keys are
removed/not found, it will return an array of keys that are not removed/found.

`js
RNSecureStorage.multiRemove(["key_1", "key_2"]).then((res) => {
console.log(res);
}).catch((err) => {
console.log(err);
});
`

Options

| Key | Platform | Description | Default |
|------------------|----------|--------------------------------------------------------------------------------------------------|---------------------------------------|
| accessible | iOS only | This indicates when a keychain item is accessible, see possible values in Keychain.ACCESSIBLE. | Keychain.ACCESSIBLE.WHEN_UNLOCKED |

$3

| Key | Description |
|-------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| WHEN_UNLOCKED | The data in the keychain item can be accessed only while the device is unlocked by the user. |
| AFTER_FIRST_UNLOCK | The data in the keychain item cannot be accessed after a restart until the device has been unlocked once by the user. |
| ALWAYS | The data in the keychain item can always be accessed regardless of whether the device is locked. |
| WHEN_PASSCODE_SET_THIS_DEVICE_ONLY | The data in the keychain can only be accessed when the device is unlocked. Only available if a passcode is set on the device. Items with this attribute never migrate to a new device. |
| WHEN_UNLOCKED_THIS_DEVICE_ONLY | The data in the keychain item can be accessed only while the device is unlocked by the user. Items with this attribute do not migrate to a new device. |
| AFTER_FIRST_UNLOCK_THIS_DEVICE_ONLY | The data in the keychain item cannot be accessed after a restart until the device has been unlocked once by the user. Items with this attribute never migrate to a new device. |
| ALWAYS_THIS_DEVICE_ONLY` | The data in the keychain item can always be accessed regardless of whether the device is locked. Items with this attribute never migrate to a new device. |

#### You can also check out sample project for more details

License

This project is licensed under the MIT License - see the LICENSE.md file for details

$3

I have rewritten the Android module with enhanced security features. I need your reviews. Please test the new version and let me know your
thoughts. I will be happy to hear your suggestions and comments. I'm planning to release the new version to handle biometric authentication
on Android.

$3

$3

As an open-source enthusiast and developer, I originally created this library for professional use. However, with recent changes in my
career, my focus has shifted away from React Native, limiting my involvement to personal projects. Consequently, my time to address issues
and review pull requests for this library has become restricted. I remain committed to maintaining and improving this library, but my
response times might be longer. I greatly appreciate your patience and understanding.

The beauty of open-source is in collaboration. If you find this library useful and would like to contribute, whether through code,
addressing issues, or even buying a coffee to show support, it would be immensely appreciated. Together, we can ensure the continued
development and enhancement of this library.