Verify TLS certificates using different network perspectives
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
nervuri 5e91fe65e7 minor changes in 4 months ago
LICENSE init 4 months ago minor changes in 4 months ago
trust-seeker response: include fingerprint in base64 format 4 months ago

Trust Seeker

Verify TLS certificates using different network perspectives.

Trust Seeker is a certificate pinning program that can be run privately, on the command line, or publicly, as a server-side CGI script. Each public trust seeker can be asked what certificate it sees for a certain host. Client software can query multiple trust seekers, to check for consensus.

It aims to bring as much relevant information as possible to bear on any trust decision. This includes the TLS version and cipher suite, to help defend against downgrade attacks.


trust-seeker --ask \
    --verify \
    --fingerprint sha256:1234567890123456789012345678901234567890123456789012345678901234

# Response:


Trust Seeker mixes ideas from:

It can verify TLS certificates on any host and port, regardless of the protocol underneath: HTTP, DNS (DoT and DoH), e-mail (SMTP, IMAP, POP3), IRC, FTP, Gemini, Gopher, etc.

SSH and STARTTLS support are on the roadmap.

Trust Seeker can be used with command line tools that support public key pinning, such as curl and wget, to protect every connection they make. For instance, this is how it can be used with curl to verify a self-signed certificate based on's network perspective:

# ask about
response=$(trust-seeker --ask \

# get certificate's public key (SubjectPublicKeyInfo)
spki=$(echo "$response" | grep 'fingerprint_base64=sha256:' | cut -d ':' -f 2)

# get minimum TLS version
tlsv=$(echo "$response" | grep 'tls_version=' | cut -d '=' -f 2)

# run curl with key pinning instead of CA validation
curl -k --pinnedpubkey "sha256//$spki" "--tlsv$tlsv"

The holy grail is to enable this kind of dynamic key pinning for e-mail server-to-server communication, which generally relies on opportunistic encryption.

Current status

The code is in an early exploratory stage. You can experiment with it, but big changes are planned and there is no regard for backward compatibility at this point.


The project is hosted at Just shoot me an email if you don't want to make a tildegit account.