103 lines
2.8 KiB
Python
103 lines
2.8 KiB
Python
#!/usr/bin/env python3
|
|
"""
|
|
Verify and build HTTP signatures
|
|
"""
|
|
import base64
|
|
|
|
from dataclasses import dataclass
|
|
from Crypto.Hash import SHA256
|
|
from Crypto.Signature import PKCS1_v1_5
|
|
from Crypto.PublicKey import RSA
|
|
from httpx import Headers
|
|
|
|
|
|
@dataclass
|
|
class SignedData:
|
|
method: str
|
|
path: str
|
|
signed_list: list
|
|
body_digest: str | None
|
|
headers: Headers
|
|
|
|
|
|
class HttpSignature:
|
|
"""
|
|
calculation and verification of HTTP signatures
|
|
"""
|
|
@classmethod
|
|
def calculation_digest(
|
|
cls,
|
|
body : bytes,
|
|
algorithm : str ="sha-256"
|
|
) -> str:
|
|
"""
|
|
Calculates the digest header value for a given HTTP body
|
|
"""
|
|
if "sha-256" == algorithm:
|
|
body_digest = SHA256.new()
|
|
body_digest.update(body)
|
|
return "SHA-256=" + \
|
|
base64.b64encode(body_digest.digest()
|
|
).decode("utf-8")
|
|
|
|
raise ValueError(f"No support algorithm {algorithm}")
|
|
|
|
@classmethod
|
|
def verify_signature(
|
|
cls,
|
|
signature_string : str,
|
|
signature : bytes,
|
|
pubkey,
|
|
) -> bool:
|
|
"""
|
|
Verify signatur that returns bool
|
|
"""
|
|
pubkey = RSA.importKey(pubkey)
|
|
signer = PKCS1_v1_5.new(pubkey)
|
|
digest = SHA256.new()
|
|
digest.update(signature_string.encode("utf-8"))
|
|
return signer.verify(digest, signature)
|
|
|
|
|
|
@classmethod
|
|
def parse_signature(
|
|
cls,
|
|
signature : str
|
|
) -> dict:
|
|
"""
|
|
Parse signature string in headers
|
|
"""
|
|
detail = {}
|
|
for item in signature.split(','):
|
|
name, value = item.split('=', 1)
|
|
value = value.strip('"')
|
|
detail[name.lower()] = value
|
|
signature_details = {
|
|
"headers": detail["headers"].split(),
|
|
"signature": base64.b64decode(detail["signature"]),
|
|
"algorithm": detail["algorithm"],
|
|
"keyid": detail["keyid"],
|
|
}
|
|
return signature_details
|
|
|
|
@classmethod
|
|
def build_signature_string(
|
|
cls,
|
|
signed_data: SignedData,
|
|
) -> str:
|
|
"""
|
|
Build signature string
|
|
"""
|
|
signed_string = []
|
|
for signed_str in signed_data.signed_list:
|
|
if signed_str == "(request-target)":
|
|
signed_string.append("(request-target): "
|
|
+ signed_data.method.lower() + ' ' + signed_data.path)
|
|
elif signed_str == "digest" and signed_data.body_digest:
|
|
signed_string.append("digest: " + signed_data.body_digest)
|
|
else:
|
|
signed_string.append(signed_str + ": "
|
|
+ signed_data.headers[signed_str])
|
|
|
|
return "\n".join(signed_string)
|
|
|