Strapi plugin logo for Encryptable Field

Encryptable Field

This field type encrypts the value on create and update. And decrypts on fetch.

thumbnail for Encryptable Field

Strapi's Encryptable Field Plugin

This field type encrypts the value on create and update.
And decrypts on fetch one and many.

DO NOT USE ENCRYPTION TO STORE USER PASSWORDS, FOR THIS YOU USE HASHING.
ONLY STORE PII DATA WHEN NEEDED AND ONLY THE BARE MINIMUM.
CONSULT THE RULES AROUND PII DATA THAT APPLY IN THE REGIONS YOU OPERATE IN.

GitHub Workflow Status (main) NPM Downloads Strapi Market Place

DISCLAIMER

Before using this in production make sure you have tested that this plugin is able to encrypt and decrypt all your expected data. Failure to decrypt results in loss of data.

Encryption method

MethodIV LengthEncryption key
aes-256-cbc1632 bytes hex string, provided by environment variable ENCRYPTION_KEY

✨ Supported Strapi Versions

The Encryptable Field plugin is only compatible with Strapi v4.

⚙️ Installation

# If you use NPM
npm install strapi-plugin-encryptable-field

# If you use Yarn
yarn add strapi-plugin-encryptable-field

Configuring the plugin

Open or create the file config/plugins.js and enable the plugin by adding the following snippet:

1
2
3
4
5
6
module.exports = {
    // ...
    'encryptable-field': {
        enabled: true,
    },
};

Add the environment variable ENCRYPTION_KEY to your server and the .env.

Using the plugin

After installation and configuration the custom field is ready to use.
When adding a new field, go to custom and select Encryptable.

Select Encryptable in the Custom tab when adding a new field.

Basic Settings

Because you loose some options to validate a field (for example an email field), you can make use of a regex and a hint to tell the user what you expect.

Set a validation regex and input hint.

Advanced Settings

By default, all fields will be decrypted when queried. It is also possible to only show the decrypted values for one or more roles.

Select one or more roles to show decrypted value to

Below images show what it looks like in a form and overview when decryption is enabled for a specific role.

🚀 Roadmap

  • Role based decryption

Install now

npm install strapi-plugin-encryptable-field

Last updated

46 days ago

Strapi Compatibility

4.4.0 and above

Author

github profile image for Edwin Luijten
Edwin Luijten

Useful links

Create your own plugin

Check out the available plugin resources that will help you to develop your plugin or provider and get it listed on the marketplace.