X509V3.CNF(5) File Formats Manual X509V3.CNF(5) (NAME) x509v3.cnf - X.509 (DESCRIPTION) OpenSSL . openssl.cnf(5) . . : extension_name=[critical,] extension_options critical () . extension_options extension_name . : (). . : nsComment="This is a Comment" . : basicConstraints=critical,CA:true,pathlen:1 : basicConstraints=critical,@bs_section [bs_section] CA=true pathlen=1 . . . (ARBITRARY EXTENSIONS) . (STANDARD EXTENSIONS) . (Basic constraints) (CA) . () CA TRUE FALSE . CA TRUE pathlen . : basicConstraints=CA:TRUE basicConstraints=CA:FALSE basicConstraints=critical,CA:TRUE, pathlen:0 CA basicConstraints CA TRUE . CA FALSE . basicConstraints CA FALSE . pathlen CA CA . CA pathlen CA CA . (Key usage) . : digitalSignature nonRepudiation keyEncipherment dataEncipherment keyAgreement keyCertSign cRLSign encipherOnly decipherOnly. : keyUsage=digitalSignature, nonRepudiation keyUsage=critical, keyCertSign (Extended key usage) . OID . OID . PKIX NS MS : serverAuth TLS clientAuth TLS codeSigning emailProtection (S/MIME) timeStamping OCSPSigning OCSP ipsecIKE IPsec msCodeInd (authenticode) msCodeCom (authenticode) msCTLSign msEFS : extendedKeyUsage=critical,codeSigning,1.2.3.4 extendedKeyUsage=serverAuth,clientAuth (Subject key identifier) : hash RFC 3280 . . : subjectKeyIdentifier=hash (Authority key identifier) : keyid issuer always . keyid . always . issuer . keyid always . : authorityKeyIdentifier=keyid,issuer (Subject alternative name) . email ( ) URI ( ) DNS ( DNS) RID ( : OBJECT IDENTIFIER) IP ( IP) dirName ( distinguished name) otherName . email copy . . IP IP IPv4 IPv6 . dirName . AVAs `+' . otherName OID : OID ASN1_generate_nconf(3) . : subjectAltName=email:copy,email:my@other.address,URI:http://my.url.here subjectAltName=IP:192.168.7.1 subjectAltName=IP:13::17 subjectAltName=email:my@other.address,RID:1.2.3.4 subjectAltName=otherName:1.2.3.4;UTF8:some other identifier subjectAltName=dirName:dir_sect [dir_sect] C=UK O=My Organization OU=My Unit CN=My Name (Issuer alternative name) . email:copy . issuer:copy ( ) . : issuerAltName = issuer:copy (Authority info access) CA . accessOID; location location ( email:copy ). accessOID OID OCSP caIssuers. : authorityInfoAccess = OCSP;URI:http://ocsp.my.host authorityInfoAccess = caIssuers;URI:http://my.ca/ca.html (CRL distribution points) name:value . name:value DistributionPoint fullName cRLissuer reasons . . : fullname . relativename DN . CRLIssuer . reasons . : keyCompromise CACompromise affiliationChanged superseded cessationOfOperation certificateHold privilegeWithdrawn AACompromise. : crlDistributionPoints=URI:http://myhost.com/myca.crl crlDistributionPoints=URI:http://my.com/my.crl,URI:http://oth.com/my.crl : crlDistributionPoints=crldp1_section [crldp1_section] fullname=URI:http://myhost.com/myca.crl CRLissuer=dirName:issuer_sect reasons=keyCompromise, CACompromise [issuer_sect] C=UK O=Organisation CN=Some Name (Issuing distribution point) CRL . "" CRL . reasons CRLissuer . onlysomereasons . reasons CRL . onlyuser onlyCA onlyAA indirectCRL . (TRUE FALSE) . : issuingDistributionPoint=critical, @idp_section [idp_section] fullname=URI:http://myhost.com/myca.crl indirectCRL=TRUE onlysomereasons=keyCompromise, CACompromise [issuer_sect] C=UK O=Organisation CN=Some Name (Certificate policies) . . PKIX OID OID . OID : certificatePolicies= 1.2.4.5, 1.1.3.4 (qualifiers) OID @section OID . OID policyIdentifier . CPSuri : CPS.nnn=value userNotice : userNotice.nnn=@notice userNotice . explicitText organization noticeNumbers . explicitText organization noticeNumbers . organization noticeNumbers ( ) . userNotice IE5 ia5org . : certificatePolicies=ia5org,1.2.3.4,1.5.6.7.8,@polsect [polsect] policyIdentifier = 1.3.5.8 CPS.1="http://my.host.name" CPS.2="http://my.your.name" userNotice.1=@notice [notice] explicitText="Explicit Text Here" organization="Organisation Name" noticeNumbers=1,2,3,4 ia5org organization . RFC 2459 DisplayText . RFC 3280 IA5String . ( MSIE) ia5org . (Policy constraints) requireExplicitPolicy inhibitPolicyMapping . . : policyConstraints = requireExplicitPolicy:3 (Inhibit any policy) . : inhibitAnyPolicy = 2 (Name constraints) . permitted excluded . subjectAltName email:copy IP IP . : nameConstraints=permitted;IP:192.168.0.0/255.255.0.0 nameConstraints=permitted;email:.somedomain.com nameConstraints=excluded;email:.com OCSP (OCSP no check) OCSP . : noCheck = ignored TLS (TLS Feature - must staple) TLS . . TLS TLS . : status_request status_request_v2. : tlsfeature = status_request (DEPRECATED EXTENSIONS) . . (Netscape string extensions) (nsComment) . : nsComment = Some Random Comment : nsBaseUrl nsRevocationUrl nsCaRevocationUrl nsRenewalUrl nsCaPolicyUrl nsSslServerName. (Netscape certificate type) . . basicConstraints keyUsage . nsCertType : client server email objsign reserved sslCA emailCA objCA. (ARBITRARY EXTENSIONS) OpenSSL . . . . ASN1 ASN1_generate_nconf(3) . : 1.2.3.4=critical,ASN1:UTF8String:Some random data 1.2.3.4=ASN1:SEQUENCE:seq_sect [seq_sect] field1 = UTF8:field1 field2 = UTF8:field2 DER : 1.2.3.4=critical,DER:01:02:03:04 1.2.3.4=DER:01020304 DER DER . . : basicConstraints=critical,DER:00:01:02:03 (FILES) /etc/ssl/x509v3.cnf (SEE ALSO) openssl(1), ASN1_generate_nconf(3), OPENSSL_config(3), openssl.cnf(5) (HISTORY) X509v3 OpenSSL 0.9.2 . (CAVEATS) . . DER ASN1 . . . : subjectAltName=URI:ldap://somehost.com/CN=foo,OU=bar : subjectAltName=@subject_alt_section [subject_alt_section] subjectAltName=URI:ldap://somehost.com/CN=foo,OU=bar OpenSSL CONF . : subjectAltName=@alt_section [alt_section] email=steve@here email=steve@there . : [alt_section] email.1=steve@here email.2=steve@there Linux 6.12.107+deb13-amd64 March 31, 2022 Linux 6.12.107+deb13-amd64