Encryption
Content Type: Module
Categories: Utility
Overview
Please see Encryption in the Mendix documentation for details.
NB: 1. version 2.x requires at least Mendix Studio Pro 7.23.22. For older versions of Mendix please use version 1.x. When using version 2.0.1 or higher remove the following jar files from the userlib directory: bcpg-jdk15on-150.jar, bcpkix-jdk15on-150.jar, bcprov-jdk15on-150.jar, if they exist. 2. version 2.1.2 is retracted, because the release included test files. Please update to version 2.1.3. 3. version 2.1.3 module still mentions the version number as 2.1.2 in _Docs folder. Kindly ignore the same. 4. version 2.2.0 introduces makes 256 bit (32 characters) keys mandatory. When upgrading to version 2.2.0 please decrypt and re-encrypt all encrypted values in your database. Set the LegacyEncryptionKey constant to your 128 bit (16 characters) key and set the EncryptionKey to a new 256 bit (32 characters) key. 5. version 2.2.0 is not backwards compatible with previous versions regarding the Encrypt microflow. Please upgrade to version 2.3.0 to resolve this.
When upgrading to 2.0.1 please remove the following jar files from the userlib directory: bcpg-jdk15on-150.jar, bcpkix-jdk15on-150.jar, bcprov-jdk15on-150.jar, if they exist.
When upgrading to 2.1.1 please remove the following jar files from the userlib directory: bcpg-jdk15on-164.jar, bcpkix-jdk15on-164.jar, bcprov-jdk15on-164.jar, if they exist.
When upgrading to 2.1.3 please remove the following jar files from the userlib directory: bcpg-jdk15on-167.jar, bcpkix-jdk15on-167.jar, bcprov-jdk15on-167.jar, if they exist.
When upgrading to 2.2.0 please remove the following jar files from the userlib directory: commons-io-2.6.jar
When upgrading to 8.0.2 please remove the following jar files from the userlib directory: commons-io-2.7.jar
When upgrading to 8.0.3 please remove the following jar files from the userlib directory: commons-io-2.8.jar
Version 2.1.0 to 2.5.x require at least Mendix Studio Pro 8.12.0.
Version 7.0.0 and later require at least Mendix Studio Pro 7.23.22.
Version 9.0.0 and later require at least Mendix Studio Pro 9.18.0.
Version 8.0.0 and later require at least Mendix Studio Pro 8.12.0.
NB: 1. version 2.x requires at least Mendix Studio Pro 7.23.22. For older versions of Mendix please use version 1.x. When using version 2.0.1 or higher remove the following jar files from the userlib directory: bcpg-jdk15on-150.jar, bcpkix-jdk15on-150.jar, bcprov-jdk15on-150.jar, if they exist. 2. version 2.1.2 is retracted, because the release included test files. Please update to version 2.1.3. 3. version 2.1.3 module still mentions the version number as 2.1.2 in _Docs folder. Kindly ignore the same. 4. version 2.2.0 introduces makes 256 bit (32 characters) keys mandatory. When upgrading to version 2.2.0 please decrypt and re-encrypt all encrypted values in your database. Set the LegacyEncryptionKey constant to your 128 bit (16 characters) key and set the EncryptionKey to a new 256 bit (32 characters) key. 5. version 2.2.0 is not backwards compatible with previous versions regarding the Encrypt microflow. Please upgrade to version 2.3.0 to resolve this.
When upgrading to 2.0.1 please remove the following jar files from the userlib directory: bcpg-jdk15on-150.jar, bcpkix-jdk15on-150.jar, bcprov-jdk15on-150.jar, if they exist.
When upgrading to 2.1.1 please remove the following jar files from the userlib directory: bcpg-jdk15on-164.jar, bcpkix-jdk15on-164.jar, bcprov-jdk15on-164.jar, if they exist.
When upgrading to 2.1.3 please remove the following jar files from the userlib directory: bcpg-jdk15on-167.jar, bcpkix-jdk15on-167.jar, bcprov-jdk15on-167.jar, if they exist.
When upgrading to 2.2.0 please remove the following jar files from the userlib directory: commons-io-2.6.jar
When upgrading to 8.0.2 please remove the following jar files from the userlib directory: commons-io-2.7.jar
When upgrading to 8.0.3 please remove the following jar files from the userlib directory: commons-io-2.8.jar
Version 2.1.0 to 2.5.x require at least Mendix Studio Pro 8.12.0.
Version 7.0.0 and later require at least Mendix Studio Pro 7.23.22.
Version 9.0.0 and later require at least Mendix Studio Pro 9.18.0.
Version 8.0.0 and later require at least Mendix Studio Pro 8.12.0.
Documentation
Please see Encryption in the Mendix documentation for details.
Note: When using version 2.0.1 or higher remove the following jar files from the userlib directory: bcpg-jdk15on-150.jar, bcpkix-jdk15on-150.jar, bcprov-jdk15on-150.jar, if they exist.
When upgrading to 2.1.1 or later please remove the following jar files from the userlib directory: bcpg-jdk15on-164.jar, bcpkix-jdk15on-164.jar, bcprov-jdk15on-164.jar, if they exist.
Version 2.1.0 to 2.5.x require at least Mendix Studio Pro 8.12.0.
Version 7.0.0 and later require at least Mendix Studio Pro 7.23.22.
Version 8.0.0 and later require at least Mendix Studio Pro 8.12.0.
Version 9.0.0 and later require at least Mendix Studio Pro 9.18.0.
Releases
Version: 10.0.3
Framework Version: 9.24.18
Release Notes: - We updated the Apache Commons IO dependency to 2.17.0. (Tickets 230717, 230797)
- We fixed some dead code in PGPUtils.
- We changed AES/GCM/PKCS5PADDING to AES/GCM/NoPadding, this is equivalent for AES in GCM mode but will prevent errors when using Java 21. (Ticket 225806)
Version: 10.0.2
Framework Version: 9.24.18
Release Notes: - We upgraded the Mendix version to 9.24.18.
- We upgraded the Bouncy Castle version to 1.78.1
- We have removed the default value for the EncryptionKey. This was mistakingly introduced in 10.0.0. We retracted 10.0.0 and 10.0.1 because of this.
Version: 9.0.3
Framework Version: 9.18.0
Release Notes: We upgraded the Bouncy Castle version to 1.78.1
Version: 9.0.2
Framework Version: 9.18.0
Release Notes: We included a migration file for the Java dependencies for Studio Pro 10 compatibility.
Version: 9.0.1
Framework Version: 9.18.0
Release Notes: - We updated the dependency Bouncy Castle from version 1.70 to 1.75
Version: 9.0.0
Framework Version: 9.18.0
Release Notes: We updated the module to Studio Pro 9.18, so it can be used in Studio Pro 10.
Version: 8.0.6
Framework Version: 8.12.0
Release Notes: - We upgraded the Bouncy Castle version to 1.78.1
Note: When upgrading to 8.0.6 please remove the following jar files from the userlib directory: bcpg-jdk18on-1.75.jar, bcpkix-jdk18on-1.75.jar, bcprov-jdk18on-1.75.jar
Version: 8.0.5
Framework Version: 8.12.0
Release Notes: - We updated the dependency Bouncy Castle from version 1.70 to 1.75
Version: 8.0.4
Framework Version: 8.12.0
Release Notes: - We updated the dependency Bouncy Castle from version 1.69 to 1.70
Note: When upgrading to 8.0.4 please remove the following jar files from the userlib directory: bcpg-jdk15on-1.69.jar, bcpkix-jdk15on-1.69.jar, bcprov-jdk15on-1.69.jar
Version: 8.0.3
Framework Version: 8.12.0
Release Notes: - We updated the dependency Apache Commons IO from version 2.8.0 to 2.11.0.
Note: When upgrading to 8.0.3 please remove the following jar files from the userlib directory: commons-io-2.8.jar