# hmacauth HMAC authentication package for Go

[![Build Status](https://travis-ci.org/18F/hmacauth.svg?branch=master)](https://travis-ci.org/18F/hmacauth)

[![Coverage Status](https://coveralls.io/repos/18F/hmacauth/badge.svg?branch=master&service=github)](https://coveralls.io/github/18F/hmacauth?branch=master)

Signs and authenticates HTTP requests based on a shared-secret HMAC signature.

Developed in parallel with the following packages for other languages:
- Node.js: [hmac-authentication](https://www.npmjs.com/package/hmac-authentication)
- Ruby: [hmac_authentication](https://rubygems.org/gems/hmac_authentication)

## Installation

```go
import "github.com/18F/hmacauth"
```

## Validating incoming requests

Coming soon...

## Signing outgoing requests

Coming soon...

## Public domain

This project is in the worldwide [public domain](LICENSE.md). As stated in [CONTRIBUTING](CONTRIBUTING.md):

> This project is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through the [CC0 1.0 Universal public domain dedication](https://creativecommons.org/publicdomain/zero/1.0/).
>
> All contributions to this project will be released under the CC0
>dedication. By submitting a pull request, you are agreeing to comply
>with this waiver of copyright interest.
