Struct trillium_http_types::auth::WwwAuthenticate

pub struct WwwAuthenticate { /* fields omitted */ }

Define the authentication method that should be used to gain access to a resource.

Specifications

• RFC 7235, section 4.1: WWW-Authenticate

Implementation Notes

This implementation only encodes and parses a single authentication method, further authorization methods are ignored. It also always passes the utf-8 encoding flag.

Examples

use http_types::Response;
use http_types::auth::{AuthenticationScheme, WwwAuthenticate};

let scheme = AuthenticationScheme::Basic;
let realm = "Access to the staging site";
let authz = WwwAuthenticate::new(scheme, realm.into());

let mut res = Response::new(200);
res.insert_header(&authz, &authz);

let authz = WwwAuthenticate::from_headers(res)?.unwrap();

assert_eq!(authz.scheme(), AuthenticationScheme::Basic);
assert_eq!(authz.realm(), realm);

Implementations

impl WwwAuthenticate

pub fn new(scheme: AuthenticationScheme, realm: String) -> Self

Create a new instance of WwwAuthenticate.

pub fn from_headers(headers: impl AsRef<Headers>) -> Result<Option<Self>>

Create a new instance from headers.

pub fn scheme(&self) -> AuthenticationScheme

Get the authorization scheme.

pub fn set_scheme(&mut self, scheme: AuthenticationScheme)

Set the authorization scheme.

pub fn realm(&self) -> &str

Get the authorization realm.

pub fn set_realm(&mut self, realm: String)

Set the authorization realm.

Trait Implementations

impl Debug for WwwAuthenticate

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

Formats the value using the given formatter.

impl Header for WwwAuthenticate

fn header_name(&self) -> HeaderName

Access the header’s name.

fn header_value(&self) -> HeaderValue

Access the header’s value.

fn apply_header<H: AsMut<Headers>>(&self, headers: H)

Insert the header name and header value into something that looks like a Headers map.