safeStorage
Permet d'accéder à des cryptage et décryptage simples de chaînes de caractères pour le stockage sur la machine locale.
Processus : Main
Ce module protège les données stockées sur le disque contre l’accès par d’autres applications ou utilisateurs pouvant accéder au disque complet.
Notez que sur Mac, l’accès au Keychain du système est requis et que ces appels peuvent bloquer le thread actuel pour collecter les entrées utilisateur. Il en va de même pour Linux, si un outil de gestion des mots de passe est disponible.
Méthodes
Le module safeStorage
possède les méthodes suivantes :
safeStorage.isEncryptionAvailable()
Retourne boolean
- Indique si le cryptage est disponible.
Sous Linux, retourne vrai si l'application a émis l'événement ready
et que la clé secrète est disponible. Sur MacOS, retourne true si Keychain est disponible. Sous Windows, renvoie true une fois que l’application a émis l’événement ready
.
safeStorage.encryptString(plainText)
plainText
string
Retourne Buffer
- Un tableau d'octets représentant la chaîne chiffrée.
Cette fonction déclenchera une erreur en cas d'échec du cryptage.
safeStorage.decryptString(encrypted)
encrypted
Buffer
Retourne string
- la chaîne décryptée. Décrypte dans une chaîne le tampon crypté obtenu avec safeStorage.encryptString
.
Cette fonction déclenchera une erreur en cas d'échec du cryptage.
safeStorage.setUsePlainTextEncryption(usePlainText)
usePlainText
boolean
This function on Linux will force the module to use an in memory password for creating symmetric key that is used for encrypt/decrypt functions when a valid OS password manager cannot be determined for the current active desktop environment. This function is a no-op on Windows and MacOS.
safeStorage.getSelectedStorageBackend()
Linux
Returns string
- User friendly name of the password manager selected on Linux.
This function will return one of the following values:
basic_text
- When the desktop environment is not recognised or if the following command line flag is provided--password-store="basic"
.gnome_libsecret
- When the desktop environment isX-Cinnamon
,Deepin
,GNOME
,Pantheon
,XFCE
,UKUI
,unity
or if the following command line flag is provided--password-store="gnome-libsecret"
.kwallet
- When the desktop session iskde4
or if the following command line flag is provided--password-store="kwallet"
.kwallet5
- When the desktop session iskde5
or if the following command line flag is provided--password-store="kwallet5"
.kwallet6
- When the desktop session iskde6
.unknown
- When the function is called before app has emitted theready
event.