====== AnonIP Plugin ======

---- plugin ----
description: Anonymize IP-Addresses inside DokuWiki
author     : Andreas Gohr 
email      : andi@splitbrain.org 
type       : action
lastupdate : 2016-07-06
compatible : adora belle, weatherwax, binky, ponder stibbons, detritus
depends    : 
conflicts  : 
similar    : 
tags       : ip, anonym

downloadurl: https://github.com/splitbrain/dokuwiki-plugin-anonip/zipball/master
bugtracker : https://github.com/splitbrain/dokuwiki-plugin-anonip/issues
sourcerepo : https://github.com/splitbrain/dokuwiki-plugin-anonip/
donationurl: http://donate.dokuwiki.org/anonip
----

===== Installation =====

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

==== Change Log ====

{{rss>https://github.com/splitbrain/dokuwiki-plugin-anonip/commits/master.atom date}}


===== Usage =====

This plugin will replace the real IP of any user with a made up local IPv6 address right after the startup of DokuWiki. From that point on, DokuWiki will no longer know the initial IP-Address and will use the fake address instead for locking and logging.

**Note: this will not anonymize the IP-Adresses your web server might log. For complete anonymity you need to configure your web server accordingly.**

Even if your webserver already anonymizes IP addresses to 127.0.0.1, it is recommended to use this plugin. Otherwise you may experience problems with page locking.

==== How the Fake Address is generated ====

If your webserver anonymizes all IP-Addresses to 127.0.0.1 (FIXME add link to the module that does this), this plugin will generate the fake address using the current PHP session ID. If no session ID is available, a random number is used.

If incoming IP addresses are not anonymized, [[xref>auth_browseruid()]] is used to create the address. This function uses the first 3 octets of the original IPv4 and some browser headers to create a pseudo unique, but anonymous and irreversible ID. Users coming with the exactly same web browser from the same IP range will get the same fake address.