swarmauri_certservice_gcpkms
Google Cloud KMS backed certificate service for Swarmauri.
This package exposes a GcpKmsCertService component implementing
CertServiceBase. It can create CSRs, generate self-signed certificates,
issue certificates from CSRs, verify certificates and parse their
metadata while using keys stored in Google Cloud KMS.
Features
- Create certificate signing requests using keys stored in KMS
- Issue self-signed or CA-signed certificates
- Verify signatures and validity windows
- Parse certificate metadata including extensions
Prerequisites
- A Google Cloud project with the Cloud KMS API enabled
- Credentials available to the application (for example via the
GOOGLE_APPLICATION_CREDENTIALSenvironment variable) - Keys provisioned in Cloud KMS with the
AsymmetricSigncapability (RSA 2048, EC P-256, or Ed25519). - Python 3.10 or newer and the
google-cloud-kmsdependency (installed via the extras shown below). - Network access to the Google Cloud KMS endpoint for the target location.
Installation
# pip
pip install swarmauri_certservice_gcpkms[gcp]
# poetry
poetry add swarmauri_certservice_gcpkms -E gcp
# uv (pyproject-based projects)
uv add "swarmauri_certservice_gcpkms[gcp]"
The optional gcp extra installs the google-cloud-kms dependency.
Usage
Issue a Certificate from a CSR
import asyncio
from datetime import datetime, timedelta, timezone
from pathlib import Path
from swarmauri_certservice_gcpkms import GcpKmsCertService
from swarmauri_core.crypto.types import KeyRef
async def issue_certificate() -> None:
service = GcpKmsCertService()
csr_bytes = Path("leaf.csr").read_bytes()
kms_ca_key = KeyRef(
kid="projects/my-project/locations/us-central1/keyRings/pki/cryptoKeys/issuing-ca/cryptoKeyVersions/1"
)
certificate_pem = await service.sign_cert(
csr=csr_bytes,
ca_key=kms_ca_key,
issuer={"CN": "Example GCP Issuing CA", "O": "Example Corp"},
not_after=int((datetime.now(timezone.utc) + timedelta(days=365)).timestamp()),
)
Path("leaf.pem").write_bytes(certificate_pem)
print("Issued certificate saved to leaf.pem")
if __name__ == "__main__":
asyncio.run(issue_certificate())
Create CSRs and Self-Signed Roots
import asyncio
from datetime import datetime, timedelta, timezone
from pathlib import Path
from swarmauri_certservice_gcpkms import GcpKmsCertService
from swarmauri_core.crypto.types import KeyRef
async def bootstrap_pki() -> None:
service = GcpKmsCertService()
# Generate a CSR using an exportable private key
local_key = KeyRef(material=Path("intermediate-key.pem").read_bytes())
csr_pem = await service.create_csr(
key=local_key,
subject={"CN": "Intermediate CA", "O": "Example Corp"},
san={"dns": ["intermediate.example.com"]},
)
Path("intermediate.csr").write_bytes(csr_pem)
# Create a self-signed root using Cloud KMS
root_key = KeyRef(
kid="projects/my-project/locations/us-central1/keyRings/pki/cryptoKeys/root-ca/cryptoKeyVersions/1"
)
root_pem = await service.create_self_signed(
key=root_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_pki())
Verification and Parsing
import asyncio
from pathlib import Path
from swarmauri_certservice_gcpkms import GcpKmsCertService
async def inspect() -> None:
service = GcpKmsCertService()
cert_bytes = Path("leaf.pem").read_bytes()
root_bytes = Path("root-ca.pem").read_bytes()
verification = await service.verify_cert(
cert=cert_bytes,
trust_roots=[root_bytes],
)
print("Valid:", verification["valid"], "Issuer:", verification.get("issuer"))
metadata = await service.parse_cert(cert_bytes)
print("Subject:", metadata["subject"])
print("Not after:", metadata["not_after"])
if __name__ == "__main__":
asyncio.run(inspect())
License
Apache-2.0
Metadata
Release files for swarmauri_certservice_gcpkms 0.2.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_gcpkms-0.2.3.tar.gz | 11.2 kB | Without provenance | Details for swarmauri_certservice_gcpkms-0.2.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| swarmauri_certservice_gcpkms-0.2.3-py3-none-any.whl | Python 3 | none | any | Details for swarmauri_certservice_gcpkms-0.2.3-py3-none-any.whl |
Total release size: 23.6 kB
Release files / swarmauri_certservice_gcpkms-0.2.3.tar.gz
| Download URL | swarmauri_certservice_gcpkms-0.2.3.tar.gz |
|---|---|
| Size | 11.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
65eefad87499ede3f6acf6fcafdcaa9e534318e93806282b196df8fe8af836ea
|
|
BLAKE2b-256 checksum How to use checksums |
42da32934fcdc68d5cf633a790bc936c5495b3a12c5dd86634884bba0dbf7037
|
| 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_gcpkms-0.2.3-py3-none-any.whl
| Download URL | swarmauri_certservice_gcpkms-0.2.3-py3-none-any.whl |
|---|---|
| Size | 12.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ce462ced5a8f4cbf99a495173f40601688c37c78e7b14e6e25779345025ea2fc
|
|
BLAKE2b-256 checksum How to use checksums |
3ce8a1ae309ab8aa1e41c7dd12fc4712c36a240f296db1cae9cae551a5d192e4
|
| 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_gcpkms 0.2.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.