Skip to content

Latest commit

 

History

History
19 lines (11 loc) · 1.47 KB

CONTRIBUTING.md

File metadata and controls

19 lines (11 loc) · 1.47 KB

Guidelines

General

Building the source code can be done with cargo. Having OpenSSL installed on your system may also be required but that comes bundled with most Unix operating systems.

Test certificates are stored using Git Large File Storage so that might be required if you're going to be interacting with any of those.

Contributing Test Cases for Validating X.509 Certificates

The easiest way to contribute test cases is to run the Python generate_certificates.py script and file a pull request with the changes if it was able to generate new test certificates that were not already present in the repository.

Additionally, run the following command where the input is the newly generated certificate. The error message will contain an object identifier which will be used to identify the primitives used in the certificate where $new_certificate represents the newly generated certificate.

wardstone x509 --guide bsi --path ./crates/cmd/src/testing/certificates/$new_certificate

This should be enough but if you want to go further, you can lookup the object identifier in a registry such as the Object Identifier (OID) Repository and update the tables in certificate.rs along with the instances in the core crate.