NAME

Net::SSH::Perl::Key::DSA - DSA key object

SYNOPSIS

    use Net::SSH::Perl::Key;
    my $key = Net::SSH::Perl::Key->new('DSA');

DESCRIPTION

Net::SSH::Perl::Key::DSA subclasses Net::SSH::Perl::Key to implement a key object, SSH style. This object provides all of the methods needed for a DSA key object; the underlying implementation is provided by Crypt::PK::DSA, and this class wraps around that module to provide SSH-specific functionality (eg. taking in a Net::SSH::Perl::Buffer blob and transforming it into a key object).

USAGE

Net::SSH::Perl::Key::DSA implements the interface described in the documentation for Net::SSH::Perl::Key. Any differences or additions are described here.

$key->sign($data)

Wraps around Crypt::PK::DSA::sign_message to sign $data using the key $key, then encodes that signature into an SSH-compatible signature blob. The output of Crypt::PK::DSA::sign_message is a DER ASN.1 binary structure, so that must be decoded to extract the components of the signature.

Returns the signature blob.

$key->verify($signature, $data)

Given a signature blob $signature and the original signed data $data, attempts to verify the signature using the key $key. This wraps around Crypt::PK::DSA::verify_message to perform the core verification. Since Crypt::PK::DSA::verify_message requires a signature in DER ASN.1 format, the signature is reconfigured to that before being passed.

$signature should be an SSH-compatible signature blob, as returned from sign; $data should be a string of data, as passed to sign.

Returns true if the verification succeeds, false otherwise.

AUTHOR & COPYRIGHTS

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