Gateway vendors
Not in the preview yet. This feature is built in the repository but is off in the v2.2.6 preview (test mode). Do not treat this page as available on a preview core. See ../preview.md and the release notes.
Status: Live with mock upstreams.
A gateway plugin checks a Dynamo allowance credential on every request, in process, against pinned keys, with no network call in the request path. Metering happens afterwards. An absent, unverifiable, exhausted or revoked credential is refused with a 402.
One vector set for every gateway
Every gateway passes the identical shared vector set: the denial classes, their order and the 402 challenge schema never differ between gateways. If a gateway's architecture forces a difference, that is raised as an open question, never adapted silently.
The shared vectors (@dynamo/conformance-vectors 1.5.0) cover:
- the denial classes and their order (absent, malformed, expired, wrong
signer, metering stopped, not yet synced, stale, revoked, stopped by Dynamo, exhausted);
- canonical credentials: 12 cases. Only canonical signatures verify, and
only canonical base64url: the URL-safe alphabet only, no padding, and each segment re-encoding to itself;
- signing primitives, signed hop intents and the durable meter journal.
Gateways built today
| Gateway | How Dynamo runs on it |
|---|---|
| Kong, APISIX | a plugin with a shared core |
| Kong AI Gateway | the Kong plugin, unchanged |
| Envoy, agentgateway | an external-processing adapter (@dynamoprotocol/gateway-envoy 0.4.0) |
| Bifrost | the official image with a provider pointed at the Dynamo guard, or a native plugin built with Bifrost from source |
A native Bifrost plugin that fails to load leaves Bifrost serving with no check; confirm that an unauthenticated request answers 402 before taking traffic.
Test suites
make conformance-kong,make conformance-apisixmake test-gateways-journalmake test-gateway-envoy,make test-kong-aigw2make test-gateway-bifrost,make test-gateway-bifrost-upstreammake p17- plugin parity over randomized vectors
The container suites need Docker.
Mocks today
Mock upstreams and pinned public images. No vendor account is needed.
Certification steps
- Every shared vector passes, byte for byte, including all 12 canonical
credential cases.
- The meter journal reconciles exactly with Dynamo's records.
- No network call sits in the request path.
- The gateway refuses (402) when the check cannot run.