Skip to main content

auth_framework/authentication/
advanced_auth.rs

1//! Delegation, ABAC, Resource Mapping, and Backup Code Management
2//! Core data models and traits for advanced authorization features
3
4use chrono::{DateTime, Utc};
5use serde::{Deserialize, Serialize};
6use std::collections::HashMap;
7
8// Delegation types
9#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
10pub enum DelegationType {
11    UserToUser,
12    UserToRole,
13    RoleToRole,
14}
15
16#[derive(Debug, Clone, Serialize, Deserialize)]
17pub struct Delegation {
18    pub id: String,
19    pub delegator: String, // user or role id
20    pub delegatee: String, // user or role id
21    pub delegation_type: DelegationType,
22    pub scopes: Vec<String>,
23    pub start_time: Option<DateTime<Utc>>,
24    pub end_time: Option<DateTime<Utc>>,
25    pub explicit: bool,
26    pub revoked: bool,
27    pub created_at: DateTime<Utc>,
28    pub revoked_at: Option<DateTime<Utc>>,
29    pub audit_log: Vec<String>, // log entries
30}
31
32// ABAC Policy DSL (initial design)
33#[derive(Debug, Clone, Serialize, Deserialize)]
34pub struct AbacPolicy {
35    pub id: String,
36    pub name: String,
37    pub dsl: String,                         // DSL string for policy
38    pub attributes: HashMap<String, String>, // attribute bindings
39    pub enabled: bool,
40    pub dynamic: bool, // true if stored in DB
41    pub created_at: DateTime<Utc>,
42    pub updated_at: Option<DateTime<Utc>>,
43}
44
45// Resource mapping
46#[derive(Debug, Clone, Serialize, Deserialize)]
47pub struct ManagedResource {
48    pub id: String,
49    pub resource_type: String, // e.g., "file", "api", "custom"
50    pub uri: String,
51    pub attributes: HashMap<String, String>,
52    pub registered_by: String,
53    pub registered_at: DateTime<Utc>,
54    pub permissions: Vec<String>, // fine/coarse-grained
55}
56
57// Backup code management
58#[derive(Debug, Clone, Serialize, Deserialize)]
59pub struct BackupCodeConfig {
60    pub code_count: usize,
61    pub code_length: usize,
62    pub code_format: String,     // e.g., "numeric", "alphanumeric"
63    pub code_complexity: String, // e.g., "simple", "strong"
64    pub expiry_seconds: u64,
65    pub rotate_on_use: bool,
66}
67
68#[derive(Clone, Serialize, Deserialize)]
69pub struct UserBackupCodes {
70    pub user_id: String,
71    pub codes: Vec<String>,
72    pub used_codes: Vec<String>,
73    pub generated_at: DateTime<Utc>,
74    pub expires_at: DateTime<Utc>,
75    pub config: BackupCodeConfig,
76}
77
78impl std::fmt::Debug for UserBackupCodes {
79    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
80        let mut d = f.debug_struct("UserBackupCodes");
81        d.field("user_id", &self.user_id);
82        d.field("codes", &crate::utils::redact::redacted(&self.codes));
83        d.field(
84            "used_codes",
85            &crate::utils::redact::redacted(&self.used_codes),
86        );
87        d.field("generated_at", &self.generated_at);
88        d.field("expires_at", &self.expires_at);
89        d.field("config", &self.config);
90        d.finish()
91    }
92}
93
94// Traits for storage and management
95pub trait DelegationManager {
96    fn create_delegation(&mut self, delegation: Delegation) -> Result<(), String>;
97    fn revoke_delegation(&mut self, delegation_id: &str, by: &str) -> Result<(), String>;
98    fn get_delegations_for(&self, user_or_role: &str) -> Vec<Delegation>;
99    fn audit_delegation(&mut self, delegation_id: &str, entry: &str);
100}
101
102pub trait AbacPolicyManager {
103    fn add_policy(&mut self, policy: AbacPolicy) -> Result<(), String>;
104    fn update_policy(&mut self, policy_id: &str, dsl: &str) -> Result<(), String>;
105    fn evaluate_policy(&self, policy_id: &str, attributes: &HashMap<String, String>) -> bool;
106}
107
108pub trait ResourceManager {
109    fn register_resource(&mut self, resource: ManagedResource) -> Result<(), String>;
110    fn update_resource(
111        &mut self,
112        resource_id: &str,
113        attributes: &HashMap<String, String>,
114    ) -> Result<(), String>;
115    fn get_resource(&self, resource_id: &str) -> Option<ManagedResource>;
116}
117
118pub trait BackupCodeManager {
119    fn generate_codes(&mut self, user_id: &str, config: &BackupCodeConfig) -> UserBackupCodes;
120    fn verify_code(&mut self, user_id: &str, code: &str) -> bool;
121    fn rotate_codes(&mut self, user_id: &str);
122}