Encrypt a Realm - React Native SDK
On this page
Overview
You can encrypt the realm database file on disk with AES-256 + SHA-2 by supplying a 64-byte encryption key when opening a realm.
Realm transparently encrypts and decrypts data with standard AES-256 encryption using the first 256 bits of the given 512-bit encryption key. Realm uses the other 256 bits of the 512-bit encryption key to validate integrity using a hash-based message authentication code (HMAC).
Do not use cryptographically-weak hashes for realm encryption keys. For optimal security, we recommend generating random rather than derived encryption keys.
Considerations
Storing & Reusing Keys
You must pass the same encryption key when opening the encrypted realm again. Apps should store the encryption key securely.
Performance Impact
Typically, reads and writes on encrypted realms can be up to 10% slower than unencrypted realms.
Encryption and Realm Sync
You can encrypt a synced realm. MongoDB Realm only encrypts the data on the device and stores the data unencrypted in your MongoDB Atlas data source.
Accessing an Encrypted Realm from Multiple Process
Realm forbids opening the same encrypted realm from multiple processes. Attempting to do so will throw the error: "Encrypted interprocess sharing is currently unsupported."
Example
The following code demonstrates how to generate an encryption key and open an encrypted realm: