Struct gcp_auth::Token

pub struct Token { /* private fields */ }

Represents an access token that can be used as a bearer token in HTTP requests

Tokens should not be cached, the AuthenticationManager handles the correct caching already.

The token does not implement Display to avoid accidentally printing the token in log files, likewise Debug does not expose the token value itself which is only available using the Token::as_str method.

Token data as returned by the server

https://cloud.google.com/iam/docs/reference/sts/rest/v1/TopLevel/token#response-body

Implementations

impl Token

pub fn has_expired(&self) -> bool

Define if the token has has_expired

This takes an additional 30s margin to ensure the token can still be reasonably used instead of expiring right after having checked.

Note: The official Python implementation uses 20s and states it should be no more than 30s. The official Go implementation uses 10s (0s for the metadata server). The docs state, the metadata server caches tokens until 5 minutes before expiry. We use 20s to be on the safe side.

pub fn as_str(&self) -> &str

Get str representation of the token.

pub fn expires_at(&self) -> DateTime<Utc>

Get expiry of token, if available

Trait Implementations

impl Clone for Token

fn clone(&self) -> Token

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Token

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Token

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.