securitydept-creds-manage 0.2.0

Credentials Management 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
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
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110

use http::StatusCode;
use securitydept_utils::{
    error::{ErrorPresentation, ToErrorPresentation, UserRecovery},
    http::ToHttpStatus,
};
use snafu::Snafu;

#[derive(Debug, Snafu)]
#[snafu(visibility(pub))]
pub enum CredsManageError {
    #[snafu(display("Failed to load config: {message}"))]
    ConfigLoad { message: String },

    #[snafu(display("Failed to read data file: {source}"))]
    DataRead { source: std::io::Error },

    #[snafu(display("Failed to write data file: {source}"))]
    DataWrite { source: std::io::Error },

    #[snafu(display("Failed to parse data: {source}"))]
    DataParse { source: serde_json::Error },

    #[snafu(display("Failed to serialize data: {source}"))]
    DataSerialize { source: serde_json::Error },

    #[snafu(display("Entry not found: {id}"))]
    EntryNotFound { id: String },

    #[snafu(display("Group not found: {id}"))]
    GroupNotFound { id: String },

    #[snafu(display("Duplicate entry name: {name}"))]
    DuplicateEntryName { name: String },

    #[snafu(display("Duplicate group name: {name}"))]
    DuplicateGroupName { name: String },

    #[snafu(display("Invalid configuration: {message}"))]
    InvalidConfig { message: String },

    #[snafu(transparent)]
    Creds {
        source: securitydept_creds::error::CredsError,
    },
    #[cfg(feature = "migration")]
    #[snafu(display("Migration error: {source}"), context(false))]
    Migration {
        source: Box<dyn std::error::Error + Send + Sync>,
    },
}

impl ToHttpStatus for CredsManageError {
    fn to_http_status(&self) -> StatusCode {
        match self {
            CredsManageError::Creds { source } => source.to_http_status(),
            CredsManageError::EntryNotFound { .. } | CredsManageError::GroupNotFound { .. } => {
                StatusCode::NOT_FOUND
            }
            CredsManageError::DuplicateEntryName { .. }
            | CredsManageError::DuplicateGroupName { .. } => StatusCode::CONFLICT,
            _ => StatusCode::INTERNAL_SERVER_ERROR,
        }
    }
}

impl ToErrorPresentation for CredsManageError {
    fn to_error_presentation(&self) -> ErrorPresentation {
        match self {
            CredsManageError::Creds { source } => source.to_error_presentation(),
            CredsManageError::EntryNotFound { .. } => ErrorPresentation::new(
                "entry_not_found",
                "The requested auth entry was not found.",
                UserRecovery::None,
            ),
            CredsManageError::GroupNotFound { .. } => ErrorPresentation::new(
                "group_not_found",
                "The requested group was not found.",
                UserRecovery::None,
            ),
            CredsManageError::DuplicateEntryName { .. } => ErrorPresentation::new(
                "duplicate_entry_name",
                "An auth entry with the same name already exists.",
                UserRecovery::None,
            ),
            CredsManageError::DuplicateGroupName { .. } => ErrorPresentation::new(
                "duplicate_group_name",
                "A group with the same name already exists.",
                UserRecovery::None,
            ),
            CredsManageError::ConfigLoad { .. }
            | CredsManageError::DataRead { .. }
            | CredsManageError::DataWrite { .. }
            | CredsManageError::DataParse { .. }
            | CredsManageError::DataSerialize { .. }
            | CredsManageError::InvalidConfig { .. } => ErrorPresentation::new(
                "creds_manage_unavailable",
                "Credential management is temporarily unavailable.",
                UserRecovery::ContactSupport,
            ),
            #[cfg(feature = "migration")]
            CredsManageError::Migration { .. } => ErrorPresentation::new(
                "creds_manage_unavailable",
                "Credential management is temporarily unavailable.",
                UserRecovery::ContactSupport,
            ),
        }
    }
}

pub type CredsManageResult<T> = std::result::Result<T, CredsManageError>;