File tree Expand file tree Collapse file tree 1 file changed +19
-0
lines changed Expand file tree Collapse file tree 1 file changed +19
-0
lines changed Original file line number Diff line number Diff line change @@ -9,6 +9,25 @@ Test vectors are maintained as JSON test vector data, with accompanying
9
9
[ JSON schema] ( https://json-schema.org/docs ) files that document the structure
10
10
of the test vector data.
11
11
12
+ ## Getting started
13
+
14
+ 1 . Clone this repository. You may also want to integrate Wycheproof as a Git
15
+ submodule or otherwise set up automation to keep track of changes over time.
16
+ 2 . Write (_ or generate from the JSON schema files_ ) code to load the vector data
17
+ as appropriate for your implementation language/project.
18
+ 3 . For each algorithm of interest, identify the inputs to your cryptography
19
+ APIs, and the produced outputs, mapping back to what the test vectors
20
+ provide.
21
+ 4 . Iterate through applicable test vectors, ensuring that the results
22
+ produced by your API when given the relevant input data matches the test
23
+ vector expected results.
24
+ 5 . For best results, integrate this process into your continuous integration
25
+ (CI) process so tests are run for all new contributions/changes.
26
+
27
+ You may find it helpful to examine how other projects like
28
+ [ pyca/cryptography] ( https://github.com/pyca/cryptography ) have
29
+ [ integrated Wycheproof's test vectors] ( https://github.com/pyca/cryptography/tree/ec689a96c98037fc9929e830f551a85cac3973d3/tests/wycheproof ) .
30
+
12
31
## Coverage
13
32
14
33
Project Wycheproof has test vectors for the most popular crypto algorithms,
You can’t perform that action at this time.
0 commit comments