-
CSR
-
Resolution: Approved
-
P3
-
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.
- csr of
-
JDK-8297161 Add additional Service Attributes to Standard Algorithm Names guide
- Resolved