NAME

DJabberd::Authen::DBIC - A DBIC authentication module for DJabberd

VERSION

Version 0.01

SYNOPSIS

<VHost mydomain.com>

        [...]

        <Plugin DJabberd::Authen::DBIC>
                DBType          mysql || pgsql || ...
                DBName          mydbname
                DBHost          192.168.12.35   # optional
                DBPort          6723                    # optional
                DBUserName      adbuser   #optional 
                DBPassword      somepass  #optional 
                DBUsernameColumn     djusername
                DBPasswordColumn     djpassword
                DBSchemaClass    MyApp::Schema
                DBTableClass     Users
                DBResultSet      mysearch  #optional function that returns a custom resultset
                DBQuoteChar      `  #optional quoting character
                DBNameSep        .  #optional separator between tablea nd column names
                DigestAlgorithm    Any algorithm supported by Digest->new()      #optional
                DigestEncoding     binary || hex || base64      #optional, defaults
        </Plugin>
</VHost>

can_retrieve_cleartext

bool can_retrieve_cleartext()

Will return false if a valid digest type was specified in the config;

dbic_rs

ResultSet = dbic_rs()

Will return a DBIx::Class::ResultSet object.

get_password(username => $username)

Will pass back the stores password to DJabberD for further checking. Will deny connection if username is invalid.

check_cleartext

bool check_cleartext(username => $username, password => $cleartext_password)

Will accept or reject a connection depending on whether the user exists and the password is right or wrong.

_prep_password($clear_text_pw)

encoded string = _prep_password(string);

Will return an encoded string if DigestEncoding and DigestAlgorithm are defined, otherwise returns plain text.

AUTHOR

Guillermo Roditi, (groditi) <groditi at cpan.org>

BUGS

Please report any bugs or feature requests to bug-djabberd-authen-dbic at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=DJabberd-Authen-DBIC. 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 DJabberd::Authen::DBIC

You can also look for information at:

ACKNOWLEDGEMENTS

Based partly upon DBIx::Class::DigestColumns.

SEE ALSO

Digest DBIx::Class DJabberd DJabberd::Authen

COPYRIGHT & LICENSE

Copyright 2006 Guillermo Roditi, all rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.