ctloglists

README

ctloglists

Tracker for CT Log Lists and logs' Accepted Roots

Features

• Bundles and parses the following CT Log Lists:

  • For Server Authentication Certificates:
    • Chrome all_logs_list.json
    • Apple current_log_list.json
    • Mozilla Known CT Logs
  • For Mark Certificates:
    • BIMIGroup Approved CT Logs (see Appendix F).
  • Also:
    • crt.sh logs.json?include=all
    • Chrome "log mimics"

• Bundles and parses logs' Accepted Roots.

• Automated handling of Log List updates and Accepted Roots updates, via GitHub Actions.

Versioning

The latest Log Lists and Accepted Roots are fetched hourly by a GitHub Action. Any changes are automatically committed. If one or more Log Lists have been updated, a Release is tagged using a Scalable Calendar Versioning format (v1.YYYYMMDD.HHMMSS).

API

LoadLogLists() error

Loads and parses all bundled CT Log Lists.

LoadAcceptedRoots() error

Loads and parses all bundled Accepted Roots data.

OldestTimestampForLogListWithEnforcementCutOff() time.Time

Returns the oldest LogListTimestamp among the supported log lists that are known to have a corresponding 70-day enforcement cut-off (Chrome, Apple, Mozilla). Log lists with an omitted or zero timestamp are ignored.

Exported Variables

Variable	Description
GstaticV3All	Chrome's all_logs_list.json
AppleCurrent	Apple's current_log_list.json
CrtshV3All	crt.sh all logs
CrtshV3Active	crt.sh active logs
MozillaV3Known	Mozilla's known_logs_list.json
BimiV3Approved	BIMI approved_logs_list.json
LogMimics	Chrome log mimics
LogSignatureVerifierMap	Map of log ID → signature verifier
TemporalIntervalMap	Map of log ID → temporal interval
AcceptedRootsMap	Map of roots list hash → PEM cert pool
LogAcceptedRootsMap	Map of log ID → accepted roots list hash

Used by

• ctlint: CT compliance linter.
• ctsubmit: CT submission proxy.

Documentation

Index

• Variables
• func LoadAcceptedRoots() error
• func LoadLogLists() error
• func OldestTimestampForLogListWithEnforcementCutOff() time.Time

Variables

var AcceptedRootsMap map[[sha256.Size]byte]*x509util.PEMCertPool

var GstaticV3All, AppleCurrent, CrtshV3All, CrtshV3Active, MozillaV3Known, BimiV3Approved, LogMimics *loglist3.LogList

var LogAcceptedRootsMap map[[sha256.Size]byte][sha256.Size]byte

var LogSignatureVerifierMap map[[sha256.Size]byte]*ctgo.SignatureVerifier

var TemporalIntervalMap map[[sha256.Size]byte]*loglist3.TemporalInterval

Functions

func LoadAcceptedRoots

func LoadAcceptedRoots() error

func LoadLogLists

func LoadLogLists() error

func OldestTimestampForLogListWithEnforcementCutOff

func OldestTimestampForLogListWithEnforcementCutOff() time.Time

OldestTimestampForLogListWithEnforcementCutOff returns the oldest LogListTimestamp among the supported log lists that are known to have a corresponding 70-day enforcement cut-off.