![]() |
|
Mod Options |
![]() |
|||||||||
This modification is currently quarantined.
I've only recently started using vBulletin, and this is my first mod so if you use this, please click Installed!
This mod (which builds on the fine work from malcomx and zemic) is intended to lower the barriers to using and LDAP directory as an external authentication source for your board. The idea is simple; capture a login attempt before authentication and test it against LDAP first, if that succeeds, see if there is already a matching user in vBulletin. If there is not, create one, using data from the LDAP to fill in the required fields, if there is already a matching user (Determined by comparing email addresses) then update the user. You might be asking why this mod is better than the two mods I've mentioned above? Well firstly the only additional file is the XML file for the new hooks (See below), and no changes to vBulletin code so installation is simple, and upgrades to vBulletin don't get over complicated by re-applying changes. Secondly, all the settings are controlled from the admincp rather than an external config file. Thirdly (as if two wasn't enough) I've added some hook points so this mod can be extended, for example to get additional data from the LDAP and put it in user profile fields. One important similarity with the two earlier mods is that in the admincp and modcp no LDAP authentication is performed, this is a safety feature, so even if the mod or an extending to it, breaks your board, you shouldn't ever get locked out of the admincp so you'll be able to turn if off quickly. Additional Hooks The mod is essentially a single plugin (plus options and help) which runs at global_complete which is before most other things have happened, but just after all the global setup has occurred. To enable the additional hooks, you need to upload the file hooks_ldap_auth.xml to /includes/xml under your forum. The following new hooks are created by this mod:
By requesting new attributes at ldap_auth_start and then applying them at either ldap_auth_all_user, ldap_auth_new_user or ldap_auth_existing_user you can setup your users easily without having to write all the LDAP code yourself! AdminCP Settings This mod creates a new options group called LDAP Authentication between email options and user registration options where you set the host name and port number of the LDAP server, the initial authentication type (Anonymous or authenticated), optionally the BindDN and Password for the LDAP server. You also set which attribute matches the vBulletin username (The default is cn which works well for inetOrgPerson based entries). You can set additional attributes to retrieve (If you want to quickly knock up a simple plugin which uses them at one of the hook points above). There is also the facility to disable (or rather make unavailable) accounts which exist in vBulletin but not in LDAP. Given that your initial admin may fall into this group, there is also a list of userids who should be allowed to log in anyway. Requirements
I'll try to provide support to users of my mod, but please bear in mind I fairly new to all this, so I may not be able to solve all problems immediately. Support will only be provided via this thread (Don't PM or email me unless I ask you to). Priority will be given to users who have clicked Installed. Release Notes
Installation
Haqa... Download Now Only licensed members can download files, Click Here for more information. Addons Screenshots Show Your Support
The following members like this post: Jimbot
|
![]() |
||||
Mod | Developer | Type | Replies | Last Post |
Integration with vBulletin vBulletin Ldap Authentication Plugin | malcolmx | vBulletin 3.6 Add-ons | 117 | 19 Jun 2013 12:18 |
Integration with vBulletin LDAP Authentication | zemic | vBulletin 3.6 Add-ons | 61 | 08 Mar 2010 22:18 |
Comments |
#2
|
|||
|
|||
Ok, so how do you use the hooks to make a mod which can use and extend ldap_auth?
Roughly like this:
There are, of course, many other things you could choose to do in your plugin, for example if you call the standard_error function, you'll display a nice error message page (For example if the user has a flag denoting the account is disabled) HOWEVER you need to call process_logout() first as the user will be partly logged in (If their account already exists in vBulletin). Examples of this can be found in the LDAP Authentication plugin in this mod, or in the Full Name Support for LDAP Auth and Location Support for LDAP Auth mods (Coming soon). Hope this helps Haqa... No members have liked this post.
Last edited by Haqa; 21 Nov 2008 at 14:14. |
#3
|
|||
|
|||
---
No members have liked this post.
Last edited by codershark; 11 Jan 2009 at 09:00. |
#4
|
|||
|
|||
Originally Posted by codershark
Well be careful, I don't claim that the code is perfect, only that it works for me - There may well be hidden bugs, or aspects of vBulletin that I don't understand properly yet.![]()
Good luck with your exam! H. No members have liked this post.
|
#5
|
|||
|
|||
---
No members have liked this post.
Last edited by codershark; 11 Jan 2009 at 09:00. |
#6
|
|||
|
|||
You should use TABLE_PREFIX for vbulletin :-)
No members have liked this post.
|
#7
|
||||
|
||||
Great to see this addon and I have one single question as of now: What if I use this with an empty directory? Does this addon automatically inserts the users to the LDAP?
No members have liked this post.
|
#8
|
|||
|
|||
You are right, I should (And I though I did...). I'll fix this and release an update.
Originally Posted by daFish
No, the way it works is it takes users from the directory and creates them in vBulletin as they log in. It doesn't work the other way round.![]()
There are a number of good tools for LDAP management, I use yala, though this does open a potential security hole unless you are VERY careful (It exposes your LDAP to the internet via the web). H. No members have liked this post.
|
#9
|
||||
|
||||
Originally Posted by Haqa
I don't know if this is achievable, but it would be great if there would be an tool for synchronize the user databases, especially if you try to connect your forum to an backend with LDAP as the authentification service.
![]()
No members have liked this post.
|
#10
|
|||
|
|||
Nice hack, planning on using this in the future to have only one userdatabase
![]() No members have liked this post.
|
#11
|
|||
|
|||
Thanks for the pointer, this is fixed. Also I noticed I'd forgotten the hook definition file, this is now available above...
H. No members have liked this post.
|
#12
|
|||
|
|||
---
No members have liked this post.
Last edited by codershark; 11 Jan 2009 at 09:00. |
#13
|
|||
|
|||
Originally Posted by codershark
In theory, yes that should be possible, but it would require so pretty extensive changes to the VB login pages, which would pretty much break upgradability. The problem is that windows login sso works using a version of HTTP Digest auth (AFAIK) which is normally only supported by IIS - This would need to be faked by the login system, and is probably beyond my current level of experience with VB.![]()
The other point is that I'm trying to make my mods so that they don't break upgradability of VB (or any other products). Anyone else know of a simpler way to do Windows SSO? H. No members have liked this post.
|
#14
|
|||
|
|||
Originally Posted by codershark
I've been doing some reasearch, and if you have control over your webserver (and the modules installed) you could try playing with mod_auth_vas which implements SPNEGO - The basis for windows domain login support for IIS/IE.![]()
You'd still need some fairly significant mods to vB, (or perhaps a plug somewhere near global_start???) to tell it to use and trust the external username supplied by SPNEGO. H. No members have liked this post.
|
#15
|
|||
|
|||
Very nice mod - installed with no fuss.
I though had the problem that my LDAP server was containing a new user where the username was not used in vB, but the email was already taken by another username in vB. This means that your plugin tries to create the new user when a correct username/password is issued (seen from the LDAP server). But due to that the email already exists i vB with another username then the creation of the new user fails. This is properly okay, as two different users can not have the same email. But the error messages indicates that a wrong password/username is issued. My suggestion for improvement is to give better response to this case. Best regards Tom No members have liked this post.
|
![]() |
«
Previous Mod
|
Next Mod
»
Currently Active Users Viewing This Thread: 1 (0 members and 1 guests) | |
Mod Options | |
|
|
New To Site? | Need Help? |
All times are GMT. The time now is 19:04.