doc/man1/openssl-ca.pod

   1 =pod
   2
   3 =head1 NAME
   4
   5 openssl-ca - sample minimal CA application
   6
   7 =head1 SYNOPSIS
   8
   9 B<openssl> B<ca>
  10 [B<-help>]
  11 [B<-verbose>]
  12 [B<-config filename>]
  13 [B<-name section>]
  14 [B<-gencrl>]
  15 [B<-revoke file>]
  16 [B<-valid file>]
  17 [B<-status serial>]
  18 [B<-updatedb>]
  19 [B<-crl_reason reason>]
  20 [B<-crl_hold instruction>]
  21 [B<-crl_compromise time>]
  22 [B<-crl_CA_compromise time>]
  23 [B<-crldays days>]
  24 [B<-crlhours hours>]
  25 [B<-crlexts section>]
  26 [B<-startdate date>]
  27 [B<-enddate date>]
  28 [B<-days arg>]
  29 [B<-md arg>]
  30 [B<-policy arg>]
  31 [B<-keyfile arg>]
  32 [B<-keyform PEM|DER>]
  33 [B<-key arg>]
  34 [B<-passin arg>]
  35 [B<-cert file>]
  36 [B<-selfsign>]
  37 [B<-in file>]
  38 [B<-out file>]
  39 [B<-notext>]
  40 [B<-outdir dir>]
  41 [B<-infiles>]
  42 [B<-spkac file>]
  43 [B<-ss_cert file>]
  44 [B<-preserveDN>]
  45 [B<-noemailDN>]
  46 [B<-batch>]
  47 [B<-msie_hack>]
  48 [B<-extensions section>]
  49 [B<-extfile section>]
  50 [B<-engine id>]
  51 [B<-subj arg>]
  52 [B<-utf8>]
  53 [B<-sigopt nm:v>]
  54 [B<-create_serial>]
  55 [B<-rand_serial>]
  56 [B<-multivalue-rdn>]
  57 [B<-rand file...>]
  58 [B<-writerand file>]
  59 [B<-sm2-id string>]
  60 [B<-sm2-hex-id hex-string>]
  61
  62 =head1 DESCRIPTION
  63
  64 The B<ca> command is a minimal CA application. It can be used
  65 to sign certificate requests in a variety of forms and generate
  66 CRLs it also maintains a text database of issued certificates
  67 and their status.
  68
  69 The options descriptions will be divided into each purpose.
  70
  71 =head1 OPTIONS
  72
  73 =over 4
  74
  75 =item B<-help>
  76
  77 Print out a usage message.
  78
  79 =item B<-verbose>
  80
  81 This prints extra details about the operations being performed.
  82
  83 =item B<-config filename>
  84
  85 Specifies the configuration file to use.
  86 Optional; for a description of the default value,
  87 see L<openssl(1)/COMMAND SUMMARY>.
  88
  89 =item B<-name section>
  90
  91 Specifies the configuration file section to use (overrides
  92 B<default_ca> in the B<ca> section).
  93
  94 =item B<-in filename>
  95
  96 An input filename containing a single certificate request to be
  97 signed by the CA.
  98
  99 =item B<-ss_cert filename>
 100
 101 A single self-signed certificate to be signed by the CA.
 102
 103 =item B<-spkac filename>
 104
 105 A file containing a single Netscape signed public key and challenge
 106 and additional field values to be signed by the CA. See the B<SPKAC FORMAT>
 107 section for information on the required input and output format.
 108
 109 =item B<-infiles>
 110
 111 If present this should be the last option, all subsequent arguments
 112 are taken as the names of files containing certificate requests.
 113
 114 =item B<-out filename>
 115
 116 The output file to output certificates to. The default is standard
 117 output. The certificate details will also be printed out to this
 118 file in PEM format (except that B<-spkac> outputs DER format).
 119
 120 =item B<-outdir directory>
 121
 122 The directory to output certificates to. The certificate will be
 123 written to a filename consisting of the serial number in hex with
 124 ".pem" appended.
 125
 126 =item B<-cert>
 127
 128 The CA certificate file.
 129
 130 =item B<-keyfile filename>
 131
 132 The private key to sign requests with.
 133
 134 =item B<-keyform PEM|DER>
 135
 136 The format of the data in the private key file.
 137 The default is PEM.
 138
 139 =item B<-sigopt nm:v>
 140
 141 Pass options to the signature algorithm during sign or verify operations.
 142 Names and values of these options are algorithm-specific.
 143
 144 =item B<-key password>
 145
 146 The password used to encrypt the private key. Since on some
 147 systems the command line arguments are visible (e.g. Unix with
 148 the 'ps' utility) this option should be used with caution.
 149
 150 =item B<-selfsign>
 151
 152 Indicates the issued certificates are to be signed with the key
 153 the certificate requests were signed with (given with B<-keyfile>).
 154 Certificate requests signed with a different key are ignored.  If
 155 B<-spkac>, B<-ss_cert> or B<-gencrl> are given, B<-selfsign> is
 156 ignored.
 157
 158 A consequence of using B<-selfsign> is that the self-signed
 159 certificate appears among the entries in the certificate database
 160 (see the configuration option B<database>), and uses the same
 161 serial number counter as all other certificates sign with the
 162 self-signed certificate.
 163
 164 =item B<-passin arg>
 165
 166 The key password source. For more information about the format of B<arg>
 167 see the B<PASS PHRASE ARGUMENTS> section in L<openssl(1)>.
 168
 169 =item B<-notext>
 170
 171 Don't output the text form of a certificate to the output file.
 172
 173 =item B<-startdate date>
 174
 175 This allows the start date to be explicitly set. The format of the
 176 date is YYMMDDHHMMSSZ (the same as an ASN1 UTCTime structure), or
 177 YYYYMMDDHHMMSSZ (the same as an ASN1 GeneralizedTime structure). In
 178 both formats, seconds SS and timezone Z must be present.
 179
 180 =item B<-enddate date>
 181
 182 This allows the expiry date to be explicitly set. The format of the
 183 date is YYMMDDHHMMSSZ (the same as an ASN1 UTCTime structure), or
 184 YYYYMMDDHHMMSSZ (the same as an ASN1 GeneralizedTime structure). In
 185 both formats, seconds SS and timezone Z must be present.
 186
 187 =item B<-days arg>
 188
 189 The number of days to certify the certificate for.
 190
 191 =item B<-md alg>
 192
 193 The message digest to use.
 194 Any digest supported by the OpenSSL B<dgst> command can be used. For signing
 195 algorithms that do not support a digest (i.e. Ed25519 and Ed448) any message
 196 digest that is set is ignored. This option also applies to CRLs.
 197
 198 =item B<-policy arg>
 199
 200 This option defines the CA "policy" to use. This is a section in
 201 the configuration file which decides which fields should be mandatory
 202 or match the CA certificate. Check out the B<POLICY FORMAT> section
 203 for more information.
 204
 205 =item B<-msie_hack>
 206
 207 This is a deprecated option to make B<ca> work with very old versions of
 208 the IE certificate enrollment control "certenr3". It used UniversalStrings
 209 for almost everything. Since the old control has various security bugs
 210 its use is strongly discouraged.
 211
 212 =item B<-preserveDN>
 213
 214 Normally the DN order of a certificate is the same as the order of the
 215 fields in the relevant policy section. When this option is set the order
 216 is the same as the request. This is largely for compatibility with the
 217 older IE enrollment control which would only accept certificates if their
 218 DNs match the order of the request. This is not needed for Xenroll.
 219
 220 =item B<-noemailDN>
 221
 222 The DN of a certificate can contain the EMAIL field if present in the
 223 request DN, however it is good policy just having the e-mail set into
 224 the altName extension of the certificate. When this option is set the
 225 EMAIL field is removed from the certificate' subject and set only in
 226 the, eventually present, extensions. The B<email_in_dn> keyword can be
 227 used in the configuration file to enable this behaviour.
 228
 229 =item B<-batch>
 230
 231 This sets the batch mode. In this mode no questions will be asked
 232 and all certificates will be certified automatically.
 233
 234 =item B<-extensions section>
 235
 236 The section of the configuration file containing certificate extensions
 237 to be added when a certificate is issued (defaults to B<x509_extensions>
 238 unless the B<-extfile> option is used). If no extension section is
 239 present then, a V1 certificate is created. If the extension section
 240 is present (even if it is empty), then a V3 certificate is created. See the
 241 L<x509v3_config(5)> manual page for details of the
 242 extension section format.
 243
 244 =item B<-extfile file>
 245
 246 An additional configuration file to read certificate extensions from
 247 (using the default section unless the B<-extensions> option is also
 248 used).
 249
 250 =item B<-engine id>
 251
 252 Specifying an engine (by its unique B<id> string) will cause B<ca>
 253 to attempt to obtain a functional reference to the specified engine,
 254 thus initialising it if needed. The engine will then be set as the default
 255 for all available algorithms.
 256
 257 =item B<-subj arg>
 258
 259 Supersedes subject name given in the request.
 260 The arg must be formatted as I</type0=value0/type1=value1/type2=...>.
 261 Keyword characters may be escaped by \ (backslash), and whitespace is retained.
 262 Empty values are permitted, but the corresponding type will not be included
 263 in the resulting certificate.
 264
 265 =item B<-utf8>
 266
 267 This option causes field values to be interpreted as UTF8 strings, by
 268 default they are interpreted as ASCII. This means that the field
 269 values, whether prompted from a terminal or obtained from a
 270 configuration file, must be valid UTF8 strings.
 271
 272 =item B<-create_serial>
 273
 274 If reading serial from the text file as specified in the configuration
 275 fails, specifying this option creates a new random serial to be used as next
 276 serial number.
 277 To get random serial numbers, use the B<-rand_serial> flag instead; this
 278 should only be used for simple error-recovery.
 279
 280 =item B<-rand_serial>
 281
 282 Generate a large random number to use as the serial number.
 283 This overrides any option or configuration to use a serial number file.
 284
 285 =item B<-multivalue-rdn>
 286
 287 This option causes the -subj argument to be interpreted with full
 288 support for multivalued RDNs. Example:
 289
 290 I</DC=org/DC=OpenSSL/DC=users/UID=123456+CN=John Doe>
 291
 292 If -multi-rdn is not used then the UID value is I<123456+CN=John Doe>.
 293
 294 =item B<-rand file...>
 295
 296 A file or files containing random data used to seed the random number
 297 generator.
 298 Multiple files can be specified separated by an OS-dependent character.
 299 The separator is B<;> for MS-Windows, B<,> for OpenVMS, and B<:> for
 300 all others.
 301
 302 =item [B<-writerand file>]
 303
 304 Writes random data to the specified I<file> upon exit.
 305 This can be used with a subsequent B<-rand> flag.
 306
 307 =item B<-sm2-id>
 308
 309 Specify the ID string to use when verifying an SM2 certificate. The ID string is
 310 required by the SM2 signature algorithm for signing and verification.
 311
 312 =item B<-sm2-hex-id>
 313
 314 Specify a binary ID string to use when signing or verifying using an SM2
 315 certificate. The argument for this option is string of hexadecimal digits.
 316
 317 =back
 318
 319 =head1 CRL OPTIONS
 320
 321 =over 4
 322
 323 =item B<-gencrl>
 324
 325 This option generates a CRL based on information in the index file.
 326
 327 =item B<-crldays num>
 328
 329 The number of days before the next CRL is due. That is the days from
 330 now to place in the CRL nextUpdate field.
 331
 332 =item B<-crlhours num>
 333
 334 The number of hours before the next CRL is due.
 335
 336 =item B<-revoke filename>
 337
 338 A filename containing a certificate to revoke.
 339
 340 =item B<-valid filename>
 341
 342 A filename containing a certificate to add a Valid certificate entry.
 343
 344 =item B<-status serial>
 345
 346 Displays the revocation status of the certificate with the specified
 347 serial number and exits.
 348
 349 =item B<-updatedb>
 350
 351 Updates the database index to purge expired certificates.
 352
 353 =item B<-crl_reason reason>
 354
 355 Revocation reason, where B<reason> is one of: B<unspecified>, B<keyCompromise>,
 356 B<CACompromise>, B<affiliationChanged>, B<superseded>, B<cessationOfOperation>,
 357 B<certificateHold> or B<removeFromCRL>. The matching of B<reason> is case
 358 insensitive. Setting any revocation reason will make the CRL v2.
 359
 360 In practice B<removeFromCRL> is not particularly useful because it is only used
 361 in delta CRLs which are not currently implemented.
 362
 363 =item B<-crl_hold instruction>
 364
 365 This sets the CRL revocation reason code to B<certificateHold> and the hold
 366 instruction to B<instruction> which must be an OID. Although any OID can be
 367 used only B<holdInstructionNone> (the use of which is discouraged by RFC2459)
 368 B<holdInstructionCallIssuer> or B<holdInstructionReject> will normally be used.
 369
 370 =item B<-crl_compromise time>
 371
 372 This sets the revocation reason to B<keyCompromise> and the compromise time to
 373 B<time>. B<time> should be in GeneralizedTime format that is B<YYYYMMDDHHMMSSZ>.
 374
 375 =item B<-crl_CA_compromise time>
 376
 377 This is the same as B<crl_compromise> except the revocation reason is set to
 378 B<CACompromise>.
 379
 380 =item B<-crlexts section>
 381
 382 The section of the configuration file containing CRL extensions to
 383 include. If no CRL extension section is present then a V1 CRL is
 384 created, if the CRL extension section is present (even if it is
 385 empty) then a V2 CRL is created. The CRL extensions specified are
 386 CRL extensions and B<not> CRL entry extensions.  It should be noted
 387 that some software (for example Netscape) can't handle V2 CRLs. See
 388 L<x509v3_config(5)> manual page for details of the
 389 extension section format.
 390
 391 =back
 392
 393 =head1 CONFIGURATION FILE OPTIONS
 394
 395 The section of the configuration file containing options for B<ca>
 396 is found as follows: If the B<-name> command line option is used,
 397 then it names the section to be used. Otherwise the section to
 398 be used must be named in the B<default_ca> option of the B<ca> section
 399 of the configuration file (or in the default section of the
 400 configuration file). Besides B<default_ca>, the following options are
 401 read directly from the B<ca> section:
 402  RANDFILE
 403  preserve
 404  msie_hack
 405 With the exception of B<RANDFILE>, this is probably a bug and may
 406 change in future releases.
 407
 408 Many of the configuration file options are identical to command line
 409 options. Where the option is present in the configuration file
 410 and the command line the command line value is used. Where an
 411 option is described as mandatory then it must be present in
 412 the configuration file or the command line equivalent (if
 413 any) used.
 414
 415 =over 4
 416
 417 =item B<oid_file>
 418
 419 This specifies a file containing additional B<OBJECT IDENTIFIERS>.
 420 Each line of the file should consist of the numerical form of the
 421 object identifier followed by white space then the short name followed
 422 by white space and finally the long name.
 423
 424 =item B<oid_section>
 425
 426 This specifies a section in the configuration file containing extra
 427 object identifiers. Each line should consist of the short name of the
 428 object identifier followed by B<=> and the numerical form. The short
 429 and long names are the same when this option is used.
 430
 431 =item B<new_certs_dir>
 432
 433 The same as the B<-outdir> command line option. It specifies
 434 the directory where new certificates will be placed. Mandatory.
 435
 436 =item B<certificate>
 437
 438 The same as B<-cert>. It gives the file containing the CA
 439 certificate. Mandatory.
 440
 441 =item B<private_key>
 442
 443 Same as the B<-keyfile> option. The file containing the
 444 CA private key. Mandatory.
 445
 446 =item B<RANDFILE>
 447
 448 At startup the specified file is loaded into the random number generator,
 449 and at exit 256 bytes will be written to it.
 450
 451 =item B<default_days>
 452
 453 The same as the B<-days> option. The number of days to certify
 454 a certificate for.
 455
 456 =item B<default_startdate>
 457
 458 The same as the B<-startdate> option. The start date to certify
 459 a certificate for. If not set the current time is used.
 460
 461 =item B<default_enddate>
 462
 463 The same as the B<-enddate> option. Either this option or
 464 B<default_days> (or the command line equivalents) must be
 465 present.
 466
 467 =item B<default_crl_hours default_crl_days>
 468
 469 The same as the B<-crlhours> and the B<-crldays> options. These
 470 will only be used if neither command line option is present. At
 471 least one of these must be present to generate a CRL.
 472
 473 =item B<default_md>
 474
 475 The same as the B<-md> option. Mandatory except where the signing algorithm does
 476 not require a digest (i.e. Ed25519 and Ed448).
 477
 478 =item B<database>
 479
 480 The text database file to use. Mandatory. This file must be present
 481 though initially it will be empty.
 482
 483 =item B<unique_subject>
 484
 485 If the value B<yes> is given, the valid certificate entries in the
 486 database must have unique subjects.  if the value B<no> is given,
 487 several valid certificate entries may have the exact same subject.
 488 The default value is B<yes>, to be compatible with older (pre 0.9.8)
 489 versions of OpenSSL.  However, to make CA certificate roll-over easier,
 490 it's recommended to use the value B<no>, especially if combined with
 491 the B<-selfsign> command line option.
 492
 493 Note that it is valid in some circumstances for certificates to be created
 494 without any subject. In the case where there are multiple certificates without
 495 subjects this does not count as a duplicate.
 496
 497 =item B<serial>
 498
 499 A text file containing the next serial number to use in hex. Mandatory.
 500 This file must be present and contain a valid serial number.
 501
 502 =item B<crlnumber>
 503
 504 A text file containing the next CRL number to use in hex. The crl number
 505 will be inserted in the CRLs only if this file exists. If this file is
 506 present, it must contain a valid CRL number.
 507
 508 =item B<x509_extensions>
 509
 510 The same as B<-extensions>.
 511
 512 =item B<crl_extensions>
 513
 514 The same as B<-crlexts>.
 515
 516 =item B<preserve>
 517
 518 The same as B<-preserveDN>
 519
 520 =item B<email_in_dn>
 521
 522 The same as B<-noemailDN>. If you want the EMAIL field to be removed
 523 from the DN of the certificate simply set this to 'no'. If not present
 524 the default is to allow for the EMAIL filed in the certificate's DN.
 525
 526 =item B<msie_hack>
 527
 528 The same as B<-msie_hack>
 529
 530 =item B<policy>
 531
 532 The same as B<-policy>. Mandatory. See the B<POLICY FORMAT> section
 533 for more information.
 534
 535 =item B<name_opt>, B<cert_opt>
 536
 537 These options allow the format used to display the certificate details
 538 when asking the user to confirm signing. All the options supported by
 539 the B<x509> utilities B<-nameopt> and B<-certopt> switches can be used
 540 here, except the B<no_signame> and B<no_sigdump> are permanently set
 541 and cannot be disabled (this is because the certificate signature cannot
 542 be displayed because the certificate has not been signed at this point).
 543
 544 For convenience the values B<ca_default> are accepted by both to produce
 545 a reasonable output.
 546
 547 If neither option is present the format used in earlier versions of
 548 OpenSSL is used. Use of the old format is B<strongly> discouraged because
 549 it only displays fields mentioned in the B<policy> section, mishandles
 550 multicharacter string types and does not display extensions.
 551
 552 =item B<copy_extensions>
 553
 554 Determines how extensions in certificate requests should be handled.
 555 If set to B<none> or this option is not present then extensions are
 556 ignored and not copied to the certificate. If set to B<copy> then any
 557 extensions present in the request that are not already present are copied
 558 to the certificate. If set to B<copyall> then all extensions in the
 559 request are copied to the certificate: if the extension is already present
 560 in the certificate it is deleted first. See the B<WARNINGS> section before
 561 using this option.
 562
 563 The main use of this option is to allow a certificate request to supply
 564 values for certain extensions such as subjectAltName.
 565
 566 =back
 567
 568 =head1 POLICY FORMAT
 569
 570 The policy section consists of a set of variables corresponding to
 571 certificate DN fields. If the value is "match" then the field value
 572 must match the same field in the CA certificate. If the value is
 573 "supplied" then it must be present. If the value is "optional" then
 574 it may be present. Any fields not mentioned in the policy section
 575 are silently deleted, unless the B<-preserveDN> option is set but
 576 this can be regarded more of a quirk than intended behaviour.
 577
 578 =head1 SPKAC FORMAT
 579
 580 The input to the B<-spkac> command line option is a Netscape
 581 signed public key and challenge. This will usually come from
 582 the B<KEYGEN> tag in an HTML form to create a new private key.
 583 It is however possible to create SPKACs using the B<spkac> utility.
 584
 585 The file should contain the variable SPKAC set to the value of
 586 the SPKAC and also the required DN components as name value pairs.
 587 If you need to include the same component twice then it can be
 588 preceded by a number and a '.'.
 589
 590 When processing SPKAC format, the output is DER if the B<-out>
 591 flag is used, but PEM format if sending to stdout or the B<-outdir>
 592 flag is used.
 593
 594 =head1 EXAMPLES
 595
 596 Note: these examples assume that the B<ca> directory structure is
 597 already set up and the relevant files already exist. This usually
 598 involves creating a CA certificate and private key with B<req>, a
 599 serial number file and an empty index file and placing them in
 600 the relevant directories.
 601
 602 To use the sample configuration file below the directories demoCA,
 603 demoCA/private and demoCA/newcerts would be created. The CA
 604 certificate would be copied to demoCA/cacert.pem and its private
 605 key to demoCA/private/cakey.pem. A file demoCA/serial would be
 606 created containing for example "01" and the empty index file
 607 demoCA/index.txt.
 608
 609
 610 Sign a certificate request:
 611
 612  openssl ca -in req.pem -out newcert.pem
 613
 614 Sign an SM2 certificate request:
 615
 616  openssl ca -in sm2.csr -out sm2.crt -md sm3 -sigopt "sm2_id:1234567812345678" -sm2-id "1234567812345678"
 617
 618 Sign a certificate request, using CA extensions:
 619
 620  openssl ca -in req.pem -extensions v3_ca -out newcert.pem
 621
 622 Generate a CRL
 623
 624  openssl ca -gencrl -out crl.pem
 625
 626 Sign several requests:
 627
 628  openssl ca -infiles req1.pem req2.pem req3.pem
 629
 630 Certify a Netscape SPKAC:
 631
 632  openssl ca -spkac spkac.txt
 633
 634 A sample SPKAC file (the SPKAC line has been truncated for clarity):
 635
 636  SPKAC=MIG0MGAwXDANBgkqhkiG9w0BAQEFAANLADBIAkEAn7PDhCeV/xIxUg8V70YRxK2A5
 637  CN=Steve Test
 638  emailAddress=steve@openssl.org
 639  0.OU=OpenSSL Group
 640  1.OU=Another Group
 641
 642 A sample configuration file with the relevant sections for B<ca>:
 643
 644  [ ca ]
 645  default_ca      = CA_default            # The default ca section
 646
 647  [ CA_default ]
 648
 649  dir            = ./demoCA              # top dir
 650  database       = $dir/index.txt        # index file.
 651  new_certs_dir  = $dir/newcerts         # new certs dir
 652
 653  certificate    = $dir/cacert.pem       # The CA cert
 654  serial         = $dir/serial           # serial no file
 655  #rand_serial    = yes                  # for random serial#'s
 656  private_key    = $dir/private/cakey.pem# CA private key
 657  RANDFILE       = $dir/private/.rand    # random number file
 658
 659  default_days   = 365                   # how long to certify for
 660  default_crl_days= 30                   # how long before next CRL
 661  default_md     = md5                   # md to use
 662
 663  policy         = policy_any            # default policy
 664  email_in_dn    = no                    # Don't add the email into cert DN
 665
 666  name_opt       = ca_default            # Subject name display option
 667  cert_opt       = ca_default            # Certificate display option
 668  copy_extensions = none                 # Don't copy extensions from request
 669
 670  [ policy_any ]
 671  countryName            = supplied
 672  stateOrProvinceName    = optional
 673  organizationName       = optional
 674  organizationalUnitName = optional
 675  commonName             = supplied
 676  emailAddress           = optional
 677
 678 =head1 FILES
 679
 680 Note: the location of all files can change either by compile time options,
 681 configuration file entries, environment variables or command line options.
 682 The values below reflect the default values.
 683
 684  /usr/local/ssl/lib/openssl.cnf - master configuration file
 685  ./demoCA                       - main CA directory
 686  ./demoCA/cacert.pem            - CA certificate
 687  ./demoCA/private/cakey.pem     - CA private key
 688  ./demoCA/serial                - CA serial number file
 689  ./demoCA/serial.old            - CA serial number backup file
 690  ./demoCA/index.txt             - CA text database file
 691  ./demoCA/index.txt.old         - CA text database backup file
 692  ./demoCA/certs                 - certificate output file
 693  ./demoCA/.rnd                  - CA random seed information
 694
 695 =head1 RESTRICTIONS
 696
 697 The text database index file is a critical part of the process and
 698 if corrupted it can be difficult to fix. It is theoretically possible
 699 to rebuild the index file from all the issued certificates and a current
 700 CRL: however there is no option to do this.
 701
 702 V2 CRL features like delta CRLs are not currently supported.
 703
 704 Although several requests can be input and handled at once it is only
 705 possible to include one SPKAC or self-signed certificate.
 706
 707 =head1 BUGS
 708
 709 The use of an in-memory text database can cause problems when large
 710 numbers of certificates are present because, as the name implies
 711 the database has to be kept in memory.
 712
 713 The B<ca> command really needs rewriting or the required functionality
 714 exposed at either a command or interface level so a more friendly utility
 715 (perl script or GUI) can handle things properly. The script
 716 B<CA.pl> helps a little but not very much.
 717
 718 Any fields in a request that are not present in a policy are silently
 719 deleted. This does not happen if the B<-preserveDN> option is used. To
 720 enforce the absence of the EMAIL field within the DN, as suggested by
 721 RFCs, regardless the contents of the request' subject the B<-noemailDN>
 722 option can be used. The behaviour should be more friendly and
 723 configurable.
 724
 725 Canceling some commands by refusing to certify a certificate can
 726 create an empty file.
 727
 728 =head1 WARNINGS
 729
 730 The B<ca> command is quirky and at times downright unfriendly.
 731
 732 The B<ca> utility was originally meant as an example of how to do things
 733 in a CA. It was not supposed to be used as a full blown CA itself:
 734 nevertheless some people are using it for this purpose.
 735
 736 The B<ca> command is effectively a single user command: no locking is
 737 done on the various files and attempts to run more than one B<ca> command
 738 on the same database can have unpredictable results.
 739
 740 The B<copy_extensions> option should be used with caution. If care is
 741 not taken then it can be a security risk. For example if a certificate
 742 request contains a basicConstraints extension with CA:TRUE and the
 743 B<copy_extensions> value is set to B<copyall> and the user does not spot
 744 this when the certificate is displayed then this will hand the requester
 745 a valid CA certificate.
 746
 747 This situation can be avoided by setting B<copy_extensions> to B<copy>
 748 and including basicConstraints with CA:FALSE in the configuration file.
 749 Then if the request contains a basicConstraints extension it will be
 750 ignored.
 751
 752 It is advisable to also include values for other extensions such
 753 as B<keyUsage> to prevent a request supplying its own values.
 754
 755 Additional restrictions can be placed on the CA certificate itself.
 756 For example if the CA certificate has:
 757
 758  basicConstraints = CA:TRUE, pathlen:0
 759
 760 then even if a certificate is issued with CA:TRUE it will not be valid.
 761
 762 =head1 HISTORY
 763
 764 Since OpenSSL 1.1.1, the program follows RFC5280. Specifically,
 765 certificate validity period (specified by any of B<-startdate>,
 766 B<-enddate> and B<-days>) will be encoded as UTCTime if the dates are
 767 earlier than year 2049 (included), and as GeneralizedTime if the dates
 768 are in year 2050 or later.
 769
 770 =head1 SEE ALSO
 771
 772 L<openssl(1)>,
 773 L<openssl-req(1)>,
 774 L<openssl-spkac(1)>,
 775 L<openssl-x509(1)>,
 776 L<CA.pl(1)>,
 777 L<config(5)>,
 778 L<x509v3_config(5)>
 779
 780 =head1 COPYRIGHT
 781
 782 Copyright 2000-2019 The OpenSSL Project Authors. All Rights Reserved.
 783
 784 Licensed under the Apache License 2.0 (the "License").  You may not use
 785 this file except in compliance with the License.  You can obtain a copy
 786 in the file LICENSE in the source distribution or at
 787 L<https://www.openssl.org/source/license.html>.
 788
 789 =cut