Skip to content

Latest commit

 

History

History
142 lines (94 loc) · 5.18 KB

README-fr.md

File metadata and controls

142 lines (94 loc) · 5.18 KB
Raw

RNSecureStorage

Stockage sécurisé pour React Native (Android & iOS)

Note: Ce projet est une amélioration de react-native-secure-key-store, RNSecureStorage fonctionne "sous l'api 23"

Voir la FAQ pour plus d'informations.

IOS

RNSecureStorage utilise le Trousseau pour le stockage sécurisé.

Android

En dessous de l'API 23, RNSecureStorage utilise secure-preferences par @scottyab

Au-dessus de l'API 23 RNSecureStorage utilise Android Keystore

Commencer

Avec NPM

npm install --save rn-secure-storage

Avec YARN

yarn add rn-secure-storage

Lien automatique

react-native link rn-secure-storage

Lien Manuel

Installation Manuel (Si quelquechose ne fonctionne pas avec react-native link)

Utilisation

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

SET

// {accessible: ACCESSIBLE.WHEN_UNLOCKED} -> seulement si iOS
RNSecureStorage.set("key1", "this is a value", {accessible: ACCESSIBLE.WHEN_UNLOCKED})
.then((res) => {
console.log(res);
}, (err) => {
console.log(err);
});

GET

RNSecureStorage.get("key1").then((value) => {
console.log(value) // Renvoie la valeur directe
}).catch((err) => {
console.log(err)
})

REMOVE

RNSecureStorage.remove("key1").then((val) => {
console.log(val)
}).catch((err) => {
console.log(err)
});

Options

Clé Platforme Description Valeur par défaut
accessible iOS uniq. Cela dit quand un élément trousseau est accessible, voir les valeurs possibles dans Keychain.ACCESSIBLE. Keychain.ACCESSIBLE.WHEN_UNLOCKED

Keychain.ACCESSIBLE enum

Clé Description
WHEN_UNLOCKED Les données de l'élément de trousseau ne sont accessibles que lorsque l'utilisateur déverrouille l'appareil.
AFTER_FIRST_UNLOCK L'accès aux données de l'élément de trousseau est impossible après un redémarrage tant que l'utilisateur n'a pas déverrouillé l'appareil.
ALWAYS Les données de l'élément de trousseau sont toujours accessibles, que le périphérique soit verrouillé ou non..
WHEN_PASSCODE_SET_THIS_DEVICE_ONLY Les données du trousseau ne sont accessibles que lorsque le périphérique est déverrouillé. Disponible uniquement si un code d'authentification est défini sur le périphérique. Les éléments avec cet attribut ne migrent jamais vers un nouveau périphérique.
WHEN_UNLOCKED_THIS_DEVICE_ONLY Les données de l'élément de trousseau sont accessibles uniquement lorsque l'utilisateur déverrouille l'appareil. Les éléments avec cet attribut ne migrent pas vers un nouveau périphérique.
AFTER_FIRST_UNLOCK_THIS_DEVICE_ONLY Il est impossible d’accéder aux données du trousseau après un redémarrage tant que l’utilisateur n’a pas déverrouillé le périphérique. Les éléments avec cet attribut ne migrent jamais vers un nouveau périphérique.
ALWAYS_THIS_DEVICE_ONLY Les données de l'élément de trousseau sont toujours accessibles, que le périphérique soit verrouillé ou non. Les éléments avec cet attribut ne migrent jamais vers un nouveau périphérique.

Exemples

Vous pouvez trouver des exemples d'utilisation dans le dossier example du projet.

git clone https://github.com/talut/rn-secure-package

cd rn-secure-package/example

npm install

react-native run-ios/android

Version 1.0.7

  • Android & IOS returing value/messages are updated.
  • Issue:1 is solved.

FAQ

  • Pourquoi devrais-je utiliser ce paquet ?
  • Vous pouvez utiliser d'autres paquets comme react-native-keychain. Mais je sais que ce paquet a plus d'options : Avec react-native-keychain, vous ne pouvez stocker que l'utilisateur, mot de passe alors qu'avec ce paquet vous pouvez stocker beaucoup de [clé,valeur].
  • Pourquoi ne devrais-je pas utiliser react-native-secure-key-store ?
  • Vous pouvez utiliser ce paquet, mais vous n'aurez aucun support avec les anciennes version d'Android. De plus, ce paquet est configuré minSDK: 18. Cela signifie que vous allez avoir quelques problèmes.
  • Hé, je peux avoir confiance dans votre code/paquet ?
  • Vous pouvez consulter le code dans ce projet afin que vous le puissiez le vérifier. De plus, si vous le souhaitez, vous pouvez facilement accéder à mon dépôt et modifier ce qui vous dérange. Ce paquet est sous licence MIT. Je ne peux donc vous donner aucune garantie. * ** Mais sachez que j'utilise ce package dans mes projets.*
  • Vas-tu maintenir ce paquet ?
  • Oui, mais vous savez que le temps peut tout changer. -Comment puis-je vous soutenir? -Si vous utilisez mon paquet, ça me suffit

Remerciement

License

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