GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
Net::SSH::Perl::Auth::PublicKey(3) User Contributed Perl Documentation Net::SSH::Perl::Auth::PublicKey(3)

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

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

Net::SSH::Perl::Auth::PublicKey performs publickey authentication with a remote sshd server. When you create a new PublicKey auth object, you give it an $ssh object, which should contain an open connection to an ssh daemon, as well as any data that the authentication module needs to proceed. In this case, for example, the $ssh object might contain a list of identity files (see the docs for Net::SSH::Perl).

The authenticate method first tries to establish a connection to an authentication agent. If the attempt is successful, authenticate loops through each of the identities returned from the agent and tries each identity against the sshd, entering into a dialog with the server: the client sends the public portion of the key to determine whether the server will accept it; if the server accepts the key as authorization, the client then asks the agent to sign a piece of data using the key, which the client sends to the server. If the server accepts an identity/key, authentication is successful.

If the agent connection attempt fails, or if none of the identities returned from the agent allow for successful authentication, authenticate then tries to load each of the user's private key identity files (specified in the Net::SSH::Perl constructor, or defaulted to $ENV{HOME}/.ssh/id_dsa). For each identity, authenticate enters into a dialog with the server. The client sends a message to the server, giving its public key, plus a signature of the key and the other data in the message (session ID, etc.). The signature is generated using the corresponding private key. The sshd receives the message and verifies the signature using the client's public key. If the verification is successful, the authentication succeeds.

When loading each of the private key files, the client first tries to load the key using an empty passphrase. If this fails, the client either prompts the user for a passphrase (if the session is interactive) or skips the key altogether.

Please see the Net::SSH::Perl manpage for author, copyright, and license information.
2017-08-24 perl v5.32.1

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.