Overview
visado is an ext_authz service for AI agent traffic that runs behind Envoy, Istio or agentgateway. For each request it verifies the caller’s workload credential and the delegation chain behind the request, asks an AuthZEN policy decision point, and passes the verified chain downstream as an OAuth Transaction Token.
How it fits
Section titled “How it fits”It follows the composition in draft-ietf-wimse-aims. It does not issue identities, log users in, evaluate policy or route traffic; see docs/scope.md.
Components
Section titled “Components”| Component | Spec | Status |
|---|---|---|
visado-txn-token |
draft-ietf-oauth-transaction-tokens-11 | alpha: mint, verify, replace, request parsing, conformance vectors |
visado-credentials |
WIMSE WIT with WPT or HTTP signatures (draft-ietf-wimse-http-signature-08) and mTLS via wimsey, SPIFFE JWT-SVIDs, OAuth access tokens (bearer or DPoP, RFC 9449) | alpha |
visado-authzen |
AuthZEN 1.0 | alpha: evaluation and discovery; batch and search not used |
visado-extauthz |
Envoy ext_authz v3 | alpha |
visado |
alpha: server binary | |
visado-chain |
alpha: normalized chain model and decoder trait | |
visado-chain-aat |
draft-niyikiza-oauth-attenuating-agent-tokens-02 | alpha: §8 verification, 229/229 published vectors, enforced by the gate |
visado-chain-asor |
draft-asor-wimse-agent-delegation-chain-03 | alpha: §6 verification with DPoP, 36/36 published vectors, enforced by the gate |
visado-chain-act |
RFC 8693 act claim |
alpha: the current actor bound to the caller, prior actors kept out of the PDP, enforced by the gate |
| Chain view, OpenTelemetry | alpha: visado.authorize spans over OTLP; an opt-in page of recent decisions and their chains at /chain (design) |
Install
Section titled “Install”cargo install visadoSigned binaries for Linux and macOS (x86-64 and arm64), with an SPDX SBOM and SLSA provenance, are on the releases page. The library crates are on crates.io.
Try it
Section titled “Try it”git clone https://github.com/kanywst/visadocd visadocargo test --workspacecargo run -p visado -- deploy/local/visado.tomlTo see it behind Envoy with a real PDP, run the lab: docker compose up -d --build && ./demo.sh in deploy/lab. The Transaction Token conformance vectors in conformance/ can be used to test other implementations; the AAT vectors there are a copy of the suite from tenuo-ai/tenuo, and the asor vectors a copy of the set from attenu-io/attenu-guard.
Documentation
Section titled “Documentation”- docs/scope.md: what visado covers and what it leaves to other projects
- docs/design.md: request pipeline and plugin interfaces
- SPEC-MAP.md: pinned draft revisions and known divergences
- docs/research/: background research
Contributing
Section titled “Contributing”See CONTRIBUTING.md. Commits need a DCO sign-off. visado follows the CNCF Code of Conduct.
Security
Section titled “Security”Do not open a public issue for a vulnerability. Follow SECURITY.md.
License
Section titled “License”© 2026 The visado Authors. Licensed under Apache-2.0.
Third-party logos are trademarks of their respective owners and are used to show compatibility; their use does not imply endorsement.