Skip to content

Commit 38afffb

Browse files
committed
update readme
1 parent 3010c7e commit 38afffb

File tree

1 file changed

+18
-11
lines changed

1 file changed

+18
-11
lines changed

readme.md

Lines changed: 18 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -154,13 +154,13 @@ Within `providers/<provider_name>/[implementation_name/]`
154154
- artifacts_cms_v3.zip
155155
- `artifacts_cms_v3/` subfolder which will contain the artifacts
156156
- `artifacts_cms_v3/expected_plaintext.txt` # The message which was encrypted and can be compared against the decrypted artifacts.
157-
- `artifacts_cms_v3/ukm.txt` # The User Keying Material (UKM) included in some of the enveloped messages.
158157
- `artifacts_cms_v3/ta.der` # ML-DSA-44 trust anchor used to sign the end-entity certificates.
159158
- `artifacts_cms_v3/<friendly>-<oid>_ee.der` # The KEM certificate that the message is enveloped to.
160-
- `artifacts_cms_v3/<friendly>-<oid>_both_priv.der` # The private KEM key to decrypt the enveloped messages.
159+
- `artifacts_cms_v3/<friendly>-<oid>_priv.der` # The private KEM key to decrypt the enveloped messages.
161160
- `artifacts_cms_v3/<friendly>-<oid>_kemri_ukm.der` # An Enveloped artifact using KEMRI’s UKM field and one of the MTI KDFs for the KEM algorithm.
162161
- `artifacts_cms_v3/<friendly>-<oid>_kemri_auth.der` # An AuthEnveloped artifact using KEMRI without UKM and one of the MTI KDFs for the KEM algorithm.
163162
- `artifacts_cms_v3/<friendly>-<oid>_kemri_<kdf>.der` # Enveloped artifacts using KEMRI without UKM, and the specified KDF. Implementations must provide artifacts for each of the MTI KDFs for the OID, and may provide artifacts for other KDFs.
163+
- `artifacts_cms_v3/<friendly>-<oid>_kemri_auth_<kdf>.der` # An AuthEnveloped artifact using KEMRI without UKM and the specified KDF.
164164
- `artifacts_cms_v3/<friendly>-<oid>_signed_attrs.der` # Signed artifact, with attached content and signed attributes.
165165

166166
#### Friendly
@@ -169,7 +169,7 @@ Per https://github.com/IETF-Hackathon/pqc-certificates/issues/96 we would like a
169169

170170
#### Trust Anchor
171171

172-
A trust anchor isn't necessary to verify the KEMRecipientInfo artifacts, but some implementations may find it useful. We're using dilithium2 at the moment since some might not have implemented ML-DSA.ipd.
172+
A trust anchor isn't necessary to verify the KEMRecipientInfo artifacts, but some implementations may find it useful. We're using ML-DSA-44.
173173

174174
#### DER vs PEM
175175

@@ -188,14 +188,21 @@ Each RFC will specify mandatory KDFs, and probably allow for others as well. You
188188
| I-D/RFC | Algorithm | MTI KDF | `<kdf> string` |
189189
| - | - | - | - |
190190
| rfc5990bis | RSA-KEM | KDF3 w/ SHA-256 | id-kdf-kdf3 |
191-
| cms-kyber | ML-KEM-512 | KMAC128-KDF\* | id-kmac128\* |
192-
| cms-kyber | ML-KEM-768 | KMAC256-KDF\* | id-kmac256\* |
193-
| cms-kyber | ML-KEM-1024 | KMAC256-KDF\* | id-kmac256\* |
194-
| - | kyber512 | KMAC256-KDF\* | id-kmac128\* |
195-
| - | kyber768 | KMAC256-KDF\* | id-kmac256\* |
196-
| - | kyber1024 | KMAC256-KDF\* | id-kmac256\* |
197-
198-
\* The MTI artifacts were updated to KMAC-based KDFs in draft-ietf-lamps-cms-kyber-03.
191+
| cms-kyber | ML-KEM-512 | HKDF with SHA256 | id-alg-hkdf-with-sha256 |
192+
| cms-kyber | ML-KEM-768 | HKDF with SHA256 | id-alg-hkdf-with-sha256 |
193+
| cms-kyber | ML-KEM-1024 | HKDF with SHA256 | id-alg-hkdf-with-sha256 |
194+
| TBD | id-MLKEM768-RSA2048-SHA3-256 | KMAC256-KDF | id-kmac256 |
195+
| TBD | id-MLKEM768-RSA3072-SHA3-256 | KMAC256-KDF | id-kmac256 |
196+
| TBD | id-MLKEM768-RSA4096-SHA3-256 | KMAC256-KDF | id-kmac256 |
197+
| TBD | id-MLKEM768-X25519-SHA3-256 | KMAC256-KDF | id-kmac256 |
198+
| TBD | id-MLKEM768-ECDH-P256-SHA3-256 | KMAC256-KDF | id-kmac256 |
199+
| TBD | id-MLKEM768-ECDH-P384-SHA3-256 | KMAC256-KDF | id-kmac256 |
200+
| TBD | id-MLKEM768-ECDH-brainpoolP256r1-SHA3-256 | KMAC256-KDF | id-kmac256 |
201+
| TBD | id-MLKEM1024-RSA3072-SHA3-256 | KMAC256-KDF | id-kmac256 |
202+
| TBD | id-MLKEM1024-ECDH-P384-SHA3-256 | KMAC256-KDF | id-kmac256 |
203+
| TBD | id-MLKEM1024-ECDH-brainpoolP384r1-SHA3-256 | KMAC256-KDF | id-kmac256 |
204+
| TBD | id-MLKEM1024-X448-SHA3-256 | KMAC256-KDF | id-kmac256 |
205+
| TBD | id-MLKEM1024-ECDH-P521-SHA3-256 | KMAC256-KDF | id-kmac256 |
199206

200207
### CMP -- artifacts_cmp.zip
201208

0 commit comments

Comments
 (0)