CA/Bug Triage
Contents
- 1 CA Program Bugzilla Dashboards
- 2 Bug Triage in Mozilla's CA Certificate Program
- 3 Compliance Problems and Incidents
- 4 Root Inclusion/Change requests and EV Treatment Enablement Requests
- 5 CA Audit Statement Bugs
- 6 CA Program Process or Policy Related Bugs
- 7 Certificate Revocation Related Bugs
- 8 Common CA Database (CCADB)
CA Program Bugzilla Dashboards
- CA Inclusion/Update Requests: https://wiki.mozilla.org/CA/Dashboard
- CA Compliance Bugs: https://wiki.mozilla.org/CA/Incident_Dashboard
- Common CA Database (CCADB) Bugs: https://wiki.mozilla.org/CA/CCADB_Dashboard
Bug Triage in Mozilla's CA Certificate Program
Mozilla’s CA Certificate Program governs inclusion of root certificates in Network Security Services (NSS), a set of open source libraries designed to support cross-platform development of security-enabled client and server applications. The NSS root certificate store is not only used in Mozilla products such as the Firefox browser, but is also used by other companies in a variety of products.
The Bugzilla products/components related to the CA Certificate Program are:
- CA Program :: CA Certificate Compliance - Problems found in certificates issued by Certificate Authorities included in the default certificate store.
- Concerns that are raised about certificates being issued by CAs, and the resulting action items for the CAs.
- CA Program :: CA Certificate Root Program - For Certificate Authorities to file requests asking for their certificates to be included in the default certificate store.
- Root inclusion/change requests. When approved, the actual code changes are requested via a new Bugzilla Bug in NSS :: CA Certificates Code.
- EV treatment enablement requests. When approved, the actual code changes are requested via a new Bugzilla Bug for PSM.
- CA Program-related concerns or action items.
- Requests to add certs to OneCRL.
- CA Program :: CA Documents - For CA audit statements, when they are not on the auditor's website.
- CA Program :: Common CA Database - For requesting updates to the Common CA Database (CCADB).
- NSS :: CA Certificates Code - For actual code changes to NSS. Kathleen should be the only person filing these bugs on behalf of the CA Program.
The CA Certificate Program deviates from Mozilla's standardized Bugzilla Bug Triage process for bug priorities (P1, P2, P3, P4, P5). Priorities are not used for CA compliance bugs because they do not directly include code changes to Mozilla's release trains or iterations. Priorities are used, however, for tracking CCADB enhancements and for prioritizing root inclusion requests. See https://wiki.mozilla.org/CA/Prioritization.
Compliance Problems and Incidents
To report a concern about certificates being issued by a CA in Mozilla's Program, or their audit statements:
If the bug concerns CA certificate issuance, then the bug summary should begin with the CA name (followed by a colon and then a space), so that sorting the bugs by Summary will sort the bugs by CA.
Open CA Compliance bugs: https://wiki.mozilla.org/CA/Incident_Dashboard
If the bug concerns audit statements not containing expected information, then the bug summary should begin with auditor's name, so that sorting the bugs by Summary will sort the bugs by auditor name.
Open Auditor Compliance bugs: https://wiki.mozilla.org/CA/Auditor_Compliance
The whiteboard tags for CA Program :: CA Certificate Compliance include:
- [ca-compliance] -- For concerns about a CA's certificates failing to comply with Mozilla's CA Certificate Policy and/or the CA/Browser Forum's Baseline Requirements, and it is not considered to be an imminent security concern.
- [auditor-compliance] -- For concerns about an auditor failing to properly detect and report on CA compliance issues that occurred during one or more periods when the CA was audited.
- [ca-revocation-delay] or [leaf-revocation-delay] -- appended after [ca-compliance] whenever a CA fails to abide by the Baseline Requirements' requirement to revoke certificates in a timely fashion.
- [audit-delay] -- appended after [ca-compliance] when a CA is unable to provide audit statements within one year and 3 months of the previous audit period end date.
- [covid-19] -- appended after [ca-compliance], [audit-delay], or [ca-revocation-delay] when delays are due to mandated restrictions regarding COVID-19.
New Whiteboard Tags appended to [ca-compliance] include the following:
- [ca-misissuance] mis-issuance of a CA certificate
- [dv-misissuance] mis-issuance of a DV certificate
- [ov-misissuance] mis-issuance of an OV end-entity certificate
- [ev-misissuance] mis-issuance of an EV end-entity certificate
- [crl-failure] failure to provide certificate status via CRL; malformed, expired CRL
- [ocsp-failure] failure to provide certificate status via OCSP; malformed, expired OCSP
- [policy-failure] failure to update CP/CPS annually, failure to comply with practice in CP/CPS, misunderstanding requirements, failed implementation
- [disclosure-failure] failure to disclose an ICA, failure to report revocation of an ICA, non-disclosure-of-EV-sources, miscommunication, poor communication, etc.
- [audit-failure] failure to perform an audit, failure to upload audits, etc.
Root Inclusion/Change requests and EV Treatment Enablement Requests
A representative of a CA may begin the process of root inclusion, change, or ev-enablement by filing a Bugzilla Bug as described here:
Root Inclusion Requests are prioritized as described here:
The whiteboard tags for CA Program :: CA Certificate Root Program are:
- [ca-initial] -- not enough information to begin the Information Verification phase, or not yet assigned to someone to do the Information Verification
- [ca-verifying] -- in Information Verification phase. This is a high-level review to ensure that all required data has been provided in Bugzilla and the CCADB and that the appropriate tests have been run.
- [ca-ready-for-discussion yyyy-mm-dd] -- Information Verification phase is complete. Ready for public discussion and detailed CP/CPS review.
- [ca-in-discussion] -- in discussion in the CCADB public mailing list.
- [ca-cps-review] -- Detailed Review, which requires that the relevant CP/CPS and audit documents be thoroughly reviewed. As a result of such review(s), the CA may be required to update their CP/CPS to become fully aligned with Mozilla's Root Store Policy.
- [ca-discussion-hold] -- discussion on hold, pending CA actions.
- [ca-hold] -- CA's request is on hold, typically because the CA is a super-CA, so all of their subCAs have to achieve inclusion first.
- [ca-pending-approval] -- final notice of intent to approve the CA's request
- [ca-approved] -- request is approved, pending code changes in NSS, also including certs which are in NSS and pending code changes in PSM
- [ca-denied] -- request was denied. Under normal circumstances the CA may submit a new root inclusion request for a new root certificate that fully complies with Mozilla's Root Store policy.
CA Audit Statement Bugs
- [ca-audits] -- One bug may be created per CA to store audit statements or CP/CPS documents.
- Link to create ca-audit bug
- Make sure the bug has the correct product/component for the CA Certificate Program, which is CA Program :: CA Documents
- Add [ca-audits] to the Whiteboard
- Add Comment: "This bug may continue to be used for uploading audit statements and documents for this CA."
- Close bug as RESOLVED | WORKSFORME
CA Program Process or Policy Related Bugs
- [ca-program] -- bugs related to CA Program process, wiki pages, or policy. Note that most CA Program Policy issues are tracked on Github.
Certificate Revocation Related Bugs
- [ca-onecrl] -- bugs related to updating entries in OneCRL. Under normal circumstances a Bugzilla Bug is not needed for this. Rather, the CA should report the revocation via the Common CA Database.
- OneCRL Entries Generated -- bugs for verifying OneCRL entries before they are pushed to production. These bugs are automatically generated from CCADB for standard revocations of intermediate certificates that are reported by CAs. Otherwise these bugs are generated by manually running the tools for specially requested additions to OneCRL.
Common CA Database (CCADB)
- [ccadb-api] -- for requesting API access to the CCADB as per https://github.com/mozilla/CCADB-Tools/tree/master/API_AddUpdateIntermediateCert
- [ccadb-bug] -- for issues or problems using the CCADB.
- [ccadb-enhancement] -- for requesting minor updates to the CCADB, such as adding sections or fields to pages for root store members.
- [ccadb-roadmap] -- for tracking large updates to the CCADB, which are prioritized by the CCADB Council in the CCADB Roadmap.
The Priority field is used for Common CA Database bugs as follows:
- P1 - In Progress and being actively worked on
- P2 - Needs to be started soon
- P3 - Ongoing project that is being done as time permits
- P4 - To be scheduled for work later