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

Add additional Service Attributes to Standard Algorithm Names guide

XMLWordPrintable

    • behavioral
    • minimal
    • n/a
    • Other
    • SE

      Summary

      It is observed that JCA recognizes four service attributes "SupportedKeyClasses", "SupportedKeyFormats", "SupportedModes", and "SupportedPaddings" and mentioned them in the "How to implement a Provider" guide. However, they are omitted in the "Standard Algorithm Names" guide which is probably an oversight.

      Problem

      Missing the specification of the service attributes "SupportedKeyClasses", "SupportedKeyFormats", "SupportedModes", and "SupportedPaddings" in the "Standard Algorithm Names" guide.

      Solution

      Add these four attributes to the "Service Attributes" section of the "Standard Algorithm Names" guide.

      Specification

      The four attributes and their descriptions (in md syntax) are as below:

      1) SupportedKeyClasses

      The list of key classes supported by the cryptographic
      service. The value is a list of fully qualified class names
      separated by vertical bars ("|"). For example, when a
      `Cipher` service provides this attribute, the value
      indicates the kinds of keys that callers should use.

      2) SupportedKeyFormats

      The list of key formats supported by the cryptographic
      service. The value is a list of key format names separated
      by vertical bars ("|"). Possible key format names include
      those listed in the [Key Encodings](#key-encodings)
      section.

      3) SupportedModes

      The list of modes supported by the cryptographic service.
      The value is a list of cipher algorithm mode names
      separated by vertical bars ("|"). Possible mode
      names include those listed in the
      [Cipher Algorithm Modes](#cipher-algorithm-modes) section. 

      4) SupportedPaddings

      The list of paddings supported by the cryptographic
      service. The value is a list of padding names separated
      by vertical bars ("|"). Possible padding names
      include those listed in the 
      [Cipher Algorithm Paddings](#cipher-algorithm-paddings)
      section.

      In addition, we made some minor wording updates to two existing service attributes.

      For "ThreadSafe" attribute, for clarity, we added the sentence of The value of this attribute is "true" or "false".

      For "LDAPSchema" attribute, instead of referring to the "ValidationAlgorithm attribute", we duplicated the format and semantics part of description under "ValidationAlgorithm" attribute instead.

            valeriep Valerie Peng
            mullan Sean Mullan
            Sean Mullan
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved: