diff --git a/doc/apps/ca.pod b/doc/apps/ca.pod index 5a2838e9..85ef8761 100644 --- a/doc/apps/ca.pod +++ b/doc/apps/ca.pod @@ -64,6 +64,9 @@ and their status. The options descriptions will be divided into each purpose. +ca指令是CA中很小的应用。它可以用来签发各种形式的用户证书并产生CRL。它还可以用来更新证书库。 +在这些指令的介绍中,将尽可能地对它们进行分类介绍。 + =head1 OPTIONS =over 4 @@ -72,70 +75,99 @@ The options descriptions will be divided into each purpose. Print out a usage message. +显示用法信息。 + =item B<-verbose> this prints extra details about the operations being performed. +输出更详细的一些操作过程信息。 + =item B<-config filename> specifies the configuration file to use. +指定将要使用的配置文件。 + =item B<-name section> specifies the configuration file section to use (overrides B in the B section). +指定将要使用的配置文件部分(覆盖ca部分中的default_ca部分) + =item B<-in filename> an input filename containing a single certificate request to be signed by the CA. +一个输入文件名包含了一个要由CA签名的单独证书请求。 + =item B<-ss_cert filename> a single self-signed certificate to be signed by the CA. +一个要由CA签名的自签名证书。 + =item B<-spkac filename> a file containing a single Netscape signed public key and challenge and additional field values to be signed by the CA. See the B section for information on the required input and output format. +一个包含了一个单独的Netscape签名的公钥和其他附加用户信息。 +关于输入输出格式的信息具体可以参考SPKAC部分。 + =item B<-infiles> if present this should be the last option, all subsequent arguments are taken as the names of files containing certificate requests. +该选项总是作为指令的最后一个选项,其后面所有的参数都被认为是证书请求文件。 + =item B<-out filename> the output file to output certificates to. The default is standard output. The certificate details will also be printed out to this file in PEM format (except that B<-spkac> outputs DER format). +输出文件输出签发好的证书。默认值为标准输出。输出的证书都是PEM编码的(除了spkac输出DER编码) + =item B<-outdir directory> the directory to output certificates to. The certificate will be written to a filename consisting of the serial number in hex with ".pem" appended. +将新生成的证书输出到目录。新生成证书将会序列号加“pem”后缀成为一个完整的证书文件名。 + =item B<-cert> the CA certificate file. +CA证书文件。 + =item B<-keyfile filename> the private key to sign requests with. +用于签署请求的私钥。 + =item B<-keyform PEM|DER> the format of the data in the private key file. The default is PEM. +私钥文件中数据的格式。默认为PEM。 + =item B<-key password> the password used to encrypt the private key. Since on some systems the command line arguments are visible (e.g. Unix with the 'ps' utility) this option should be used with caution. +用于加密私钥的密码。因为在某些系统上命令行参数是可见的(例如使用“ps”实用程序的Unix),应谨慎使用此指令。 + =item B<-selfsign> indicates the issued certificates are to be signed with the key @@ -150,35 +182,54 @@ certificate appears among the entries in the certificate database serial number counter as all other certificates sign with the self-signed certificate. +表示发出的证书将使用证书请求签名的密钥(以-keyfile命名)进行签名。 +使用不同密钥签名的证书请求将被忽略。如果给出-spkac,-ss_cert或-gencrl,则忽略-selfsign + +使用-selfsign的结果是自签名证书出现在证书数据库的条目中,并使用与其他证书相同的序列号计数器。 + =item B<-passin arg> the key password source. For more information about the format of B see the B section in L. +给定了读取私钥文件的时候需要提供的口令。 + =item B<-notext> don't output the text form of a certificate to the output file. +不把证书的文本形式输出到输出文件。 + =item B<-startdate date> this allows the start date to be explicitly set. The format of the date is YYMMDDHHMMSSZ (the same as an ASN1 UTCTime structure). +设置证书的生效时间,其参数格式是“YYMMDDHHMMSSZ”。 + =item B<-enddate date> this allows the expiry date to be explicitly set. The format of the date is YYMMDDHHMMSSZ (the same as an ASN1 UTCTime structure). +设置证书的到期时间,其参数格式是“YYMMDDHHMMSSZ”。 + =item B<-days arg> the number of days to certify the certificate for. +设置证书的有效天数。 + =item B<-md alg> the message digest to use. Any digest supported by the GmSSL B command can be used. This option also applies to CRLs. +消息摘要使用。 +可以使用GmSSL dgst命令支持的任何摘要。 +该选项也适用于CRLs。 + =item B<-policy arg> this option defines the CA "policy" to use. This is a section in @@ -186,6 +237,9 @@ the configuration file which decides which fields should be mandatory or match the CA certificate. Check out the B section for more information. +该选项定义了CA的匹配策略。这是配置文件中的一部分,它决定了哪些字段应该是必须的 +或与CA证书匹配。查看policy format部分来了解更多信息。 + =item B<-msie_hack> this is a legacy option to make B work with very old versions of @@ -194,6 +248,10 @@ for almost everything. Since the old control has various security bugs its use is strongly discouraged. The newer control "Xenroll" does not need this option. +这是一个遗留的项目,它可以使ca可以使用非常老的ie证书注册控件centenr3.它几乎所有东西 +都使用了UniversalStrings。我们非常不推荐使用旧版控件应为它有很多的安全漏洞。新的控件 +Xenroll不需要这一项。 + =item B<-preserveDN> Normally the DN order of a certificate is the same as the order of the @@ -202,6 +260,10 @@ is the same as the request. This is largely for compatibility with the older IE enrollment control which would only accept certificates if their DNs match the order of the request. This is not needed for Xenroll. +使指令在签发证书的时候让证书主体名称内的各项内容顺序跟证书请求中的顺序保持一致。 +而在默认情况下,证书主题名称内的各个选项顺序是按照配置文件中的证书匹配策略子段的 +选项顺序进行排列的。 + =item B<-noemailDN> The DN of a certificate can contain the EMAIL field if present in the @@ -211,11 +273,17 @@ EMAIL field is removed from the certificate' subject and set only in the, eventually present, extensions. The B keyword can be used in the configuration file to enable this behaviour. +一个证书的主体名称可以包含E-mail项目,但是将电子邮件放在主体别名中会更好一点。 +当你启用这个选项后e-mail会从证书主体名称移除并最终设在主体别名中。 +可以在配置文件中使用email_in_dn来启用这个行为。 + =item B<-batch> this sets the batch mode. In this mode no questions will be asked and all certificates will be certified automatically. +该选项设定batch模式。在这一模式中ca指令不提示用户输入任何信息而直接签发所有输入的证书请求。 + =item B<-extensions section> the section of the configuration file containing certificate extensions @@ -226,12 +294,18 @@ is present (even if it is empty), then a V3 certificate is created. See the:w L manual page for details of the extension section format. +配置文件部分包含了颁发证书时要添加的证书扩展名(默认为x509_extensions,除非使用-extfile选项)。 +如果没有扩展部分,则创建V1证书。如果存在扩展部分(即使该部分为空),则创建V3证书。 +有关扩展部分格式的详细信息,请参阅x509v3_config(5)手册页。 + =item B<-extfile file> an additional configuration file to read certificate extensions from (using the default section unless the B<-extensions> option is also used). +一个专门用来保存X.509 v3扩展项信息的文件。 + =item B<-engine id> specifying an engine (by its unique B string) will cause B @@ -239,12 +313,17 @@ to attempt to obtain a functional reference to the specified engine, thus initialising it if needed. The engine will then be set as the default for all available algorithms. +指定一个引擎(通过其唯一的id字符串)会导致ca尝试获取对指定engine设备的功能引用 +并进行初始化如果需要。这个engine将被设置为所有可用算法的默认。 + =item B<-subj arg> supersedes subject name given in the request. The arg must be formatted as I, characters may be escaped by \ (backslash), no spaces are skipped. +重新填写用户的证书主体名称。subj选项的参数格式为/type0=value0/type1=value1/type2...,字符可能会被\转义,空格不被跳过。 + =item B<-utf8> this option causes field values to be interpreted as UTF8 strings, by @@ -252,17 +331,23 @@ default they are interpreted as ASCII. This means that the field values, whether prompted from a terminal or obtained from a configuration file, must be valid UTF8 strings. +这一选项字段值转为UTF8字符串,默认情况下为ASCII。这意味着字段值(无论从终端提示还是从配置文件获取)都必须是有效的UTF8字符串。 + =item B<-create_serial> if reading serial from the text file as specified in the configuration fails, specifying this option creates a new random serial to be used as next serial number. +如果从配置中指定的文本文件读取序列失败,该选项可以创造一个新的随机序列作为下一个序列号。 + =item B<-multivalue-rdn> This option causes the -subj argument to be interpreted with full support for multivalued RDNs. Example: +该选项可以解释-subj参数,并完全支持多RND。 + I If -multi-rdn is not used then the UID value is I<123456+CN=John Doe>. @@ -277,32 +362,46 @@ If -multi-rdn is not used then the UID value is I<123456+CN=John Doe>. this option generates a CRL based on information in the index file. +该选项用于生成一个基于索引文件信息的CFL, + =item B<-crldays num> the number of days before the next CRL is due. That is the days from now to place in the CRL nextUpdate field. +以“天”为单位设置CRL的有效期。 + =item B<-crlhours num> the number of hours before the next CRL is due. +以小时为单位设置CRL有效期。 + =item B<-revoke filename> a filename containing a certificate to revoke. +一个包含要撤销的证书的文件名 + =item B<-valid filename> a filename containing a certificate to add a Valid certificate entry. +一个包含添加有效证书条目的证书的文件名。 + =item B<-status serial> displays the revocation status of the certificate with the specified serial number and exits. +显示具有指定序列号的证书的撤销状态并退出。 + =item B<-updatedb> Updates the database index to purge expired certificates. +更新数据库索引清除以过期的证书。 + =item B<-crl_reason reason> revocation reason, where B is one of: B, B, @@ -313,6 +412,10 @@ insensitive. Setting any revocation reason will make the CRL v2. In practice B is not particularly useful because it is only used in delta CRLs which are not currently implemented. +撤销原因,其中的原因有:未指定,key妥协,CA妥协,联系改变,superseded,cessationofoperation,insensitive。设置任何撤销原因将使CRL变成v2. + +实际上,removeFromCRL不是特别有用因为,因为它仅用于当前未实现的deltaCRL。 + =item B<-crl_hold instruction> This sets the CRL revocation reason code to B and the hold @@ -320,16 +423,23 @@ instruction to B which must be an OID. Although any OID can be used only B (the use of which is discouraged by RFC2459) B or B will normally be used. +这会将CRL撤销原因代码设置为certificatehold,并将指令的保持指令设置为必须是OID的指令。 +虽然任何OID只能使用holdInstructionNone*RFC2459不鼓励使用它),但通常会使用holdInstructionCallIssuer或holdInstruvtionReject。 + =item B<-crl_compromise time> This sets the revocation reason to B and the compromise time to B