Enum Error 

pub enum Error {
    InvalidInput {
        field: &'static str,
        reason: &'static str,
    },
    InvalidToken(Token),
    Revoked(String),
    Denied(Token),
    Overloaded,
    Datalog(Token),
}

Why a request or a token was rejected.

Every variant means “deny”: callers must never grant access on error.

Messages of Error::Denied, Error::InvalidToken and Error::Datalog can quote Datalog written by the token holder, which may carry arbitrary data: services should log and return Error::kind only, and show full messages to people handling their own tokens.

Variants

InvalidInput

A request field or command-line value is malformed.

Fields

field: &'static str

What was malformed.

reason: &'static str

Why it was refused.

InvalidToken(Token)

The token cannot be decoded or its signatures do not match the root key.

Revoked(String)

One of the token’s blocks carries a revoked identifier.

Denied(Token)

The token is valid but its checks or the verifier policies refuse the request.

Overloaded

The evaluation ran out of time. That may come from the load, and the request may then succeed when retried; a costly token can also time out every time. Access is refused meanwhile.

Datalog(Token)

Datalog could not be built (bad operator policy, internal error).

Implementations

impl Error

pub fn kind(&self) -> &'static str

A stable, content-free label for logs and client responses.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.