NAME

       Authen::SASL::Perl::DIGEST_MD5 - Digest MD5 Authentication class

SYNOPSIS

         use Authen::SASL qw(Perl);

         $sasl = Authen::SASL->new(
           mechanism => 'DIGEST-MD5',
           callback  => {
             user => $user,
             pass => $pass,
             serv => $serv
           },
         );

DESCRIPTION

       This method implements the client and server parts of the DIGEST-MD5 SASL algorithm, as
       described in RFC 2831.

   CALLBACK
       The callbacks used are:

       client

       authname
           The authorization id to use after successful authentication

       user
           The username to be used in the response

       pass
           The password to be used to compute the response.

       serv
           The service name when authenticating to a replicated service

       realm
           The authentication realm when overriding the server-provided default.  If not given
           the server-provided value is used.

           The callback will be passed the list of realms that the server provided in the initial
           response.

       server

       realm
           The default realm to provide to the client

       getsecret(username, realm, authzid)
           returns the password associated with "username" and "realm"

   PROPERTIES
       The properties used are:

       maxbuf
           The maximum buffer size for receiving cipher text

       minssf
           The minimum SSF value that should be provided by the SASL security layer.  The default
           is 0

       maxssf
           The maximum SSF value that should be provided by the SASL security layer.  The default
           is 2**31

       externalssf
           The SSF value provided by an underlying external security layer.  The default is 0

       ssf The actual SSF value provided by the SASL security layer after the SASL authentication
           phase has been completed. This value is read-only and set by the implementation after
           the SASL authentication phase has been completed.

       maxout
           The maximum plaintext buffer size for sending data to the peer.  This value is set by
           the implementation after the SASL authentication phase has been completed and a SASL
           security layer is in effect.

SEE ALSO

       Authen::SASL, Authen::SASL::Perl

AUTHORS

       Graham Barr, Djamel Boudjerda (NEXOR), Paul Connolly, Julian Onions (NEXOR), Yann
       Kerherve.

       Please report any bugs, or post any suggestions, to the perl-ldap mailing list
       <perl-ldap@perl.org>

COPYRIGHT

       Copyright (c) 2003-2009 Graham Barr, Djamel Boudjerda, Paul Connolly, Julian Onions,
       Nexor, Peter Marschall and Yann Kerherve.  All rights reserved. This program is free
       software; you can redistribute it and/or modify it under the same terms as Perl itself.