http-message-signatures

http-message-signatures is an implementation of the IETF HTTP Message Signatures draft standard in Python.

Installation

pip3 install http-message-signatures

Synopsis

from http_message_signatures import HTTPMessageSigner, HTTPMessageVerifier, HTTPSignatureKeyResolver, algorithms
import requests, base64, hashlib, http_sfv

class MyHTTPSignatureKeyResolver(HTTPSignatureKeyResolver):
    keys = {"my-key": b"top-secret-key"}

    def resolve_public_key(self, key_id: str):
        return self.keys[key_id]

    def resolve_private_key(self, key_id: str):
        return self.keys[key_id]

request = requests.Request('POST', 'https://example.com/foo?param=Value&Pet=dog', json={"hello": "world"})
request = request.prepare()
request.headers["Content-Digest"] = str(http_sfv.Dictionary({"sha-256": hashlib.sha256(request.body).digest()}))

signer = HTTPMessageSigner(signature_algorithm=algorithms.HMAC_SHA256, key_resolver=MyHTTPSignatureKeyResolver())
signer.sign(request, key_id="my-key", covered_component_ids=("@method", "@authority", "@target-uri", "content-digest"))

verifier = HTTPMessageVerifier(signature_algorithm=algorithms.HMAC_SHA256, key_resolver=MyHTTPSignatureKeyResolver())
verifier.verify(request)

Note that verifying the body content-digest is outside the scope of this package’s functionality, so it remains the caller’s responsibility. The requests-http-signature library builds upon this package to provide integrated signing and validation of the request body.

See what is signed

It is important to understand and follow the best practice rule of “See what is signed” when verifying HTTP message signatures. The gist of this rule is: if your application neglects to verify that the information it trusts is what was actually signed, the attacker can supply a valid signature but point you to malicious data that wasn’t signed by that signature. Failure to follow this rule can lead to vulnerability against signature wrapping and substitution attacks.

In http-message-signatures, you can ensure that the information signed is what you expect to be signed by only trusting the data returned by the verify() method:

FIXME: example

Authors

Andrey Kislyuk

License

Licensed under the terms of the Apache License, Version 2.0.

Metadata

Release files for http-message-signatures 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for http-message-signatures 0.2.0
File	Size	Uploaded
http-message-signatures-0.2.0.tar.gz	22.1 kB	Apr 10, 2022	Details

Built distribution (wheel)

Table of built distributions (wheels) for http-message-signatures 0.2.0
File	Interpreter	ABI	Platform	Reset
http_message_signatures-0.2.0-py3-none-any.whl 13.1 kB Apr 10, 2022	Python 3	none	any	Details

Total release size: 35.2 kB

Release files / http-message-signatures-0.2.0.tar.gz

Download URL	http-message-signatures-0.2.0.tar.gz
Size	22.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`520376f01269ea373f55efc928f71a59d1b4c423af077fad5bab9faff3ef0887`
BLAKE2b-256 checksum How to use checksums	`7aba0378da8e3e8b4f8e08f3877b6d3722fd00a1d81dba38886695dbd0617d53`
Upload date	Apr 10, 2022
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.4.1 importlib_metadata/4.6.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.1 CPython/3.9.10`

Release files / http_message_signatures-0.2.0-py3-none-any.whl

Download URL	http_message_signatures-0.2.0-py3-none-any.whl
Size	13.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`0796833794bac5ad15eb1750a6cdf3a7ec59eda2dcdd03c8d441e1e8b0999442`
BLAKE2b-256 checksum How to use checksums	`aba815800456bc71d84ec109bbadbedad583733badfcc119900713cb76fa0070`
Upload date	Apr 10, 2022
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.4.1 importlib_metadata/4.6.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.1 CPython/3.9.10`