https://github.com/racke/dancer-plugin-ldap

Dancer LDAP Plugin
https://github.com/racke/dancer-plugin-ldap

Last synced: 3 months ago
JSON representation

Dancer LDAP Plugin

• Host: GitHub
• URL: https://github.com/racke/dancer-plugin-ldap
• Owner: racke
• Created: 2011-12-06T22:22:11.000Z (about 13 years ago)
• Default Branch: master
• Last Pushed: 2014-02-09T14:35:17.000Z (almost 11 years ago)
• Last Synced: 2023-03-12T03:37:49.311Z (almost 2 years ago)
• Language: Perl
• Homepage:
• Size: 217 KB
• Stars: 6
• Watchers: 3
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README
  • Changelog: Changes

Awesome Lists containing this project

README

        
NAME

    Dancer::Plugin::LDAP - LDAP plugin for Dancer micro framework

VERSION

    Version 0.0050

SYNOPSIS

        use Dancer;

        use Dancer::Plugin::LDAP;

        # Calling the ldap keyword returns you a LDAP handle

        $ldap = ldap;

        # Use convenience methods for retrieving, updating and deleting LDAP entries

        $account = ldap->quick_select({dn => '[email protected],dc=linuxia,dc=de'});

        ldap->quick_update('[email protected],dc=linuxia,dc=de', {l => 'Vienna'});

        ldap->quick_delete('[email protected],dc=linuxia,dc=de');

DESCRIPTION

    Provides an easy way to obtain a connected LDAP handle by simply calling

    the ldap keyword within your Dancer application.

    Returns a Dancer::Plugin::LDAP::Handle object, which is a subclass of a

    Net::LDAP handle object, so it does everything you'd expect to do with

    Net::LDAP, but also adds a few convenience methods. See the

    documentation for Dancer::Plugin::LDAP::Handle for full details of

    those.

    This plugin is compatible to Dancer 1 and Dancer 2.

  TEXT SEARCHES

    Need to run a text search across your LDAP directory? This plugin

    provides a quick way to do that:

        for (qw/uid sn givenName c l/) {

            $search{$_} = [substr => $args{search}];

        }

        @entries = ldap->quick_select({-or => \%search});

  UTF-8

    Attribute values returned by the Dancer::Plugin::LDAP::Handle method are

    automatically converted to UTF-8 strings.

CONFIGURATION

        plugins:

            LDAP:

                uri: 'ldap://127.0.0.1:389/'

                base: 'dc=linuxia,dc=de'

                bind: cn=admin,dc=linuxia,dc=de

                password: nevairbe

AUTHOR

    Stefan Hornburg (Racke), `'

CONTRIBUTING

    This module is developed on Github at:

    https://github.com/racke/Dancer-Plugin-LDAP

    Feel free to fork the repo and submit pull requests! Also, it makes

    sense to watch the repo on GitHub for updates.

    Feedback and bug reports are always appreciated. Even a quick mail to

    let me know the module is useful to you would be very nice - it's nice

    to know if code is being actively used.

ACKNOWLEDGEMENTS

    David Precious for providing the great Dancer::Plugin::Database, which

    helped me a lot in terms of ideas and code to write this plugin.

    Marco Pessotto for fixing update of attributes with empty value.

BUGS

    Please report any bugs or feature requests to `bug-dancer-plugin-ldap at

    rt.cpan.org', or through the web interface at

    http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Dancer-Plugin-LDAP. I

    will be notified, and then you'll automatically be notified of progress

    on your bug as I make changes.

SUPPORT

    You can find documentation for this module with the perldoc command.

        perldoc Dancer::Plugin::LDAP

    You can also look for information at:

    * RT: CPAN's request tracker (report bugs here)

        http://rt.cpan.org/NoAuth/Bugs.html?Dist=Dancer-Plugin-LDAP

    * AnnoCPAN: Annotated CPAN documentation

        http://annocpan.org/dist/Dancer-Plugin-LDAP

    * CPAN Ratings

        http://cpanratings.perl.org/d/Dancer-Plugin-LDAP

    * Search CPAN

        http://search.cpan.org/dist/Dancer-Plugin-LDAP/

    You can find the author on IRC in the channel `#dancer' on

    .

LICENSE AND COPYRIGHT

    Copyright 2011-2013 Stefan Hornburg (Racke).

    This program is free software; you can redistribute it and/or modify it

    under the terms of either: the GNU General Public License as published

    by the Free Software Foundation; or the Artistic License.

    See http://dev.perl.org/licenses/ for more information.

SEE ALSO

    Dancer

    Net::LDAP