Struct AuthInterceptor 

pub struct AuthInterceptor { /* private fields */ }

Adds authorization: Bearer <token> (and x-app-name) to every request.

The authorization value is marked sensitive, so tonic does not print it in debug output. One interceptor serves one token. TbankClient builds it from the config, build it yourself only when you wrap your own channel.

Examples

use brokapi_tbank_protocol::AuthInterceptor;
use tonic::service::Interceptor;

let mut auth = AuthInterceptor::new("t.my-token", Some("me.my-robot"))?;
let request = auth.call(tonic::Request::new(())).expect("the interceptor never refuses");
assert_eq!(request.metadata().get("authorization").unwrap(), "Bearer t.my-token");
assert_eq!(request.metadata().get("x-app-name").unwrap(), "me.my-robot");

// A token a header cannot carry is a configuration error, not a panic.
assert!(AuthInterceptor::new("line\nbreak", None).is_err());

Implementations

impl AuthInterceptor

pub fn new(token: &str, app_name: Option<&str>) -> Result<Self, ProtocolError>

Prepares the headers for token and the optional app_name.

app_name becomes the x-app-name header (the T-Bank convention is <github nick>.<repo>).

Errors

ProtocolError::Config when the token or the app name contains characters a header value cannot carry (control characters such as a line break). The message does not repeat the token.

Trait Implementations

impl Clone for AuthInterceptor

fn clone(&self) -> AuthInterceptor

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Interceptor for AuthInterceptor

fn call(&mut self, req: Request<()>) -> Result<Request<()>, Status>

Intercept a request before it is sent, optionally cancelling it.