Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Amazon S3 signing and bucket interaction for Dispatch
Latest commit 5f45208 @n8han Merge pull request #3 from dwestheide/signed_uri_generation
Signed uri generation


Amazon S3 module

The aws-s3 module provides basic support for interacting with Amazon's S3 service by providing additional handlers which sign the HTTP request in accordance with the S3 authentication specifications. It's possible both to sign requests for Authorization Header Authentication and to generate signed request URIs that can be handed out to third parties for Query String Authentication. The module also provides a convenience class for interacting with S3 Buckets.


To use the aws-s3 module, you will need to first sign up for the S3 service. Afterwards, Amazon should provide you with an AWS Access Key and an AWS Secret Access Key. You will need both of these to be able to use the module.

Below is an example of retrieving a file from S3:

import dispatch._
import dispatch.s3._
import S3._

val access_key = Option(System.getenv("awsAccessKey")
val secret_key = Option(System.getenv("awsSecretAccessKey")
val x = h(Bucket("my-test-bucket") / "testing.txt" <@ (access_key.get, secret_key.get) as_str)

Using the aws-s3 module, you can create buckets, delete buckets, create files, delete files and retrieve files. Other S3 functionality is not provided.

To create a bucket, you can use the method create on a Bucket object to create the proper Request.

h(Bucket("my-test-bucket").create @(access_key.get, secret_key.get) >|)

The following snippet would delete a bucket:

h(Bucket("my-test-bucket").DELETE @(access_key.get, secret_key.get) >|)

To delete a file:

h(Bucket("my-test-bucket").DELETE / "testing.txt" <@(access_key.get, secret_key.get) >|)

Creating a file does require you to set the content type of the file upload:

val b = Bucket("my-test-bucket")
val testFile = new File("testing.txt")

h(b / "testing.txt" <<< (testFile, "plain/text") <@(access_key.get, secret_key.get) >|)

Generation of a signed URI for a GET request with query string authentication works as follows:

val expires = System.currentTimeMillis() / 1000 + 30 * 60
(Bucket("my-test-bucket") / "testing.txt").signed(access_key.get, secret_key.get, expires).to_uri


To test the module, you'll need to set two system properties:

  • awsAccessKey
  • awsSecretAccessKey

When using sbt 0.11, you can do the following:

eval System.setProperty("awsAccessKey", "XXXXXXXXX")
eval System.setProperty("awsSecretAccessKey", "XXXXXXXXX")

After that, you can just run test and all of the tests should pass.

Something went wrong with that request. Please try again.