83 lines
3.0 KiB
Plaintext
83 lines
3.0 KiB
Plaintext
Gallery3 PAM version 0.1 released 2010-08-12
|
|
|
|
ABOUT
|
|
Allows users to login by using external authentication methods.
|
|
|
|
Note: I chose not to use the existing LDAP module because it did not allow me
|
|
to use both local Gallery accounts along with the LDAP accounts.
|
|
|
|
This module replaces the default login link on the user_menu_login. This
|
|
works for the ajax login but to use the html you need to go to /pam ... I do
|
|
not know enough about kohana to know how to use the /login url without
|
|
removing the gallery/controller/login.php file.
|
|
|
|
INSTALLATION
|
|
Copy the pam folder to the gallery3 modules folder.
|
|
|
|
CONFIGURATION
|
|
Add plugins to the plugin folder to enable alternative authentication methods.
|
|
|
|
Edit the config/config.php file to override defaults.
|
|
|
|
$plugin_path = '';
|
|
The default path is pam/plugins. You can put them anywhere and use this to set
|
|
the absolute path.
|
|
|
|
$plugins = array('gallery');
|
|
By default the plugin folder is scanned and whatever folders are found are
|
|
added to the plugin array. By using this setting you can specify what
|
|
plugins to include and in what order they will be used.
|
|
|
|
$create_account = true;
|
|
By default this is set to false. Set this to true if you want to
|
|
automatically create accounts. This assumes the plugin will have a
|
|
getAccount() method that will return at the very least: name,full_name,email
|
|
|
|
Note:
|
|
Two plugins are included in the pam_plugin folder. Copy a plugin to the
|
|
plugin folder to make it available to the PAM module.
|
|
|
|
mock: will authenticate any matching name/password pair. ex. user/user and if
|
|
$create_account is true then an account will be created using the name. The
|
|
fullname will be "Mock {the name used}" and the email will be set to "{the
|
|
name used}@email.com"
|
|
|
|
ad: this is a plugin to authenticate a user via an Active Directory domain
|
|
controller. It uses the class adLDAP (http://adldap.sourceforge.net/) and
|
|
assumes that your PHP environment has the LDAP exensions loaded. This
|
|
plugin has included the adLDAP class version 2.1. I've not tested with later
|
|
versions.
|
|
|
|
USE
|
|
Login as admin and go to the Gallery Modules page. Check the PAM module and
|
|
update. The PAM module will replace the "Login" link so that the PAM module
|
|
will be used instead of the core Login.
|
|
|
|
By default the "gallery" plugin is in the plugin folder. This allows
|
|
authentication via the core identity. You should be able to logout and then
|
|
login again.
|
|
|
|
PROBLEMS
|
|
If you are not able to login just remove the PAM folder from the modules and
|
|
refresh your page. Or you can go to the default login by going to {your site
|
|
url}/login.
|
|
|
|
Submit an issue at http://github.com/jimsloan/gallery3-pam/issues or email
|
|
me.
|
|
|
|
FUTURE
|
|
I will be adding a OpenID plugin soon.
|
|
|
|
By using the Mock plugin as an example you should be able to create a
|
|
connector/plugin to any existing database or web service that will
|
|
authenticate user credentials.
|
|
|
|
AUTHOR
|
|
Jim Sloan (jsloan.email@gmail.com)
|
|
|
|
PROJECT HOME
|
|
http://github.com/jimsloan/gallery3-pam
|
|
|
|
LICENSE
|
|
see LICENSE
|