doc/apps/x509.pod

   1
   2 =pod
   3
   4 =head1 NAME
   5
   6 x509 - Certificate display and signing utility
   7
   8 =head1 SYNOPSIS
   9
  10 B<openssl> B<x509>
  11 [B<-inform DER|PEM|NET>]
  12 [B<-outform DER|PEM|NET>]
  13 [B<-keyform DER|PEM>]
  14 [B<-CAform DER|PEM>]
  15 [B<-CAkeyform DER|PEM>]
  16 [B<-in filename>]
  17 [B<-out filename>]
  18 [B<-serial>]
  19 [B<-hash>]
  20 [B<-subject_hash>]
  21 [B<-issuer_hash>]
  22 [B<-subject>]
  23 [B<-issuer>]
  24 [B<-nameopt option>]
  25 [B<-email>]
  26 [B<-startdate>]
  27 [B<-enddate>]
  28 [B<-purpose>]
  29 [B<-dates>]
  30 [B<-modulus>]
  31 [B<-fingerprint>]
  32 [B<-alias>]
  33 [B<-noout>]
  34 [B<-trustout>]
  35 [B<-clrtrust>]
  36 [B<-clrreject>]
  37 [B<-addtrust arg>]
  38 [B<-addreject arg>]
  39 [B<-setalias arg>]
  40 [B<-days arg>]
  41 [B<-set_serial n>]
  42 [B<-signkey filename>]
  43 [B<-x509toreq>]
  44 [B<-req>]
  45 [B<-CA filename>]
  46 [B<-CAkey filename>]
  47 [B<-CAcreateserial>]
  48 [B<-CAserial filename>]
  49 [B<-text>]
  50 [B<-C>]
  51 [B<-md2|-md5|-sha1|-mdc2>]
  52 [B<-clrext>]
  53 [B<-extfile filename>]
  54 [B<-extensions section>]
  55 [B<-engine id>]
  56
  57 =head1 DESCRIPTION
  58
  59 The B<x509> command is a multi purpose certificate utility. It can be
  60 used to display certificate information, convert certificates to
  61 various forms, sign certificate requests like a "mini CA" or edit
  62 certificate trust settings.
  63
  64 Since there are a large number of options they will split up into
  65 various sections.
  66
  67 =head1 OPTIONS
  68
  69 =head2 INPUT, OUTPUT AND GENERAL PURPOSE OPTIONS
  70
  71 =over 4
  72
  73 =item B<-inform DER|PEM|NET>
  74
  75 This specifies the input format normally the command will expect an X509
  76 certificate but this can change if other options such as B<-req> are
  77 present. The DER format is the DER encoding of the certificate and PEM
  78 is the base64 encoding of the DER encoding with header and footer lines
  79 added. The NET option is an obscure Netscape server format that is now
  80 obsolete.
  81
  82 =item B<-outform DER|PEM|NET>
  83
  84 This specifies the output format, the options have the same meaning as the
  85 B<-inform> option.
  86
  87 =item B<-in filename>
  88
  89 This specifies the input filename to read a certificate from or standard input
  90 if this option is not specified.
  91
  92 =item B<-out filename>
  93
  94 This specifies the output filename to write to or standard output by
  95 default.
  96
  97 =item B<-md2|-md5|-sha1|-mdc2>
  98
  99 the digest to use. This affects any signing or display option that uses a message
 100 digest, such as the B<-fingerprint>, B<-signkey> and B<-CA> options. If not
 101 specified then SHA1 is used. If the key being used to sign with is a DSA key
 102 then this option has no effect: SHA1 is always used with DSA keys.
 103
 104 =item B<-engine id>
 105
 106 specifying an engine (by it's unique B<id> string) will cause B<req>
 107 to attempt to obtain a functional reference to the specified engine,
 108 thus initialising it if needed. The engine will then be set as the default
 109 for all available algorithms.
 110
 111 =back
 112
 113 =head2 DISPLAY OPTIONS
 114
 115 Note: the B<-alias> and B<-purpose> options are also display options
 116 but are described in the B<TRUST SETTINGS> section.
 117
 118 =over 4
 119
 120 =item B<-text>
 121
 122 prints out the certificate in text form. Full details are output including the
 123 public key, signature algorithms, issuer and subject names, serial number
 124 any extensions present and any trust settings.
 125
 126 =item B<-certopt option>
 127
 128 customise the output format used with B<-text>. The B<option> argument can be
 129 a single option or multiple options separated by commas. The B<-certopt> switch
 130 may be also be used more than once to set multiple options. See the B<TEXT OPTIONS>
 131 section for more information.
 132
 133 =item B<-noout>
 134
 135 this option prevents output of the encoded version of the request.
 136
 137 =item B<-modulus>
 138
 139 this option prints out the value of the modulus of the public key
 140 contained in the certificate.
 141
 142 =item B<-serial>
 143
 144 outputs the certificate serial number.
 145
 146 =item B<-subject_hash>
 147
 148 outputs the "hash" of the certificate subject name. This is used in OpenSSL to
 149 form an index to allow certificates in a directory to be looked up by subject
 150 name.
 151
 152 =item B<-issuer_hash>
 153
 154 outputs the "hash" of the certificate issuer name.
 155
 156 =item B<-hash>
 157
 158 synonym for "-hash" for backward compatibility reasons.
 159
 160 =item B<-subject>
 161
 162 outputs the subject name.
 163
 164 =item B<-issuer>
 165
 166 outputs the issuer name.
 167
 168 =item B<-nameopt option>
 169
 170 option which determines how the subject or issuer names are displayed. The
 171 B<option> argument can be a single option or multiple options separated by
 172 commas.  Alternatively the B<-nameopt> switch may be used more than once to
 173 set multiple options. See the B<NAME OPTIONS> section for more information.
 174
 175 =item B<-email>
 176
 177 outputs the email address(es) if any.
 178
 179 =item B<-startdate>
 180
 181 prints out the start date of the certificate, that is the notBefore date.
 182
 183 =item B<-enddate>
 184
 185 prints out the expiry date of the certificate, that is the notAfter date.
 186
 187 =item B<-dates>
 188
 189 prints out the start and expiry dates of a certificate.
 190
 191 =item B<-fingerprint>
 192
 193 prints out the digest of the DER encoded version of the whole certificate
 194 (see digest options).
 195
 196 =item B<-C>
 197
 198 this outputs the certificate in the form of a C source file.
 199
 200 =back
 201
 202 =head2 TRUST SETTINGS
 203
 204 Please note these options are currently experimental and may well change.
 205
 206 A B<trusted certificate> is an ordinary certificate which has several
 207 additional pieces of information attached to it such as the permitted
 208 and prohibited uses of the certificate and an "alias".
 209
 210 Normally when a certificate is being verified at least one certificate
 211 must be "trusted". By default a trusted certificate must be stored
 212 locally and must be a root CA: any certificate chain ending in this CA
 213 is then usable for any purpose.
 214
 215 Trust settings currently are only used with a root CA. They allow a finer
 216 control over the purposes the root CA can be used for. For example a CA
 217 may be trusted for SSL client but not SSL server use.
 218
 219 See the description of the B<verify> utility for more information on the
 220 meaning of trust settings.
 221
 222 Future versions of OpenSSL will recognize trust settings on any
 223 certificate: not just root CAs.
 224
 225
 226 =over 4
 227
 228 =item B<-trustout>
 229
 230 this causes B<x509> to output a B<trusted> certificate. An ordinary
 231 or trusted certificate can be input but by default an ordinary
 232 certificate is output and any trust settings are discarded. With the
 233 B<-trustout> option a trusted certificate is output. A trusted
 234 certificate is automatically output if any trust settings are modified.
 235
 236 =item B<-setalias arg>
 237
 238 sets the alias of the certificate. This will allow the certificate
 239 to be referred to using a nickname for example "Steve's Certificate".
 240
 241 =item B<-alias>
 242
 243 outputs the certificate alias, if any.
 244
 245 =item B<-clrtrust>
 246
 247 clears all the permitted or trusted uses of the certificate.
 248
 249 =item B<-clrreject>
 250
 251 clears all the prohibited or rejected uses of the certificate.
 252
 253 =item B<-addtrust arg>
 254
 255 adds a trusted certificate use. Any object name can be used here
 256 but currently only B<clientAuth> (SSL client use), B<serverAuth>
 257 (SSL server use) and B<emailProtection> (S/MIME email) are used.
 258 Other OpenSSL applications may define additional uses.
 259
 260 =item B<-addreject arg>
 261
 262 adds a prohibited use. It accepts the same values as the B<-addtrust>
 263 option.
 264
 265 =item B<-purpose>
 266
 267 this option performs tests on the certificate extensions and outputs
 268 the results. For a more complete description see the B<CERTIFICATE
 269 EXTENSIONS> section.
 270
 271 =back
 272
 273 =head2 SIGNING OPTIONS
 274
 275 The B<x509> utility can be used to sign certificates and requests: it
 276 can thus behave like a "mini CA".
 277
 278 =over 4
 279
 280 =item B<-signkey filename>
 281
 282 this option causes the input file to be self signed using the supplied
 283 private key.
 284
 285 If the input file is a certificate it sets the issuer name to the
 286 subject name (i.e.  makes it self signed) changes the public key to the
 287 supplied value and changes the start and end dates. The start date is
 288 set to the current time and the end date is set to a value determined
 289 by the B<-days> option. Any certificate extensions are retained unless
 290 the B<-clrext> option is supplied.
 291
 292 If the input is a certificate request then a self signed certificate
 293 is created using the supplied private key using the subject name in
 294 the request.
 295
 296 =item B<-clrext>
 297
 298 delete any extensions from a certificate. This option is used when a
 299 certificate is being created from another certificate (for example with
 300 the B<-signkey> or the B<-CA> options). Normally all extensions are
 301 retained.
 302
 303 =item B<-keyform PEM|DER>
 304
 305 specifies the format (DER or PEM) of the private key file used in the
 306 B<-signkey> option.
 307
 308 =item B<-days arg>
 309
 310 specifies the number of days to make a certificate valid for. The default
 311 is 30 days.
 312
 313 =item B<-x509toreq>
 314
 315 converts a certificate into a certificate request. The B<-signkey> option
 316 is used to pass the required private key.
 317
 318 =item B<-req>
 319
 320 by default a certificate is expected on input. With this option a
 321 certificate request is expected instead.
 322
 323 =item B<-set_serial n>
 324
 325 specifies the serial number to use. This option can be used with either
 326 the B<-signkey> or B<-CA> options. If used in conjunction with the B<-CA>
 327 option the serial number file (as specified by the B<-CAserial> or
 328 B<-CAcreateserial> options) is not used.
 329
 330 The serial number can be decimal or hex (if preceded by B<0x>). Negative
 331 serial numbers can also be specified but their use is not recommended.
 332
 333 =item B<-CA filename>
 334
 335 specifies the CA certificate to be used for signing. When this option is
 336 present B<x509> behaves like a "mini CA". The input file is signed by this
 337 CA using this option: that is its issuer name is set to the subject name
 338 of the CA and it is digitally signed using the CAs private key.
 339
 340 This option is normally combined with the B<-req> option. Without the
 341 B<-req> option the input is a certificate which must be self signed.
 342
 343 =item B<-CAkey filename>
 344
 345 sets the CA private key to sign a certificate with. If this option is
 346 not specified then it is assumed that the CA private key is present in
 347 the CA certificate file.
 348
 349 =item B<-CAserial filename>
 350
 351 sets the CA serial number file to use.
 352
 353 When the B<-CA> option is used to sign a certificate it uses a serial
 354 number specified in a file. This file consist of one line containing
 355 an even number of hex digits with the serial number to use. After each
 356 use the serial number is incremented and written out to the file again.
 357
 358 The default filename consists of the CA certificate file base name with
 359 ".srl" appended. For example if the CA certificate file is called
 360 "mycacert.pem" it expects to find a serial number file called "mycacert.srl".
 361
 362 =item B<-CAcreateserial>
 363
 364 with this option the CA serial number file is created if it does not exist:
 365 it will contain the serial number "02" and the certificate being signed will
 366 have the 1 as its serial number. Normally if the B<-CA> option is specified
 367 and the serial number file does not exist it is an error.
 368
 369 =item B<-extfile filename>
 370
 371 file containing certificate extensions to use. If not specified then
 372 no extensions are added to the certificate.
 373
 374 =item B<-extensions section>
 375
 376 the section to add certificate extensions from. If this option is not
 377 specified then the extensions should either be contained in the unnamed
 378 (default) section or the default section should contain a variable called
 379 "extensions" which contains the section to use. See the
 380 L<x509v3_config(5)|x509v3_config(5)> manual page for details of the
 381 extension section format.
 382
 383 =back
 384
 385 =head2 NAME OPTIONS
 386
 387 The B<nameopt> command line switch determines how the subject and issuer
 388 names are displayed. If no B<nameopt> switch is present the default "oneline"
 389 format is used which is compatible with previous versions of OpenSSL.
 390 Each option is described in detail below, all options can be preceded by
 391 a B<-> to turn the option off. Only the first four will normally be used.
 392
 393 =over 4
 394
 395 =item B<compat>
 396
 397 use the old format. This is equivalent to specifying no name options at all.
 398
 399 =item B<RFC2253>
 400
 401 displays names compatible with RFC2253 equivalent to B<esc_2253>, B<esc_ctrl>,
 402 B<esc_msb>, B<utf8>, B<dump_nostr>, B<dump_unknown>, B<dump_der>,
 403 B<sep_comma_plus>, B<dn_rev> and B<sname>.
 404
 405 =item B<oneline>
 406
 407 a oneline format which is more readable than RFC2253. It is equivalent to
 408 specifying the  B<esc_2253>, B<esc_ctrl>, B<esc_msb>, B<utf8>, B<dump_nostr>,
 409 B<dump_der>, B<use_quote>, B<sep_comma_plus_spc>, B<spc_eq> and B<sname>
 410 options.
 411
 412 =item B<multiline>
 413
 414 a multiline format. It is equivalent B<esc_ctrl>, B<esc_msb>, B<sep_multiline>,
 415 B<spc_eq>, B<lname> and B<align>.
 416
 417 =item B<esc_2253>
 418
 419 escape the "special" characters required by RFC2253 in a field That is
 420 B<,+"E<lt>E<gt>;>. Additionally B<#> is escaped at the beginning of a string
 421 and a space character at the beginning or end of a string.
 422
 423 =item B<esc_ctrl>
 424
 425 escape control characters. That is those with ASCII values less than
 426 0x20 (space) and the delete (0x7f) character. They are escaped using the
 427 RFC2253 \XX notation (where XX are two hex digits representing the
 428 character value).
 429
 430 =item B<esc_msb>
 431
 432 escape characters with the MSB set, that is with ASCII values larger than
 433 127.
 434
 435 =item B<use_quote>
 436
 437 escapes some characters by surrounding the whole string with B<"> characters,
 438 without the option all escaping is done with the B<\> character.
 439
 440 =item B<utf8>
 441
 442 convert all strings to UTF8 format first. This is required by RFC2253. If
 443 you are lucky enough to have a UTF8 compatible terminal then the use
 444 of this option (and B<not> setting B<esc_msb>) may result in the correct
 445 display of multibyte (international) characters. Is this option is not
 446 present then multibyte characters larger than 0xff will be represented
 447 using the format \UXXXX for 16 bits and \WXXXXXXXX for 32 bits.
 448 Also if this option is off any UTF8Strings will be converted to their
 449 character form first.
 450
 451 =item B<no_type>
 452
 453 this option does not attempt to interpret multibyte characters in any
 454 way. That is their content octets are merely dumped as though one octet
 455 represents each character. This is useful for diagnostic purposes but
 456 will result in rather odd looking output.
 457
 458 =item B<show_type>
 459
 460 show the type of the ASN1 character string. The type precedes the
 461 field contents. For example "BMPSTRING: Hello World".
 462
 463 =item B<dump_der>
 464
 465 when this option is set any fields that need to be hexdumped will
 466 be dumped using the DER encoding of the field. Otherwise just the
 467 content octets will be displayed. Both options use the RFC2253
 468 B<#XXXX...> format.
 469
 470 =item B<dump_nostr>
 471
 472 dump non character string types (for example OCTET STRING) if this
 473 option is not set then non character string types will be displayed
 474 as though each content octet represents a single character.
 475
 476 =item B<dump_all>
 477
 478 dump all fields. This option when used with B<dump_der> allows the
 479 DER encoding of the structure to be unambiguously determined.
 480
 481 =item B<dump_unknown>
 482
 483 dump any field whose OID is not recognised by OpenSSL.
 484
 485 =item B<sep_comma_plus>, B<sep_comma_plus_space>, B<sep_semi_plus_space>,
 486 B<sep_multiline>
 487
 488 these options determine the field separators. The first character is
 489 between RDNs and the second between multiple AVAs (multiple AVAs are
 490 very rare and their use is discouraged). The options ending in
 491 "space" additionally place a space after the separator to make it
 492 more readable. The B<sep_multiline> uses a linefeed character for
 493 the RDN separator and a spaced B<+> for the AVA separator. It also
 494 indents the fields by four characters.
 495
 496 =item B<dn_rev>
 497
 498 reverse the fields of the DN. This is required by RFC2253. As a side
 499 effect this also reverses the order of multiple AVAs but this is
 500 permissible.
 501
 502 =item B<nofname>, B<sname>, B<lname>, B<oid>
 503
 504 these options alter how the field name is displayed. B<nofname> does
 505 not display the field at all. B<sname> uses the "short name" form
 506 (CN for commonName for example). B<lname> uses the long form.
 507 B<oid> represents the OID in numerical form and is useful for
 508 diagnostic purpose.
 509
 510 =item B<align>
 511
 512 align field values for a more readable output. Only usable with
 513 B<sep_multiline>.
 514
 515 =item B<spc_eq>
 516
 517 places spaces round the B<=> character which follows the field
 518 name.
 519
 520 =back
 521
 522 =head2 TEXT OPTIONS
 523
 524 As well as customising the name output format, it is also possible to
 525 customise the actual fields printed using the B<certopt> options when
 526 the B<text> option is present. The default behaviour is to print all fields.
 527
 528 =over 4
 529
 530 =item B<compatible>
 531
 532 use the old format. This is equivalent to specifying no output options at all.
 533
 534 =item B<no_header>
 535
 536 don't print header information: that is the lines saying "Certificate" and "Data".
 537
 538 =item B<no_version>
 539
 540 don't print out the version number.
 541
 542 =item B<no_serial>
 543
 544 don't print out the serial number.
 545
 546 =item B<no_signame>
 547
 548 don't print out the signature algorithm used.
 549
 550 =item B<no_validity>
 551
 552 don't print the validity, that is the B<notBefore> and B<notAfter> fields.
 553
 554 =item B<no_subject>
 555
 556 don't print out the subject name.
 557
 558 =item B<no_issuer>
 559
 560 don't print out the issuer name.
 561
 562 =item B<no_pubkey>
 563
 564 don't print out the public key.
 565
 566 =item B<no_sigdump>
 567
 568 don't give a hexadecimal dump of the certificate signature.
 569
 570 =item B<no_aux>
 571
 572 don't print out certificate trust information.
 573
 574 =item B<no_extensions>
 575
 576 don't print out any X509V3 extensions.
 577
 578 =item B<ext_default>
 579
 580 retain default extension behaviour: attempt to print out unsupported certificate extensions.
 581
 582 =item B<ext_error>
 583
 584 print an error message for unsupported certificate extensions.
 585
 586 =item B<ext_parse>
 587
 588 ASN1 parse unsupported extensions.
 589
 590 =item B<ext_dump>
 591
 592 hex dump unsupported extensions.
 593
 594 =item B<ca_default>
 595
 596 the value used by the B<ca> utility, equivalent to B<no_issuer>, B<no_pubkey>, B<no_header>,
 597 B<no_version>, B<no_sigdump> and B<no_signame>.
 598
 599 =back
 600
 601 =head1 EXAMPLES
 602
 603 Note: in these examples the '\' means the example should be all on one
 604 line.
 605
 606 Display the contents of a certificate:
 607
 608  openssl x509 -in cert.pem -noout -text
 609
 610 Display the certificate serial number:
 611
 612  openssl x509 -in cert.pem -noout -serial
 613
 614 Display the certificate subject name:
 615
 616  openssl x509 -in cert.pem -noout -subject
 617
 618 Display the certificate subject name in RFC2253 form:
 619
 620  openssl x509 -in cert.pem -noout -subject -nameopt RFC2253
 621
 622 Display the certificate subject name in oneline form on a terminal
 623 supporting UTF8:
 624
 625  openssl x509 -in cert.pem -noout -subject -nameopt oneline,-escmsb
 626
 627 Display the certificate MD5 fingerprint:
 628
 629  openssl x509 -in cert.pem -noout -fingerprint
 630
 631 Display the certificate SHA1 fingerprint:
 632
 633  openssl x509 -sha1 -in cert.pem -noout -fingerprint
 634
 635 Convert a certificate from PEM to DER format:
 636
 637  openssl x509 -in cert.pem -inform PEM -out cert.der -outform DER
 638
 639 Convert a certificate to a certificate request:
 640
 641  openssl x509 -x509toreq -in cert.pem -out req.pem -signkey key.pem
 642
 643 Convert a certificate request into a self signed certificate using
 644 extensions for a CA:
 645
 646  openssl x509 -req -in careq.pem -extfile openssl.cnf -extensions v3_ca \
 647         -signkey key.pem -out cacert.pem
 648
 649 Sign a certificate request using the CA certificate above and add user
 650 certificate extensions:
 651
 652  openssl x509 -req -in req.pem -extfile openssl.cnf -extensions v3_usr \
 653         -CA cacert.pem -CAkey key.pem -CAcreateserial
 654
 655
 656 Set a certificate to be trusted for SSL client use and change set its alias to
 657 "Steve's Class 1 CA"
 658
 659  openssl x509 -in cert.pem -addtrust clientAuth \
 660         -setalias "Steve's Class 1 CA" -out trust.pem
 661
 662 =head1 NOTES
 663
 664 The PEM format uses the header and footer lines:
 665
 666  -----BEGIN CERTIFICATE-----
 667  -----END CERTIFICATE-----
 668
 669 it will also handle files containing:
 670
 671  -----BEGIN X509 CERTIFICATE-----
 672  -----END X509 CERTIFICATE-----
 673
 674 Trusted certificates have the lines
 675
 676  -----BEGIN TRUSTED CERTIFICATE-----
 677  -----END TRUSTED CERTIFICATE-----
 678
 679 The conversion to UTF8 format used with the name options assumes that
 680 T61Strings use the ISO8859-1 character set. This is wrong but Netscape
 681 and MSIE do this as do many certificates. So although this is incorrect
 682 it is more likely to display the majority of certificates correctly.
 683
 684 The B<-fingerprint> option takes the digest of the DER encoded certificate.
 685 This is commonly called a "fingerprint". Because of the nature of message
 686 digests the fingerprint of a certificate is unique to that certificate and
 687 two certificates with the same fingerprint can be considered to be the same.
 688
 689 The Netscape fingerprint uses MD5 whereas MSIE uses SHA1.
 690
 691 The B<-email> option searches the subject name and the subject alternative
 692 name extension. Only unique email addresses will be printed out: it will
 693 not print the same address more than once.
 694
 695 =head1 CERTIFICATE EXTENSIONS
 696
 697 The B<-purpose> option checks the certificate extensions and determines
 698 what the certificate can be used for. The actual checks done are rather
 699 complex and include various hacks and workarounds to handle broken
 700 certificates and software.
 701
 702 The same code is used when verifying untrusted certificates in chains
 703 so this section is useful if a chain is rejected by the verify code.
 704
 705 The basicConstraints extension CA flag is used to determine whether the
 706 certificate can be used as a CA. If the CA flag is true then it is a CA,
 707 if the CA flag is false then it is not a CA. B<All> CAs should have the
 708 CA flag set to true.
 709
 710 If the basicConstraints extension is absent then the certificate is
 711 considered to be a "possible CA" other extensions are checked according
 712 to the intended use of the certificate. A warning is given in this case
 713 because the certificate should really not be regarded as a CA: however
 714 it is allowed to be a CA to work around some broken software.
 715
 716 If the certificate is a V1 certificate (and thus has no extensions) and
 717 it is self signed it is also assumed to be a CA but a warning is again
 718 given: this is to work around the problem of Verisign roots which are V1
 719 self signed certificates.
 720
 721 If the keyUsage extension is present then additional restraints are
 722 made on the uses of the certificate. A CA certificate B<must> have the
 723 keyCertSign bit set if the keyUsage extension is present.
 724
 725 The extended key usage extension places additional restrictions on the
 726 certificate uses. If this extension is present (whether critical or not)
 727 the key can only be used for the purposes specified.
 728
 729 A complete description of each test is given below. The comments about
 730 basicConstraints and keyUsage and V1 certificates above apply to B<all>
 731 CA certificates.
 732
 733
 734 =over 4
 735
 736 =item B<SSL Client>
 737
 738 The extended key usage extension must be absent or include the "web client
 739 authentication" OID.  keyUsage must be absent or it must have the
 740 digitalSignature bit set. Netscape certificate type must be absent or it must
 741 have the SSL client bit set.
 742
 743 =item B<SSL Client CA>
 744
 745 The extended key usage extension must be absent or include the "web client
 746 authentication" OID. Netscape certificate type must be absent or it must have
 747 the SSL CA bit set: this is used as a work around if the basicConstraints
 748 extension is absent.
 749
 750 =item B<SSL Server>
 751
 752 The extended key usage extension must be absent or include the "web server
 753 authentication" and/or one of the SGC OIDs.  keyUsage must be absent or it
 754 must have the digitalSignature, the keyEncipherment set or both bits set.
 755 Netscape certificate type must be absent or have the SSL server bit set.
 756
 757 =item B<SSL Server CA>
 758
 759 The extended key usage extension must be absent or include the "web server
 760 authentication" and/or one of the SGC OIDs.  Netscape certificate type must
 761 be absent or the SSL CA bit must be set: this is used as a work around if the
 762 basicConstraints extension is absent.
 763
 764 =item B<Netscape SSL Server>
 765
 766 For Netscape SSL clients to connect to an SSL server it must have the
 767 keyEncipherment bit set if the keyUsage extension is present. This isn't
 768 always valid because some cipher suites use the key for digital signing.
 769 Otherwise it is the same as a normal SSL server.
 770
 771 =item B<Common S/MIME Client Tests>
 772
 773 The extended key usage extension must be absent or include the "email
 774 protection" OID. Netscape certificate type must be absent or should have the
 775 S/MIME bit set. If the S/MIME bit is not set in netscape certificate type
 776 then the SSL client bit is tolerated as an alternative but a warning is shown:
 777 this is because some Verisign certificates don't set the S/MIME bit.
 778
 779 =item B<S/MIME Signing>
 780
 781 In addition to the common S/MIME client tests the digitalSignature bit must
 782 be set if the keyUsage extension is present.
 783
 784 =item B<S/MIME Encryption>
 785
 786 In addition to the common S/MIME tests the keyEncipherment bit must be set
 787 if the keyUsage extension is present.
 788
 789 =item B<S/MIME CA>
 790
 791 The extended key usage extension must be absent or include the "email
 792 protection" OID. Netscape certificate type must be absent or must have the
 793 S/MIME CA bit set: this is used as a work around if the basicConstraints
 794 extension is absent.
 795
 796 =item B<CRL Signing>
 797
 798 The keyUsage extension must be absent or it must have the CRL signing bit
 799 set.
 800
 801 =item B<CRL Signing CA>
 802
 803 The normal CA tests apply. Except in this case the basicConstraints extension
 804 must be present.
 805
 806 =back
 807
 808 =head1 BUGS
 809
 810 Extensions in certificates are not transferred to certificate requests and
 811 vice versa.
 812
 813 It is possible to produce invalid certificates or requests by specifying the
 814 wrong private key or using inconsistent options in some cases: these should
 815 be checked.
 816
 817 There should be options to explicitly set such things as start and end
 818 dates rather than an offset from the current time.
 819
 820 The code to implement the verify behaviour described in the B<TRUST SETTINGS>
 821 is currently being developed. It thus describes the intended behaviour rather
 822 than the current behaviour. It is hoped that it will represent reality in
 823 OpenSSL 0.9.5 and later.
 824
 825 =head1 SEE ALSO
 826
 827 L<req(1)|req(1)>, L<ca(1)|ca(1)>, L<genrsa(1)|genrsa(1)>,
 828 L<gendsa(1)|gendsa(1)>, L<verify(1)|verify(1)>
 829
 830 =head1 HISTORY
 831
 832 Before OpenSSL 0.9.8, the default digest for RSA keys was MD5.
 833
 834 =cut