securitydept-realip 0.2.0

Real IP of SecurityDept, a layered authentication and authorization toolkit built as reusable Rust crates.
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

use std::{net::IpAddr, path::PathBuf};

use snafu::Snafu;

pub type RealIpResult<T> = Result<T, RealIpError>;

#[derive(Debug, Snafu)]
#[snafu(visibility(pub))]
pub enum RealIpError {
    #[snafu(display("Invalid real-ip config: {message}"))]
    Config { message: String },

    #[snafu(display("Unknown provider kind `{kind}` for provider `{name}`"))]
    UnknownProviderKind { name: String, kind: String },

    #[snafu(display("No custom provider factory registered for kind `{kind}`"))]
    MissingProviderFactory { kind: String },

    #[snafu(display("Duplicate custom provider factory registration for kind `{kind}`"))]
    DuplicateProviderFactory { kind: String },

    #[snafu(display("Provider `{provider}` is missing required field `{field}`"))]
    MissingProviderField {
        provider: String,
        field: &'static str,
    },

    #[snafu(display("Source `{source_name}` references unknown provider `{provider}`"))]
    UnknownSourceProvider {
        source_name: String,
        provider: String,
    },

    #[snafu(display("Failed to read provider file `{:?}`: {source}", path))]
    ReadProviderFile {
        path: PathBuf,
        source: std::io::Error,
    },

    #[snafu(display("Provider command `{command}` failed: {details}"))]
    ProviderCommand { command: String, details: String },

    #[snafu(display("Provider request for `{url}` failed: {source}"))]
    ProviderHttp { url: String, source: reqwest::Error },

    #[snafu(display("Failed to watch provider path `{:?}`: {details}", path))]
    WatchProvider { path: PathBuf, details: String },

    #[snafu(display("Provider `{provider}` returned no valid CIDRs"))]
    EmptyProviderOutput { provider: String },

    #[snafu(display("Provider `{provider}` has invalid CIDR or IP entry `{entry}`"))]
    InvalidProviderEntry { provider: String, entry: String },

    #[snafu(display("Provider `{provider}` failed: {details}"))]
    ProviderLoad { provider: String, details: String },

    #[snafu(display("Invalid real-ip access config: {message}"))]
    AccessConfig { message: String },

    #[snafu(display("Real-ip access denied for `{client_ip}`: {reason}"))]
    AccessDenied { client_ip: IpAddr, reason: String },
}