Jump to content

Install Modsecurity di Apache: Difference between revisions

From Wiki
No edit summary
No edit summary
 
Line 1: Line 1:
==Installing ModSecurity==
==Installing ModSecurity==
ModSecurity can be installed by running the following command in your terminal:


* ModSecurity can be installed by running the following command in your terminal:
<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
sudo apt install libapache2-mod-security2 -y
sudo apt install libapache2-mod-security2 -y
</syntaxhighlight>
</syntaxhighlight>


Alternatively, you can also build ModSecurity manually by cloning the official ModSecurity Github repository.
* Alternatively, you can also build ModSecurity manually by cloning the official ModSecurity Github repository.
 
* After installing ModSecurity, enable the Apache 2 headers module by running the following command:
After installing ModSecurity, enable the Apache 2 headers module by running the following command:
 
<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
sudo a2enmod headers
sudo a2enmod headers
</syntaxhighlight>
</syntaxhighlight>


After installing ModSecurity and enabling the header module, you need to restart the apache2 service, this can be done by running the following command:
* After installing ModSecurity and enabling the header module, you need to restart the apache2 service, this can be done by running the following command:
 
<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
sudo systemctl restart apache2
sudo systemctl restart apache2
</syntaxhighlight>
</syntaxhighlight>


You should now have ModSecurity installed. The next steps involves enabling and configuring ModSecurity and the OWASP-CRS.
* You should now have ModSecurity installed. The next steps involves enabling and configuring ModSecurity and the OWASP-CRS.


==Configuring ModSecurity==
==Configuring ModSecurity==
ModSecurity is a firewall and therefore requires rules to function. This section shows you how to implement the OWASP Core Rule Set. First, you must prepare the ModSecurity configuration file.


Remove the <code>.recommended</code> extension from the ModSecurity configuration file name with the following command:
* ModSecurity is a firewall and therefore requires rules to function. This section shows you how to implement the OWASP Core Rule Set. First, you must prepare the ModSecurity configuration file.
* Remove the <code>.recommended</code> extension from the ModSecurity configuration file name with the following command:


<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
Line 31: Line 28:
</syntaxhighlight>
</syntaxhighlight>


With a text editor such as vim, open /etc/modsecurity/modsecurity.conf and change the value for SecRuleEngine to On:
* With a text editor such as vim, open /etc/modsecurity/modsecurity.conf and change the value for SecRuleEngine to On:
 




Line 48: Line 46:
...
...
</syntaxhighlight>
</syntaxhighlight>
   
Restart Apache to apply the changes:


* Restart Apache to apply the changes:
<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
sudo systemctl restart apache2
sudo systemctl restart apache2
</syntaxhighlight>
</syntaxhighlight>


ModSecurity should now be configured to run. The next step in the process is to set up a rule set to actively prevent your web server from attacks.
* ModSecurity should now be configured to run. The next step in the process is to set up a rule set to actively prevent your web server from attacks.


==Setting Up the OWASP ModSecurity Core Rule Set==
==Setting Up the OWASP ModSecurity Core Rule Set==
Line 62: Line 59:
To set up the OWASP-CRS, follow the procedures outlined below.
To set up the OWASP-CRS, follow the procedures outlined below.


First, delete the current rule set that comes prepackaged with ModSecurity by running the following command:
* First, delete the current rule set that comes prepackaged with ModSecurity by running the following command:
 
<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
sudo rm -rf /usr/share/modsecurity-crs
sudo rm -rf /usr/share/modsecurity-crs
</syntaxhighlight>
</syntaxhighlight>


Ensure that git is installed:
* Ensure that git is installed:
 
<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
sudo apt install git
sudo apt install git
</syntaxhighlight>
</syntaxhighlight>


Clone the OWASP-CRS GitHub repository into the <code>/usr/share/modsecurity-crs</code> directory:
* Clone the OWASP-CRS GitHub repository into the <code>/usr/share/modsecurity-crs</code> directory:


<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
Line 86: Line 81:
</syntaxhighlight>
</syntaxhighlight>


Rename the default request exclusion rule file:
* Rename the default request exclusion rule file:
 
<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
sudo mv /usr/share/modsecurity-crs/rules/REQUEST-900-EXCLUSION-RULES-BEFORE-CRS.conf.example /usr/share/modsecurity-crs/rules/REQUEST-900-EXCLUSION-RULES-BEFORE-CRS.conf
sudo mv /usr/share/modsecurity-crs/rules/REQUEST-900-EXCLUSION-RULES-BEFORE-CRS.conf.example /usr/share/modsecurity-crs/rules/REQUEST-900-EXCLUSION-RULES-BEFORE-CRS.conf
</syntaxhighlight>
</syntaxhighlight>


You should now have the OWASP-CRS setup and ready to be used in your Apache configuration.
* You should now have the OWASP-CRS setup and ready to be used in your Apache configuration.


==Enabling ModSecurity in Apache 2==
==Enabling ModSecurity in Apache 2==
To begin using ModSecurity, enable it in the Apache configuration file by following the steps outlined below:
To begin using ModSecurity, enable it in the Apache configuration file by following the steps outlined below:


Using a text editor such as vim, edit the /etc/apache2/mods-available/security2.conf file to include the OWASP-CRS files you have downloaded:
* Using a text editor such as vim, edit the /etc/apache2/mods-available/security2.conf file to include the OWASP-CRS files you have downloaded:
 
 
<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
vim /etc/apache2/mods-available/security2.conf
vim /etc/apache2/mods-available/security2.conf
</syntaxhighlight>
</syntaxhighlight>


<syntaxhighlight lang="bash">
<syntaxhighlight lang="apacheconf">
<IfModule security2_module>
<IfModule security2_module>
         SecDataDir /var/cache/modsecurity
         SecDataDir /var/cache/modsecurity
Line 111: Line 103:
</IfModule>
</IfModule>
</syntaxhighlight>
</syntaxhighlight>
   
 
In <code>/etc/apache2/sites-enabled/000-default.conf</code> file VirtualHost block, include the SecRuleEngine directive set to On.
* In <code>/etc/apache2/sites-enabled/000-default.conf</code> file VirtualHost block, include the SecRuleEngine directive set to On.




Line 119: Line 111:
</syntaxhighlight>
</syntaxhighlight>


<syntaxhighlight lang="bash">
<syntaxhighlight lang="apacheconf">
<VirtualHost *:80>
<VirtualHost *:80>
         ServerAdmin webmaster@localhost
         ServerAdmin webmaster@localhost
Line 130: Line 122:
</VirtualHost>
</VirtualHost>
</syntaxhighlight>
</syntaxhighlight>
   
If you are running a website that uses SSL, add SecRuleEngine directive to that website’s configuration file as well. See our guide on SSL Certificates with Apache on Debian & Ubuntu for more information.
Restart the apache2 service to apply the configuration:


* If you are running a website that uses SSL, add SecRuleEngine directive to that website’s configuration file as well. See our guide on SSL Certificates with Apache on Debian & Ubuntu for more information.
* Restart the apache2 service to apply the configuration:
<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
sudo systemctl restart apache2
sudo systemctl restart apache2
</syntaxhighlight>
</syntaxhighlight>


ModSecurity should now be configured and running to protect your web server from attacks. You can now perform a quick test to verify that ModSecurity is running.
* ModSecurity should now be configured and running to protect your web server from attacks. You can now perform a quick test to verify that ModSecurity is running.


==Source==
==Source==

Latest revision as of 20:38, 22 November 2022

Installing ModSecurity

  • ModSecurity can be installed by running the following command in your terminal:
sudo apt install libapache2-mod-security2 -y
  • Alternatively, you can also build ModSecurity manually by cloning the official ModSecurity Github repository.
  • After installing ModSecurity, enable the Apache 2 headers module by running the following command:
sudo a2enmod headers
  • After installing ModSecurity and enabling the header module, you need to restart the apache2 service, this can be done by running the following command:
sudo systemctl restart apache2
  • You should now have ModSecurity installed. The next steps involves enabling and configuring ModSecurity and the OWASP-CRS.

Configuring ModSecurity

  • ModSecurity is a firewall and therefore requires rules to function. This section shows you how to implement the OWASP Core Rule Set. First, you must prepare the ModSecurity configuration file.
  • Remove the .recommended extension from the ModSecurity configuration file name with the following command:
sudo cp /etc/modsecurity/modsecurity.conf-recommended /etc/modsecurity/modsecurity.conf
  • With a text editor such as vim, open /etc/modsecurity/modsecurity.conf and change the value for SecRuleEngine to On:


vim /etc/modsecurity/modsecurity.conf
# -- Rule engine initialization ----------------------------------------------

# Enable ModSecurity, attaching it to every transaction. Use detection
# only to start with, because that minimises the chances of post-installation
# disruption.
#
SecRuleEngine On
...
  • Restart Apache to apply the changes:
sudo systemctl restart apache2
  • ModSecurity should now be configured to run. The next step in the process is to set up a rule set to actively prevent your web server from attacks.

Setting Up the OWASP ModSecurity Core Rule Set

The OWASP ModSecurity Core Rule Set (CRS) is a set of generic attack detection rules for use with ModSecurity or compatible web application firewalls. The CRS aims to protect web applications from a wide range of attacks, including the OWASP Top Ten, with a minimum of false alerts. The CRS provides protection against many common attack categories, including SQL Injection, Cross Site Scripting, and Local File Inclusion.

To set up the OWASP-CRS, follow the procedures outlined below.

  • First, delete the current rule set that comes prepackaged with ModSecurity by running the following command:
sudo rm -rf /usr/share/modsecurity-crs
  • Ensure that git is installed:
sudo apt install git
  • Clone the OWASP-CRS GitHub repository into the /usr/share/modsecurity-crs directory:
sudo git clone https://github.com/coreruleset/coreruleset /usr/share/modsecurity-crs

Rename the crs-setup.conf.example to crs-setup.conf:

sudo mv /usr/share/modsecurity-crs/crs-setup.conf.example /usr/share/modsecurity-crs/crs-setup.conf
  • Rename the default request exclusion rule file:
sudo mv /usr/share/modsecurity-crs/rules/REQUEST-900-EXCLUSION-RULES-BEFORE-CRS.conf.example /usr/share/modsecurity-crs/rules/REQUEST-900-EXCLUSION-RULES-BEFORE-CRS.conf
  • You should now have the OWASP-CRS setup and ready to be used in your Apache configuration.

Enabling ModSecurity in Apache 2

To begin using ModSecurity, enable it in the Apache configuration file by following the steps outlined below:

  • Using a text editor such as vim, edit the /etc/apache2/mods-available/security2.conf file to include the OWASP-CRS files you have downloaded:
vim /etc/apache2/mods-available/security2.conf
<IfModule security2_module>
        SecDataDir /var/cache/modsecurity
        Include /usr/share/modsecurity-crs/crs-setup.conf
        Include /usr/share/modsecurity-crs/rules/*.conf
</IfModule>
  • In /etc/apache2/sites-enabled/000-default.conf file VirtualHost block, include the SecRuleEngine directive set to On.


vim /etc/apache2/sites-enabled/000-default.conf
<VirtualHost *:80>
        ServerAdmin webmaster@localhost
        DocumentRoot /var/www/html

        ErrorLog ${APACHE_LOG_DIR}/error.log
        CustomLog ${APACHE_LOG_DIR}/access.log combined

        SecRuleEngine On
</VirtualHost>
  • If you are running a website that uses SSL, add SecRuleEngine directive to that website’s configuration file as well. See our guide on SSL Certificates with Apache on Debian & Ubuntu for more information.
  • Restart the apache2 service to apply the configuration:
sudo systemctl restart apache2
  • ModSecurity should now be configured and running to protect your web server from attacks. You can now perform a quick test to verify that ModSecurity is running.

Source