Integration Guide
Oridio offers three primary integration patterns: the Drop-in Proxy, the Native SDKs, and the REST API. Choosing the right integration depends on your specific infrastructure and level of control required.
Drop-in Proxy (Recommended)
The proxy integration is the fastest way to secure an agent. By configuring HTTP_PROXY or changing the base URL of your LLM client, all traffic flows through Oridio. This requires zero code changes to your agent logic and guarantees comprehensive coverage of all outbound calls.
Native SDKs (Node.js & Python)
For fine-grained control, use the `@oridio/sdk`. The SDK allows you to programmatically wrap specific functions, tools, or graph nodes. You can dynamically attach context (like user IDs or tenant IDs) to requests, allowing Oridio to enforce tenant-specific budgets and RBAC policies.
Control Plane REST API
The REST API is used for programmatic management of the Oridio platform. You can automate the deployment of new Wasm policies, dynamically adjust budgets based on billing events, or integrate HITL (Human-in-the-Loop) approvals into your internal dashboards.
Installation & Setup
Oridio can be integrated either as a drop-in HTTP proxy without modifying your agent codebase, or via our official language bindings for programmatic telemetry and fine-grained Wasm triggers.
Route OpenAI/Anthropic SDK client requests through https://proxy.oridio.org/v1.
Supply your Oridio Master Key via header X-Oridio-Auth: ord_live_....
Architecture & Deep Dive
The Oridio security runtime operates as an out-of-band Layer 7 data plane. Rather than relying on non-deterministic LLM-as-a-judge prompts, security constraints are compiled into Ahead-Of-Time (AOT) WebAssembly binaries evaluated at bare-metal speeds.
P50 evaluation overhead per token packet.
Global Anycast edge proxy availability.
Distributed Redis mutex for swarms.
Sample Code & Implementation
from oridio import OridioClient
from langgraph.graph import StateGraph
# Initialize Oridio Edge Gateway client
client = OridioClient(api_key="ord_live_7x9k2m...")
# Wrap your state graph with zero-trust proxy
graph = StateGraph(AgentState)
secure_graph = client.wrap_graph(
graph,
budget_limit_usd=50.00,
pii_redaction=True,
anomaly_detection=True
)Interactive Runtime Playground
Frequently Asked Questions
Need help integrating?
Our runtime engineering team can help pair on your agent topology.