Skip to content

Commit a9f0b6f

Browse files
author
Joel Brockman
committed
Updated documentation to show both SHAKE 1.0 and FIPS202 versions instead of a mix.
1 parent 2d8b9a6 commit a9f0b6f

File tree

3 files changed

+99
-4
lines changed

3 files changed

+99
-4
lines changed

src/sha3/sections/05-capabilities.adoc

Lines changed: 21 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ The following grid outlines which properties are *REQUIRED*, as well as all the
4848
| SHAKE-256| FIPS202 | | | {"Min": 16, "Max": 65536, "Inc": any}| | {"Min": 0, "Max": 65536, "Inc": 8} |
4949
|===
5050

51-
The following is a example JSON object advertising support for SHA3-256 for testing revision 1.0.
51+
The following is a example JSON object advertising support for SHA3-256 for testing revision v1.0.
5252

5353
[source, json]
5454
----
@@ -62,6 +62,26 @@ The following is a example JSON object advertising support for SHA3-256 for test
6262
}
6363
----
6464

65+
The following is an example JSON object advertising support for SHAKE-128 v1.0.
66+
67+
[source, json]
68+
----
69+
{
70+
"algorithm": "SHAKE-128",
71+
"revision": "1.0",
72+
"mode": null,
73+
"inBit": true,
74+
"inEmpty": true,
75+
"outBit": true,
76+
"outputLen": [
77+
{
78+
"min": 16,
79+
"max": 1024
80+
}
81+
]
82+
}
83+
----
84+
6585
The following is an example JSON object advertising support for SHAKE-128 FIPS202.
6686

6787
[source, json]

src/sha3/sections/06-test-vectors.adoc

Lines changed: 41 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -97,7 +97,7 @@ The following are example JSON objects for secure hash test vectors sent from th
9797
]
9898
----
9999

100-
The following is an example JSON object for SHAKE v1.0.
100+
The following is an example JSON object for SHAKE-128 v1.0.
101101

102102
[source, json]
103103
----
@@ -158,3 +158,43 @@ The following is an example JSON object for SHAKE v1.0.
158158
}
159159
]
160160
----
161+
162+
The following is an example JSON object for SHAKE-128 FIPS202.
163+
164+
[source, json]
165+
----
166+
[
167+
{ "acvVersion": <acvp-version> },
168+
{
169+
"vsId": 12345,
170+
"algorithm": "SHAKE-128",
171+
"revision": "FIPS202",
172+
"testGroups": [
173+
{
174+
"tgId": 1,
175+
"testType": "AFT",
176+
"tests": [
177+
{
178+
"tcId": 1,
179+
"msg": "3D955AA590240623A3BFCA54D8...",
180+
"len": 31352,
181+
"outLen": 504
182+
},
183+
{
184+
"tcId": 2,
185+
"msg": "AD2E9023C60D916A51DD73E75D...",
186+
"len": 208,
187+
"outLen": 360
188+
},
189+
{
190+
"tcId": 3,
191+
"msg": "418130A5678E5D1773...",
192+
"len": 1104,
193+
"outLen": 408
194+
}
195+
]
196+
}
197+
]
198+
}
199+
]
200+
----

src/sha3/sections/07-responses.adoc

Lines changed: 37 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ The following table describes the JSON elements for each test case object.
3535

3636
| tcId| Numeric identifier for the test case, unique across the entire vector set.| integer
3737
| md| The IUT's digest response to a VOT, AFT or LDT| string (hex)
38-
| resultsArray| Array of JSON objects that represent each iteration of a Monte Carlo Test. Each iteration will contain the msg and md (and outLen for SHAKE-128 and SHAKE-256)| array of objects containing the md (and potentially outLen)
38+
| resultsArray| Array of JSON objects that represent each iteration of a Monte Carlo Test. Each iteration will contain the msg and md (and outLen for SHAKE-128 v1.0 and SHAKE-256 v1.0)| array of objects containing the md (and potentially outLen)
3939
|===
4040

4141
NOTE: The 'tcId' *MUST* be included in every test case object sent between the client and the server.
@@ -148,7 +148,7 @@ The following is an example JSON object response for SHAKE-128 v1.0. The group i
148148
[source, json]
149149
----
150150
{
151-
"vsId": 0,
151+
"vsId": 12345,
152152
"algorithm": "SHAKE-128",
153153
"revision": "1.0",
154154
"testGroups": [
@@ -199,3 +199,38 @@ The following is an example JSON object response for SHAKE-128 v1.0. The group i
199199
]
200200
}
201201
----
202+
203+
The following is an example JSON object response for SHAKE-128 FIPS202. The group identified by tgId 1 is a group of AFTs.
204+
205+
[source, json]
206+
----
207+
{
208+
"vsId": 12345,
209+
"algorithm": "SHAKE-128",
210+
"revision": "FIPS202",
211+
"testGroups": [
212+
{
213+
"tgId": 1,
214+
"tests": [
215+
{
216+
"tcId": 1,
217+
"md": "1991649A5A7766AC93F2C665186C..."
218+
},
219+
{
220+
"tcId": 2,
221+
"md": "32C4F0A828FE7704B37FD92EBD34..."
222+
},
223+
{
224+
"tcId": 3,
225+
"md": "0386A3F546FC3DD4958D0B1..."
226+
},
227+
{
228+
"tcId": 4,
229+
"md": "0942D03460462EFC1A5F0A229D1..."
230+
}
231+
]
232+
}
233+
]
234+
}
235+
----
236+

0 commit comments

Comments
 (0)