[DERBY-4229] encryptionKeyLength connection attribute should be documented

• Type: Bug
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 10.5.1.1
• Fix Version/s: 10.5.3.1, 10.6.2.2, 10.7.1.4, 10.8.3.0, 10.9.2.2, 10.10.1.1
• Component/s: Documentation
• Assignee: Camilla Haase
• Reporter: Katherine Marsden
• Created: 14/May/09 20:03
• Updated: 25/Nov/12 20:14
• Resolved: 01/Nov/12 19:05

Description

The developer guide says:

The length of the encryption key depends on the algorithm used:
AES (128, 192, and 256 bits)
DES (the default) (56 bits)
DESede (168 bits)
All other algorithms (128 bits)
Note: The boot password should have at least as many characters as number of bytes in the encryption key (56 bits=8 bytes, 168 bits=24 bytes, 128 bits=16 bytes). The minimum number of characters for the boot password allowed by Derby is eight.

For AES, however, it does not tell how to change the default key length of 128. This can be changed with the encryptionKeyLength connection attribute. The documentation should also specify that special policy files for the JRE may be necessary to accomodate the longer length.

Also note that there is an outstanding issue DERBY-3710 regarding length of 192 for AES.

Issue Links

• relates to: DERBY-2821 emphasize that derby encryption only supports NoPadding option
• relates to: DERBY-5805 Database encryption topics in Reference Manual need more information