PAM Duress 项目教程

PAM Duress 项目教程

pam-duress A Pluggable Authentication Module (PAM) which allows the establishment of alternate passwords that can be used to perform actions to clear sensitive data, notify IT/Security staff, close off sensitive network connections, etc if a user is coerced into giving a threat actor a password. 项目地址: https://gitcode.com/gh_mirrors/pa/pam-duress

1. 项目的目录结构及介绍

PAM Duress 项目的目录结构如下：

pam-duress/
├── docs/
├── src/
├── .gitignore
├── CHANGELOG.md
├── LICENSE
├── Makefile
└── README.md

目录结构介绍

• docs/: 存放项目的文档文件，包括使用说明、安装指南等。
• src/: 存放项目的源代码文件，包括主要的 PAM 模块代码。
• .gitignore: 指定 Git 版本控制系统忽略的文件和目录。
• CHANGELOG.md: 记录项目的变更历史，包括版本更新、修复的 bug 等。
• LICENSE: 项目的开源许可证文件，本项目使用 LGPL-3.0 许可证。
• Makefile: 项目的构建文件，包含编译、安装、卸载等命令。
• README.md: 项目的介绍文件，包含项目的基本信息、安装步骤、使用说明等。

2. 项目的启动文件介绍

PAM Duress 项目的启动文件主要是 src/pam_duress.c，这是 PAM 模块的核心代码文件。该文件实现了 PAM 模块的主要功能，包括：

• 处理用户输入的密码，判断是否为胁迫密码。
• 如果密码为胁迫密码，执行预定义的胁迫脚本。
• 与 PAM 系统进行交互，完成用户认证流程。

启动文件功能介绍

• 密码验证: 通过 PAM 模块接口，验证用户输入的密码是否为胁迫密码。
• 脚本执行: 如果密码为胁迫密码，执行预定义的胁迫脚本，清理敏感数据、通知安全人员等。
• 认证流程: 完成 PAM 认证流程，确保用户能够正常登录系统。

3. 项目的配置文件介绍

PAM Duress 项目的配置文件主要包括以下几个部分：

3.1 本地胁迫脚本目录

用户可以在本地创建一个目录来存放胁迫脚本，例如：

mkdir -p ~/duress

在这个目录中，用户可以创建多个胁迫脚本，每个脚本对应一个胁迫密码。

3.2 全局胁迫脚本目录

管理员可以在系统中创建一个全局胁迫脚本目录，例如：

sudo mkdir -p /etc/duress.d

在这个目录中，管理员可以创建多个全局胁迫脚本，这些脚本可以被所有用户使用。

3.3 PAM 配置文件

PAM Duress 模块需要在 PAM 配置文件中进行配置，通常是 /etc/pam.d/common-auth 文件。配置示例如下：

auth [success=2 default=ignore] pam_unix.so
auth [success=1 default=ignore] pam_duress.so
auth requisite pam_deny.so

配置文件功能介绍

• 本地胁迫脚本目录: 用户自定义的胁迫脚本存放目录，每个用户可以有自己的胁迫脚本。
• 全局胁迫脚本目录: 系统管理员定义的胁迫脚本存放目录，所有用户都可以使用这些脚本。
• PAM 配置文件: 配置 PAM 模块的执行顺序和行为，确保胁迫密码能够触发相应的胁迫脚本。

通过以上配置，PAM Duress 模块可以在用户输入胁迫密码时，执行预定义的胁迫脚本，从而保护系统的安全。

pam-duress A Pluggable Authentication Module (PAM) which allows the establishment of alternate passwords that can be used to perform actions to clear sensitive data, notify IT/Security staff, close off sensitive network connections, etc if a user is coerced into giving a threat actor a password. 项目地址: https://gitcode.com/gh_mirrors/pa/pam-duress