amazon-s3-url-signer

Module to sign urls to allow access to resources in the S3

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
amazon-s3-url-signer
7360.1.06 years ago10 years agoMinified + gzip package size for amazon-s3-url-signer in KB

Readme

Amazon S3 url signer

Module to sign urls to allow access to the private resources in the S3
NPM

To install

npm install amazon-s3-url-signer

Use example

var sig= require('amazon-s3-url-signer');

var bucket1 = sig.urlSigner('my key', 'my secret');
var bucket2 = sig.urlSigner('my key2', 'my secret2');

var url1 = bucket1.getUrl('GET', 'somefile.png', 'mybucket', 10); //url expires in 10 minutes
var url2 = bucket2.getUrl('PUT', '/somedir/somefile.png', 'mybucketonotheraccount', 100); //url expires in 100 minutes

Local test

If you want to test without an s3 acount you can use .
sudo apt-get install rubygems
sudo gem install fakes3  --no-rdoc --no-ri
mkdir s3_files
fakes3 -r s3_files -p 1234
Now a fakes3 server is started. Now we will generate an S3 URL, and push a file to it.
var s3 = require('./index');

var putUrl = s3.urlSigner(123, 'abc', {
  host: 'mymachine.me',
  port: 1234
}).getUrl('PUT', 'toto.json', 'my_bucket', 600);
console.log(putUrl);
The generated S3 url is:
http://mymachine.me:1234/my_bucket/toto.json?Expires=1352966881&AWSAccessKeyId=123&Signature=FDs%2Buf0hXskY1%2BUj4A7S4wHFx20%3D
Now you can use this URL with curl
curl --upload-file package.json "http://mymachine.me:1234/my_bucket/toto.json?Expires=1352966881&AWSAccessKeyId=123&Signature=FDs%2Buf0hXskY1%2BUj4A7S4wHFx20%3D"
Or with request
var fs = require('fs');
var request = require('request');
fs.createReadStream('file.json').pipe(request.put("http://mymachine.me:1234/my_bucket/toto.json?Expires=1352966881&AWSAccessKeyId=123&Signature=FDs%2Buf0hXskY1%2BUj4A7S4wHFx20%3D"))
Or with any http client you like :)
Thank to @Filirom1 for local server changes