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


Manual Reference Pages  -  NET::SSH::PERL::AUTH (3)

.ds Aq ’

NAME

Net::SSH::Perl::Auth - Base authentication class, plus utility methods

CONTENTS

SYNOPSIS



   use Net::SSH::Perl::Cipher;

   # Get list of supported authentication IDs.
   my $supported = Net::SSH::Perl::Auth::supported();

   # Translate an auth name into an ID.
   my $id = Net::SSH::Perl::Auth::id($name);

   # Translate an auth ID into a name.
   my $name = Net::SSH::Perl::Auth::name($id);

   # Get the order in which auth methods are tested.
   my $order = Net::SSH::Perl::Auth::order();



DESCRIPTION

Net::SSH::Perl::Auth provides a base class for each of the authentication method classes. In addition, it defines a set of utility methods that can be called either as functions or object methods.

UTILITY METHODS

supported( [ CW$auth_id [, CW$server_supports ] ])

Without arguments, returns a reference to an array of auth methods supported by Net::SSH::Perl. These are methods that have working Net::SSH::Perl::Auth:: implementations, essentially.

With one argument $auth_id, returns a true value if that auth method is supported by Net::SSH::Perl, and false otherwise.

With two arguments, $auth_id and $server_supports, returns true if the auth represented by $auth_id is supported both by Net::SSH::Perl and by the sshd server. The list of methods supported by the server should be in $server_supports, a bit mask sent from the server during the session identification phase.

Can be called either as a non-exported function, i.e.



    my $i_support = Net::SSH::Perl::Auth::supported();



or as an object method of a Net::SSH::Perl::Auth object, or an object of a subclass (in which case the first argument should be $server_supports, not the $auth_id):



    if ($auth->supported($server_supports)) {
        print "Server supports auth method $auth";
    }



id( [ CW$auth_name ] )

Translates an auth method name into an ID (suitable for sending to the sshd server, for example).

If given $auth_name translates that name into the corresponding ID. If called as an object method, translates the object’s auth class name into the ID.

name( [ CW$auth_id ] )

Translates an auth method ID into a name.

If given $auth_id translates that ID into the corresponding name. If called as an object method, returns the (stripped) object’s auth class name; for example, if the object were of type Net::SSH::Perl::Auth::Rhosts, name would return Rhosts.

auth_order()

Returns a reference to an array containing auth method IDs. These IDs describe the order in which authentication should be tested against the server. So, for example, if the array listed (2, 4, 3), then the client should test: RSA, then Rhosts-RSA, then Password authentication.

AUTH USAGE

Net::SSH::Perl::Auth->new($auth_name, CW$ssh)

Instantiates a new auth object of the type $auth_name, and gives it the Net::SSH::Perl object $ssh, which should contain an open connection to an sshd server.

Returns the auth object, which will be blessed into the actual auth subclass.

CW$valid = CW$auth->authenticate()

Talks to the sshd server to authenticate the user; if valid, returns true, and if invalid, returns false.

AUTH DEVELOPMENT

Classes implementing an authentication method must implement the following two methods:
o $class->new($ssh)

Given a Net::SSH::Perl object $ssh, should construct a new auth object and bless it into $class, presumably.

o $class->authenticate()

Authenticate the current user with the remote daemon. This requires following the messaging protocol defined for your authentication method. All of the data you need—user name, password (if required), etc.--should be in the $ssh object.

Returns 1 if the authentication is successful, 0 otherwise.

AUTHOR & COPYRIGHTS

Please see the Net::SSH::Perl manpage for author, copyright, and license information.
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 NET::SSH::PERL::AUTH (3) 2015-09-12

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