Skip to main content

Module interceptor

Module interceptor 

Source
Expand description

Interceptors: an extension’s code that changes a cloud call after Alien builds it and before Alien signs it, and changes the response before Alien reads it.

A deployment’s chain travels on the clients built for it, never on a client config or in a global, so two deployments in one process never see each other’s interceptors. An interceptor never sees the credentials Alien signs with. It may change what a call says about the deployment’s own resources, and Alien refuses any change to where a call goes, to its method and path, to which identity it names, to an image in a cloud registry, or to a header that carries or protects a credential; on Kubernetes it may change only an object’s labels. A call that changes who has access, acts as another identity or carries a Kubernetes credential is never offered, and no call may become one.

Structs§

HookRequest
A call as an interceptor sees it: the request Alien built, without credentials.
HookResponse
A response as an interceptor sees it, before Alien reads it.
InterceptorChain
A deployment’s interceptors, in the order its stack lists extensions. Each one gets the request as the previous one left it.
ResponseHook
The interceptors that matched one call, to run on its response.

Enums§

Cloud
The API a call goes to.

Traits§

CallInterceptor
One extension’s interceptor.

Functions§

apply_response_hook
Passes response through hook, when the call had one.
keep_interceptor_failure_final
Keeps an interceptor’s failure final under a wrapper that marks the error retryable: the same request fails the same way again. A failure before the call was sent that the interceptor itself marked retryable, as a hook stopped at its deadline is, stays retryable.