AsterionDocumentation v0.4.1

Certificates

Tables of the area Certificates and their relations
Certificates: tables and foreign keys. Dashed lines lead to tables of other areas.

certificates

Every certificate once, by SHA-256: PEM, subject, issuer, SAN names, validity, key and signature algorithm.

17 columns
ColumnTypeNullDefaultReferences
id PKbigint(20) unsigned
sha256 uniquevarchar(64)
common_namevarchar(255)yes
subjecttextyes
issuervarchar(255)yes
sanslongtextyes
wildcardtinyint(1)0
serialvarchar(100)yes
keyvarchar(50)yes
signature_algorithmvarchar(50)yes
not_beforetimestampyes
not_aftertimestampyes
pemtextyes
first_seen_attimestampyes
last_seen_attimestampyes
created_attimestampyes
updated_attimestampyes

Indexes: sha256 (unique)

certificate_observations

Which certificate an endpoint (host, address, port, SNI name, STARTTLS protocol) serves, seen by which satellite, with trust and revocation status.

15 columns
ColumnTypeNullDefaultReferences
id PKbigint(20) unsigned
tenant_idbigint(20) unsignedtenants on delete cascade
certificate_idbigint(20) unsignedcertificates on delete cascade
host_idbigint(20) unsignedyeshosts on delete cascade
domain_idbigint(20) unsignedyesdomains on delete cascade
satellite_idbigint(20) unsignedyessatellites on delete set null
endpointvarchar(255)
portint(10) unsigned
snivarchar(255)
protocolvarchar(8)tls
statuslongtextyes
first_seen_attimestampyes
last_seen_attimestampyes
created_attimestampyes
updated_attimestampyes

Indexes: certificate_id · domain_id · host_id · satellite_id · tenant_id, endpoint, sni, satellite_id (unique)

certificate_changes

An endpoint started serving another certificate (notification cert.changed).

9 columns
ColumnTypeNullDefaultReferences
id PKbigint(20) unsigned
tenant_idbigint(20) unsignedtenants on delete cascade
host_idbigint(20) unsignedyeshosts on delete cascade
satellite_idbigint(20) unsignedyessatellites on delete set null
endpointvarchar(255)
snivarchar(255)
old_certificate_idbigint(20) unsignedyescertificates on delete set null
new_certificate_idbigint(20) unsignedyescertificates on delete set null
detected_attimestamp

Indexes: host_id, detected_at · new_certificate_id · old_certificate_id · satellite_id · tenant_id

ct_entries

Certificates found in Certificate Transparency logs for a monitored domain. The first poll is the baseline.

13 columns
ColumnTypeNullDefaultReferences
id PKbigint(20) unsigned
tenant_idbigint(20) unsignedtenants on delete cascade
domain_idbigint(20) unsigneddomains on delete cascade
serialvarchar(128)
log_idbigint(20) unsignedyes
issuervarchar(500)yes
common_namevarchar(255)yes
nameslongtextyes
not_beforetimestampyes
not_aftertimestampyes
logged_attimestampyes
first_seen_attimestampyes
baselinetinyint(1)0

Indexes: domain_id, serial (unique) · tenant_id, first_seen_at