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 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 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 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.