Scala library to sign HTTP requests to AWS services.
Scala
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

README.md

AWS Request Signer

NOTE: a broader library for this and other AWS features is available here: https://github.com/aws4s/aws4s

Helper to evaluate the signing headers for HTTP requests to Amazon Web Services. This is a Scala port of (part of) the Java aws-signing-request-interceptor.

I originally needed this library to support AWS' Elasticsearch Service, but this library is 'AWS service agnostic'.

Import via SBT

Currently available for scala 2.10, 2.11 and 2.12. In your build.sbt file,

resolvers += Resolver.jcenterRepo

libraryDependencies += "io.ticofab" %% "aws-request-signer" % "0.5.2"

Usage

The procedure to sign AWS Api requests is described on the official documentation. The idea is that each request must be signed through the evaluation of a hash which depends on the very request itself. The resulting string can then be added to the request either as a header or as a query param. This library focuses on the header way.

You first need to instantiate the signer, for example:

val awsCredentialProvider = new StaticCredentialsProvider(new BasicAWSCredentials("YOUR-ID", "YOUR-SECRET"))
val service = "es"
val region = "eu-central-1"
def clock(): LocalDateTime = LocalDateTime.now(ZoneId.of("UTC"))
val signer = io.ticofab.AwsSigner(awsCredentialProvider, region, service, clock)

Then use it for each request, via

def getSignedHeaders(uri: String,
                     method: String,
                     queryParams: Map[String, String],
                     headers: Map[String, String],
                     payload: Option[Array[Byte]]): Map[String, String]

Check the examples in the test folder of this project. Once you have the headers, add them to your HTTP request and fire it.

Implementations

aws-request-signer-proxy implements this package as a Dockerized proxy application, and provides an example integration with the Play framework.

Dependencies

License

Copyright 2016, 2017 Fabio Tiriticco - Fabway

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.