Hi!

Craig Andrews wrote:
>  I just made some major changes to the plugin, and there will be more-
> this code is very volatile. You're welcome to test and report
> thoughts/issues as you see fit; caveat emptor.

I wasn't able to test your changes but I hope I'll have time to play
around a bit with LdapAuthentication next week. Anyway, I just had a
look at the new README- I've attached a version I like better. The point
is: Some people still work on servers without a GUI and your README is
hard to read on an 80 column terminal. I didn't change the content, just
the "layout".

You usually log in to your server using a GUI (PuTTY from Windows or
something) and are therefore able to enlarge you terminal window, but I
just consider a 80 column layout to be Good Style(tm).

/Mario


-- 
They can tak' oour lives but they cannae tak' oour troousers!
#
The LDAP Authentication plugin allows for StatusNet to handle authentication
through LDAP.

Installation
============
add "addPlugin('ldapAuthentication', array('setting'=>'value', 'setting2'=>'value2', ...);" to the bottom of your config.php

Settings
========
provider_name*: a unique name for this authentication provider.

authoritative (false): Set to true if LDAP's responses are authoritative
(meaning if LDAP fails, do check any other plugins or the internal password database).

autoregistration (false): Set to true if users should be automatically created
when they attempt to login.

email_changeable (true): Are users allowed to change their email address? (true
or false)

password_changeable (true): Are users allowed to change their passwords? (true
or false)

host*: LDAP server name to connect to. You can provide several hosts in an
array in which case the hosts are tried from left to right..
See http://pear.php.net/manual/en/package.networking.net-ldap2.connecting.php

port: Port on the server.
See http://pear.php.net/manual/en/package.networking.net-ldap2.connecting.php

version: LDAP version.
See http://pear.php.net/manual/en/package.networking.net-ldap2.connecting.php

starttls: TLS is started after connecting.
See http://pear.php.net/manual/en/package.networking.net-ldap2.connecting.php

binddn: The distinguished name to bind as (username).
See http://pear.php.net/manual/en/package.networking.net-ldap2.connecting.php

bindpw: Password for the binddn.
See http://pear.php.net/manual/en/package.networking.net-ldap2.connecting.php

basedn*: LDAP base name (root directory).
See http://pear.php.net/manual/en/package.networking.net-ldap2.connecting.php

options:
See http://pear.php.net/manual/en/package.networking.net-ldap2.connecting.php

filter: Default search filter.
See http://pear.php.net/manual/en/package.networking.net-ldap2.connecting.php

scope: Default search scope.
See http://pear.php.net/manual/en/package.networking.net-ldap2.connecting.php

attributes: an array with the key being the StatusNet user attribute name, and
the value the LDAP attribute name
    username*
    nickname*
    email
    fullname
    homepage
    location
    
* required
default values are in (parenthesis)

Example
=======
Here's an example of an LDAP plugin configuration that connects to Microsoft
Active Directory.

addPlugin('ldapAuthentication', array(
    'provider_name'=>'Example',
    'authoritative'=>true,
    'autoregistration'=>true,
    'binddn'=>'username',
    'bindpw'=>'password',
    'basedn'=>'OU=Users,OU=StatusNet,OU=US,DC=americas,DC=global,DC=loc',
    'host'=>array('server1', 'server2'),
    'attributes'=>array(
        'nickname'=>'sAMAccountName',
        'email'=>'mail',
        'fullname'=>'displayName')
));
_______________________________________________
StatusNet-dev mailing list
[email protected]
http://lists.status.net/mailman/listinfo/statusnet-dev

Reply via email to