1Net::SSH::Perl::Auth::PUusbelricCKoenyt(r3i)buted Perl DNoectu:m:eSnStHa:t:iPoenrl::Auth::PublicKey(3)
2
3
4

NAME

6       Net::SSH::Perl::Auth::PublicKey - Perform publickey authentication
7

SYNOPSIS

9           use Net::SSH::Perl::Auth;
10           my $auth = Net::SSH::Perl::Auth->new('PublicKey', $ssh);
11           $auth->authenticate;
12

DESCRIPTION

14       Net::SSH::Perl::Auth::PublicKey performs publickey authentication with
15       a remote sshd server. When you create a new PublicKey auth object, you
16       give it an $ssh object, which should contain an open connection to an
17       ssh daemon, as well as any data that the authentication module needs to
18       proceed. In this case, for example, the $ssh object might contain a
19       list of identity files (see the docs for Net::SSH::Perl).
20
21       The authenticate method first tries to establish a connection to an
22       authentication agent. If the attempt is successful, authenticate loops
23       through each of the identities returned from the agent and tries each
24       identity against the sshd, entering into a dialog with the server: the
25       client sends the public portion of the key to determine whether the
26       server will accept it; if the server accepts the key as authorization,
27       the client then asks the agent to sign a piece of data using the key,
28       which the client sends to the server. If the server accepts an iden‐
29       tity/key, authentication is successful.
30
31       If the agent connection attempt fails, or if none of the identities
32       returned from the agent allow for successful authentication, authenti‐
33       cate then tries to load each of the user's private key identity files
34       (specified in the Net::SSH::Perl constructor, or defaulted to
35       $ENV{HOME}/.ssh/id_dsa). For each identity, authenticate enters into a
36       dialog with the server. The client sends a message to the server, giv‐
37       ing its public key, plus a signature of the key and the other data in
38       the message (session ID, etc.).  The signature is generated using the
39       corresponding private key.  The sshd receives the message and verifies
40       the signature using the client's public key. If the verification is
41       successful, the authentication succeeds.
42
43       When loading each of the private key files, the client first tries to
44       load the key using an empty passphrase. If this fails, the client
45       either prompts the user for a passphrase (if the session is interac‐
46       tive) or skips the key altogether.
47

AUTHOR & COPYRIGHTS

49       Please see the Net::SSH::Perl manpage for author, copyright, and
50       license information.
51
52
53
54perl v5.8.8                       2003-12-03Net::SSH::Perl::Auth::PublicKey(3)
Impressum