diff --git a/doc/apps/ca.pod b/doc/apps/ca.pod index 6c918e07..85ef8761 100644 --- a/doc/apps/ca.pod +++ b/doc/apps/ca.pod @@ -4,8 +4,6 @@ =head1 NAME -=encoding utf8 - ca - sample minimal CA application =head1 SYNOPSIS @@ -67,7 +65,7 @@ and their status. The options descriptions will be divided into each purpose. ca指令是CA中很小的应用。它可以用来签发各种形式的用户证书并产生CRL。它还可以用来更新证书库。 -在这些选项的介绍中,将尽可能地对它们进行分类介绍。 +在这些指令的介绍中,将尽可能地对它们进行分类介绍。 =head1 OPTIONS @@ -168,7 +166,7 @@ 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),应谨慎使用此选项。 +用于加密私钥的密码。因为在某些系统上命令行参数是可见的(例如使用“ps”实用程序的Unix),应谨慎使用此指令。 =item B<-selfsign> @@ -266,7 +264,6 @@ 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 @@ -276,13 +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 @@ -293,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 @@ -306,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 @@ -319,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>. @@ -344,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, @@ -380,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 @@ -387,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