NAME

Net::SSH::Perl::Auth::Password - Password authentication plugin

SYNOPSIS

    use Net::SSH::Perl::Auth;
    my $auth = Net::SSH::Perl::Auth->new('Password', $ssh);
    print "Valid auth" if $auth->authenticate;

DESCRIPTION

Net::SSH::Perl::Auth::Password performs password authentication with a remote sshd server. When you create a new password auth object, you give it an $ssh object, which should contain an open connection to an ssh daemon, as well as the data that the authentication module needs to proceed.

The authenticate method will enter into a dialog with the server. For password authentication, all that needs to be done is to send a password (encrypted by the standard SSH encryption layer) to the server, and wait for its response. If the $ssh object doesn't already have a password that you've given it, Net::SSH::Perl::Auth::Password will check to see if you're in an interactive session (see the docs for Net::SSH::Perl), and if so will issue a prompt, asking you to enter your password. If the session is not interactive (if it's in batch mode), we send a blank password to comply with the protocol, but odds are the authentication will then fail.

AUTHOR & COPYRIGHTS

Please see the Net::SSH::Perl manpage for author, copyright, and license information.