letstool/http2cert

By letstool

Updated about 2 months ago

Fast & lightweight HTTP gateway that serves X.509 certificate inspection as a JSON REST API.

Image
Networking
API management
Web servers
0

7.3K

letstool/http2cert repository overview

http2cert

Lightweight HTTP gateway that inspects X.509 certificates through a JSON REST API. Send a POST /api/v1/certinfo request with a hostname or raw certificate bytes, get the full parsed certificate chain back as structured JSON — equivalent to openssl x509 -noout -text.

Supports live TLS socket inspection (dial by hostname, IPv4, or IPv6) and raw PEM/DER parsing (single certificate or full chain). Returns fingerprints (SHA-1, SHA-256, SHA-512), validity status, Subject/Issuer DN, public key details, and all X.509 v3 extensions.

The binary embeds a web UI (dark/light mode) and an OpenAPI 3.1 spec — no external files, no runtime dependencies.

Quick start

docker run -p 8080:8080 letstool/http2cert:latest

Open http://localhost:8080 to use the web UI, or query the API directly:

curl -s -X POST http://localhost:8080/api/v1/certinfo \
  -H "Content-Type: application/json" \
  -d '{"socket": "example.com:443"}' | jq

To inspect a raw PEM certificate:

curl -s -X POST http://localhost:8080/api/v1/certinfo \
  -H "Content-Type: application/json" \
  -d "{\"raw_cert_data\": \"$(cat cert.pem)\"}" | jq

Configuration

CLI flagEnvironment variableDefault
-addrLISTEN_ADDR127.0.0.1:8080
-timeoutDIAL_TIMEOUT10s
-jsonLOG_JSONfalse

CLI flags take priority over environment variables.

docker run -p 9090:9090 \
  -e LISTEN_ADDR=0.0.0.0:9090 \
  -e DIAL_TIMEOUT=30s \
  -e LOG_JSON=true \
  letstool/http2cert:latest

Repo

https://github.com/letstool/http2cert


License

This project is licensed under the Apache License, Version 2.0.

Copyright (c) 2026 letstool.net

See also

ProjectGitHubDocker HubDescription
http2dnsletstool/http2dnsletstool/http2dnsFast & lightweight HTTP gateway that serves DNS queries as a JSON REST API
http2whoisletstool/http2whoisletstool/http2whoisFast & lightweight HTTP gateway that serves WHOIS queries as a JSON REST API
http2rdapletstool/http2rdapletstool/http2rdapFast & lightweight HTTP gateway that serves RDAP queries as a JSON REST API
http2geoipletstool/http2geoipletstool/http2geoipFast & lightweight HTTP gateway that serves IP geolocation database as a JSON REST API
http2certletstool/http2certletstool/http2certFast & lightweight HTTP gateway that serves X.509 certificate inspection as a JSON REST API
http2torletstool/http2torletstool/http2torFast & lightweight HTTP gateway that serves Tor IP database as a JSON REST API
http2sunletstool/http2sunletstool/http2sunFast & lightweight HTTP gateway that serves solar position algorithm as a JSON REST API
http2macletstool/http2macletstool/http2macFast & lightweight HTTP gateway that serves MAC address OUI database as a JSON REST API
http2countryletstool/http2countryletstool/http2countryFast & lightweight HTTP gateway that serves country database as a JSON REST API
http2prefixletstool/http2prefixletstool/http2prefixFast & lightweight HTTP gateway that serves Internet BGP routing database as a JSON REST API
http2registryletstool/http2registryletstool/http2registryFast & lightweight HTTP gateway that serves RIR/NIR Internet registry database as a JSON REST API

Tag summary

Content type

Image

Digest

sha256:5f9f21620

Size

2.6 MB

Last updated

about 2 months ago

docker pull letstool/http2cert