Serveur Apache HTTP Version 2.4
Ce document couvre la compatibilit� ascendante entre mod_ssl et d'autres solutions SSL. mod_ssl n'est pas la seule solution SSL pour Apache ; quatre autres produits sont (ou ont �t�) �galement disponibles : Apache-SSL, le produit libre de Ben Laurie (d'o� mod_ssl est issu � l'origine en 1998), Secure Web Server, un produit commercial de Red Hat (bas� sur mod_ssl), Raven SSL Module, un produit commercial de Covalent (bas� lui aussi sur mod_ssl), et enfin Stronghold, produit commercial de C2Net et maintenant de Red Hat, (bas� sur une branche d'�volution diff�rente appel�e Sioux jusqu'� Stronghold 2.x et bas� sur mod_ssl depuis Stronghold 3.x).
En plus de ses fonctionnalit�s propres, mod_ssl rassemble la plupart de celles des autres solutions SSL, si bien qu'il est tr�s simple de migrer depuis un module plus ancien vers mod_ssl. Les directives de configuration et les noms des variables d'environnement utilis�s par les solutions SSL plus anciennes diff�rent de ceux qu'utilise mod_ssl ; les tableaux de correspondance ci-dessous fournissent les �quivalences de termes utilis�s par mod_ssl.
La correspondance entre les directives de configuration qu'utilise Apache-SSL 1.x et mod_ssl 2.0.x est fournie dans le Tableau 1. La correspondance depuis Sioux 1.x et Stronghold 2.x n'est que partielle car certaines fonctionnalit�s de ces interfaces ne sont pas support�es par mod_ssl.
Ancienne directive | Directive mod_ssl | Commentaires |
---|---|---|
Compatibilit� entre Apache-SSL 1.x et mod_ssl 2.0.x : | ||
SSLEnable | SSLEngine on | plus compacte |
SSLDisable | SSLEngine off | plus compacte |
SSLLogFile
file |
| Utilisez plut�t la directive
de niveau module LogLevel . |
SSLRequiredCiphers spec | SSLCipherSuite spec | renomm�e |
SSLRequireCipher c1 ... | SSLRequire %{SSL_CIPHER} in {" c1",
...} | plus g�n�rale |
SSLBanCipher c1 ... | SSLRequire not (%{SSL_CIPHER} in {" c1",
...}) | plus g�n�rale |
SSLFakeBasicAuth | SSLOptions +FakeBasicAuth | rassembl�es |
SSLCacheServerPath dir | - | fonctionnalit� supprim�e |
SSLCacheServerPort integer | - | fonctionnalit� supprim�e |
Compatibilit� avec Apache-SSL 1.x : | ||
SSLExportClientCertificates | SSLOptions +ExportCertData | rassembl�es |
SSLCacheServerRunDir dir | - | fonctionnalit� non support�e |
Compatibilit� avec Sioux 1.x : | ||
SSL_CertFile file | SSLCertificateFile file | renomm�e |
SSL_KeyFile file | SSLCertificateKeyFile file | renomm�e |
SSL_CipherSuite arg | SSLCipherSuite arg | renomm�e |
SSL_X509VerifyDir arg | SSLCACertificatePath arg | renomm�e |
SSL_Log
file | - | Utilisez plut�t la directive
de niveau module LogLevel |
SSL_Connect flag | SSLEngine flag | renomm�e |
SSL_ClientAuth arg | SSLVerifyClient arg | renomm�e |
SSL_X509VerifyDepth arg | SSLVerifyDepth arg | renomm�e |
SSL_FetchKeyPhraseFrom arg | - | pas de v�ritable �quivalent ; utiliser SSLPassPhraseDialog |
SSL_SessionDir dir | - | pas de v�ritable �quivalent ; utiliser SSLSessionCache |
SSL_Require expr | - | pas de v�ritable �quivalent ; utiliser SSLRequire |
SSL_CertFileType arg | - | fonctionnalit� non support�e |
SSL_KeyFileType arg | - | fonctionnalit� non support�e |
SSL_X509VerifyPolicy arg | - | fonctionnalit� non support�e |
SSL_LogX509Attributes arg | - | fonctionnalit� non support�e |
Compatibilit� avec Stronghold 2.x : | ||
StrongholdAccelerator engine | SSLCryptoDevice engine | renomm�e |
StrongholdKey dir | - | sans objet |
StrongholdLicenseFile dir | - | sans objet |
SSLFlag flag | SSLEngine flag | renomm�e |
SSLSessionLockFile file | SSLMutex file | renomm�e |
SSLCipherList spec | SSLCipherSuite spec | renomm�e |
RequireSSL | SSLRequireSSL | renomm�e |
SSLErrorFile file | - | fonctionnalit� non support�e |
SSLRoot dir | - | fonctionnalit� non support�e |
SSL_CertificateLogDir dir | - | fonctionnalit� non support�e |
AuthCertDir dir | - | fonctionnalit� non support�e |
SSL_Group name | - | fonctionnalit� non support�e |
SSLProxyMachineCertPath dir | SSLProxyMachineCertificatePath dir | renomm�e |
SSLProxyMachineCertFile file | SSLProxyMachineCertificateFile file | renomm�e |
SSLProxyCipherList spec | SSLProxyCipherSpec spec | renomm�e |
La correspondance entre les noms des variables d'environnement utilis�s par les solutions SSL plus anciennes et les noms utilis�s par mod_ssl est fournie dans le Tableau 2.
Ancienne variable | Variable mod_ssl | Commentaires |
---|---|---|
SSL_PROTOCOL_VERSION | SSL_PROTOCOL | renomm�e |
SSLEAY_VERSION | SSL_VERSION_LIBRARY | renomm�e |
HTTPS_SECRETKEYSIZE | SSL_CIPHER_USEKEYSIZE | renomm�e |
HTTPS_KEYSIZE | SSL_CIPHER_ALGKEYSIZE | renomm�e |
HTTPS_CIPHER | SSL_CIPHER | renomm�e |
HTTPS_EXPORT | SSL_CIPHER_EXPORT | renomm�e |
SSL_SERVER_KEY_SIZE | SSL_CIPHER_ALGKEYSIZE | renomm�e |
SSL_SERVER_CERTIFICATE | SSL_SERVER_CERT | renomm�e |
SSL_SERVER_CERT_START | SSL_SERVER_V_START | renomm�e |
SSL_SERVER_CERT_END | SSL_SERVER_V_END | renomm�e |
SSL_SERVER_CERT_SERIAL | SSL_SERVER_M_SERIAL | renomm�e |
SSL_SERVER_SIGNATURE_ALGORITHM | SSL_SERVER_A_SIG | renomm�e |
SSL_SERVER_DN | SSL_SERVER_S_DN | renomm�e |
SSL_SERVER_CN | SSL_SERVER_S_DN_CN | renomm�e |
SSL_SERVER_EMAIL | SSL_SERVER_S_DN_Email | renomm�e |
SSL_SERVER_O | SSL_SERVER_S_DN_O | renomm�e |
SSL_SERVER_OU | SSL_SERVER_S_DN_OU | renomm�e |
SSL_SERVER_C | SSL_SERVER_S_DN_C | renomm�e |
SSL_SERVER_SP | SSL_SERVER_S_DN_SP | renomm�e |
SSL_SERVER_L | SSL_SERVER_S_DN_L | renomm�e |
SSL_SERVER_IDN | SSL_SERVER_I_DN | renomm�e |
SSL_SERVER_ICN | SSL_SERVER_I_DN_CN | renomm�e |
SSL_SERVER_IEMAIL | SSL_SERVER_I_DN_Email | renomm�e |
SSL_SERVER_IO | SSL_SERVER_I_DN_O | renomm�e |
SSL_SERVER_IOU | SSL_SERVER_I_DN_OU | renomm�e |
SSL_SERVER_IC | SSL_SERVER_I_DN_C | renomm�e |
SSL_SERVER_ISP | SSL_SERVER_I_DN_SP | renomm�e |
SSL_SERVER_IL | SSL_SERVER_I_DN_L | renomm�e |
SSL_CLIENT_CERTIFICATE | SSL_CLIENT_CERT | renomm�e |
SSL_CLIENT_CERT_START | SSL_CLIENT_V_START | renomm�e |
SSL_CLIENT_CERT_END | SSL_CLIENT_V_END | renomm�e |
SSL_CLIENT_CERT_SERIAL | SSL_CLIENT_M_SERIAL | renomm�e |
SSL_CLIENT_SIGNATURE_ALGORITHM | SSL_CLIENT_A_SIG | renomm�e |
SSL_CLIENT_DN | SSL_CLIENT_S_DN | renomm�e |
SSL_CLIENT_CN | SSL_CLIENT_S_DN_CN | renomm�e |
SSL_CLIENT_EMAIL | SSL_CLIENT_S_DN_Email | renomm�e |
SSL_CLIENT_O | SSL_CLIENT_S_DN_O | renomm�e |
SSL_CLIENT_OU | SSL_CLIENT_S_DN_OU | renomm�e |
SSL_CLIENT_C | SSL_CLIENT_S_DN_C | renomm�e |
SSL_CLIENT_SP | SSL_CLIENT_S_DN_SP | renomm�e |
SSL_CLIENT_L | SSL_CLIENT_S_DN_L | renomm�e |
SSL_CLIENT_IDN | SSL_CLIENT_I_DN | renomm�e |
SSL_CLIENT_ICN | SSL_CLIENT_I_DN_CN | renomm�e |
SSL_CLIENT_IEMAIL | SSL_CLIENT_I_DN_Email | renomm�e |
SSL_CLIENT_IO | SSL_CLIENT_I_DN_O | renomm�e |
SSL_CLIENT_IOU | SSL_CLIENT_I_DN_OU | renomm�e |
SSL_CLIENT_IC | SSL_CLIENT_I_DN_C | renomm�e |
SSL_CLIENT_ISP | SSL_CLIENT_I_DN_SP | renomm�e |
SSL_CLIENT_IL | SSL_CLIENT_I_DN_L | renomm�e |
SSL_EXPORT | SSL_CIPHER_EXPORT | renomm�e |
SSL_KEYSIZE | SSL_CIPHER_ALGKEYSIZE | renomm�e |
SSL_SECKEYSIZE | SSL_CIPHER_USEKEYSIZE | renomm�e |
SSL_SSLEAY_VERSION | SSL_VERSION_LIBRARY | renomm�e |
SSL_STRONG_CRYPTO | - | Non support�e par mod_ssl |
SSL_SERVER_KEY_EXP | - | Non support�e par mod_ssl |
SSL_SERVER_KEY_ALGORITHM | - | Non support�e par mod_ssl |
SSL_SERVER_KEY_SIZE | - | Non support�e par mod_ssl |
SSL_SERVER_SESSIONDIR | - | Non support�e par mod_ssl |
SSL_SERVER_CERTIFICATELOGDIR | - | Non support�e par mod_ssl |
SSL_SERVER_CERTFILE | - | Non support�e par mod_ssl |
SSL_SERVER_KEYFILE | - | Non support�e par mod_ssl |
SSL_SERVER_KEYFILETYPE | - | Non support�e par mod_ssl |
SSL_CLIENT_KEY_EXP | - | Non support�e par mod_ssl |
SSL_CLIENT_KEY_ALGORITHM | - | Non support�e par mod_ssl |
SSL_CLIENT_KEY_SIZE | - | Non support�e par mod_ssl |
Quand mod_ssl est activ�, le Format de journal courant
(Custom Log Format) du module mod_log_config
poss�de
des fonctions suppl�mentaires comme indiqu� dans le chapitre de r�f�rence.
En plus de la fonction de format �tendu
``%{
varname}x
'' que l'on peut utiliser pour
extraire le contenu d'une variable fournie par n'importe quel module,
la fonction
de format cryptographique ``%{
name}c
'' a
�t� ajout�e � des fins de compatibilit� ascendante. Les appels de fonctions
actuellement impl�ment�s sont �num�r�s dans le
Tableau 3.
Appel de fonction | Description |
---|---|
%...{version}c | Version du protocole SSL |
%...{cipher}c | Chiffrement SSL |
%...{subjectdn}c | Nom distinctif du sujet du certificat du client |
%...{issuerdn}c | Nom distinctif de l'�metteur du certificat du client |
%...{errcode}c | Erreur lors de la v�rification du certificat (num�rique) |
%...{errstr}c | Erreur lors de la v�rification du certificat (cha�ne de caract�res) |