Notary Project Specifications

August 3, 2023 ยท View on GitHub

This repository is in active maintenance and contains specifications shared across repositories under Notary Project as well as used by other open source projects and/or vendor tools that want to interoperate with Notary Project tooling.

Please see the Notary Project README file to learn about overall Notary Project.

In this README

Folder Structure

Folder NameDescription
mediaMedia files referenced by documents in this repository
requirementsRequirements for Notary Project
securityNotary Project security related documents and reports
specsNotary Project specifications
status-updatesThis folder is not in active maintenance and contains status updates report for Notary Project
threatmodelsThreat models for repositories under Notary Project

Requirements

File NameDescription
definitions-terms.mdA collection of definitions and terms used within this repository
key-revocation.mdRequirements and proposals for key revocation
keymanagementrequirements.mdRequirements for key management
requirements.mdA collection of requirements and scenarios for Notary Project
scenarios.mdNotary Project signing scenarios
verification-by-reference.mdRequirement of verification by reference

Security Documents

File NameDescription
ADA-notation-security-audit-23.pdfSecurity audit report in 2023 covering notation, notation-go, and notation-core-go repositories
ADA-fuzzing-audit-22-23.pdfFuzz testing audit in 2023 covering notary, notation-go, and notation-core-go repositories

Specifications

File NameDescription
plugin-extensibility.mdNotation Plugin specification
signature-envelope-cose.mdNotary Project OCI COSE signature envelope
signature-envelope-jws.mdNotary Project OCI JWS signature envelope
signature-specification.mdNotary Project OCI signature specification
signing-and-verification-workflow.mdNotary Project OCI signing and verification workflow
signing-scheme.mdNotary Project signing scheme
trust-store-trust-policy.mdNotary Project Trust Store and Trust Policy

Threat Models

File NameDescription
notation-threatmodel.mdThreat models for Notation CLI

Community

If you have any questions about Notary Project or contributing, do not hesitate to file an issue on relevant repository or contact the Notary Project maintainers and community members via the following channels: