github.com/krum110487/go-htaccess@v0.0.0-20240316004156-60641c8e7598/tests/data/apache_2_4_58/conf/extra/httpd-ssl.conf (about)

     1  #
     2  # This is the Apache server configuration file providing SSL support.
     3  # It contains the configuration directives to instruct the server how to
     4  # serve pages over an https connection. For detailed information about these 
     5  # directives see <URL:http://httpd.apache.org/docs/2.4/mod/mod_ssl.html>
     6  # 
     7  # Do NOT simply read the instructions in here without understanding
     8  # what they do.  They're here only as hints or reminders.  If you are unsure
     9  # consult the online docs. You have been warned.  
    10  #
    11  # Required modules: mod_log_config, mod_setenvif, mod_ssl,
    12  #          socache_shmcb_module (for default value of SSLSessionCache)
    13  
    14  #
    15  # Pseudo Random Number Generator (PRNG):
    16  # Configure one or more sources to seed the PRNG of the SSL library.
    17  # The seed data should be of good random quality.
    18  # WARNING! On some platforms /dev/random blocks if not enough entropy
    19  # is available. This means you then cannot use the /dev/random device
    20  # because it would lead to very long connection times (as long as
    21  # it requires to make more entropy available). But usually those
    22  # platforms additionally provide a /dev/urandom device which doesn't
    23  # block. So, if available, use this one instead. Read the mod_ssl User
    24  # Manual for more details.
    25  #
    26  #SSLRandomSeed startup file:/dev/random  512
    27  #SSLRandomSeed startup file:/dev/urandom 512
    28  #SSLRandomSeed connect file:/dev/random  512
    29  #SSLRandomSeed connect file:/dev/urandom 512
    30  
    31  
    32  #
    33  # When we also provide SSL we have to listen to the 
    34  # standard HTTP port (see above) and to the HTTPS port
    35  #
    36  Listen 443
    37  
    38  ##
    39  ##  SSL Global Context
    40  ##
    41  ##  All SSL configuration in this context applies both to
    42  ##  the main server and all SSL-enabled virtual hosts.
    43  ##
    44  
    45  #   SSL Cipher Suite:
    46  #   List the ciphers that the client is permitted to negotiate,
    47  #   and that httpd will negotiate as the client of a proxied server.
    48  #   See the OpenSSL documentation for a complete list of ciphers, and
    49  #   ensure these follow appropriate best practices for this deployment.
    50  #   httpd 2.2.30, 2.4.13 and later force-disable aNULL, eNULL and EXP ciphers,
    51  #   while OpenSSL disabled these by default in 0.9.8zf/1.0.0r/1.0.1m/1.0.2a.
    52  SSLCipherSuite HIGH:MEDIUM:!MD5:!RC4:!3DES
    53  SSLProxyCipherSuite HIGH:MEDIUM:!MD5:!RC4:!3DES
    54  
    55  #  By the end of 2016, only TLSv1.2 ciphers should remain in use.
    56  #  Older ciphers should be disallowed as soon as possible, while the
    57  #  kRSA ciphers do not offer forward secrecy.  These changes inhibit
    58  #  older clients (such as IE6 SP2 or IE8 on Windows XP, or other legacy
    59  #  non-browser tooling) from successfully connecting.  
    60  #
    61  #  To restrict mod_ssl to use only TLSv1.2 ciphers, and disable
    62  #  those protocols which do not support forward secrecy, replace
    63  #  the SSLCipherSuite and SSLProxyCipherSuite directives above with
    64  #  the following two directives, as soon as practical.
    65  # SSLCipherSuite HIGH:MEDIUM:!SSLv3:!kRSA
    66  # SSLProxyCipherSuite HIGH:MEDIUM:!SSLv3:!kRSA
    67  
    68  #   User agents such as web browsers are not configured for the user's
    69  #   own preference of either security or performance, therefore this
    70  #   must be the prerogative of the web server administrator who manages
    71  #   cpu load versus confidentiality, so enforce the server's cipher order.
    72  SSLHonorCipherOrder on 
    73  
    74  #   SSL Protocol support:
    75  #   List the protocol versions which clients are allowed to connect with.
    76  #   Disable SSLv3 by default (cf. RFC 7525 3.1.1).  TLSv1 (1.0) should be
    77  #   disabled as quickly as practical.  By the end of 2016, only the TLSv1.2
    78  #   protocol or later should remain in use.
    79  SSLProtocol all -SSLv3
    80  SSLProxyProtocol all -SSLv3
    81  
    82  #   Pass Phrase Dialog:
    83  #   Configure the pass phrase gathering process.
    84  #   The filtering dialog program (`builtin' is an internal
    85  #   terminal dialog) has to provide the pass phrase on stdout.
    86  SSLPassPhraseDialog  builtin
    87  
    88  #   Inter-Process Session Cache:
    89  #   Configure the SSL Session Cache: First the mechanism 
    90  #   to use and second the expiring timeout (in seconds).
    91  #SSLSessionCache         "dbm:${SRVROOT}/logs/ssl_scache"
    92  SSLSessionCache        "shmcb:${SRVROOT}/logs/ssl_scache(512000)"
    93  SSLSessionCacheTimeout  300
    94  
    95  #   OCSP Stapling (requires OpenSSL 0.9.8h or later)
    96  #
    97  #   This feature is disabled by default and requires at least
    98  #   the two directives SSLUseStapling and SSLStaplingCache.
    99  #   Refer to the documentation on OCSP Stapling in the SSL/TLS
   100  #   How-To for more information.
   101  #
   102  #   Enable stapling for all SSL-enabled servers:
   103  #SSLUseStapling On
   104  
   105  #   Define a relatively small cache for OCSP Stapling using
   106  #   the same mechanism that is used for the SSL session cache
   107  #   above.  If stapling is used with more than a few certificates,
   108  #   the size may need to be increased.  (AH01929 will be logged.)
   109  #SSLStaplingCache "shmcb:${SRVROOT}/logs/ssl_stapling(32768)"
   110  
   111  #   Seconds before valid OCSP responses are expired from the cache
   112  #SSLStaplingStandardCacheTimeout 3600
   113  
   114  #   Seconds before invalid OCSP responses are expired from the cache
   115  #SSLStaplingErrorCacheTimeout 600
   116  
   117  ##
   118  ## SSL Virtual Host Context
   119  ##
   120  
   121  <VirtualHost _default_:443>
   122  
   123  #   General setup for the virtual host
   124  DocumentRoot "${SRVROOT}/htdocs"
   125  ServerName www.example.com:443
   126  ServerAdmin admin@example.com
   127  ErrorLog "${SRVROOT}/logs/error.log"
   128  TransferLog "${SRVROOT}/logs/access.log"
   129  
   130  #   SSL Engine Switch:
   131  #   Enable/Disable SSL for this virtual host.
   132  SSLEngine on
   133  
   134  #   Server Certificate:
   135  #   Point SSLCertificateFile at a PEM encoded certificate.  If
   136  #   the certificate is encrypted, then you will be prompted for a
   137  #   pass phrase.  Note that a kill -HUP will prompt again.  Keep
   138  #   in mind that if you have both an RSA and a DSA certificate you
   139  #   can configure both in parallel (to also allow the use of DSA
   140  #   ciphers, etc.)
   141  #   Some ECC cipher suites (http://www.ietf.org/rfc/rfc4492.txt)
   142  #   require an ECC certificate which can also be configured in
   143  #   parallel.
   144  SSLCertificateFile "${SRVROOT}/conf/server.crt"
   145  #SSLCertificateFile "${SRVROOT}/conf/server-dsa.crt"
   146  #SSLCertificateFile "${SRVROOT}/conf/server-ecc.crt"
   147  
   148  #   Server Private Key:
   149  #   If the key is not combined with the certificate, use this
   150  #   directive to point at the key file.  Keep in mind that if
   151  #   you've both a RSA and a DSA private key you can configure
   152  #   both in parallel (to also allow the use of DSA ciphers, etc.)
   153  #   ECC keys, when in use, can also be configured in parallel
   154  SSLCertificateKeyFile "${SRVROOT}/conf/server.key"
   155  #SSLCertificateKeyFile "${SRVROOT}/conf/server-dsa.key"
   156  #SSLCertificateKeyFile "${SRVROOT}/conf/server-ecc.key"
   157  
   158  #   Server Certificate Chain:
   159  #   Point SSLCertificateChainFile at a file containing the
   160  #   concatenation of PEM encoded CA certificates which form the
   161  #   certificate chain for the server certificate. Alternatively
   162  #   the referenced file can be the same as SSLCertificateFile
   163  #   when the CA certificates are directly appended to the server
   164  #   certificate for convenience.
   165  #SSLCertificateChainFile "${SRVROOT}/conf/server-ca.crt"
   166  
   167  #   Certificate Authority (CA):
   168  #   Set the CA certificate verification path where to find CA
   169  #   certificates for client authentication or alternatively one
   170  #   huge file containing all of them (file must be PEM encoded)
   171  #   Note: Inside SSLCACertificatePath you need hash symlinks
   172  #         to point to the certificate files. Use the provided
   173  #         Makefile to update the hash symlinks after changes.
   174  #SSLCACertificatePath "${SRVROOT}/conf/ssl.crt"
   175  #SSLCACertificateFile "${SRVROOT}/conf/ssl.crt/ca-bundle.crt"
   176  
   177  #   Certificate Revocation Lists (CRL):
   178  #   Set the CA revocation path where to find CA CRLs for client
   179  #   authentication or alternatively one huge file containing all
   180  #   of them (file must be PEM encoded).
   181  #   The CRL checking mode needs to be configured explicitly
   182  #   through SSLCARevocationCheck (defaults to "none" otherwise).
   183  #   Note: Inside SSLCARevocationPath you need hash symlinks
   184  #         to point to the certificate files. Use the provided
   185  #         Makefile to update the hash symlinks after changes.
   186  #SSLCARevocationPath "${SRVROOT}/conf/ssl.crl"
   187  #SSLCARevocationFile "${SRVROOT}/conf/ssl.crl/ca-bundle.crl"
   188  #SSLCARevocationCheck chain
   189  
   190  #   Client Authentication (Type):
   191  #   Client certificate verification type and depth.  Types are
   192  #   none, optional, require and optional_no_ca.  Depth is a
   193  #   number which specifies how deeply to verify the certificate
   194  #   issuer chain before deciding the certificate is not valid.
   195  #SSLVerifyClient require
   196  #SSLVerifyDepth  10
   197  
   198  #   TLS-SRP mutual authentication:
   199  #   Enable TLS-SRP and set the path to the OpenSSL SRP verifier
   200  #   file (containing login information for SRP user accounts). 
   201  #   Requires OpenSSL 1.0.1 or newer. See the mod_ssl FAQ for
   202  #   detailed instructions on creating this file. Example:
   203  #   "openssl srp -srpvfile ${SRVROOT}/conf/passwd.srpv -add username"
   204  #SSLSRPVerifierFile "${SRVROOT}/conf/passwd.srpv"
   205  
   206  #   Access Control:
   207  #   With SSLRequire you can do per-directory access control based
   208  #   on arbitrary complex boolean expressions containing server
   209  #   variable checks and other lookup directives.  The syntax is a
   210  #   mixture between C and Perl.  See the mod_ssl documentation
   211  #   for more details.
   212  #<Location />
   213  #SSLRequire (    %{SSL_CIPHER} !~ m/^(EXP|NULL)/ \
   214  #            and %{SSL_CLIENT_S_DN_O} eq "Snake Oil, Ltd." \
   215  #            and %{SSL_CLIENT_S_DN_OU} in {"Staff", "CA", "Dev"} \
   216  #            and %{TIME_WDAY} >= 1 and %{TIME_WDAY} <= 5 \
   217  #            and %{TIME_HOUR} >= 8 and %{TIME_HOUR} <= 20       ) \
   218  #           or %{REMOTE_ADDR} =~ m/^192\.76\.162\.[0-9]+$/
   219  #</Location>
   220  
   221  #   SSL Engine Options:
   222  #   Set various options for the SSL engine.
   223  #   o FakeBasicAuth:
   224  #     Translate the client X.509 into a Basic Authorisation.  This means that
   225  #     the standard Auth/DBMAuth methods can be used for access control.  The
   226  #     user name is the `one line' version of the client's X.509 certificate.
   227  #     Note that no password is obtained from the user. Every entry in the user
   228  #     file needs this password: `xxj31ZMTZzkVA'.
   229  #   o ExportCertData:
   230  #     This exports two additional environment variables: SSL_CLIENT_CERT and
   231  #     SSL_SERVER_CERT. These contain the PEM-encoded certificates of the
   232  #     server (always existing) and the client (only existing when client
   233  #     authentication is used). This can be used to import the certificates
   234  #     into CGI scripts.
   235  #   o StdEnvVars:
   236  #     This exports the standard SSL/TLS related `SSL_*' environment variables.
   237  #     Per default this exportation is switched off for performance reasons,
   238  #     because the extraction step is an expensive operation and is usually
   239  #     useless for serving static content. So one usually enables the
   240  #     exportation for CGI and SSI requests only.
   241  #   o StrictRequire:
   242  #     This denies access when "SSLRequireSSL" or "SSLRequire" applied even
   243  #     under a "Satisfy any" situation, i.e. when it applies access is denied
   244  #     and no other module can change it.
   245  #   o OptRenegotiate:
   246  #     This enables optimized SSL connection renegotiation handling when SSL
   247  #     directives are used in per-directory context. 
   248  #SSLOptions +FakeBasicAuth +ExportCertData +StrictRequire
   249  <FilesMatch "\.(cgi|shtml|phtml|php)$">
   250      SSLOptions +StdEnvVars
   251  </FilesMatch>
   252  <Directory "${SRVROOT}/cgi-bin">
   253      SSLOptions +StdEnvVars
   254  </Directory>
   255  
   256  #   SSL Protocol Adjustments:
   257  #   The safe and default but still SSL/TLS standard compliant shutdown
   258  #   approach is that mod_ssl sends the close notify alert but doesn't wait for
   259  #   the close notify alert from client. When you need a different shutdown
   260  #   approach you can use one of the following variables:
   261  #   o ssl-unclean-shutdown:
   262  #     This forces an unclean shutdown when the connection is closed, i.e. no
   263  #     SSL close notify alert is sent or allowed to be received.  This violates
   264  #     the SSL/TLS standard but is needed for some brain-dead browsers. Use
   265  #     this when you receive I/O errors because of the standard approach where
   266  #     mod_ssl sends the close notify alert.
   267  #   o ssl-accurate-shutdown:
   268  #     This forces an accurate shutdown when the connection is closed, i.e. a
   269  #     SSL close notify alert is send and mod_ssl waits for the close notify
   270  #     alert of the client. This is 100% SSL/TLS standard compliant, but in
   271  #     practice often causes hanging connections with brain-dead browsers. Use
   272  #     this only for browsers where you know that their SSL implementation
   273  #     works correctly. 
   274  #   Notice: Most problems of broken clients are also related to the HTTP
   275  #   keep-alive facility, so you usually additionally want to disable
   276  #   keep-alive for those clients, too. Use variable "nokeepalive" for this.
   277  #   Similarly, one has to force some clients to use HTTP/1.0 to workaround
   278  #   their broken HTTP/1.1 implementation. Use variables "downgrade-1.0" and
   279  #   "force-response-1.0" for this.
   280  BrowserMatch "MSIE [2-5]" \
   281           nokeepalive ssl-unclean-shutdown \
   282           downgrade-1.0 force-response-1.0
   283  
   284  #   Per-Server Logging:
   285  #   The home of a custom SSL log file. Use this when you want a
   286  #   compact non-error SSL logfile on a virtual host basis.
   287  CustomLog "${SRVROOT}/logs/ssl_request.log" \
   288            "%t %h %{SSL_PROTOCOL}x %{SSL_CIPHER}x \"%r\" %b"
   289  
   290  </VirtualHost>