Expand description
Agent protocol for Sentinel proxy
This module defines the protocol for communication between the proxy dataplane and external processing agents (WAF, auth, rate limiting, custom logic).
The protocol is inspired by SPOE (Stream Processing Offload Engine) and Envoy’s ext_proc, designed for bounded, predictable behavior with strong failure isolation.
Structs§
- Agent
Client - Agent client for communicating with external agents
- Agent
Request - Agent request message
- Agent
Response - Agent response message
- Agent
Server - Agent server for testing and reference implementations
- Audit
Metadata - Audit metadata from agent
- Denylist
Agent - Reference implementation: Denylist agent
- Echo
Agent - Reference implementation: Echo agent (for testing)
- Request
Body Chunk Event - Request body chunk event
- Request
Complete Event - Request complete event (for logging/audit)
- Request
Headers Event - Request headers event
- Request
Metadata - Request metadata sent to agents
- Response
Body Chunk Event - Response body chunk event
- Response
Headers Event - Response headers event
Enums§
- Agent
Protocol Error - Agent protocol errors
- Decision
- Agent decision
- Event
Type - Agent event type
- Header
Op - Header modification operation
Constants§
- MAX_
MESSAGE_ SIZE - Maximum message size (10MB)
- PROTOCOL_
VERSION - Agent protocol version
Traits§
- Agent
Handler - Trait for implementing agent logic