Struct rocket_oauth2::TokenResponse

pub struct TokenResponse<K> { /* private fields */ }

The server’s response to a successful token exchange, defined in in RFC 6749 §5.1.

TokenResponse<K> implements FromRequest, and is used in the callback route to complete the token exchange.

Example

use rocket_oauth2::TokenResponse;

#[get("/auth")]
fn auth_callback(token: TokenResponse<Auth>, cookies: &CookieJar<'_>) -> Redirect {
     // ...
}

Implementations

impl<K> TokenResponse<K>

pub fn cast<L>(self) -> TokenResponse<L>

Reinterpret this TokenResponse as if it were keyed by L instead. This function can be used to treat disparate TokenResponses as a single concrete type such as TokenResponse<()> to avoid an explosion of generic bounds.

Example

use rocket_oauth2::TokenResponse;

struct GitHub;

fn use_nongeneric_token(token: TokenResponse<()>) {
    // ...
}

#[rocket::get("/login/github")]
fn login_github(token: TokenResponse<GitHub>) {
    use_nongeneric_token(token.cast());
}

pub fn as_value(&self) -> &Value

Get the TokenResponse data as a raw JSON Value. It is guaranteed to be of type Object.

Example

use rocket_oauth2::TokenResponse;

struct MyProvider;

#[rocket::get("/login/github")]
fn login_github(token: TokenResponse<MyProvider>) {
    let custom_data = token.as_value().get("custom_data").unwrap().as_str();
}

pub fn access_token(&self) -> &str

Get the access token issued by the authorization server.

Example

use rocket_oauth2::TokenResponse;

struct GitHub;

#[rocket::get("/login/github")]
fn login_github(token: TokenResponse<GitHub>) {
    let access_token = token.access_token();
}

pub fn token_type(&self) -> &str

Get the type of token, described in RFC 6749 §7.1.

Example

use rocket_oauth2::TokenResponse;

struct GitHub;

#[rocket::get("/login/github")]
fn login_github(token: TokenResponse<GitHub>) {
    let token_type = token.token_type();
}

pub fn expires_in(&self) -> Option<i64>

Get the lifetime in seconds of the access token, if the authorization server provided one.

Example

use rocket_oauth2::TokenResponse;

struct GitHub;

#[rocket::get("/login/github")]
fn login_github(token: TokenResponse<GitHub>) {
    if let Some(expires_in) = token.expires_in() {
        println!("Token expires in {} seconds", expires_in);
    }
}

pub fn refresh_token(&self) -> Option<&str>

Get the refresh token, if the server provided one.

Example

use rocket_oauth2::TokenResponse;

struct GitHub;

#[rocket::get("/login/github")]
fn login_github(token: TokenResponse<GitHub>) {
    if let Some(refresh_token) = token.refresh_token() {
        println!("Got a refresh token! '{}'", refresh_token);
    }
}

pub fn scope(&self) -> Option<&str>

Get the (space-separated) list of scopes associated with the access token. The authorization server is required to provide this if it differs from the requested set of scopes.

If scope was not provided by the server as a string, this method will return None. For those providers, use `.as_value().get(“scope”) instead.

Example

use rocket_oauth2::TokenResponse;

struct GitHub;

#[rocket::get("/login/github")]
fn login_github(token: TokenResponse<GitHub>) {
    if let Some(scope) = token.scope() {
        println!("Token scope: '{}'", scope);
    }
}

Trait Implementations

impl<K: Clone> Clone for TokenResponse<K>

fn clone(&self) -> TokenResponse<K>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<K: Debug> Debug for TokenResponse<K>

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

Formats the value using the given formatter.

impl<'r, K: 'static> FromRequest<'r> for TokenResponse<K>

fn from_request<'life0, 'async_trait>( request: &'r Request<'life0> ) -> Pin<Box<dyn Future<Output = Outcome<Self, Self::Error>> + Send + 'async_trait>>

where Self: 'async_trait, 'r: 'async_trait, 'life0: 'async_trait,

Handle the redirect callback, delegating to the Adapter to perform the token exchange.

type Error = Error

The associated error to be returned if derivation fails.

impl<K: PartialEq> PartialEq for TokenResponse<K>

fn eq(&self, other: &TokenResponse<K>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<K: 'static> Sentinel for TokenResponse<K>

fn abort(rocket: &Rocket<Ignite>) -> bool

Returns true if launch should be aborted and false otherwise.

impl TryFrom<Value> for TokenResponse<()>

fn try_from(data: Value) -> Result<Self, Error>

Construct a TokenResponse from a Value.

Returns an Error if data is not a JSON Object, or the access_token or token_type is missing or not a string.

type Error = Error

The type returned in the event of a conversion error.

impl<K> StructuralPartialEq for TokenResponse<K>