view release on metacpan or  search on metacpan

README  view on Meta::CPAN

  authenticate( $authinfo, $c )
    Try to log a user in, receives a hashref containing authentication
    information as the first argument, and the current context as the
    second.

JUSTIFICATION
    Why would you use this module rather than one of the similar ones?

    This module gives a combination of authentication against a remote http
    server, but maintains a local user store. This allows your
    authentication to be delegated, but the authorization (for example
    allocation and use of roles) to be determined by the local user store.

    Nearly all the other alternatives require you to combine your
    authentication and authorization databases.

    Catalyst::Authentication::Credential::HTTP::Proxy has a similar basis,
    but requires you to use HTTP basic authentication for the application,
    which may not be appropriate.

NTLM NOTES
    There are a number of issues relating to NTLM authentication. In
    particular the supporting modules can be rather picky. To make NTLM
    authentication work you must have an installed copy of libwww-perl that
    includes LWP::Authen::Ntlm (some linux distributions may drop this
    component as it gives you additional dependency requirements over the
    basic LWP package).

    Additionally you require Authen::NTLM of version 1.02 or later. There
    are 2 different CPAN module distributions that provide this module - but
    only one of them has the appropriate version number.

    Finally, if you are using NTLM-1.02 then you need to apply the patch
    described in RT entry 9521
    <http://rt.cpan.org/Ticket/Display.html?id=9521>.

    When using NTLM authentication the configuration option
    "http_keep_alive" must be set true - otherwise the session to the remote
    server is not maintained and the authentication nonce will be lost
    between sessions.

    You may also need to set "username_prefix" or "username_suffix" to set
    the correct domain for the authentication, unless the username as given
    to your application includes the domain information.

ACKNOWLEDGEMENTS
    Daisuke Murase <typester@cpan.org> - original
    Catalyst::Plugin::Authentication::Store::HTTP used as the base for a
    previous version of this module.

    The code framework was taken from
    Catalyst::Authentication::Credential::Password

    Tomas Doran (t0m) <t0m@state51.co.uk> - Fixups to best practice
    guidelines

INSTALLATION
    See perlmodinstall for information and options on installing Perl
    modules.

BUGS AND LIMITATIONS
    You can make new bug reports, and view existing ones, through the web
    interface at
    <http://rt.cpan.org/Public/Dist/Display.html?Name=Catalyst-Authenticatio
    n-Credential-RemoteHTTP>.

AVAILABILITY
    The project homepage is
    <https://metacpan.org/release/Catalyst-Authentication-Credential-RemoteH
    TTP>.

    The latest version of this module is available from the Comprehensive
    Perl Archive Network (CPAN). Visit <http://www.perl.com/CPAN/> to find a
    CPAN site near you, or see
    <https://metacpan.org/module/Catalyst::Authentication::Credential::Remot
    eHTTP/>.

AUTHOR
    Nigel Metheringham <nigelm@cpan.org>

COPYRIGHT AND LICENSE
    This software is copyright (c) 2012 by Nigel Metheringham
    <nigelm@cpan.org>.

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