X-Git-Url: https://git.immae.eu/?a=blobdiff_plain;f=doc%2FTroubleshooting.html;h=3de8ad1e2a55f6c3154c336a34ccd5418ca74dde;hb=5e148f8a529abf72256ef74ed149d56a5b27bd72;hp=6965a578ea32d92ac4bb72741ee7024c94e1b433;hpb=27cf2e671d1f35bd8c9383d008cd3733fc1c6e0d;p=github%2Fshaarli%2FShaarli.git diff --git a/doc/Troubleshooting.html b/doc/Troubleshooting.html index 6965a578..3de8ad1e 100644 --- a/doc/Troubleshooting.html +++ b/doc/Troubleshooting.html @@ -4,31 +4,49 @@ - Shaarli - Troubleshooting + Shaarli – Troubleshooting - +
@@ -36,21 +54,30 @@ code > span.er { color: #ff0000; font-weight: bold; }
  • Home
  • Installation
  • +
  • Docker
  • Usage
  • How To
  • Troubleshooting
  • Development @@ -60,6 +87,7 @@ code > span.er { color: #ff0000; font-weight: bold; }
  • Directory structure
  • 3rd party libraries
  • Plugin System
  • +
  • Release Shaarli
  • Security
  • Static analysis
  • Theming
  • @@ -74,6 +102,54 @@ code > span.er { color: #ff0000; font-weight: bold; }

    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 anly 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 +157,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);