swarmauri_certservice_aws_kms
AWS KMS backed certificate service for Swarmauri.
This package provides an implementation of CertServiceBase that signs and verifies X.509 certificates using AWS Key Management Service.
Features
- Create CSRs from exportable key material.
- Issue certificates using AWS KMS
SignAPI. - Create self‑signed certificates.
- Verify and parse certificates with RFC 5280 compliance.
Prerequisites
- Python 3.10 or newer.
- AWS account with KMS keys that allow the
Signoperation (RSAorECC_NIST_P256). AWS_ACCESS_KEY_ID/AWS_SECRET_ACCESS_KEY(or an IAM role/instance profile) grantingkms:GetPublicKeyandkms:Signpermissions.boto3installed (automatically pulled in via this package) and network access to the target AWS region.- For certificate signing: an issuer subject template and optional CA certificate bytes to embed in verification metadata.
Extras
docs: documentation helpers.perf: benchmarking support.
Installation
# pip
pip install swarmauri_certservice_aws_kms
# poetry
poetry add swarmauri_certservice_aws_kms
# uv (pyproject-based projects)
uv add swarmauri_certservice_aws_kms
Testing
Run unit, functional and performance tests in isolation from the repository root:
uv run --package swarmauri_certservice_aws_kms --directory community/swarmauri_certservice_aws_kms pytest
Quickstart: Issue a Certificate with AWS KMS
The snippet below signs an incoming CSR using a customer-managed KMS key. Attach the key ARN to the KeyRef via kid or tags (aws_kms_key_id).
import asyncio
from datetime import datetime, timedelta, timezone
from pathlib import Path
from swarmauri_certservice_aws_kms import AwsKmsCertService
from swarmauri_core.crypto.types import KeyRef
async def main() -> None:
service = AwsKmsCertService(region_name="us-east-1")
csr_bytes = Path("tenant.csr").read_bytes()
ca_cert = Path("ca.pem").read_bytes()
kms_key = KeyRef(kid="arn:aws:kms:us-east-1:123456789012:key/abcd-1234")
certificate_pem = await service.sign_cert(
csr=csr_bytes,
ca_key=kms_key,
issuer={"CN": "Example KMS Issuing CA", "O": "Example Corp"},
ca_cert=ca_cert,
not_after=int((datetime.now(timezone.utc) + timedelta(days=365)).timestamp()),
)
Path("tenant.pem").write_bytes(certificate_pem)
print("Issued certificate saved to tenant.pem")
if __name__ == "__main__":
asyncio.run(main())
Generating CSRs and Self-Signed Roots
AwsKmsCertService can build CSRs from exportable key material and mint a self-signed certificate using the same KMS key.
import asyncio
from datetime import datetime, timedelta, timezone
from pathlib import Path
from swarmauri_certservice_aws_kms import AwsKmsCertService
from swarmauri_core.crypto.types import KeyRef
async def bootstrap_ca() -> None:
service = AwsKmsCertService(region_name="us-east-1")
# Generate CSR from a local private key
key_ref = KeyRef(material=Path("intermediate-key.pem").read_bytes())
csr_pem = await service.create_csr(
key=key_ref,
subject={"CN": "Example Intermediate CA", "O": "Example Corp"},
san={"dns": ["intermediate.example.com"]},
)
Path("intermediate.csr").write_bytes(csr_pem)
# Issue a self-signed root using a KMS key
kms_key = KeyRef(kid="arn:aws:kms:us-east-1:123456789012:key/root-ca-key")
root_pem = await service.create_self_signed(
key=kms_key,
subject={"CN": "Example Root CA", "O": "Example Corp"},
not_after=int((datetime.now(timezone.utc) + timedelta(days=3650)).timestamp()),
)
Path("root-ca.pem").write_bytes(root_pem)
if __name__ == "__main__":
asyncio.run(bootstrap_ca())
Best Practices
- Grant the KMS key limited permissions:
kms:GetPublicKey,kms:DescribeKey,kms:Sign. Avoid broad grants (e.g., wildcard actions). - Store KMS key ARNs in
KeyRef.tags["aws_kms_key_id"]orKeyRef.kidfor clarity and to avoid hard-coding ARNs throughout application logic. - Coordinate certificate validity with KMS key rotation—renew certificates before rotating customer-managed keys.
- Cache returned certificates and metadata to minimize repeated calls to KMS and reduce signing latency.
Metadata
Release files for swarmauri_certservice_aws_kms 0.3.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| swarmauri_certservice_aws_kms-0.3.3.tar.gz | 14.9 kB | Without provenance | Details for swarmauri_certservice_aws_kms-0.3.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| swarmauri_certservice_aws_kms-0.3.3-py3-none-any.whl | Python 3 | none | any | Details for swarmauri_certservice_aws_kms-0.3.3-py3-none-any.whl |
Total release size: 29.2 kB
Release files / swarmauri_certservice_aws_kms-0.3.3.tar.gz
| Download URL | swarmauri_certservice_aws_kms-0.3.3.tar.gz |
|---|---|
| Size | 14.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1258c57537b8e51913868f229ca0c27d6811be76ba35067f05e662d4f5dc3391
|
|
BLAKE2b-256 checksum How to use checksums |
61b3c32cd83dc7ef0c61e4b13cd3d399fea6ae408097fe4ccba6ab26d2780d53
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.0 {"installer":{"name":"uv","version":"0.11.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / swarmauri_certservice_aws_kms-0.3.3-py3-none-any.whl
| Download URL | swarmauri_certservice_aws_kms-0.3.3-py3-none-any.whl |
|---|---|
| Size | 14.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ef2c40101efb65b5c9b5aeedb3ffaebfb75d258b604433dfc197a299ee799618
|
|
BLAKE2b-256 checksum How to use checksums |
31f4d63caf687cf63e87730755e0bb13c4e8700b8879da4ed0988145542d3eb6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.0 {"installer":{"name":"uv","version":"0.11.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for swarmauri_certservice_aws_kms 0.3.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.