agent-ca 0.2.1

A Zero Trust Cryptographic Certificate Authority SDK for Autonomous AI Agents.

Agent-CA 🛡️

Zero Trust Hardware Cryptography for Autonomous AI Agents.

In an era of AI-to-API communication, hardcoded API keys are a catastrophic vulnerability. agent-ca allows autonomous AI agents (LangChain, CrewAI, AutoGen) to securely authenticate with internal enterprise APIs using mathematically unforgeable, short-lived X.509 passports backed by a cloud Hardware Security Module (HSM).

---

🏗️ Architecture

sequenceDiagram
    participant Agent as AI Agent (Python SDK)
    participant CA as Agent-CA (Azure Container)
    participant HSM as Azure Key Vault (Hardware)
    participant API as Internal Bouncer API

    Agent->>CA: 1. Request Passport (Budget: $500)
    CA->>HSM: 2. Validate Identity & Sign (ECDSA)
    HSM-->>CA: 3. Return Hardware Signature
    CA-->>Agent: 4. Issue X.509 Passport (60m expiry)
    Agent->>API: 5. Execute Task (Injects Passport in Headers)
    API-->>Agent: 6. Verify Signature & Allow Access

🚀 Quickstart
1. Get your API key
Register your agent in the Agent-CA Command Center. (Note: Link will update post-beta).
https://agent-ca-saas.vercel.app/

2. Install the SDK
```python
pip install agent-ca

3. Initialize your secure session agent-ca acts as a drop-in secure replacement for requests.Session. It handles ephemeral key generation, CA negotiation, payload signing, and automatic background rotation.

from agent_ca import SecureAgentSession

# 1. Initialize the Zero-Trust session
#Get the API key: https://agent-ca-saas.vercel.app/
session = SecureAgentSession(
    agent_name="Finance-LangGraph-Bot", 
    api_key="sk_live_your_key_here"
)

# 2. Execute requests. The SDK automatically signs the payload 
# and injects the X.509 passport into the headers.
response = session.post(
    "[https://api.your-company.com/v1/execute](https://api.your-company.com/v1/execute)",
    json={"action": "transfer_funds", "amount": 500}
)

print(response.json())

⚙️ Core Security Guarantees Ephemeral Identity: Certificates mathematically expire in 15 minutes.

Auto-Rotation: The SDK runs a background heartbeat thread, automatically provisioning a fresh passport before the old one expires.

Zero-Trust Memory: Keys are held in volatile RAM, never written to disk.

Least Privilege: Developers can revoke an agent's passport instantly from the dashboard.

Built for the next generation of Autonomous DevSecOps.

🔒 Why Agent-CA? No Hardcoded Secrets: Agents generate ephemeral private keys in memory. If an LLM gets prompt-injected, the attacker gets nothing but useless math.

Hardware Anchored: Every certificate is signed by a physical FIPS 140-2 Level 2 Hardware Security Module hosted in the Microsoft Azure cloud.

Instant Revocation: Global Certificate Revocation Lists (CRL) give you a terrifyingly fast kill-switch for rogue AI agents.

Privacy by Design: Built-in telemetry sanitization ensures your proprietary LLM prompts and vector data never leave your infrastructure.

📄 License This SDK is released under the MIT License. See LICENSE for more information.

Note: The Agent-CA core routing engine and cryptographic HSM backend are proprietary SaaS infrastructure.