Crate aep_tower

Expand description

§aep-tower

aep-tower connects the framework-neutral aep-service engine to Tower-compatible HTTP stacks. It provides a command service for the AEP discovery and lifecycle endpoints and an authentication layer for protected application resources.

§Install

[dependencies]
aep-service = "0.2"
aep-tower = "0.2"

§Command endpoints

use std::sync::Arc;

use aep_service::Service;
use aep_tower::CommandService;

let commands = CommandService::new(service, 1 << 20)?;

Mount the percent-encoded HTTP paths returned by CommandService::paths() without decoding them. The Service’s Inspect document retains the configured endpoint_base. The adapter handles Inspect, Enroll, Status, Grant, and Revoke while enforcing the methods, authentication, idempotency, body limit, and AEP response media types.

§Protected resources

Apply AuthenticationLayer to application resources that require an enrolled Agent. Successful authentication inserts AuthenticatedPrincipal into the request extensions. The configured origin is used to construct the absolute protected-resource URL bound into JWT client assertions. Plaintext HTTP is rejected unless explicitly enabled for a loopback origin.

The aep-local-lifecycle example uses CommandService directly. The aep-service-axum example shows the same Tower boundaries composed through Axum.

The underlying aep-service crate remains usable without Tower. See the workspace guide and the AEP specifications.