aboutsummaryrefslogtreecommitdiffstats
path: root/INSTALL.txt
diff options
context:
space:
mode:
authorSimon L'nu <simon.lnu@gmail.com>2012-05-21 21:23:40 -0400
committerSimon L'nu <simon.lnu@gmail.com>2012-05-21 21:23:40 -0400
commit867e3b33d11a8403ce2d7eda567b8eb7ba58bda7 (patch)
tree1a91309205c5659516b0a7daab0d478db82b846a /INSTALL.txt
parentf570965ebe65fe7d549cafea5f5d8c04da3d986f (diff)
parent9ca3ac6e61ff57a2bc615b133a64b0a7f66b3c41 (diff)
downloadvolse-hubzilla-867e3b33d11a8403ce2d7eda567b8eb7ba58bda7.tar.gz
volse-hubzilla-867e3b33d11a8403ce2d7eda567b8eb7ba58bda7.tar.bz2
volse-hubzilla-867e3b33d11a8403ce2d7eda567b8eb7ba58bda7.zip
Merge branch 'master', remote-tracking branch 'remotes/upstream/master'
* remotes/upstream/master: rev update, bug 428, 429, and ability to block globaldir submissions from demo sites * master:
Diffstat (limited to 'INSTALL.txt')
-rw-r--r--INSTALL.txt47
1 files changed, 47 insertions, 0 deletions
diff --git a/INSTALL.txt b/INSTALL.txt
index 574e90975..86076a09a 100644
--- a/INSTALL.txt
+++ b/INSTALL.txt
@@ -222,3 +222,50 @@ Retry the installation. As soon as the database has been created,
% chmod 755 .htconfig.php
+#####################################################################
+- Some congiurations with "suhosin" security are configured without
+an ability to run external processes. Friendica requires this ability.
+Following are some notes provided by one of our members.
+#####################################################################
+
+On my server I use the php protection system Suhosin
+[http://www.hardened-php.net/suhosin/]. One of the things it does is to block
+certain functions like proc_open, as configured in /etc/php5/conf.d/suhosin.ini:
+
+ suhosin.executor.func.blacklist = proc_open, ...
+
+For those sites like Friendica that really need these functions they can be
+enabled, e.g. in /etc/apache2/sites-available/friendica:
+
+ <Directory /var/www/friendica/>
+ php_admin_value suhosin.executor.func.blacklist none
+ php_admin_value suhosin.executor.eval.blacklist none
+ </Directory>
+
+This enables every function for Friendica if accessed via browser, but not for
+the cronjob that is called via php command line. I attempted to enable it for
+cron by using something like
+
+ */10 * * * * cd /var/www/friendica/friendica/ && sudo -u www-data /usr/bin/php
+-d suhosin.executor.func.blacklist=none -d suhosin.executor.eval.blacklist=none
+-f include/poller.php
+
+This worked well for simple test cases, but the friendica-cron still failed with
+a fatal error:
+suhosin[22962]: ALERT - function within blacklist called: proc_open() (attacker
+'REMOTE_ADDR not set', file '/var/www/friendica/friendica/boot.php', line 1341)
+
+After a while I noticed, that include/poller.php calls further php script via
+proc_open. These scripts themselves also use proc_open and fail, because they
+are NOT called with -d suhosin.executor.func.blacklist=none.
+
+So the simple solution is to put the correct parameters into .htconfig.php:
+ // Location of PHP command line processor
+ $a->config['php_path'] = '/usr/bin/php -d suhosin.executor.func.blacklist=none
+-d suhosin.executor.eval.blacklist=none';
+
+
+This is obvious as soon as you notice that the friendica-cron uses proc_open to
+execute php-scripts that also use proc_open, but it took me quite some time to
+find that out. I hope this saves some time for other people using suhosin with
+function blacklists.