Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8037260

Enhance JCA Reference Guide with GCM cipher examples

    XMLWordPrintable

Details

    • Enhancement
    • Resolution: Fixed
    • P4
    • 8u20
    • 8
    • docs
    • inapplicable
    • generic
    • solaris

    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.

      Attachments

        Issue Links

          Activity

            People

              rgoyal Ram Goyal (Inactive)
              valeriep Valerie Peng
              Votes:
              0 Vote for this issue
              Watchers:
              2 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: