requests-http-signature 0.7.1

验证响应

可以使用类方法HTTPSignatureAuth.verify()来验证从服务器接收到的响应

class MyKeyResolver:
    def resolve_public_key(self, key_id):
        assert key_id == 'squirrel'
        return 'monorail_cat'

response = requests.get(url, auth=auth)
verify_result = HTTPSignatureAuth.verify(response,
                                         signature_algorithm=algorithms.HMAC_SHA256,
                                         key_resolver=MyKeyResolver())

更一般地，您可以使用Requests API重建任意请求，并将其传递给verify()

request = requests.Request(...)  # Reconstruct the incoming request using the Requests API
prepared_request = request.prepare()  # Generate a PreparedRequest
HTTPSignatureAuth.verify(prepared_request, ...)

要在HTTP服务器环境中验证传入请求并签名响应，请参阅flask-http-signature和http-message-signatures包。

请参阅API文档以获取详细信息。

非对称密钥算法

要使用非对称密钥算法签名或验证消息，请将signature_algorithm关键字参数设置为algorithms.ED25519、algorithms.ECDSA_P256_SHA256、algorithms.RSA_V1_5_SHA256或algorithms.RSA_PSS_SHA512。请注意，由于cryptography库的限制，目前不支持使用rsa-pss-sha512进行签名。

对于非对称密钥算法，您可以将私钥作为PEM格式的字节数据作为key参数传递给HTTPSignatureAuth()构造函数，或如下配置密钥解析器

with open('key.pem', 'rb') as fh:
    auth = HTTPSignatureAuth(algorithm=algorithms.RSA_V1_5_SHA256,
                             key=fh.read(),
                             key_id=preshared_key_id)
requests.get(url, auth=auth)

class MyKeyResolver:
    def resolve_public_key(self, key_id: str):
        return public_key_pem_bytes[key_id]

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

auth = HTTPSignatureAuth(algorithm=algorithms.RSA_V1_5_SHA256,
                         key=fh.read(),
                         key_resolver=MyKeyResolver())
requests.get(url, auth=auth)

摘要算法

要使用SHA-512代替默认的SHA-256生成内容摘要（Content-Digest）头，如下子类化HTTPSignatureAuth

class MySigner(HTTPSignatureAuth):
    signing_content_digest_algorithm = "sha-512"

错误

请在GitHub上报告错误、问题、功能请求等。