Skip to content

Overview

visado

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.

Agent A calls through Envoy; Envoy asks visado over ext_authz; visado asks the PDP over AuthZEN and the request reaches agent B with a Transaction Token

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.

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)
Terminal window
cargo install visado

Signed 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.

Terminal window
git clone https://github.com/kanywst/visado
cd visado
cargo test --workspace
cargo run -p visado -- deploy/local/visado.toml

To 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.

See CONTRIBUTING.md. Commits need a DCO sign-off. visado follows the CNCF Code of Conduct.

Do not open a public issue for a vulnerability. Follow SECURITY.md.

Apache-2.0