Docs: 忘记密码

Thu, 26 Jun 2025 00:00:00 +0000

iTop 允许最终用户自助重置密码，无需打扰管理员。此功能默认启用（iTop 2.0.2+）。

工作流程

登录页面底部点击链接 → 输入登录名
iTop 搜索账号 → 发送重置邮件
用户点击邮件链接 → 获取密码重置表单（不需要旧密码）
设置新密码（须满足密码复杂度策略）

安全注意事项

发送给用户的链接为一次性使用链接
如果用户多次尝试重置密码，只有最新链接有效

配置

由于该功能依赖发送邮件，首先必须确保 iTop 能够发送邮件。使用页面 /setup/email.test.php 检查邮件功能是否正常。邮件配置请参考邮件配置。

注意：此类邮件同步发送，即使邮件配置为异步发送。

此外，该功能还依赖账号数据：

用户必须是 iTop 用户类型（对 LDAP 用户无效）
用户账号必须关联一个联系人
联系人必须配置有效的电子邮件地址

如果没有任何用户需要此功能，可以在 iTop 配置文件中设置 forgot_password 参数为 false 来禁用它。禁用时，登录页面上的超链接将消失。

前提条件

配置中启用忘记密码功能（默认启用）
用户账号关联电子邮件地址
已配置邮件发送功能

错误处理

如果某个用户不满足使用此功能的条件，该功能将不可用。以下是失败尝试的截图示例：

原文：https://www.itophub.io/wiki/page?id=3_2_0:admin:forgot_password

Last modified: 2025/03/10 10:24 by127.0.0.1

版本：3_2_0/admin/forgot_password.txt · Last modified: 2024/09/10 10:25 by 127.0.0.1

Docs: 密码复杂度策略

Thu, 26 Jun 2025 00:00:00 +0000

管理员可配置密码复杂度策略，确保用户使用安全的密码。

默认策略

创建新的本地用户账号或更改本地用户密码时，iTop 会应用密码策略，通过正则表达式检查密码复杂度。

默认情况下，密码必须满足：

至少包含一个小写字母
至少包含一个大写字母
至少包含一个数字
至少包含一个特殊字符
长度超过 8 个字符

其他注意事项：

现有密码不受影响
安装期间创建的 admin 账号不受影响
所有更改密码的方式均受影响，但 CSV 导入和数据同步除外（已知限制）
管理员无法绕过策略，但可以修改策略配置

配置

默认设置不会显式出现在配置文件中，但格式如下：

$MyModuleSettings = array(
 'authent-local' => array (
 'password_validation.pattern' => '^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)(?=.*[^\da-zA-Z]).{8,}$',
 ),
);

禁用策略

如需禁用密码模式匹配策略，将正则表达式设为空字符串：

$MyModuleSettings = array(
 'authent-local' => array(
 'password_validation.pattern' => '',
 ),
);

自定义策略

如需应用自己的策略，只需编写相应的正则表达式。建议使用 regex101.com 测试正则表达式。

例如，强制密码长度在 6 到 15 个字符之间：

$MyModuleSettings = array(
 'authent-local' => array(
 'password_validation.pattern' => '.{6,15}',
 'password_validation.message' => array(
 'FR FR' => 'Le mot de passe doit faire en 6 et 15 caractères de long',
 'EN US' => 'Password length must be between 6 and 15 characters',
 ),
 ),
);

设置密码验证提示信息时，可以使用翻译键 Error:UserLocalPasswordValidator:UserPasswordPolicyRegex/ValidationFailed，或使用配置键 password_validation.message：

配置键优先级高于翻译键
可以是字符串或按语言分类的数组
如果使用数组，EN US 条目将作为用户语言未找到时的回退

其他策略

可以通过扩展引入其他密码策略。

密码过期

LocalUser 类新增了两个原生字段：expiration 和 password_renewed_date。

password_renewed_date 在密码更改时自动填充
expiration 标志允许定义过期规则

如需实现密码过期策略，请参考相关指南。

原文：https://www.itophub.io/wiki/page?id=3_2_0:admin:password-policy