Struct AddAuthorizationLayer

pub struct AddAuthorizationLayer { /* private fields */ }

Layer that applies AddAuthorization which adds authorization to all requests using the Authorization header.

See the module docs for an example.

You can also use SetRequestHeader if you have a use case that isn’t supported by this middleware.

Implementations

impl AddAuthorizationLayer

pub fn none() -> Self

Create a new AddAuthorizationLayer that does not add any authorization.

Can be useful if you only want to add authorization for some branches of your service.

pub fn basic(username: &str, password: &str) -> Self

Authorize requests using a username and password pair.

The Authorization header will be set to Basic {credentials} where credentials is base64_encode("{username}:{password}").

Since the username and password is sent in clear text it is recommended to use HTTPS/TLS with this method. However use of HTTPS/TLS is not enforced by this middleware.

pub fn bearer(token: &str) -> Self

Authorize requests using a “bearer token”. Commonly used for OAuth 2.

The Authorization header will be set to Bearer {token}.

Panics

Panics if the token is not a valid HeaderValue.

pub fn as_sensitive(self, sensitive: bool) -> Self

Mark the header as sensitive.

This can for example be used to hide the header value from logs.

pub fn set_as_sensitive(&mut self, sensitive: bool) -> &mut Self

Mark the header as sensitive.

This can for example be used to hide the header value from logs.

pub fn if_not_present(self, value: bool) -> Self

Preserve the existing Authorization header if it exists.

This can be useful if you want to use different authorization headers for different requests.

pub fn set_if_not_present(&mut self, value: bool) -> &mut Self

Preserve the existing Authorization header if it exists.

This can be useful if you want to use different authorization headers for different requests.

Trait Implementations

impl Clone for AddAuthorizationLayer

fn clone(&self) -> AddAuthorizationLayer

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AddAuthorizationLayer

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<S> Layer<S> for AddAuthorizationLayer

type Service = AddAuthorization<S>

The service produced by the layer.

fn layer(&self, inner: S) -> Self::Service

Wrap the given service with the middleware, returning a new service.