swarmauri_pop_dpop 0.11.0.dev1

DPoP proof-of-possession tooling for Swarmauri services

Swarmauri PoP DPoP

swarmauri_pop_dpop enables RFC 9449 Demonstrating Proof-of-Possession flows for Swarmauri services. The signer and verifier reuse the shared Swarmauri PoP contract so applications can mix DPoP, CWT, and X.509 strategies interchangeably.

Features

• Implements DPoPSigner and DPoPVerifier with consistent Swarmauri PoP semantics, including cnf generation and verification hooks
• Normalises HTTP method and URI handling to align with the DPoP specification, including support for query strings and ports
• Provides nonce and replay integration points so you can plug in application-specific storage to enforce single-use proofs
• Validates ath hashes for OAuth access tokens to ensure request binding when PoP is layered on bearer credentials

Installation

pip install swarmauri_pop_dpop

uv add swarmauri_pop_dpop

Usage

Signing an outgoing HTTP request

from cryptography.hazmat.primitives import serialization
from cryptography.hazmat.primitives.asymmetric import ed25519
import base64

from swarmauri_pop_dpop import DPoPSigner

private_key = ed25519.Ed25519PrivateKey.generate()
public_key = private_key.public_key()

public_jwk = {
    "kty": "OKP",
    "crv": "Ed25519",
    "x": base64.urlsafe_b64encode(
        public_key.public_bytes(
            encoding=serialization.Encoding.Raw,
            format=serialization.PublicFormat.Raw,
        )
    ).rstrip(b"=").decode("ascii"),
}

signer = DPoPSigner(
    private_key=private_key,
    public_jwk=public_jwk,
    algorithm="EdDSA",
)

dpop_header = signer.sign_request("GET", "https://api.example.com/resource")
print("DPoP header:", dpop_header)
print("cnf:", signer.cnf_binding())

Verifying an incoming HTTP request

import asyncio
from typing import Mapping

from swarmauri_core.pop import CnfBinding, HttpParts, VerifyPolicy
from swarmauri_pop_dpop import DPoPVerifier


class MemoryReplay:
    def __init__(self) -> None:
        self._seen: set[str] = set()

    def seen(self, scope: str, key: str) -> bool:
        return f"{scope}:{key}" in self._seen

    def mark(self, scope: str, key: str, ttl_s: int) -> None:
        self._seen.add(f"{scope}:{key}")


async def verify_request(headers: Mapping[str, str], cnf: CnfBinding, access_token: str) -> None:
    verifier = DPoPVerifier()
    req = HttpParts(method="GET", url="https://api.example.com/resource", headers=headers)
    await verifier.verify_http(
        req,
        cnf,
        policy=VerifyPolicy(require_ath=True),
        replay=MemoryReplay(),
        extras={"access_token": access_token},
    )


asyncio.run(verify_request({"DPoP": dpop_header}, signer.cnf_binding(), "opaque-access-token"))

The verifier enforces thumbprints for the provided JWK, checks nonce and replay constraints, and validates ath hashes when bearer tokens are provided.

Compatibility

• Python 3.10, 3.11, and 3.12
• Asynchronous contexts that can dispatch HttpParts instances from swarmauri_core
• Intended for OAuth 2.0 servers, API gateways, and microservices that need to accept Demonstration of Proof-of-Possession headers

Related Packages

• swarmauri_pop_cwt for COSE-based confirmation
• swarmauri_pop_x509 to validate mutual TLS thumbprints using the same cnf contract
• swarmauri_core which defines the PoP primitives consumed by all Swarmauri proof strategies

Contributing

Please contribute improvements through the Swarmauri SDK repository. Ensure tests, formatting, and linting match the root instructions and describe your changes clearly in pull requests so reviewers understand the intended impact.

Support

Need help integrating DPoP in Swarmauri? File an issue on GitHub with implementation details and reproduction steps. For security disclosures, use the contact information listed in the repository security policy.

License

Apache License 2.0. See the LICENSE file for details.