Skip to main content

A python library to sign AWS requests using AWS Signature V4.

Project description


A python library to sign AWS requests using AWS Signature V4.

This small python library serves only purpose: Helping you sign HTTP requests for use with AWS (and compatible) services. The library is unopinionated and should work with just about anything that makes HTTP requests (requests, aiohttp).

It supports generating authorization headers for HTTP requests, pre-signing URLs so you can easily use them elsewhere and signing S3 POST policies for use in HTML forms.

This library has no requirements, but comes with an authentication helper for the requests package.


aws-request-signer is available from pypi:

pip install aws-request-signer

Usage example

Here's an example of how to use the library to sign a request to upload a file to a minio S3 bucket running on your local machine:

import hashlib

import requests
from aws_request_signer import AwsRequestSigner


URL = ""

# Demo content for our target file.
content = b"Hello, World!\n"
content_hash = hashlib.sha256(content).hexdigest()

# Create a request signer instance.
request_signer = AwsRequestSigner(

# The headers we'll provide and want to sign.
headers = {"Content-Type": "text/plain", "Content-Length": str(len(content))}

# Add the authentication headers.
    request_signer.sign_with_headers("PUT", URL, headers, content_hash)

# Make the request.
r = requests.put(URL, headers=headers, data=content)

For more examples and usage, please refer to

Development setup

For development purposes, you can clone the repository and use poetry to install and maintain the dependencies. There is no test suite. It comes with a set of pre-commit hooks that can format (isort, black) and check your code (mypy, flake8) automatically.

git clone
cd aws-request-signer
poetry install -E demo
poetry run pre-commit install

Note: At the time of writing, the typeshed library that mypy uses contains an incorrect signature for the requests.auth.AuthBase.__call__ method. The repository of aws-request-signer includes updated stubs for requests until the signature is fixed upstream.

Release History

  • 1.0.0
    • Initial Release.


Ingmar Steen – @iksteen

Distributed under the MIT license. See LICENSE for more information.


  1. Fork it (
  2. Create your feature branch (git checkout -b feature/fooBar)
  3. Commit your changes (git commit -am 'Add some fooBar')
  4. Push to the branch (git push origin feature/fooBar)
  5. Create a new Pull Request

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for aws-request-signer, version 1.0.0
Filename, size File type Python version Upload date Hashes
Filename, size aws_request_signer-1.0.0-py3-none-any.whl (17.3 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size aws-request-signer-1.0.0.tar.gz (6.7 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page