Setting up Utimaco SecurityServer Library in OpenSSL Configuration File

  1. Open the file /etc/pki/tls/openssl.cnf and enter the following line in the first line of the file.

openssl.cnf

openssl_conf = openssl_init  
  1. Enter the following lines at the end of the openssl.cnf file.

openssl.cnf

[openssl_init]  
engines=engine_section  
[engine_section]  
pkcs11 = pkcs11_section  
[pkcs11_section]  
engine_id = pkcs11  
dynamic_path = /usr/lib/x86_64-linux-gnu/engines-3/pkcs11.so  
MODULE_PATH = /opt/utimaco/lib/libcs_pkcs11_R3.so  
init = 0  
  1. Below is complete sample openssl.cnf file.

openssl.cnf

openssl_conf = openssl_init  
HOME = .  
config_diagnostics = 1  
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  
[openssl_init]  
providers = provider_sect  
[provider_sect]
default = default_sect  
[default_sect]  
[ ca ]  
default_ca = CA_default # The default ca section  
[ CA_default ]  
dir = /localca # Where everything is kept  
certs = $dir/certs # Where the issued certs are kept  
crl_dir = $dir/crl # Where the issued crl are kept  
database = $dir/index.txt # database index file.  
new_certs_dir = $dir/ # default place for new certs.  
certificate = $dir/cacert.pem # The CA certificate  
serial = $dir/serial # The current serial number  
crlnumber = $dir/crlnumber   
crl = $dir/crl.pem # The current CRL  
private_key = $dir/private/cakey.pem # The private key  
x509_extensions = usr_cert # The extensions to add to the cert  
name_opt = ca_default # Subject Name options  
cert_opt = ca_default # Certificate field options  
default_days = 365 # how long to certify for  
default_crl_days= 30 # how long before next CRL  
default_md = default # use public key default MD  
preserve = no # keep passed DN ordering  
policy = policy_match  
[ policy_match ]  
countryName = optional  
stateOrProvinceName = optional  
organizationName = optional  
organizationalUnitName = optional  
commonName = supplied  
emailAddress = optional  
[ policy_anything ]  
countryName = optional  
stateOrProvinceName = optional  
localityName = optional  
organizationName = optional  
organizationalUnitName = optional  
commonName = supplied  
emailAddress = optional
[ req ]  
default_bits = 2048  
default_keyfile = privkey.pem  
distinguished_name = req_distinguished_name  
attributes = req_attributes  
x509_extensions = v3_ca # The extensions to add to the self signed cert  
string_mask = utf8only  
[ req_distinguished_name ]  
countryName = Country Name (2 letter code)  
countryName_default = AU  
countryName_min = 2  
countryName_max = 2  
stateOrProvinceName = State or Province Name (full name)  
stateOrProvinceName_default = Some-State  
localityName = Locality Name (eg, city)  
0.organizationName = Organization Name (eg, company)  
0.organizationName_default = Internet Widgits Pty Ltd  
organizationalUnitName = Organizational Unit Name (eg, section)  
commonName = Common Name (e.g. server FQDN or YOUR name)  
commonName_max = 64  
emailAddress = Email Address  
emailAddress_max = 64  
[ req_attributes ]  
challengePassword = A challenge password  
challengePassword_min = 4  
challengePassword_max = 20  
unstructuredName = An optional company name  
[ usr_cert ]  
basicConstraints=CA:FALSE  
subjectKeyIdentifier=hash  
authorityKeyIdentifier=keyid,issuer  
[ v3_req ]  
basicConstraints = CA:FALSE  
keyUsage = nonRepudiation, digitalSignature, keyEncipherment  
[ v3_ca ]  
subjectKeyIdentifier=hash
authorityKeyIdentifier=keyid:always,issuer  
basicConstraints = critical,CA:true  
[ v3_ca_reqexts ]  
subjectKeyIdentifier = hash  
keyUsage = digitalSignature, keyCertSign, cRLSign  
[ v3_issuing_extensions ]  
subjectKeyIdentifier = hash  
keyUsage = digitalSignature, keyCertSign, cRLSign  
basicConstraints = critical,CA:TRUE  
authorityKeyIdentifier = keyid:always,issuer:always  
[ v3_ca_reqexts ]  
subjectKeyIdentifier = hash  
keyUsage = digitalSignature, keyCertSign, cRLSign  
[ v3_datavault_reqexts ]  
subjectKeyIdentifier = hash  
keyUsage = keyEncipherment  
extendedKeyUsage = emailProtection  
[ v3_scep_reqexts ]  
subjectKeyIdentifier = hash  
[ v3_web_reqexts ]  
subjectKeyIdentifier = hash  
keyUsage = critical, digitalSignature, keyEncipherment  
extendedKeyUsage = serverAuth, clientAuth  
[ v3_ca_extensions ]  
subjectKeyIdentifier = hash  
keyUsage = digitalSignature, keyCertSign, cRLSign  
basicConstraints = critical,CA:TRUE  
authorityKeyIdentifier = keyid:always,issuer  
[ v3_issuing_extensions ]  
subjectKeyIdentifier = hash  
keyUsage = digitalSignature, keyCertSign, cRLSign  
basicConstraints = critical,CA:TRUE  
authorityKeyIdentifier = keyid:always,issuer:always  
[ v3_datavault_extensions ]
subjectKeyIdentifier = hash  
keyUsage = keyEncipherment  
extendedKeyUsage = emailProtection  
basicConstraints = CA:FALSE  
authorityKeyIdentifier = keyid:always,issuer  
[ v3_scep_extensions ]  
subjectKeyIdentifier = hash  
keyUsage = digitalSignature, keyEncipherment  
basicConstraints = CA:FALSE  
authorityKeyIdentifier = keyid,issuer  
[ v3_web_extensions ]  
subjectKeyIdentifier = hash  
keyUsage = critical, digitalSignature, keyEncipherment  
extendedKeyUsage = serverAuth, clientAuth  
basicConstraints = critical,CA:FALSE  
subjectAltName = DNS:Openxpki  
[ crl_ext ]  
authorityKeyIdentifier=keyid:always  
[ proxy_cert_ext ]  
basicConstraints=CA:FALSE  
subjectKeyIdentifier=hash  
authorityKeyIdentifier=keyid,issuer  
proxyCertInfo=critical,language:id-ppl-anyLanguage,pathlen:3,policy:foo  
[ tsa ]  
default_tsa = tsa_config1 # the default TSA section  
[ tsa_config1 ]  
dir = ./demoCA # TSA root directory  
serial = $dir/tsaserial # The current serial number   
(mandatory)  
crypto_device = builtin # OpenSSL engine to use for signing  
signer_cert = $dir/tsacert.pem # The TSA signing certificate  
certs = $dir/cacert.pem   
signer_key = $dir/private/tsakey.pem # The TSA private key (optional)  
signer_digest = sha256 # Signing digest to use. (Optional)  
default_policy = tsa_policy1 # Policy if request did not specify it  
 # (optional)
 other_policies = tsa_policy2, tsa_policy3 # acceptable policies   
(optional)  
digests = sha1, sha256, sha384, sha512 # Acceptable message digests   
(mandatory)  
accuracy = secs:1, millisecs:500, microsecs:100 # (optional)  
clock_precision_digits = 0 # number of digits after dot. (optional)  
ordering = yes # Is ordering defined for timestamps?  
 # (optional, default: no)  
tsa_name = yes # Must the TSA name be included in the reply?  
 # (optional, default: no)  
ess_cert_id_chain = no # Must the ESS cert id chain be included?  
 # (optional, default: no)  
ess_cert_id_alg = sha1 # algorithm to compute certificate  
 # identifier (optional, default: sha1)  
[insta] # CMP using Insta Demo CA  
# Message transfer  
server = pki.certificate.fi:8700  
path = pkix/  
recipient = "/C=FI/O=Insta Demo/CN=Insta Demo CA" # or set srvcert or issuer  
ignore_keyusage = 1 # potentially needed quirk  
unprotected_errors = 1 # potentially needed quirk  
extracertsout = insta.extracerts.pem  
ref = 3078 # user identification  
secret = pass:insta # can be used for both client and server side  
cmd = ir # default operation, can be overridden on cmd line with, e.g., kur  
subject = "/CN=openssl-cmp-test"  
newkey = insta.priv.pem  
out_trusted = apps/insta.ca.crt # does not include keyUsage digitalSignature  
certout = insta.cert.pem  
[pbm]   
ref = $insta::ref # 3078  
secret = $insta::secret # pass:insta  
[signature] # Signature-based protection for Insta CA  
trusted = $insta::out_trusted # apps/insta.ca.crt  
secret = # disable PBM  
key = $insta::newkey # insta.priv.pem  
cert = $insta::certout # insta.cert.pem  
[ir]  
cmd = ir
[cr]  
cmd = cr  
[kur]  
cmd = kur  
oldcert = $insta::certout # insta.cert.pem  
[rr]  
cmd = rr  
oldcert = $insta::certout # insta.cert.pem  
[openssl_init]  
engines=engine_section  
[engine_section]  
pkcs11 = pkcs11_section  
[pkcs11_section]  
engine_id = pkcs11  
dynamic_path = /usr/lib/x86_64-linux-gnu/engines-3/pkcs11.so  
MODULE_PATH = /opt/utimaco/lib/libcs_pkcs11_R3.so  
init = 0