Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Desired properties of V4 format artifact file #112

Open
johngray-dev opened this issue May 7, 2024 · 5 comments
Open

Desired properties of V4 format artifact file #112

johngray-dev opened this issue May 7, 2024 · 5 comments

Comments

@johngray-dev
Copy link
Collaborator

As per #111 the next artifact version file should have the following properties

  • Use only the latest OIDs so it is not encumbered by many of the older formats
  • Use DER encoding so that PEM encoding issues get eliminated.
@johngray-dev
Copy link
Collaborator Author

  • Discussion of adding private keys to the format in the June meeting. Especially with some cases with seeds and such.

@johngray-dev
Copy link
Collaborator Author

Specify the list of OIDS to be used in each artifact format.

@johngray-dev
Copy link
Collaborator Author

Also add a friendly Name so its easy to identify which algorithm it is.

@johngray-dev
Copy link
Collaborator Author

Certificates - artifacts_certs_r4.zip

Starting with artifacts for the NIST standards released 2024-08-13, we will use a much simpler artifact format:

  • Only produce a self-signed certificate (TAs).
  • We will restrict the R4 artifacts to only the algorithms with NIST standards.
  • Use DER Encoding format (so that PEM encoding doesn't cause issues)
  • Use a flat folder structure with filenames -_ta.pem
  • For ML-KEM, use the the ML-DSA TA of the equivalent security level to sign a <ML-KEM_oid>_ee.pem
  • For hybrid certificate formats, name the file <hybrid_format>_<oid1>_with_<oid2>_ta.pem

Within providers/<provider_name>/[implementation_name/]

  • artifacts_certs_r4.zip
    • <algname>-<oid>_ta.pem # self-signed cert for signature alg oids
    • <algname>-<oid>_ee.pem # ex.: ML-KEM-512 - signed with ML-DSA-44
    • <hybrid_format>_<oid1>_with_<oid2>_ta.pem # ex.: catalyst_1.2.840.10045.4.3.2_with_1.3.6.1.4.1.2.267.12.4.4_ta.pem

The KEM end entity certificate can be used to validate encrypted artifacts in either the CMS or CMP artifacts zips.

@johngray-dev
Copy link
Collaborator Author

Added V4 format into the main readme and deprecated the older V3 and V2 formats. The automation will need to be updated to read V4 format files now. 1caea6e

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant