From 5409ade28c5f0acf99dbadd4d95e6f8efda5d395 Mon Sep 17 00:00:00 2001 From: ArthurHoaro Date: Thu, 14 Apr 2016 14:20:23 +0200 Subject: Update docs from Wiki --- doc/Server-security.html | 166 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 166 insertions(+) create mode 100644 doc/Server-security.html (limited to 'doc/Server-security.html') diff --git a/doc/Server-security.html b/doc/Server-security.html new file mode 100644 index 00000000..97f93780 --- /dev/null +++ b/doc/Server-security.html @@ -0,0 +1,166 @@ + + + + + + + Shaarli – Server security + + + + + + + +

Server security

php.ini

PHP settings are defined in:

a main configuration file, usually found under /etc/php5/php.ini; some distributions provide different configuration environments, e.g. +
- /etc/php5/php.ini - used when running console scripts
- /etc/php5/apache2/php.ini - used when a client requests PHP resources from Apache
- /etc/php5/php-fpm.conf - used when PHP requests are proxied to PHP-FPM
additional configuration files/entries, depending on the installed/enabled extensions: +
- /etc/php/conf.d/xdebug.ini

Locate .ini files

Console environment

$ php --ini
+Configuration File (php.ini) Path: /etc/php
+Loaded Configuration File:         /etc/php/php.ini
+Scan for additional .ini files in: /etc/php/conf.d
+Additional .ini files parsed:      /etc/php/conf.d/xdebug.ini

Server environment

create a phpinfo.php script located in a path supported by the web server, e.g. +
- Apache (with user dirs enabled): /home/myself/public_html/phpinfo.php
- /var/www/test/phpinfo.php
make sure the script is readable by the web server user/group (usually, www, www-data or httpd)
access the script from a web browser
look at the Loaded Configuration File and Scan this dir for additional .ini files entries
+
```
<?php phpinfo(); ?>
```

fail2ban

fail2ban is an intrusion prevention framework that reads server (Apache, SSH, etc.) and uses iptables profiles to block brute-force attempts:

Official website
Source code

Read Shaarli logs to ban IPs

Example configuration:

allow 3 login attempts per IP address
after 3 failures, permanently ban the corresponding IP adddress

/etc/fail2ban/jail.local

[shaarli-auth][](.html)
+enabled  = true
+port     = https,http
+filter   = shaarli-auth
+logpath  = /var/www/path/to/shaarli/data/log.txt
+maxretry = 3
+bantime = -1

/etc/fail2ban/filter.d/shaarli-auth.conf

[INCLUDES][](.html)
+before = common.conf
+[Definition][](.html)
+failregex = \s-\s<HOST>\s-\sLogin failed for user.*$
+ignoreregex =

+ + -- cgit v1.2.3 From 08dcd8ea58c07cd8258567ca14260aa18ba2660f Mon Sep 17 00:00:00 2001 From: ArthurHoaro Date: Sat, 14 May 2016 11:37:28 +0200 Subject: Doc update Signed-off-by: ArthurHoaro --- doc/Server-security.html | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) (limited to 'doc/Server-security.html') diff --git a/doc/Server-security.html b/doc/Server-security.html index 97f93780..6b44a133 100644 --- a/doc/Server-security.html +++ b/doc/Server-security.html @@ -60,10 +60,9 @@ code > span.in { color: #60a0b0; font-weight: bold; font-style: italic; } /* Inf

Server security

Shaarli installation

Shaarli configuration

Plugin installation & configuration

Plugins

Docker

Plugin list

Usage

Sharing button (bookmarklet)