sysknife_daemon/actions/

users.rs

use super::{command_mechanism, ActionSpec};
use sysknife_types::RiskLevel;

pub fn specs() -> Vec<ActionSpec> {
    vec![
        list_users(),
        list_groups(),
        create_user("alice", Some("/bin/bash"), Some("/home/alice")),
        delete_user("alice"),
        add_user_to_group("alice", "wheel"),
        remove_user_from_group("alice", "wheel"),
        create_group("developers", false),
        delete_group("developers"),
        lock_user_account("alice"),
        unlock_user_account("alice"),
    ]
}

pub fn list_users() -> ActionSpec {
    ActionSpec {
        action_name: "ListUsers",
        mechanism: command_mechanism("getent", ["passwd"]),
        risk_level: RiskLevel::Low,
        reboot_required: false,
        rollback_available: false,
    }
}

pub fn list_groups() -> ActionSpec {
    ActionSpec {
        action_name: "ListGroups",
        mechanism: command_mechanism("getent", ["group"]),
        risk_level: RiskLevel::Low,
        reboot_required: false,
        rollback_available: false,
    }
}

/// Create a local account (`sudo action-steps user-create <name> [...]`).
///
/// Through the helper rather than `sudo useradd` directly. A sudoers grant
/// cannot say "this subcommand and no further options": the arguments are
/// matched as one concatenated string, so `/usr/sbin/useradd --create-home *`
/// authorised `useradd --create-home -o -u 0 -g 0 backdoor` too. The helper
/// re-validates the account name, the home directory and the shell, and builds
/// the same `useradd --create-home [--home-dir H] [--shell S] <name>` argv this
/// function used to build itself.
pub fn create_user(username: &str, shell: Option<&str>, home: Option<&str>) -> ActionSpec {
    let mut args = vec![
        "/usr/lib/sysknife/action-steps".to_string(),
        "user-create".to_string(),
        username.to_string(),
    ];
    if let Some(home) = home {
        args.push("--home-dir".to_string());
        args.push(home.to_string());
    }
    if let Some(shell) = shell {
        args.push("--shell".to_string());
        args.push(shell.to_string());
    }

    ActionSpec {
        action_name: "CreateUser",
        mechanism: super::ActionMechanism::Command {
            program: "sudo",
            args,
        },
        risk_level: RiskLevel::High,
        reboot_required: false,
        rollback_available: false,
    }
}

pub fn delete_user(username: &str) -> ActionSpec {
    ActionSpec {
        action_name: "DeleteUser",
        // Through the helper: shadow-utils honours `userdel -R <dir>` even
        // after `--`, so no sudoers spelling of `userdel` could refuse it.
        mechanism: command_mechanism(
            "sudo",
            ["/usr/lib/sysknife/action-steps", "user-delete", username],
        ),
        // High risk: permanently removes login access — same class as SSH key
        // removal and group membership changes.
        risk_level: RiskLevel::High,
        reboot_required: false,
        rollback_available: false,
    }
}

pub fn add_user_to_group(username: &str, group: &str) -> ActionSpec {
    // On Fedora Atomic, system groups (wheel, adm, systemd-journal, etc.) live
    // in the read-only /usr/lib/group OSTree layer. `usermod` only modifies
    // /etc/group. If the group is absent from /etc/group, usermod silently
    // succeeds without actually adding the user. Fix: copy the entry via
    // `getent group` (which merges /usr/lib/group + /etc/group) if missing.
    ActionSpec {
        action_name: "AddUserToGroup",
        mechanism: command_mechanism(
            "sudo",
            [
                "/usr/lib/sysknife/action-steps",
                "group-add",
                username,
                group,
            ],
        ),
        // High risk: adding a user to a privileged group (e.g. `wheel`) grants
        // sudo / sysknife-admin rights, constituting a privilege escalation if
        // performed at lower than Admin level.
        risk_level: RiskLevel::High,
        reboot_required: false,
        rollback_available: false,
    }
}

pub fn remove_user_from_group(username: &str, group: &str) -> ActionSpec {
    // Same Fedora Atomic group-layer issue as AddUserToGroup: `gpasswd` fails
    // with "group does not exist in /etc/group" for system groups. Ensure the
    // entry is present in /etc/group before deletion.
    ActionSpec {
        action_name: "RemoveUserFromGroup",
        mechanism: command_mechanism(
            "sudo",
            [
                "/usr/lib/sysknife/action-steps",
                "group-remove",
                username,
                group,
            ],
        ),
        // High risk: mirrors AddUserToGroup — removing from a privileged group
        // is equally impactful and should require the same Admin authorization.
        risk_level: RiskLevel::High,
        reboot_required: false,
        rollback_available: false,
    }
}

/// Create a group (`sudo action-steps group-create [--system] <group>`, which
/// runs `groupadd [--system] <group>`).
///
/// High risk: groups gate access to privileged resources, so creating one is a
/// privilege-relevant operation on par with the rest of the user/group family.
/// `system` selects a system group (GID from the system range) via `--system`.
pub fn create_group(group: &str, system: bool) -> ActionSpec {
    let mut args = vec![
        "/usr/lib/sysknife/action-steps".to_string(),
        "group-create".to_string(),
    ];
    if system {
        args.push("--system".to_string());
    }
    args.push(group.to_string());
    ActionSpec {
        action_name: "CreateGroup",
        mechanism: super::ActionMechanism::Command {
            program: "sudo",
            args,
        },
        risk_level: RiskLevel::Medium,
        reboot_required: false,
        rollback_available: false,
    }
}

/// Delete a group (`sudo action-steps group-delete <group>`, which runs
/// `groupdel <group>`).
///
/// High risk: irreversible; removing a group can strip access from every member
/// and orphan file ownership. `groupdel` itself refuses to remove a user's
/// primary group, which is a useful built-in guard.
pub fn delete_group(group: &str) -> ActionSpec {
    ActionSpec {
        action_name: "DeleteGroup",
        mechanism: command_mechanism(
            "sudo",
            ["/usr/lib/sysknife/action-steps", "group-delete", group],
        ),
        risk_level: RiskLevel::High,
        reboot_required: false,
        rollback_available: false,
    }
}

/// Lock a user account (`sudo usermod --lock <username>`).
///
/// High risk: disables password login for the account without deleting it
/// (reversible via [`unlock_user_account`]). Note this does not terminate the
/// user's existing sessions or disable SSH-key logins.
pub fn lock_user_account(username: &str) -> ActionSpec {
    ActionSpec {
        action_name: "LockUserAccount",
        mechanism: command_mechanism(
            "sudo",
            ["/usr/lib/sysknife/action-steps", "user-lock", username],
        ),
        risk_level: RiskLevel::High,
        reboot_required: false,
        rollback_available: false,
    }
}

/// Unlock a previously locked user account (`sudo usermod --unlock <username>`).
///
/// High risk: re-enables password login — an access-control change on par with
/// the rest of the user/group family.
pub fn unlock_user_account(username: &str) -> ActionSpec {
    ActionSpec {
        action_name: "UnlockUserAccount",
        mechanism: command_mechanism(
            "sudo",
            ["/usr/lib/sysknife/action-steps", "user-unlock", username],
        ),
        risk_level: RiskLevel::High,
        reboot_required: false,
        rollback_available: false,
    }
}