branislav-zahradnik-gdc / net-amazon-signature-v4 Goto Github PK

NAME
    Net::Amazon::Signature::V4 - Implements the Amazon Web Services
    signature version 4, AWS4-HMAC-SHA256

VERSION
    Version 0.18

SYNOPSIS
    This module signs an HTTP::Request to Amazon Web Services by appending
    an Authorization header. Amazon Web Services signature version 4,
    AWS4-HMAC-SHA256, is used.

        use Net::Amazon::Signature::V4;

        my $sig = Net::Amazon::Signature::V4->new( $access_key_id, $secret, $endpoint, $service );
        my $req = HTTP::Request->parse( $request_string );
        my $signed_req = $sig->sign( $req );
        ...

    The primary purpose of this module is to be used by
    Net::Amazon::Glacier.

METHODS
  new( $access_key_id, $secret, $endpoint, $service )
    Constructs the signature object, which is used to sign requests.

    Note that the access key ID is an alphanumeric string, not your account
    ID. The endpoint could be "eu-west-1", and the service could be
    "glacier".

  sign( $request )
    Signs a request with your credentials by appending the Authorization
    header. $request should be an HTTP::Request. The signed request is
    returned.

AUTHOR
    Tim Nordenfur, "<tim at gurka.se>"

    Maintained by Dan Book, "<dbook at cpan.org>"

BUGS
    Please report any bugs or feature requests to
    "bug-net-amazon-signature-v4 at rt.cpan.org", or through the web
    interface at
    <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Net-Amazon-Signature-V4>
    . I will be notified, and then you'll automatically be notified of
    progress on your bug as I make changes.

SUPPORT
    You can find documentation for this module with the perldoc command.

        perldoc Net::Amazon::Signature::V4

    You can also look for information at:

    *   RT: CPAN's request tracker (report bugs here)

        <http://rt.cpan.org/NoAuth/Bugs.html?Dist=Net-Amazon-Signature-V4>

    *   AnnoCPAN: Annotated CPAN documentation

        <http://annocpan.org/dist/Net-Amazon-Signature-V4>

    *   CPAN Ratings

        <http://cpanratings.perl.org/d/Net-Amazon-Signature-V4>

    *   Search CPAN

        <http://search.cpan.org/dist/Net-Amazon-Signature-V4/>

LICENSE AND COPYRIGHT
    Copyright 2012 Tim Nordenfur.

    This program is free software; you can redistribute it and/or modify it
    under the terms of either: the GNU General Public License as published
    by the Free Software Foundation; or the Artistic License.

    See http://dev.perl.org/licenses/ for more information.