Skip to content

christian-fei/cert-chain-resolver

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

44 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SSL certificate chain resolver

CircleCI Licence

This shell script downloads all intermediate CA certificates for a given SSL server certificate. It can help you fix the incomplete certificate chain issue, also reported as Extra download by Qualys SSL Server Test.

Dependencies

  • wget
  • OpenSSL

Usage

SSL certificate chain resolver

Usage: ./cert-chain-resolver.sh [OPTION]... [INPUT_FILE]

Read certificate from stdin, or INPUT_FILE if specified. The input certificate can be in either DER or PEM format.
Write certificate bundle to stdout in PEM format, with both leaf and intermediate certificates.

    -d|--der

        output DER format

    -i|--intermediate-only

        output intermediate certificates only, without leaf certificate

    -o|--output OUTPUT_FILE

        write output to OUTPUT_FILE

Example

$ ./cert-chain-resolver.sh -o domain.bundle.pem domain.pem
1: OU=Domain Control Validated, OU=PositiveSSL Wildcard, CN=*.xxx.com
2: C=GB, ST=Greater Manchester, L=Salford, O=COMODO CA Limited, CN=COMODO RSA Domain Validation Secure Server CA
3: C=GB, ST=Greater Manchester, L=Salford, O=COMODO CA Limited, CN=COMODO RSA Certification Authority
Certificate chain complete.
Total 3 certificate(s) found.

Tests

tests/run.sh

Background

Incomplete certificate chain

All operating systems contain a set of default trusted root certificates. But CAs usually don't use their root certificate to sign customer certificates. Instead of they use so called intermediate certificates, because they can be rotated more frequently.

A certificate can contain a special Authority Information Access extension (RFC-3280) with URL to issuer's certificate. Most browsers can use the AIA extension to download missing intermediate certificate to complete the certificate chain. This is the exact meaning of the Extra download message. But some clients (mobile browsers, OpenSSL) don't support this extension, so they report such certificate as untrusted.

A server should always send a complete chain, which means concatenated all certificates from the certificate to the trusted root certificate (exclusive, in this order), to prevent such issues. Note, the trusted root certificate should not be there, as it is already included in the system’s root certificate store.

You should be able to fetch intermediate certificates from the issuer and concat them together by yourself, this script helps you automatize it by looping over certificate's AIA extension field.

Other implementations

Licence

The MIT License (MIT). See LICENCE file for more information. TL;DR

If you use my code in some interesting project, I'd be happy to know about it.

About

SSL certificate chain resolver

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Shell 100.0%