gamlastan 0.6.0

SAML 2.0 library - types, XML, crypto, metadata, bindings, security, profiles
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91

// Binding-level errors for SAML 2.0 protocol bindings.

use thiserror::Error;

/// Errors that can occur during SAML binding operations.
#[derive(Debug, Error)]
pub enum BindingError {
    /// Base64 decode error.
    #[error("base64 decode error: {0}")]
    Base64Decode(#[from] base64::DecodeError),

    /// DEFLATE decompression error.
    #[error("DEFLATE decompression error: {0}")]
    DeflateError(String),

    /// URL decoding error.
    #[error("URL decode error: {0}")]
    UrlDecodeError(String),

    /// Required SAML parameter missing from the request.
    #[error("missing SAML parameter: {0}")]
    MissingSamlParam(&'static str),

    /// A binding request supplied the same security-sensitive parameter more than once.
    #[error("duplicate SAML parameter: {0}")]
    DuplicateSamlParam(&'static str),

    /// A binding request contains an ambiguous or inconsistent SAML parameter set.
    #[error("invalid SAML parameters: {0}")]
    InvalidSamlParams(String),

    /// Invalid artifact format.
    #[error("invalid artifact: {0}")]
    InvalidArtifact(String),

    /// Artifact has already been consumed (one-time-use violation).
    #[error("artifact already consumed")]
    ArtifactAlreadyConsumed,

    /// Artifact not found in the store.
    #[error("artifact not found")]
    ArtifactNotFound,

    /// RelayState exceeds 80-byte limit.
    #[error("RelayState exceeds 80-byte limit (got {0} bytes)")]
    RelayStateTooLong(usize),

    /// RelayState failed E90 sanitization (XSS/CSRF).
    #[error("RelayState failed sanitization: {0}")]
    RelayStateUnsafe(String),

    /// Signature verification failed for the binding.
    #[error("signature verification failed: {0}")]
    SignatureVerificationFailed(String),

    /// Destination attribute mismatch.
    #[error("destination mismatch: expected {expected}, got {actual}")]
    DestinationMismatch { expected: String, actual: String },

    /// SOAP fault received.
    #[error("SOAP fault: {faultcode} - {faultstring}")]
    SoapFault {
        faultcode: String,
        faultstring: String,
        detail: Option<String>,
    },

    /// HTTP-level error.
    #[error("HTTP error: status {0}")]
    HttpError(u16),

    /// XML processing error.
    #[error("XML error: {0}")]
    XmlError(#[from] crate::xml::error::XmlError),

    /// Crypto error (from gamlastan crypto).
    #[error("crypto error: {0}")]
    CryptoError(#[from] crate::crypto::CryptoError),

    /// I/O error.
    #[error("I/O error: {0}")]
    IoError(#[from] std::io::Error),

    /// Message too large.
    #[error("message too large: {0} bytes")]
    MessageTooLarge(usize),

    /// Invalid SOAP envelope.
    #[error("invalid SOAP envelope: {0}")]
    InvalidSoapEnvelope(String),
}