Swarmauri AWS KMS Key Provider
Community plugin providing an AWS Key Management Service (KMS) backed KeyProvider for Swarmauri. It manages non-exportable customer managed keys (CMKs), exposes JWKS for downstream services, and handles key rotation workflows aligned with AWS best practices.
Features
- Create RSA, ECC, and AES-256 keys in AWS KMS with deterministic aliasing per
kidand version. - Rotate keys by minting new KMS key versions and updating aliases, while preserving previous versions for auditing or staged cutovers.
- Describe keys through
KeyRefobjects, including public PEM material when the key spec allows export, and RFC 7517-compliant JWKs viaget_public_jwk/jwks. - Generate cryptographically secure random bytes and perform HKDF expansion with SHA-256 to support envelope encryption and symmetric derivation flows.
- Destroy keys by scheduling deletion through the KMS API, maintaining Swarmauri tagging metadata for traceability.
Prerequisites
- Python 3.10 or newer.
boto3(installed automatically with this package) and network access to the target AWS region.- AWS credentials with permissions such as
kms:CreateKey,kms:CreateAlias,kms:UpdateAlias,kms:DescribeKey,kms:GetPublicKey,kms:ListAliases,kms:ListResourceTags, andkms:ScheduleKeyDeletion. - Optional: a custom key policy if you need to delegate key administration to non-root principals; pass it through the
key_policyconstructor argument.
Installation
# pip
pip install swarmauri_keyprovider_aws_kms
# poetry
poetry add swarmauri_keyprovider_aws_kms
# uv (pyproject-based projects)
uv add swarmauri_keyprovider_aws_kms
Quickstart: Create, Rotate, and Publish Keys
import asyncio
from swarmauri_keyprovider_aws_kms import AwsKmsKeyProvider
from swarmauri_core.key_providers.types import KeyAlg, KeyClass, KeySpec, ExportPolicy
async def main() -> None:
provider = AwsKmsKeyProvider(region="us-east-1", alias_prefix="swarmauri-demo")
rsa_spec = KeySpec(
klass=KeyClass.asymmetric,
alg=KeyAlg.RSA_PSS_SHA256,
size_bits=3072,
export_policy=ExportPolicy.never_export_secret,
label="api-signing",
)
# Create the initial version (aliases: alias/swarmauri-demo/<kid> and .../v1)
key_ref = await provider.create_key(rsa_spec)
print("KID", key_ref.kid, "version", key_ref.version)
# Surface the public JWK for JWT signing or JWKS endpoints
jwk = await provider.get_public_jwk(key_ref.kid)
print("Public JWK", jwk)
# Rotate the key – new CMK in KMS, version alias bump, old alias retained
rotated = await provider.rotate_key(key_ref.kid)
print("Rotated to version", rotated.version)
# Publish the aggregate JWKS (includes the latest version per kid)
jwks_payload = await provider.jwks()
print("JWKS keys", [k["kid"] for k in jwks_payload["keys"]])
if __name__ == "__main__":
asyncio.run(main())
Symmetric Utilities: Random Bytes and HKDF
import asyncio
from swarmauri_keyprovider_aws_kms import AwsKmsKeyProvider
async def derive_data_key() -> bytes:
provider = AwsKmsKeyProvider(region="us-east-1")
master_salt = await provider.random_bytes(32)
info = b"swarmauri/example"
pseudo_random_key = await provider.random_bytes(32)
derived = await provider.hkdf(
pseudo_random_key,
salt=master_salt,
info=info,
length=32,
)
return derived
# asyncio.run(derive_data_key())
Operational Tips
list_versions(kid)inspects versioned aliases (alias/<prefix>/<kid>/vN); use it before destructive actions to ensure you capture all active CMKs.- Destroying a key schedules deletion for 7 days. Plan rotations ahead of time so dependent systems can migrate to the new version before you call
destroy_key. - Tag metadata persisted by the provider (
saur:kid,saur:version,saur:alg, optionalsaur:label) enables inventory checks—query them from the AWS console or CLI when auditing. - For high-throughput signing, ensure your IAM policies, KMS quotas, and region placement match latency expectations; consider caching public JWKs from
jwks()in your verifier services.
Metadata
Release files for swarmauri_keyprovider_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_keyprovider_aws_kms-0.3.3.tar.gz | 11.6 kB | Without provenance | Details for swarmauri_keyprovider_aws_kms-0.3.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| swarmauri_keyprovider_aws_kms-0.3.3-py3-none-any.whl | Python 3 | none | any | Details for swarmauri_keyprovider_aws_kms-0.3.3-py3-none-any.whl |
Total release size: 24.3 kB
Release files / swarmauri_keyprovider_aws_kms-0.3.3.tar.gz
| Download URL | swarmauri_keyprovider_aws_kms-0.3.3.tar.gz |
|---|---|
| Size | 11.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5518e289e34ff3a5e881cba65dd3c5964429e1ecc0a9945545bca2d82800d577
|
|
BLAKE2b-256 checksum How to use checksums |
3be4810c03d0230e63667c2fe5541ff9d790b1ab4d07840253f06ccab432412f
|
| 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_keyprovider_aws_kms-0.3.3-py3-none-any.whl
| Download URL | swarmauri_keyprovider_aws_kms-0.3.3-py3-none-any.whl |
|---|---|
| Size | 12.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d8194c07dd1d944144de3addf09beb77713482237eb311b3891a8a7c4ff50043
|
|
BLAKE2b-256 checksum How to use checksums |
289475534effe96ede18da5458533650ebc7eb553fb641adb38739ea920ce2fa
|
| 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_keyprovider_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.