Bug 24457 - Add a note regarding constraints on the size of wrapped keys
authorMark Watson <watsonm@netflix.com>
Thu, 06 Mar 2014 16:40:26 -0800
changeset 161 a3021bc66588
parent 160 64993be45f9f
child 162 079162842e93
Bug 24457 - Add a note regarding constraints on the size of wrapped keys
spec/Overview-WebCryptoAPI.xml
spec/Overview.html
--- a/spec/Overview-WebCryptoAPI.xml	Thu Mar 06 16:26:41 2014 -0800
+++ b/spec/Overview-WebCryptoAPI.xml	Thu Mar 06 16:40:26 2014 -0800
@@ -2395,6 +2395,19 @@
                   property of <var>key</var> using <var>key</var> and <var>format</var>.
                 </p>
               </li>
+              <div class="note">
+                <p class="norm">
+                  This note is non-normative.
+                </p>
+                <p>
+                  The key wrapping operations for some algorithms place constraints on the payload
+                  size. For example AES-KW requires the payload to be a multiple of 8 bytes in
+                  length and RSA-OAEP places a restriction on the length. For key formats that
+                  offer flexibility in serialization of a given key (for example JWK),
+                  implementations may choose to adapt the serialization to the constraints of
+                  the wrapping algorithm.
+                </p>
+              </div>
               <li>
                 <dl class="switch">
                   <dt>If <var>normalizedAlgorithm</var> supports the wrap key operation:</dt>
--- a/spec/Overview.html	Thu Mar 06 16:26:41 2014 -0800
+++ b/spec/Overview.html	Thu Mar 06 16:40:26 2014 -0800
@@ -2402,6 +2402,19 @@
                   property of <var>key</var> using <var>key</var> and <var>format</var>.
                 </p>
               </li>
+              <div class="note"><div class="noteHeader">Note</div>
+                <p class="norm">
+                  This note is non-normative.
+                </p>
+                <p>
+                  The key wrapping operations for some algorithms place constraints on the payload
+                  size. For example AES-KW requires the payload to be a multiple of 8 bytes in
+                  length and RSA-OAEP places a restriction on the length. For key formats that
+                  offer flexibility in serialization of a given key (for example JWK),
+                  implementations may choose to adapt the serialization to the constraints of
+                  the wrapping algorithm.
+                </p>
+              </div>
               <li>
                 <dl class="switch">
                   <dt>If <var>normalizedAlgorithm</var> supports the wrap key operation:</dt>