1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
|
#!/usr/bin/env python
# Copyright 2025 The OpenSSL Project Authors. All Rights Reserved.
#
# Licensed under the Apache License 2.0 (the "License"). You may not use
# this file except in compliance with the License. You can obtain a copy
# in the file LICENSE in the source distribution or at
# https://www.openssl.org/source/license.html
# A python program written to parse (version 42) of the ACVP test vectors for
# ML_DSA. The 3 files that can be processed by this utility can be downloaded
# from
# https://github.com/usnistgov/ACVP-Server/blob/master/gen-val/json-files/ML-DSA-keyGen-FIPS204/internalProjection.json
# https://github.com/usnistgov/ACVP-Server/blob/master/gen-val/json-files/ML-DSA-sigGen-FIPS204/internalProjection.json
# https://github.com/usnistgov/ACVP-Server/blob/master/gen-val/json-files/ML-DSA-sigVer-FIPS204/internalProjection.json
# and output from this utility to
# test/recipes/30-test_evp_data/evppkey_ml_dsa_keygen.txt
# test/recipes/30-test_evp_data/evppkey_ml_dsa_siggen.txt
# test/recipes/30-test_evp_data/evppkey_ml_dsa_sigver.txt
#
# e.g. python3 mldsa_parse.py ~/Downloads/keygen.json > ./test/recipes/30-test_evp_data/evppkey_ml_dsa_keygen.txt
#
import json
import argparse
import datetime
def print_label(label, value):
print(label + " = " + value)
def print_hexlabel(label, tag, value):
print(label + " = hex" + tag + ":" + value)
def parse_ml_dsa_key_gen(groups):
for grp in groups:
for tst in grp['tests']:
print("");
print_label("FIPSversion", ">=3.5.0")
print_label("KeyGen", grp['parameterSet'])
print_label("KeyName", "tcId" + str(tst['tcId']))
print_hexlabel("Ctrl", "seed", tst['seed'])
print_hexlabel("CtrlOut", "pub", tst['pk'])
print_hexlabel("CtrlOut", "priv", tst['sk'])
def parse_ml_dsa_sig_gen(groups):
for grp in groups:
deter = grp['deterministic'] # Boolean
externalMu = grp['externalMu'] # Boolean
signInterfaceExternal = (grp['signatureInterface'] == "External")
signPreHash = (grp['preHash'] == "preHash")
signPure = (grp['preHash'] == "pure")
includeMu = True # Flag flips to only include the Ctrl mu:0 half the time
if signPreHash:
continue
if not externalMu and not signPure:
continue
name = grp['parameterSet'].replace('-', '_')
for tst in grp['tests']:
testname = name + "_" + str(tst['tcId'])
print("");
print_label("PrivateKeyRaw", testname + ":" + grp['parameterSet'] + ":" + tst['sk'])
print("");
print_label("FIPSversion", ">=3.5.0")
print_label("Sign-Message", grp['parameterSet'] + ":" + testname)
print_label("Input", tst['mu' if externalMu else 'message'])
print_label("Output", tst['signature'])
print_label("Ctrl", "message-encoding:1")
if not externalMu:
print_label("Ctrl", "hexcontext-string:" + tst["context"])
includeMu = not includeMu
if externalMu or includeMu:
print_label("Ctrl", "mu:" + ("1" if externalMu else "0"))
print_label("Ctrl", "deterministic:" + ("1" if deter else "0"))
if not deter:
print_label("Ctrl", "hextest-entropy:" + tst["rnd"])
def parse_ml_dsa_sig_ver(groups):
for grp in groups:
externalMu = grp["externalMu"] # Boolean
signInterfaceExternal = (grp['signatureInterface'] == "External")
signPreHash = (grp['preHash'] == "preHash")
signPure = (grp['preHash'] == "pure")
includeMu = True # Flag flips to only include the Ctrl mu:0 half the time
if signPreHash:
continue
if not externalMu and not signPure:
continue
name = grp['parameterSet'].replace('-', '_')
for tst in grp['tests']:
testname = name + "_" + str(tst['tcId'])
print("");
print_label("PublicKeyRaw", testname + ":" + grp['parameterSet'] + ":" + tst['pk'])
print("");
if "reason" in tst:
print("# " + tst['reason'])
print_label("FIPSversion", ">=3.5.0")
print_label("Verify-Message-Public", grp['parameterSet'] + ":" + testname)
print_label("Input", tst['mu' if externalMu else 'message'])
print_label("Output", tst['signature'])
print_label("Ctrl", "message-encoding:1")
if not externalMu:
print_label("Ctrl", "hexcontext-string:" + tst["context"])
includeMu = not includeMu
if externalMu or includeMu:
print_label("Ctrl", "mu:" + ("1" if externalMu else "0"))
if not tst['testPassed']:
print_label("Result", "VERIFY_ERROR")
parser = argparse.ArgumentParser(description="")
parser.add_argument('filename', type=str)
args = parser.parse_args()
# Open and read the JSON file
with open(args.filename, 'r') as file:
data = json.load(file)
year = datetime.date.today().year
version = data['vsId']
algorithm = data['algorithm']
mode = data['mode']
print("# Copyright " + str(year) + " The OpenSSL Project Authors. All Rights Reserved.")
print("#")
print("# Licensed under the Apache License 2.0 (the \"License\"). You may not use")
print("# this file except in compliance with the License. You can obtain a copy")
print("# in the file LICENSE in the source distribution or at")
print("# https://www.openssl.org/source/license.html\n")
print("# ACVP test data for " + algorithm + " " + mode + " generated from")
print("# https://github.com/usnistgov/ACVP-Server/blob/master/gen-val/json-files/"
"ML-DSA-" + mode + "-FIPS204/internalProjection.json")
print("# [version " + str(version) + "]")
if algorithm == "ML-DSA":
if mode == 'sigVer':
parse_ml_dsa_sig_ver(data['testGroups'])
elif mode == 'sigGen':
parse_ml_dsa_sig_gen(data['testGroups'])
elif mode == 'keyGen':
parse_ml_dsa_key_gen(data['testGroups'])
else:
print("Unsupported mode " + mode)
else:
print("Unsupported algorithm " + algorithm)
|
