ocsp-response-linter

README

OCSP Response Linter

OCSP Response Linter is a command line tool for fetching, linting, and verifying OCSP responses.

This is not an officially supported Google product.

Lints and Verifications Sources

We distinguish between lints and verifications as follows:

• A lint is a requirement that can be checked using only the OCSP response (e.g. ensuring that the producedAt date field of a response is no more than four days in the past)
• A verification is a requirement that necessitates querying an outside service and may run while in the process of fetching the OCSP Response (e.g. checking that an OCSP response is delivered in 10 seconds after sending the request)

The lints and verifications implemented come primarily from Apple's OCSP Lints and Test Cases and IETF standards set out in RFC 6960.

Usage

The OCSP Response Linter allows users to specify three different types of input. The first (default) method is to supply server URL(s)

./ocsp_status [url1] [url2] ...

The second method is to supply ASN.1 DER encoded certificate file(s) that should be sent to an OCSP responder. Please note that the certificate must contain an OCSP responder URL and issuer certificate URL or else the tool will not be able to generate the OCSP request.

./ocsp_status -incert [certfile1] [certfile2] ...

The third method is to supply the OCSP response file(s) itself. If this method is chosen, verifications checking to see if fetching the OCSP Response meets IETF standards cannot be run.

./ocsp_status -inresp [respfile1] [respfile2] ...

The OCSP Response Linter will loop through all inputs provided and lint/verify each resulting OCSP response.

A complete table of available flags:

Flag	Description	Example
inresp	Read in OCSP response(s) files	./ocsp_status -inresp google_resp google_resp2
incert	Read in certificate files (must be ASN.1 DER encoded)	./ocsp_status -incert google_cert.der google_cert2.der
issuercert	Read in space separated issuer certificate files (must be ASN.1 DER encoded)	./ocsp_status -issuercert="googleissuer_cert.der googleissuer_cert2.der" -incert google_cert.der google_cert2.der
ocspurl	Read in space separated urls to send the OCSP request to	./ocsp_status -ocspurl=http://ocsp1.com http://ocsp2.com google.com:443 google2.com:443
usepost	Use POST to send the OCSP request (default is GET)	./ocsp_status -post google.com:443
dir	Write the OCSP response to a file	./ocsp_status -dir=google_resp google.com:443
nostaple	Don't use the stapled OCSP response (only use with server URLs)	./ocsp_status -nostaple google.com:443
verbose	Print information on all lints (default is only printing failed/errored lints)	./ocsp_status -verbose google.com:443

Note you can also do ./ocsp_status -help to see a list of all possible flags and their descriptions.

Documentation

Overview

Package main provides the main command line functionality