X-Git-Url: https://git.immae.eu/?a=blobdiff_plain;f=doc%2FTroubleshooting.html;h=ed1c6f09fa1ae285346f37ff14eda53faefd140c;hb=4fd053d6b29a1b6724eda17a3daddb29b1bf1ca3;hp=6965a578ea32d92ac4bb72741ee7024c94e1b433;hpb=27cf2e671d1f35bd8c9383d008cd3733fc1c6e0d;p=github%2Fshaarli%2FShaarli.git diff --git a/doc/Troubleshooting.html b/doc/Troubleshooting.html index 6965a578..ed1c6f09 100644 --- a/doc/Troubleshooting.html +++ b/doc/Troubleshooting.html @@ -4,45 +4,69 @@ - Shaarli - Troubleshooting + Shaarli – Troubleshooting - +

Troubleshooting

+

Browser

+

Redirection issues (HTTP Referer)

+

Depending on its configuration and installed plugins, the browser may remove or alter (spoof) HTTP referers, thus preventing Shaarli from properly redirecting between pages.

+

See:

+ +

Firefox HTTP Referer options

+

HTTP settings are available by browsing about:config, here are the available settings and their values.

+

network.http.sendRefererHeader - determines when to send the Referer HTTP header

+ +

network.http.referer.XOriginPolicy - Cross-domain origin policy

+ +

network.http.referer.spoofSource - Referer spoofing (~faking)

+ +

network.http.referer.trimmingPolicy - trim the URI not to send a full Referer

+ +

Firefox, localhost and redirections

+

localhost is not a proper Fully Qualified Domain Name (FQDN); if Firefox has been set up to spoof referers, or only accept requests from the same base domain/host, Shaarli redirections will not work properly.

+

To solve this, assign a local domain to your host, e.g.

+
127.0.0.1 localhost desktop localhost.lan
+::1       localhost desktop localhost.lan
+

and browse Shaarli at http://localhost.lan/.

+

Related threads:

+

Login

I forgot my password!

Delete the file data/config.php and display the page again. You will be asked for a new login/password.

@@ -81,21 +156,24 @@ code > span.er { color: #ff0000; font-weight: bold; }

Login form is protected against brute force attacks: 4 failed logins will ban the IP address from login for 30 minutes. Banned IPs can still browse links.

To remove the current IP bans, delete the file data/ipbans.php

List of all login attempts

-

The file data/log.txt shows all logins (successful or failed) and bans/lifted bans.
Search for failed in this file to look for unauthorized login attempts.

+

The file data/log.txt shows all logins (successful or failed) and bans/lifted bans.
+Search for failed in this file to look for unauthorized login attempts.

Hosting problems

+

Old PHP versions

-
php 1
-SetEnv PHP_VER 5
+
<IfDefine Free>
+php56 1
+</IfDefine>
-
//list($status,$headers,$data) = getHTTP($url,4); // Short timeout to keep the application responsive.
+
//list($status,$headers,$data) = getHTTP($url,4); // Short timeout to keep the application responsive.
 // FIXME: Decode charset according to charset specified in either 1) HTTP response headers or 2) <head> in html 
-//if (strpos($status,'200 OK')) $title=html_extract_title($data);
+//if (strpos($status,'200 OK')) $title=html_extract_title($data);