Start from the code or terminal line instead of a screenshot.
Error troubleshooter
Turn an SSL error into the next fix path.
Use this when the team has an error code but not a clear owner. The troubleshooter separates hostname mismatch, expiry, not-yet-valid, untrusted chain, revocation, and handshake failures into actionable evidence.
Troubleshooter workspace
Map an SSL error to the likely fix path
Paste the exact warning or terminal error. This tool does not fetch the certificate; it classifies the symptom, identifies the likely owner, and produces a ticket handoff.
Optional context for the ticket handoff. The diagnosis is driven by the pasted error.
Paste the exact warning text. This classifies the symptom; use the live SSL checker or OpenSSL workbench to verify the endpoint.
The certificate SAN list does not cover the hostname requested by the client, or SNI selected the wrong certificate.
First checks
- Check the SAN list for the exact hostname, including wildcard scope.
- Run an SNI-aware check against the customer hostname, not just the origin.
- Review CDN/load-balancer certificate bindings and default certificate fallback.
Fix path
- Issue or select a certificate that covers the requested hostname.
- Bind the certificate to the exact hostname at the edge or load balancer.
- Re-run with SNI and confirm the serial/fingerprint changed if a new certificate was deployed.
Hostname: api.example.com Observed error: NET::ERR_CERT_COMMON_NAME_INVALID Likely layer: Certificate identity Likely owner: CDN, load balancer, or certificate binding owner Probable cause: The certificate SAN list does not cover the hostname requested by the client, or SNI selected the wrong certificate. First checks: Check the SAN list for the exact hostname, including wildcard scope. | Run an SNI-aware check against the customer hostname, not just the origin. | Review CDN/load-balancer certificate bindings and default certificate fallback. Evidence to capture: Requested hostname, SAN list, SNI hostname, Certificate subject, Edge/origin target
Separate hostname, date, chain, revocation, and handshake failures.
Assign the team that owns the failed layer and evidence.
Use the live checker, decoder, chain checker, or OpenSSL workbench to prove the fix.
Troubleshooting intent
Use this when an SSL error needs an owner.
The troubleshooter focuses on the symptom and the handoff. It turns mismatch, expired, not-yet-valid, untrusted-chain, revocation, and handshake errors into likely owners and concrete first checks.
Start with the error text
Browser and terminal errors usually contain enough signal to route the first investigation. The troubleshooter reads common Chrome, Firefox, OpenSSL, curl, Go, and Node-style messages and maps them to the certificate layer involved.
- Map ERR_CERT_COMMON_NAME_INVALID to SAN and SNI checks.
- Map expired and not-yet-valid messages to the active validity window.
- Map unable to get local issuer certificate to chain and trust-store checks.
Route by owner, not by vague severity
Different SSL errors belong to different teams. Hostname mismatches often belong to edge or load-balancer bindings, expiry belongs to the certificate owner, incomplete chains belong to the installer, and handshake failures often belong to networking or ingress.
- Use the probable owner to route the first ticket.
- Use the first-check list to gather evidence before escalation.
- Use the generated handoff to avoid screenshots without certificate fields.
Confirm with a live or pasted-evidence tool
The troubleshooter explains the likely path, then points to the tool that can confirm it: the public SSL checker, the chain checker, the PEM decoder, or the OpenSSL workbench.
- Run the live checker when the endpoint is public.
- Paste OpenSSL output when the endpoint is private or local.
- Monitor critical hostnames after the fix so validity does not become a one-time check.
Fix the current error, then keep the endpoint watched.
The troubleshooter routes the current symptom. Monitoring keeps checking validity, expiry, and certificate changes before customers report warnings.
What errors can the troubleshooter map?
It maps common browser, OpenSSL, curl, Go, and Node certificate errors for hostname mismatch, expired certificates, not-yet-valid certificates, untrusted or incomplete chains, revocation signals, and TLS handshake failures.
Does this replace a live SSL check?
No. It turns error text into a likely investigation path. Use the live checker, chain checker, PEM decoder, or OpenSSL workbench to confirm the actual certificate evidence.
What should I include in a ticket?
Include the hostname, port, exact error text, likely layer, likely owner, first checks, issuer, SANs, serial number, fingerprint, and verify return code when available.