Apache模块mod_ssl

SSLCACertificateFile 指令

该指令设置了一个多文件，您可以在其中汇编与您处理其客户的证书颁发机构的证书（CA）。这些用于客户端身份验证。按照优先顺序，此文件只是各种PEM编码的证书文件的串联。可以替代地和/或附加地使用它 SSLCACertificatePath。

SSLCACertificateFile "/usr/local/apache2/conf/ssl.crt/ca-bundle-client.crt"

SSLCACertificatePath 指令

此伪指令设置目录，在该目录中保留与您处理客户的证书颁发机构证书（CA）。这些用于验证客户端身份验证上的客户端证书。

此目录中的文件必须经过PEM编码，并可以通过哈希文件名进行访问。因此，通常不能只将证书文件放在此处：还必须创建名为hash-value的符号链接 .N。并且您应始终确保此目录包含适当的符号链接。

SSLCACertificatePath "/usr/local/apache2/conf/ssl.crt/"

SSLCADNRequestFile 指令

当mod_ssl请求客户端证书时，可接受的证书颁发机构名称列表将 通过SSL握手发送给客户端。客户端可以使用这些CA名称从可用的证书中选择适当的客户端证书。

如果既没有给出指令，SSLCADNRequestPath也SSLCADNRequestFile没有给出，则发送给客户端的一组可接受的CA名称就是SSLCACertificateFileand SSLCACertificatePath指令给出的所有CA证书的名称；换句话说，实际上将用于验证客户端证书的CA的名称。

在某些情况下，能够发送一组与用于验证客户端证书的实际CA不同的可接受的CA名称很有用-例如，如果客户端证书是由中间CA签名的。在这种情况下，SSLCADNRequestPath和/或SSLCADNRequestFile可以使用；然后，从这对指令指定的目录和/或文件中的完整证书集中获取可接受的CA名称。

SSLCADNRequestFile必须指定所有功能于一身的含PEM编码的CA证书的级联文件。

SSLCADNRequestFile "/usr/local/apache2/conf/ca-names.crt"

SSLCADNRequestPath 指令

此可选指令可用于指定一组 可接受的CA名称，当请求客户端证书时，这些名称将发送给客户端。有关SSLCADNRequestFile更多详细信息，请参见指令。

此目录中的文件必须经过PEM编码，并可以通过哈希文件名进行访问。因此，通常不能只将证书文件放在此处：还必须创建名为hash-value的符号链接 .N。并且您应始终确保此目录包含适当的符号链接。

SSLCADNRequestPath "/usr/local/apache2/conf/ca-names.crt/"

SSLCARevocationCheck 指令

启用证书吊销列表（CRL）检查。中的至少一个 SSLCARevocationFile 或SSLCARevocationPath必须进行配置。设置为chain（推荐设置）时，CRL检查将应用于链中的所有证书，同时将CRL检查设置为 leaf将检查限制为最终实体证书。

可用的标志为：

• no_crl_for_cert_ok

  在2.3.15版之前，如果在用SSLCARevocationFile 或配置的任何位置均未找到检查证书的CRL，则mod_ssl中的CRL检查也成功SSLCARevocationPath。

  随着的引入SSLCARevocationFile，行为已更改：默认情况下，使用chain或 leaf，必须提供CRL 才能使验证成功-否则它将失败并显示 "unable to get certificate CRL"错误。

  该标志 no_crl_for_cert_ok允许恢复以前的行为。

SSLCARevocationCheck chain

SSLCARevocationCheck chain no_crl_for_cert_ok

SSLCARevocationFile 指令

此伪指令设置了一个多文件，您可以在其中汇编与您处理其客户的证书颁发机构（CA）的证书吊销列表（CRL）。这些用于客户端身份验证。按照优先顺序，此类文件只是各种PEM编码的CRL文件的串联。可以替代地和/或附加地使用它SSLCARevocationPath。

SSLCARevocationFile "/usr/local/apache2/conf/ssl.crl/ca-bundle-client.crl"

SSLCARevocationPath 指令

此伪指令设置目录，在该目录中保留与您处理其客户的证书颁发机构（CA）的证书吊销列表（CRL）。这些用于撤销客户端身份验证上的客户端证书。

此目录中的文件必须经过PEM编码，并可以通过哈希文件名进行访问。因此，通常您不仅要将CRL文件放在此处。另外，您必须创建名为hash-value的符号链接 .rN。并且您应始终确保此目录包含适当的符号链接。

SSLCARevocationPath "/usr/local/apache2/conf/ssl.crl/"

SSLCertificateChainFile 指令

此伪指令设置可选的多合一文件，您可以在其中组装构成服务器证书的证书链的证书颁发机构（CA）的证书。这从服务器证书的颁发CA证书开始，并且可以扩展到根CA证书。这样的文件只是各种PEM编码的CA证书文件的串联，通常以证书链顺序排列。

除SSLCACertificatePath服务器证书外，还应使用它替代和/或附加地用于显式构建发送到浏览器的服务器证书链。使用客户端身份验证时，避免与CA证书冲突特别有用。因为尽管将服务器证书链的CA证书放入SSLCACertificatePath证书链的构造中具有相同的效果，但是它具有副作用，即在客户机认证中也接受由同一CA证书颁发的客户机证书。

但请注意：仅在使用单个基于RSA 或 DSA的服务器证书时，提供证书链才有效 。如果您使用的是RSA + DSA耦合的证书对，则只有在两个证书实际上都使用同一证书链的情况下，此方法才有效。在这种情况下，其他浏览器会感到困惑。

SSLCertificateChainFile "/usr/local/apache2/conf/ssl.crt/ca.crt"

SSLCertificateFile 指令

该指令指向具有PEM格式的证书数据的文件，或指向通过配置的加密令牌的证书标识符的文件。如果使用的是PEM文件，则该文件至少必须包含最终实体（叶子）证书。该指令可以多次使用（引用不同的文件名）以支持服务器认证的多种算法-通常为RSA，DSA和ECC。支持的算法数量取决于用于mod_ssl的OpenSSL版本：1.0.0或更高版本 openssl list-public-key-algorithms将输出支持的算法列表，另请参阅以下有关1.0.2之前的OpenSSL版本的局限性以及实现方法的注释。在他们周围工作。

这些文件可能还包含从叶到根排序的中间CA证书。版本2.4.8和更高版本支持此功能，并且已过时SSLCertificateChainFile。与OpenSSL 1.0.2或更高版本一起运行时，这允许在每个证书的基础上配置中间CA链。

自定义DH参数和临时密钥的EC曲线名称也可以添加到使用配置的第一个文件的末尾 SSLCertificateFile。2.4.7版或更高版本支持此功能。可以使用命令openssl dhparam和生成此类参数 openssl ecparam。可以按原样将参数添加到第一个证书文件的末尾。由于第一个文件与身份验证算法类型无关，因此只能将第一个文件用于自定义参数。

最后，最终实体证书的私钥也可以添加到证书文件中，而不用使用单独的 SSLCertificateKeyFile 指令。不鼓励这种做法。如果使用该证书，则必须在使用单独密钥文件的证书之后配置使用这种嵌入式密钥的证书文件。如果私钥已加密，则在启动时会强制输入密码对话框。

作为将证书和私钥存储在文件中的替代方法，可以使用证书标识符来标识存储在令牌中的证书。当前，只有PKCS＃11 URI被识别为证书标识符，并且可以与OpenSSL pkcs11引擎一起使用。如果SSLCertificateKeyFile省略，则可以通过使用指定的单个标识符加载证书和私钥SSLCertificateFile。

# Example using a PEM-encoded file.
SSLCertificateFile "/usr/local/apache2/conf/ssl.crt/server.crt"
# Example use of a certificate and private key from a PKCS#11 token:
SSLCertificateFile "pkcs11:token=My%20Token%20Name;id=45"

SSLCertificateKeyFile 指令

该指令指向服务器的PEM编码的私钥文件，或指向通过配置的加密令牌的密钥ID。如果包含的私钥已加密，则在启动时会强制输入密码对话框。

该指令可以多次使用（引用不同的文件名）以支持服务器认证的多种算法。对于每个 SSLCertificateKeyFile 指令，必须有一个匹配的SSLCertificateFile 指令。

私钥也可以与给出的文件中的证书结合使用 SSLCertificateFile，但是强烈建议不要这样做。如果使用该证书，则必须在使用单独密钥文件的证书之后配置使用这种嵌入式密钥的证书文件。

作为将私钥存储在文件中的替代方法，可以使用密钥标识符来标识存储在令牌中的私钥。当前，只有PKCS＃11 URI被识别为私钥标识符，并且可以与OpenSSL pkcs11引擎一起使用 。

# To use a private key from a PEM-encoded file:
SSLCertificateKeyFile "/usr/local/apache2/conf/ssl.key/server.key"
# To use a private key from a PKCS#11 token:
SSLCertificateKeyFile "pkcs11:token=My%20Token%20Name;id=45"

SSLCipherSuite 指令

此复杂指令使用冒号分隔的，由OpenSSL密码规范组成的密码规范字符串来配置允许客户端在SSL握手阶段进行协商的Cipher Suite。可选的协议说明符可以为特定的SSL版本配置密码套件。可能的值包括所有SSL协议（包括TLSv1.2）及以下的“ SSL”。

注意，此伪指令可以在每个服务器和每个目录上下文中使用。在每服务器上下文中，当建立连接时，它适用于标准SSL握手。在按目录的上下文中，它会在读取HTTP请求之后但在发送HTTP响应之前，通过重新配置的Cipher Suite强制进行SSL重新协商。

如果SSL库支持TLSv1.3（OpenSSL 1.1.1和更高版本），则可以使用协议说明符“ TLSv1.3”来配置该协议的密码套件。由于TLSv1.3不提供重新协商，因此不允许在目录上下文中为其指定密码。

有关TLSv1.3密码名称的列表，请参见 OpenSSL文档。

cipher-spec中 的SSL密码规范由4个主要属性和一些额外的次要属性组成：

• 密钥交换算法：
  RSA，Diffie-Hellman，椭圆曲线Diffie-Hellman，安全远程密码
• 身份验证算法：
  RSA，Diffie-Hellman，DSS，ECDSA或无。
• 密码/加密算法：
  AES，DES，Triple-DES，RC4，RC2，IDEA等
• MAC摘要算法：
  MD5，SHA或SHA1，SHA256，SHA384。

SSL密码也可以是导出密码。不再支持SSLv2密码。要指定要使用的密码，可以一次指定所有密码，也可以使用别名指定密码的优先级和顺序（请参阅表1）。实际可用的密码和别名取决于所使用的openssl版本。较新的openssl版本可能包含其他密码。

现在，变得有趣的是可以将它们组合在一起以指定要使用的顺序和密码。为了加快速度SSLv3, TLSv1, EXP, LOW, MEDIUM, HIGH，某些密码组还具有别名（）。这些标签可以与前缀结合在一起形成cipher-spec。可用的前缀是：

• none：将密码添加到列表
• +：将匹配的密码移动到列表中的当前位置
• -：从列表中删除密码（可以稍后再添加）
• !：完全杀死列表中的密码（以后不能再添加）

一种更简单的方法是使用`` openssl ciphers -v''命令，该命令提供了一种很好的方式来连续创建正确的密码规范字符串。默认的密码规范字符串取决于所使用的OpenSSL库的版本。让我们假设它是`` RC4-SHA:AES128-SHA:HIGH:MEDIUM:!aNULL:!MD5''，其含义如下：放在RC4-SHA和AES128-SHA开头。我们这样做是因为这些密码在速度和安全性之间提供了很好的折衷方案。接下来，包括高中安全密码。最后，删除所有未认证的密码，即对于SSL，匿名Diffie-Hellman密码以及MD5用作哈希算法的所有密码 ，因为已被证明是不够的。

$ openssl ciphers -v 'RC4-SHA:AES128-SHA:HIGH:MEDIUM:!aNULL:!MD5'
RC4-SHA                 SSLv3 Kx=RSA      Au=RSA  Enc=RC4(128)  Mac=SHA1
AES128-SHA              SSLv3 Kx=RSA      Au=RSA  Enc=AES(128)  Mac=SHA1
DHE-RSA-AES256-SHA      SSLv3 Kx=DH       Au=RSA  Enc=AES(256)  Mac=SHA1
...                     ...               ...     ...           ...
SEED-SHA                SSLv3 Kx=RSA      Au=RSA  Enc=SEED(128) Mac=SHA1
PSK-RC4-SHA             SSLv3 Kx=PSK      Au=PSK  Enc=RC4(128)  Mac=SHA1
KRB5-RC4-SHA            SSLv3 Kx=KRB5     Au=KRB5 Enc=RC4(128)  Mac=SHA1

表2给出了SSL的特定RSA和DH密码的完整列表。

SSLCipherSuite RSA:!EXP:!NULL:+HIGH:+MEDIUM:-LOW

SSLCompression 指令

此伪指令允许在SSL级别启用压缩。

SSLCryptoDevice 指令

该指令允许使用加密硬件加速器板来减轻某些SSL处理开销。仅当SSL工具箱是通过“引擎”支持构建的时，才可以使用此伪指令。OpenSSL 0.9.7和更高版本默认情况下具有“引擎”支持，必须使用单独的OpenSSL 0.9.6“ -engine”版本。

要发现支持哪些引擎名称，请运行命令“ openssl engine”。

# For a Broadcom accelerator:
SSLCryptoDevice ubsec

SSLEngine 指令

该指令切换SSL / TLS协议引擎的用法。应该在一个<VirtualHost>部分中使用它来为该虚拟主机启用SSL / TLS。默认情况下，主服务器和所有已配置的虚拟主机均禁用SSL / TLS协议引擎。

<VirtualHost _default_:443>
SSLEngine on
#...
</VirtualHost>

在Apache 2.1及更高版本中，SSLEngine可以设置为 optional。这样可以支持 RFC 2817（在HTTP / 1.1内升级到TLS）。目前，没有网络浏览器支持RFC 2817。

SSLFIPS 指令

此伪指令切换SSL库FIPS_