./simple-neon-login/ 0000755 0002150 0002151 00000000000 12646757740 014672 5 ustar dallasge dallasge ./simple-neon-login/readme.txt 0000644 0002150 0002151 00000014571 12646757740 016700 0 ustar dallasge dallasge === Plugin Name === Contributors: ah0265 Donate link: http://dallasgenealogy.org/simple-neon-login Tags: Neon, z2Systems, NeonCRM, authentication, login, active directory Requires at least: 4.2 Tested up to: 4.2 Stable tag: 1.0.0 License: GPLv2 or later This plugin allows you to validate your WordPress users directly on the z2Systems NeonCRM server. == Description == This plugin allows you to authenticate all of your users against your z2Systems Neon platform utilizing their API interface. Users supply their UserID and Password: the program established a connetion to the Neon server and attempts to authendicate the credentials. If they are valid, the user is granted access to the WordPress site. If the are not already entered in the WordPress Users table the program will make an entry for them (including thier First and Last Names and email address which is obtained from the Neon server). If the users credentials are not authenticated they are returned to the login screen. If the UserID existed in the WordPress Users table it will be deleted (there are exceptions to this rule... Usernames with Admin privilidges will not be deleted, and Usernames listed in the Exempt Usernames field (see below) also will not be deleted). When combined with the Members plugin this provides a very effective 'Members Only' capability on WordPress. **Settings** Once installed and Activated a configuration page is made available (Simple Neon Settings under the WordPress Settings tab). Enable Neon Autentication - This is a check box that enable (checked) or disables (unchecked) the plugin functionality. New User Role - Sets the default rolse for each user added to the WordPress Users table. Neon Organization ID - A required value that can be obtained from Neon Neon API Key - Another required value that can be obtained from Neon Locally Verified Usernames - List all Usernames that you want to validate locally (via the normal Wordpress process). These will NOT be deleted by the program if/when the Neon authentication fails. If there are multiple Usernames listed each entry should be seperated using a semi-colon with NO extra spaces. For example: user1;user2;user3 It is a good idea to create an extra Admin account and several test accounts and list them here (technically you should not need to list the Admin accounts but listing them here is extra protection, especially if you are modifying or testing the code. **Contributing** **NEW VERSION -- 1.1.0** 17 January 2015 - Created to address problems with how user accounts were deleted. Version 1.0.0 was case sensitive when it compared User ID's listed in the Locally Verified Usernames list with the User ID provided in the User. In some cases this led to the program deleting a User ID that was on the Locally Verified Usernames list. This program was based entirely on Cliff Griffin's simple-LDAP-login plugin and, wherever possible, used his original code unchanged. The LDAP specific functions and variables were removed and replaced with those required for the Neon login functions If you have any problems with 1.5, please let me know: aehanson@swbell.net **Support** Sorry, you are on your own... If it breaks you get all of the pieces = Features = * Supports Active Directory and OpenLDAP (and other directory systems which comply to the LDAP standard, such as OpenDS) * Supports TLS * Uses up-to-date methods for WordPress authentication routines. * Authenticates existing WordPress usernames against LDAP. * Can be configured to automatically create WordPress users for valid LDAP logins. * You can restrict logins based on one or more LDAP groups. * Intuitive control panel. = Architecture = Simple LDAP Login adds an authentication filter to WordPress that authentication requests must pass. In doing so, it makes several decisions. * Can the provided credentials be authenticated against Neon? * * Does a matching WordPress user exist? * * * IF NOT, delete the user from the Users table * * * IF SO, log the user in. * * * If not, is user creation enabled? * * * * Create the user and log them in. This is high level overview. This should answer the philosophical questions about how the plugin works. If the plugin is unable to authenticate the user, it should pass it down the chain to WordPress. == Upgrade Notice == I have spent some time completely rewriting Simple LDAP Login from the ground up. Proceed with caution as it's possible I have broken something in the process, but I'm reasonably certain it's fundamentally stable. If you have any problems with 1.5, please let me know: clifgriffin@gmail.com == Changelog == **Version 1.0.0** * Original version * Based on 1.5.5 of simple-LDAP-login == Installation == 1. Use the WordPress plugin directory to install the plugin or upload the directory `simple-neon-login` to the `/wp-content/plugins/` directory. 1. Activate the plugin through the 'Plugins' menu in WordPress 1. Update the settings to those that best match your environment by going to Settings -> Simple Neon Login 1. If you don't get the settings right the first time, don't fret! Just disable the plugin by going to the Simple Neon Login settings page and un-checking the 'Enable Neon Authentication' box. That should allow you to log in using your administrator account or one of the accounts you created and excluded using the 'Exempt Usernames' field on the setting page 1. To make your life easier, consider using two different browsers (e.g., Chrome and Firefox) to do testing. Change settings in one. Test in the other. This will prevent any chance of being locked out. == Frequently Asked Questions == = How do I know what the correct settings are? = I have tried to make the settings as self-explanatory as possible. If you are struggling figuring them out, you may need to contact Neon to obtain the correct API Key and Organization ID = It's still not working, what other things can I try? = If you are confident your settings are correct and it still does not work, it may be time to check for port or firewall issues. If you are comfortable with PHP I have left debug statements commented out throughout the code. Start enabling some of the echo commands and try to figure out where things are falling off the tracks. Note that this will seriously upset the way things work... you will get the debug output you need to figure out what is going on, but when you are done you need to re-comment ALL of the echo and print_r commands to get things working again. ./simple-neon-login/Simple-Neon-Login-Admin.php 0000644 0002150 0002151 00000007064 12646757737 021642 0 ustar dallasge dallasge