====== authjoomla3 Plugin ======

---- plugin ----
description:
author     : snaiperskaya 
email      : jury.verrigni@skayahack.com
type       : auth
lastupdate : 2017-01-06
compatible : Elenor of Tsort
depends    : 
conflicts  : 
similar    : 
tags       : joomla

downloadurl: https://github.com/snaiperskaya96/dokuwiki-authjoomla3-plugin/archive/master.zip
bugtracker : https://github.com/snaiperskaya96/dokuwiki-authjoomla3-plugin/issues
sourcerepo : https://github.com/snaiperskaya96/dokuwiki-authjoomla3-plugin
donationurl: 

screenshot_img : 
----

DokuWiki plugin to authenticate against a Joomla 3 installation.

Have a look at https://github.com/snaiperskaya96/dokuwiki-authjoomla3-plugin/blob/master/README.md to see a more detailed documentation.

===== Installation =====

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

===== Configuration and Settings =====

Go to the configuration page, then

  - change the option //Authentication backend// to ''authjoomla3'', but do not save yet.
  - go to the section //Authjoomla3// and type in the absolute path to your Joomla 3 installation, e.g. ''/var/www/html/joomla''
  - save your configuration

Now you should be able to login with your Joomla account.

:!: Once you changed the authentication backend, you won't be able to log in with your previous credentials. If the Joomla authentification fails, go to ''conf/local.php'' and change

<code>
$conf['authtype'] = 'authjoomla3';
</code>

to

<code>
$conf['authtype'] = 'authplain';
</code>

to switch back to the DokuWiki authentification.

===== Development =====

=== Change Log ===

{{rss>https://github.com/snaiperskaya96/dokuwiki-authjoomla3-plugin/commits/master.atom}}

=== Known Bugs and Issues ===


=== ToDo/Wish List ===


===== FAQ =====


===== Discussion =====

For security reasons setting AuthPDO can be better, because unlike authjoomla3 it doesn't access Joomla directory. So we can limit the PHP access of web sites to each other, with open_basedir. For example, using NGINX:

  location ~ \.php$ {
      try_files     $uri $uri/ /doku.php;
      fastcgi_pass  unix:/run/php-fpm/php-fpm.sock;
      fastcgi_param SCRIPT_FILENAME    $document_root$fastcgi_script_name;
      fastcgi_param PHP_VALUE open_basedir="/usr/share/nginx/www/dokuwiki/:/tmp/";
      include       fastcgi_params;
  }

So DokuWiki site would have access only to its folder (and temp folder or whatever you set there), but not to Joomla files. Also, the DokuWiki user for the database can have very limited rights too — just to read users tables information.