swarmauri_certservice_ms_adcs
Community plugin providing a certificate service client for Microsoft Active Directory Certificate Services (AD CS).
Features
- Generate RFC 2986-compliant PKCS#10 CSRs with rich subject, subject alternative name, and extension options.
- Parse and validate X.509 certificates per RFC 5280, including issuer matching and signature verification.
- Ready-to-use authentication helpers for NTLM, Kerberos, and HTTP basic auth while preserving TLS configuration.
- Typed
supports()metadata describing templates, key algorithms, and capabilities advertised to Swarmauri agents.
Prerequisites
- Python 3.10 or newer.
- Network access to an AD CS Web Enrollment endpoint (typically
https://<ca>/certsrv). - A private key for each CSR you plan to submit; software keys can be read from PEM while HSM-backed keys can be referenced via
KeyRefmetadata. - Optional authentication libraries: install
requests-ntlmfor NTLM flows andrequests-kerberosfor Kerberos/SPNEGO delegation.
Installation
Install the core package or include extras for the auth helpers your environment requires:
# pip
pip install "swarmauri_certservice_ms_adcs[ntlm,kerberos]"
# poetry
poetry add swarmauri_certservice_ms_adcs -E ntlm -E kerberos
# uv (pyproject-based projects)
uv add "swarmauri_certservice_ms_adcs[ntlm,kerberos]"
You can drop the extras if your AD CS deployment only needs anonymous access or HTTP basic authentication.
Quickstart: Build a CSR for AD CS
import asyncio
from pathlib import Path
from swarmauri_certservice_ms_adcs import MsAdcsCertService, _AuthCfg
from swarmauri_core.certs.ICertService import SubjectSpec
from swarmauri_core.crypto.types import ExportPolicy, KeyRef, KeyType, KeyUse
async def main() -> None:
service = MsAdcsCertService(
base_url="https://ca.example.com/certsrv",
default_template="WebServer",
auth=_AuthCfg(
mode="ntlm",
username="EXAMPLE\\svc-adcs",
password="s3cr3t!",
verify_tls=True,
),
)
key_bytes = Path("webserver.key.pem").read_bytes()
key_ref = KeyRef(
kid="webserver-key",
version=1,
type=KeyType.RSA,
uses=(KeyUse.SIGN,),
export_policy=ExportPolicy.PUBLIC_ONLY,
material=key_bytes,
)
subject: SubjectSpec = {
"C": "US",
"ST": "Texas",
"L": "Austin",
"O": "Example Corp",
"CN": "app.example.com",
}
csr_pem = await service.create_csr(
key=key_ref,
subject=subject,
san={"dns": ["app.example.com", "www.example.com"]},
)
Path("app.csr").write_bytes(csr_pem)
print("CSR saved to app.csr")
if __name__ == "__main__":
asyncio.run(main())
Submit app.csr through your AD CS Web Enrollment UI, automation, or a downstream Swarmauri agent responsible for certificate issuance.
Validate Issued Certificates
After AD CS returns a certificate, use the same service instance to confirm the chain and inspect metadata:
import asyncio
from pathlib import Path
from swarmauri_certservice_ms_adcs import MsAdcsCertService, _AuthCfg
async def verify_certificate() -> None:
service = MsAdcsCertService(
base_url="https://ca.example.com/certsrv",
auth=_AuthCfg(mode="none"),
)
issued_cert = Path("app.pem").read_bytes()
issuing_ca = Path("issuing-ca.pem").read_bytes()
verification = await service.verify_cert(
cert=issued_cert,
trust_roots=[issuing_ca],
)
if verification["valid"]:
print("Certificate is valid until", verification["not_after"])
else:
print("Validation failed:", verification["reason"])
parsed = await service.parse_cert(issued_cert)
print("Subject:", parsed["subject"])
print("Subject Alternative Names:", parsed.get("san"))
if __name__ == "__main__":
asyncio.run(verify_certificate())
verify_cert performs structural checks and signature validation when an issuer certificate is supplied, while parse_cert surfaces extension data for auditing or observability pipelines.
Authentication Modes
- NTLM – enable by installing
requests-ntlmand providing domain credentials via_AuthCfg(mode="ntlm", username="DOMAIN\\user", password="..." ). - Kerberos/SPNEGO – install
requests-kerberosand set_AuthCfg(mode="kerberos", spnego_delegate=True)when delegation is required. - HTTP Basic – provide
_AuthCfg(mode="basic", username=..., password=...)for AD CS deployments fronted by basic auth proxies. - Anonymous – set
_AuthCfg(mode="none")for environments that rely on IP allow lists or mutual TLS.
Best Practices
- Store AD CS credentials in a secure secrets manager and inject them via environment variables rather than hard-coding passwords.
- Capture issued certificates, verification results, and parsed metadata in your logging system so you can trace enrollment activity.
- Rotate key pairs and certificates regularly; regenerate CSRs ahead of expiry to leave time for manual approvals.
- Combine this plugin with Swarmauri certificate verification agents (CRL/OCSP) to maintain revocation visibility across the lifecycle.
Metadata
Release files for swarmauri_certservice_ms_adcs 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_ms_adcs-0.2.3.tar.gz | 12.1 kB | Without provenance | Details for swarmauri_certservice_ms_adcs-0.2.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| swarmauri_certservice_ms_adcs-0.2.3-py3-none-any.whl | Python 3 | none | any | Details for swarmauri_certservice_ms_adcs-0.2.3-py3-none-any.whl |
Total release size: 25.4 kB
Release files / swarmauri_certservice_ms_adcs-0.2.3.tar.gz
| Download URL | swarmauri_certservice_ms_adcs-0.2.3.tar.gz |
|---|---|
| Size | 12.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0263efc02d020731f36c24ce08ad9df913bac70cce5a2a85606e6ad69de54cc9
|
|
BLAKE2b-256 checksum How to use checksums |
aef92fdcf0dc17a087045bc1ae31f4d67624f81cf48718a8e83a182820e20a69
|
| 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_ms_adcs-0.2.3-py3-none-any.whl
| Download URL | swarmauri_certservice_ms_adcs-0.2.3-py3-none-any.whl |
|---|---|
| Size | 13.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d2e09d8998164aa1afc777879bff7235b9f7a42259dbff5bc2c9b2850905221a
|
|
BLAKE2b-256 checksum How to use checksums |
1f97a1dd1d80e32ae886b77f2d4ddd82d2ebcb9cbf09deb3fc3bac674907d03e
|
| 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_ms_adcs 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.