write readme to generate timestamps
This commit is contained in:
parent
958c96193e
commit
9f085484f7
GPG Key ID:
BDE2190974723FCB
4
ts-authority/.gitignore
vendored
Normal file
4
ts-authority/.gitignore
vendored
Normal file
@ -0,0 +1,4 @@
|
||||
ca/*
|
||||
!ca/certs/.gitkeep
|
||||
!ca/db/.gitkeep
|
||||
!ca/private/.gitkeep
|
||||
153
ts-authority/README.md
Normal file
153
ts-authority/README.md
Normal file
@ -0,0 +1,153 @@
|
||||
# Set up CA
|
||||
|
||||
## Sources:
|
||||
|
||||
- https://www.jimby.name/techbits/recent/openssl_tsa/
|
||||
|
||||
## Create directory
|
||||
|
||||
```bash
|
||||
# mkdir certs db private ## should already be created
|
||||
# chmod 700 private ## should already be set
|
||||
touch db/index
|
||||
openssl rand -hex 16 > db/serial
|
||||
echo ‘1001’ > db/crlnumber
|
||||
echo 01 > tsa_serial
|
||||
```
|
||||
|
||||
## Create files for certificate authority
|
||||
|
||||
Create a new private key and root CA certificate request in one step:
|
||||
|
||||
```bash
|
||||
openssl req -new -newkey rsa:2048 -config ./rootca.conf -out ca/root-ca.csr -keyout ca/private/root-ca.key
|
||||
```
|
||||
|
||||
Don’t forget the password – you’ll need it again and again below.
|
||||
|
||||
Now self-sign the certificate request.
|
||||
|
||||
```bash
|
||||
openssl ca -selfsign -config ./rootca.conf -in ca/root-ca.csr -out ca/root-ca.crt -extensions ca_ext
|
||||
```
|
||||
|
||||
Check the certificate:
|
||||
|
||||
```bash
|
||||
openssl x509 -text -in ca/root-ca.crt -noout
|
||||
```
|
||||
|
||||
## Create certificate for timestamp
|
||||
|
||||
To proceed, we first make a key and a certificate request for a non-CA certificate. We use the -subj option so we don’t
|
||||
have to use a configuration file for this step. The Country (C=US) and Organization (O=Example Inc.) elements must
|
||||
match the root certificate.
|
||||
|
||||
```bash
|
||||
openssl req -new \
|
||||
-newkey rsa:2048 \
|
||||
-subj "/C=US/O=Example Inc./OU=Engineering/CN=Example Inc. TSA Responder" \
|
||||
-keyout ca/private/tsa.key \
|
||||
-out ca/tsa.csr
|
||||
```
|
||||
|
||||
|
||||
You should use a different password for the tsa.key private key.
|
||||
|
||||
Then we generate a non-CA certificate using the -extension tsa_ext command line option which points to the required
|
||||
extendedKeyUsage in the configuration file.
|
||||
|
||||
```bash
|
||||
openssl ca -config ./rootca.conf -in ca/tsa.csr -out ca/tsa.crt -extensions tsa_ext -days 365
|
||||
```
|
||||
|
||||
Sign with the root-ca.key private key password, and commit to the database.
|
||||
|
||||
Examine the new TSA certificate as follows:
|
||||
|
||||
```bash
|
||||
openssl x509 -in ca/tsa.crt -text -noout
|
||||
```
|
||||
|
||||
Ensure that it has CA: false , keyUsage nonRepudiation, and extendedKeyUsage timeStamping.
|
||||
|
||||
Requests to the time stamp service usually require that the reply include the certificate chain of the service. We now create the certificate chain as follows:
|
||||
|
||||
First, extract just the PEM form of the x509 certificates for root-ca.crt and tsa.crt :
|
||||
|
||||
```bash
|
||||
openssl x509 -in ca/root-ca.crt -outform PEM -out ca/root-ca.pem
|
||||
openssl x509 -in ca/tsa.crt -outform PEM -out ca/tsa.pem
|
||||
```
|
||||
|
||||
Next, concatenate the two bare certificates ensuring that the root certificate is last in the file:
|
||||
|
||||
```bash
|
||||
cat ca/tsa.pem ca/root-ca.pem > ca/tsa-chain.pem
|
||||
```
|
||||
|
||||
You can verify this chain by just viewing the file:
|
||||
|
||||
```bash
|
||||
cat ca/tsa-chain.pem
|
||||
```
|
||||
|
||||
## Generate a timestamp request
|
||||
|
||||
Ok! We are now ready to create a time stamp request. First, we prepare a query:
|
||||
|
||||
```bash
|
||||
openssl ts -query -config ./rootca.conf -cert -data /etc/hosts -out /tmp/request.tsq
|
||||
```
|
||||
|
||||
View the request with
|
||||
|
||||
```bash
|
||||
openssl ts -query -in /tmp/request.tsq -text
|
||||
```
|
||||
|
||||
Note that since we did not request certificate checking (using the -cert option in the request command above), the text
|
||||
output of this command shows “Certificate required: no”. Also, note that we did not specify our own configuration
|
||||
file in the above example.
|
||||
|
||||
If you want to use a stronger digest algorithm, specify it on the command line (sha512 requested here):
|
||||
|
||||
```bash
|
||||
openssl ts -query -config ./rootca.conf -data /etc/hosts -out /tmp/request.tsr -sha512
|
||||
```
|
||||
|
||||
## Generating a reply
|
||||
|
||||
We can now process a reply to the the request. Note that the openssl ts -reply sub-command does require a configuration
|
||||
file, including the all the tsa sections. In particular, it uses the tsa_policy1(2,3) options we added at the top of the file.
|
||||
|
||||
Here (and everywhere you utilize the services of the tsa.crt certificate), you must enter the password for the tsa
|
||||
certificate private key.
|
||||
|
||||
```bash
|
||||
openssl ts -reply -config ./rootca.conf -queryfile /tmp/request.tsq -chain ca/tsa-chain.pem -out /tmp/response.tsr
|
||||
```
|
||||
|
||||
```bash
|
||||
openssl ts -reply -config ./rootca.conf -in /tmp/response.tsr -text
|
||||
```
|
||||
|
||||
|
||||
## Verification
|
||||
|
||||
|
||||
|
||||
Openssl can also verify the received timestamp ensuring that the data file or data digest the query was based on still
|
||||
applies to the current version of the file.
|
||||
|
||||
```bash
|
||||
openssl ts -verify -queryfile /tmp/request.tsq -in /tmp/response.tsr -CAfile ca/root-ca.pem -untrusted ca/tsa.pem
|
||||
```
|
||||
|
||||
The OK response ensures that the original signed timestamp is correctly authorized by the root and tsa certificates
|
||||
(in PEM format).
|
||||
|
||||
```bash
|
||||
openssl ts -verify -data /etc/hosts -in /tmp/response.tsr -CAfile ca/root-ca.pem -untrusted ca/tsa.pem
|
||||
```
|
||||
|
||||
168
ts-authority/rootca.conf
Normal file
168
ts-authority/rootca.conf
Normal file
@ -0,0 +1,168 @@
|
||||
#
|
||||
# rootca.conf
|
||||
#
|
||||
# See Ristic OpenSSL Cookbook URL above.
|
||||
|
||||
oid_section = new_oids
|
||||
|
||||
[ new_oids ]
|
||||
tsa_policy1 = 1.2.3.4.1
|
||||
tsa_policy2 = 1.2.3.4.5.6
|
||||
tsa_policy3 = 1.2.3.4.5.7
|
||||
|
||||
###### First Part ########
|
||||
|
||||
[default]
|
||||
name = root-ca
|
||||
domain_suffix = example.com
|
||||
aia_url = http://$name.$domain_suffix/$name.crt
|
||||
crl_url = http://$name.$domain_suffix/$name.crl
|
||||
ocsp_url = http://ocsp.$name.$domain_suffix:9080
|
||||
default_ca = ca_default
|
||||
name_opt = utf8,esc_ctrl,multiline,lname,align
|
||||
|
||||
[ca_dn]
|
||||
countryName = "US"
|
||||
organizationName = "Example Inc."
|
||||
commonName = "Root CA"
|
||||
|
||||
###### Second Part #######
|
||||
|
||||
[ca_default]
|
||||
home = .
|
||||
database = $home/ca/db/index
|
||||
serial = $home/ca/db/serial
|
||||
crlnumber = $home/ca/db/crlnumber
|
||||
certificate = $home/ca/$name.crt
|
||||
private_key = $home/ca/private/$name.key
|
||||
RANDFILE = $home/ca/private/random
|
||||
new_certs_dir = $home/ca/certs
|
||||
unique_subject = no
|
||||
copy_extensions = none
|
||||
default_days = 3650
|
||||
default_crl_days = 30
|
||||
default_md = sha256
|
||||
policy = policy_c_o_match
|
||||
name = foo@example.com
|
||||
|
||||
|
||||
[policy_c_o_match]
|
||||
countryName = match
|
||||
stateOrProvinceName = optional
|
||||
organizationName = match
|
||||
organizationalUnitName = optional
|
||||
commonName = supplied
|
||||
emailAddress = optional
|
||||
|
||||
|
||||
##### Third Part #######
|
||||
|
||||
[req]
|
||||
default_bits = 4096
|
||||
encrypt_key = yes
|
||||
default_md = sha256
|
||||
utf8 = yes
|
||||
string_mask = utf8only
|
||||
prompt = no
|
||||
distinguished_name = ca_dn
|
||||
req_extensions = ca_ext
|
||||
|
||||
|
||||
[ca_ext]
|
||||
basicConstraints = critical,CA:true
|
||||
keyUsage = critical,keyCertSign,cRLSign
|
||||
subjectKeyIdentifier = hash
|
||||
|
||||
|
||||
####### Fourth Part - Extensions ########
|
||||
#
|
||||
# Value Meaning - see x509v3.cnf(5)
|
||||
# -------- ------------------------------
|
||||
# serverAuth SSL/TLS web server authentication
|
||||
# clientAuth SSL/TLS web client authentication
|
||||
# codeSigning code signing
|
||||
# emailProtection email protection (S/MIME)
|
||||
# timeStamping trusted doc hash timestamping
|
||||
# OCSPSigning OCSP Signing
|
||||
# ipsecIKE IPsec internet key exchange
|
||||
# msCodeInd Microsoft individual code signing (authenticode)
|
||||
# msCodeCom Microsoft commercial code signing (authenticode)
|
||||
# msCTLSign Microsoft trust list signing
|
||||
# msEFS Microsoft encrypted file system (EFS)
|
||||
|
||||
|
||||
[sub_ca_ext]
|
||||
authorityInfoAccess = @issuer_info
|
||||
authorityKeyIdentifier = keyid:always
|
||||
basicConstraints = critical,CA:true,pathlen:0
|
||||
crlDistributionPoints = @crl_info
|
||||
keyUsage = critical,keyCertSign,cRLSign
|
||||
extendedKeyUsage = clientAuth,serverAuth
|
||||
nameConstraints = @name_constraints
|
||||
subjectKeyIdentifier = hash
|
||||
|
||||
|
||||
[crl_info]
|
||||
URI.0 = $crl_url
|
||||
|
||||
[issuer_info]
|
||||
caIssuers;URI.0 = $aia_url
|
||||
OCSP;URI.0 = $ocsp_url
|
||||
|
||||
[name_constraints]
|
||||
permitted;DNS.0=example.com
|
||||
permitted;DNS.1=example.org
|
||||
excluded;IP.0=0.0.0.0/0.0.0.0
|
||||
excluded;IP.1=0:0:0:0:0:0:0:0/0:0:0:0:0:0:0:0
|
||||
|
||||
|
||||
####### Fifth Part ==========
|
||||
|
||||
|
||||
[ocsp_ext]
|
||||
authorityKeyIdentifier = keyid:always
|
||||
basicConstraints = critical,CA:false
|
||||
extendedKeyUsage = OCSPSigning
|
||||
keyUsage = critical,digitalSignature
|
||||
subjectKeyIdentifier = hash
|
||||
|
||||
|
||||
########### TSA extension ##############
|
||||
#
|
||||
# Copied from the OpenSSL CAtsa.cnf test configuration and modified for use as a TSA extension.
|
||||
#
|
||||
#
|
||||
|
||||
[ tsa ]
|
||||
|
||||
default_tsa = tsa_config1
|
||||
|
||||
[ tsa_config1 ]
|
||||
dir = . # TSA root directory, same as root-ca
|
||||
serial = $dir/ca/tsa_serial # current serial number (mandatory)
|
||||
signer_cert = $dir/ca/tsa.crt # signing certificate (optional)
|
||||
certs = $dir/ca/tsa-chain.pem # certification chain (optional)
|
||||
signer_key = $dir/ca/private/tsa.key # tsa private key (optional)
|
||||
default_policy = tsa_policy1
|
||||
signer_digest = sha256 # digest to use for signing (optional)
|
||||
other_policies = tsa_policy2,tsa_policy3 # other policies (optional)
|
||||
digests = sha256,sha384,sha512 # acceptable digests (mandatory)
|
||||
accuracy = secs:1,millisecs:500,microsecs:100 # accuracy optional
|
||||
ordering = yes # is ordering defined? (optional, default: no)
|
||||
tsa_name = yes # must tsa name be included in reply? (opt., default: no)
|
||||
ess_cert_id_chain = yes # must ess cert id change be incl? (opt., default: no)
|
||||
ess_cert_id_alg = sha256 # alg to compute cert. id (optional, default: sha1)
|
||||
|
||||
# added, was missing in the blog post
|
||||
crypto_device = builtin
|
||||
|
||||
# The tsa_ext extension is
|
||||
# used to create the tsa cert tsa.crt
|
||||
|
||||
[ tsa_ext ]
|
||||
|
||||
authorityKeyIdentifier = keyid:always
|
||||
basicConstraints = critical,CA:false
|
||||
extendedKeyUsage = critical,timeStamping
|
||||
keyUsage = critical,nonRepudiation
|
||||
subjectKeyIdentifier = hash
|
||||
Loading…
Reference in New Issue
Block a user