# AWS signature verification routines for Rust
## Crate: [aws_sig_verify](https://crates.io/crates/aws_sig_verify)

![GitHub Actions](https://github.com/dacut/rust-aws-sig/workflows/Rust/badge.svg)
[![Coverage Status](https://coveralls.io/repos/github/dacut/rust-aws-sig/badge.svg?branch=master)](https://coveralls.io/github/dacut/rust-aws-sig?branch=master)

The `aws_sig_verify` crate provides AWS SigV4 _verification_ routines.
This *is not* the library you want if you just want to call AWS services
or other services that use AWS SigV4 signatures.
[Rusoto](https://github.com/rusoto/rusoto) already has a library, 
[rusoto_signature](https://docs.rs/rusoto_signature/), that provides this
functionality.

If you are attempting to perform AWS SigV4 verification using AWS-vended
credentials, this library also ___will not work for you___. You need the
caller's secret key (or a derivative), and AWS does not allow this for
obvious reasons. Instead, you should be using [API Gateway with IAM
authentication](https://docs.aws.amazon.com/apigateway/latest/developerguide/permissions.html).

On the other hand, if you have your own ecosystem of AWS-like credentials
and are developing mock-AWS services or just really like AWS SigV4 but
can't run within AWS, this library _might_ be for you.

Documentation for this package is published automatically to [docs.rs](https://docs.rs/aws_sig_verify/).

## Version information

Version 0.5 supports [ring 0.14](https://github.com/briansmith/ring), needed
for [Gotham 0.4](https://gotham.rs).

Version 0.6 supports ring 0.16, needed for Gotham 0.5.