Struct AuthDeny 

pub struct AuthDeny {
    pub reason: String,
    pub code: AuthErrorCode,
    pub details: AuthErrorDetails,
    pub retry_policy: RetryPolicy,
    pub http_status: u16,
    pub reset_at: Option<SystemTime>,
}

Enhanced authentication denial with structured error information

Fields

reason: String

code: AuthErrorCode

details: AuthErrorDetails

Structured error details for machine processing

retry_policy: RetryPolicy

Retry policy hint

http_status: u16

HTTP status code equivalent for the error

reset_at: Option<SystemTime>

When the error condition will reset (if applicable)

Implementations

impl AuthDeny

pub fn new(code: AuthErrorCode, reason: impl Into<String>) -> Self

Create a new AuthDeny with the specified error code and reason

pub fn token_missing() -> Self

Create an AuthDeny for missing token

pub fn from_verify_error(err: VerifyError) -> Self

Create an AuthDeny from a VerifyError

pub fn with_details(self, details: AuthErrorDetails) -> Self

Add structured error details

pub fn with_field(self, field: impl Into<String>) -> Self

Add a specific field that caused the error

pub fn with_context(self, context: impl Into<String>) -> Self

Add context to the error

pub fn with_suggested_action(self, action: impl Into<String>) -> Self

Add a suggested action for the client

pub fn with_docs_url(self, url: impl Into<String>) -> Self

Add documentation URL

pub fn with_retry_policy(self, policy: RetryPolicy) -> Self

Set a custom retry policy

pub fn with_reset_at(self, reset_at: SystemTime) -> Self

Set when the error condition will reset

pub fn rate_limited(retry_after: Duration, limit_type: &str) -> Self

Create an AuthDeny for rate limiting with retry information

pub fn connection_limit_exceeded( limit_type: &str, current: usize, max: usize, ) -> Self

Create an AuthDeny for connection limits

pub fn for_publishable_session(self) -> Self

The refusal a publishable-key session sees for a connection limit.

Publishable keys ship to browsers, so the reason a visitor reads names no identity and no counts. The detailed reason stays in details.context, which is never sent to the client.

pub fn to_error_response(&self) -> ErrorResponse

Convert to a JSON-serializable error response

Trait Implementations

impl Clone for AuthDeny

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AuthDeny

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

Formats the value using the given formatter.