liburlx 0.2.2

A memory-safe URL transfer library — idiomatic Rust reimplementation of libcurl
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

//! HTTP authentication mechanisms.
//!
//! Supports Basic, Bearer, Digest (RFC 7616), NTLM, SCRAM-SHA-256, and AWS `SigV4` authentication.

pub mod aws_sigv4;
pub mod cram_md5;
pub mod digest;
pub mod ntlm;
pub mod scram;

/// The HTTP authentication method to use.
#[derive(Debug, Clone, PartialEq, Eq)]
#[non_exhaustive]
pub enum AuthMethod {
    /// HTTP Basic authentication (RFC 7617).
    ///
    /// Sends credentials as base64-encoded `user:password` on every request.
    Basic,
    /// HTTP Bearer token authentication (RFC 6750).
    Bearer,
    /// HTTP Digest authentication (RFC 7616).
    ///
    /// Performs challenge-response: first request gets 401, then retries
    /// with a computed hash response.
    Digest,
    /// NTLM authentication (NT LAN Manager).
    ///
    /// Multi-step challenge-response: Type 1 negotiate, Type 2 challenge,
    /// Type 3 authenticate.
    Ntlm,
    /// Automatic authentication method selection.
    ///
    /// Sends the first request without auth, then examines the
    /// `WWW-Authenticate` header to pick the strongest supported method
    /// (Digest > NTLM > Basic).
    AnyAuth,
}

/// Credentials for HTTP authentication.
#[derive(Debug, Clone)]
pub struct AuthCredentials {
    /// Username for authentication.
    pub username: String,
    /// Password for authentication.
    pub password: String,
    /// The authentication method to use.
    pub method: AuthMethod,
    /// Optional NTLM domain (e.g., from `DOMAIN\user` format).
    pub domain: Option<String>,
}

/// Proxy authentication method.
#[derive(Debug, Clone, PartialEq, Eq)]
#[non_exhaustive]
pub enum ProxyAuthMethod {
    /// HTTP Basic authentication.
    Basic,
    /// HTTP Digest authentication.
    Digest,
    /// NTLM authentication.
    Ntlm,
    /// Automatic authentication method selection.
    ///
    /// Sends the first request without auth, then examines the
    /// `Proxy-Authenticate` header to pick the strongest supported method
    /// (NTLM > Digest > Basic).
    Any,
}

/// Proxy authentication credentials.
#[derive(Debug, Clone)]
pub struct ProxyAuthCredentials {
    /// Username for proxy authentication.
    pub username: String,
    /// Password for proxy authentication.
    pub password: String,
    /// The authentication method to use.
    pub method: ProxyAuthMethod,
    /// Optional NTLM domain (e.g., "DOMAIN\\user").
    pub domain: Option<String>,
}