projects / github / shaarli / Shaarli.git / blame
| Commit | Line | Data |
|---|---|---|
| 5409ade2 A |
1 | #Server security |
| 2 | ## php.ini | |
| 3 | PHP settings are defined in: | |
| 4 | - a main configuration file, usually found under `/etc/php5/php.ini`; some distributions provide different configuration environments, e.g. | |
| 5 | - `/etc/php5/php.ini` - used when running console scripts | |
| 6 | - `/etc/php5/apache2/php.ini` - used when a client requests PHP resources from Apache | |
| 7 | - `/etc/php5/php-fpm.conf` - used when PHP requests are proxied to PHP-FPM | |
| 8 | - additional configuration files/entries, depending on the installed/enabled extensions: | |
| 9 | - `/etc/php/conf.d/xdebug.ini` | |
| 10 | ||
| 11 | ### Locate .ini files | |
| 12 | #### Console environment | |
| 13 | ```bash | |
| 14 | $ php --ini | |
| 15 | Configuration File (php.ini) Path: /etc/php | |
| 16 | Loaded Configuration File: /etc/php/php.ini | |
| 17 | Scan for additional .ini files in: /etc/php/conf.d | |
| 18 | Additional .ini files parsed: /etc/php/conf.d/xdebug.ini | |
| 19 | ``` | |
| 20 | ||
| 21 | #### Server environment | |
| 22 | - create a `phpinfo.php` script located in a path supported by the web server, e.g. | |
| 23 | - Apache (with user dirs enabled): `/home/myself/public_html/phpinfo.php` | |
| 24 | - `/var/www/test/phpinfo.php` | |
| 25 | - make sure the script is readable by the web server user/group (usually, `www`, `www-data` or `httpd`) | |
| 26 | - access the script from a web browser | |
| 27 | - look at the _Loaded Configuration File_ and _Scan this dir for additional .ini files_ entries | |
| 28 | ```php | |
| 29 | <?php phpinfo(); ?> | |
| 30 | ``` | |
| 31 | ||
| 32 | ## fail2ban | |
| 33 | `fail2ban` is an intrusion prevention framework that reads server (Apache, SSH, etc.) and uses `iptables` profiles to block brute-force attempts: | |
| 34 | - [Official website](http://www.fail2ban.org/wiki/index.php/Main_Page)[](.html) | |
| 35 | - [Source code](https://github.com/fail2ban/fail2ban)[](.html) | |
| 36 | ||
| 37 | ### Read Shaarli logs to ban IPs | |
| 38 | Example configuration: | |
| 39 | - allow 3 login attempts per IP address | |
| 40 | - after 3 failures, permanently ban the corresponding IP adddress | |
| 41 | ||
| 42 | `/etc/fail2ban/jail.local` | |
| 43 | ```ini | |
| 44 | [shaarli-auth][](.html) | |
| 45 | enabled = true | |
| 46 | port = https,http | |
| 47 | filter = shaarli-auth | |
| 48 | logpath = /var/www/path/to/shaarli/data/log.txt | |
| 49 | maxretry = 3 | |
| 50 | bantime = -1 | |
| 51 | ``` | |
| 52 | ||
| 53 | `/etc/fail2ban/filter.d/shaarli-auth.conf` | |
| 54 | ```ini | |
| 55 | [INCLUDES][](.html) | |
| 56 | before = common.conf | |
| 57 | [Definition][](.html) | |
| 58 | failregex = \s-\s<HOST>\s-\sLogin failed for user.*$ | |
| 59 | ignoreregex = | |
| 60 | ``` | |
| fdf88d19 A |
61 | |
| 62 | ## Robots - Restricting search engines and web crawler traffic | |
| 63 | ||
| 64 | Creating a `robots.txt` with the following contents at the root of your Shaarli installation will prevent _honest_ web crawlers from indexing each and every link and Daily page from a Shaarli instance, thus getting rid of a certain amount of unsollicited network traffic. | |
| 65 | ||
| 66 | ``` | |
| 67 | User-agent: * | |
| 68 | Disallow: / | |
| 69 | ``` | |
| 70 | ||
| 71 | See: | |
| 72 | - http://www.robotstxt.org/ | |
| 73 | - http://www.robotstxt.org/robotstxt.html | |
| 74 | - http://www.robotstxt.org/meta.html |