JDK-8037260 : Enhance JCA Reference Guide with GCM cipher examples
  • Type: Enhancement
  • Component: docs
  • Sub-Component: guides
  • Affected Version: 8
  • Priority: P4
  • Status: Resolved
  • Resolution: Fixed
  • OS: solaris
  • CPU: generic
  • Submitted: 2014-03-13
  • Updated: 2015-02-05
  • Resolved: 2014-07-25
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
JDK 8
8u20 inapplicableFixed
Related Reports
Relates :  
Description
AES cipher with GCM mode is an AEAD cipher which has somewhat different usage patterns than the non-AEAD ciphers. Besides the regular data for encryption/decryption, it also takes AAD which is optional, but when present, must be supplied before the data for encryption/decryption is fed. In addition, in order to use GCM securely, callers should not re-use key+iv combinations for encryption. This means that the cipher object should be explicitly re-initialized with a different set of parameters every time for each encryption operation. The javadoc for javax.crypto.Cipher is enhanced to mention these. But, it'd be helpful to update JCA reference guide with more details and sample code to get the points through.
Comments
This is the link to the changeset: http://closedjdk.us.oracle.com/jdk8u/jdk8u20-dev/pubs/rev/6e3e639c1b9d
25-07-2014

Sign off received by the Engineer: valerie.peng@oracle.com.
25-07-2014

Sent for review. Waiting for sign-off from the Engineer.
23-07-2014

Researching content for this issue.
15-07-2014