ToolJet 密码重置实战指南用户自助重置与超级管理员重置全流程解析【免费下载链接】ToolJetOpen-source foundation of ToolJet AI - the enterprise app generation platform for internal tools, dashboards, business applications, workflows and AI agents. Build visually, from a prompt, or from Claude Code, Codex and Cursor over MCP 项目地址: https://gitcode.com/GitHub_Trending/to/ToolJet本文以 ToolJet 3.0.0-LTS 版本的用户管理功能为对象系统讲解在启用密码登录后用户如何通过「Forgot Password」自助重置密码以及实例超级管理员Super Admin如何在后台为用户重置密码的完整流程。文章将结合仓库中的前端页面实现与后端认证服务源码说明从邮箱校验、重置链接生成、Token 校验到密码规则校验的完整调用链帮助读者掌握 ToolJet 密码重置功能的操作步骤与底层原理。适用前提密码登录已启用ToolJet 支持多种登录认证方式包括各类 SSO / OAuth 登录。根据官方文档说明只有在该实例启用了「密码登录」Password Login时重置密码功能才可用。若实例配置了其他单点登录方式密码重置流程不适用用户应通过对应的 SSO 流程或联系超级管理员处理。当密码登录启用后用户可以通过两种途径重置密码用户自助重置由用户本人通过登录页的「Forgot Password」发起经邮箱收到重置链接后自行设置新密码超级管理员重置由实例的 Super Admin 在后台「All Users」页面中为指定用户直接重置密码。用户自助重置Forgot Password 完整流程第一步进入忘记密码页面在登录页面点击Forgot Password链接进入忘记密码界面。该界面由仓库中的 ForgotPasswordPage.jsx 实现页面上会展示「Forgot Password」标题、邮箱输入框与「Send a reset link」按钮同时提供「Create an account」注册入口。第二步提交注册邮箱在邮箱输入框中输入与账号关联的注册邮箱地址然后点击Send a reset link按钮。从前端实现看ForgotPasswordPage.jsx 在提交时会先通过validateEmail对邮箱格式做本地校验邮箱为空或格式非法时按钮处于禁用状态或直接提示Invalid Email。校验通过后前端调用authenticationService.forgotPassword(email)向后端发起请求请求成功页面弹出 toast 提示「Please check your email/inbox for the password reset link」并切换到发送成功的信息确认页ForgotPasswordInfoScreen请求失败展示服务端返回的错误信息如「Something went wrong, please try again」。第三步查收密码重置邮件提交邮箱后系统会向该邮箱发送一封密码重置邮件邮件中包含指向密码重置页面的链接。点击邮件中的链接即可进入密码重置页面。第四步设置新密码点击邮件链接进入密码重置页对应前端 ResetPasswordPage.jsx需要完成以下操作在New Password输入框中设置新密码在Re-enter the password输入框中再次输入确认密码点击Reset password按钮完成提交。密码校验规则与表单细节ResetPasswordPage.jsx 中实现了完整的前端密码校验逻辑可作为部署后的行为参考校验项规则界面反馈密码最小长度至少 5 个字符提示「Password should be at least 5 characters」密码最大长度最多 100 个字符提示「Password should be Max 100 characters」两次密码一致password与password_confirmation必须相同提示「Passwords dont match, please re-enter」可见性切换支持通过眼睛图标切换明文/密文显示—「Reset password」按钮的提交条件非常严格只要密码或确认密码不足 5 位、两次输入长度不一致、校验不通过或两次密码不相同按钮均处于禁用状态源码 L261-L269。提交成功后会弹出「Password reset successfully」提示并切换到成功页失败则展示服务端返回的错误。前端调用链从表单到 API前端所有认证请求统一封装在 authentication.service.js 中与密码重置相关的接口如下前端方法HTTP 方法端点请求体/参数forgotPassword(email, redirectTo, orgSlug)POST/forgot-password{ email, redirectTo?, orgSlug? }resetPassword({ token, password })POST/reset-password{ token, password }verifyResetToken(token)GET/reset-password/verify-token?token...查询参数tokenpasswordExpiredReset(email, redirectTo, orgSlug)POST/password-expired-reset{ email, redirectTo?, orgSlug? }其中forgotPassword额外支持可选的redirectTo重置完成后的跳转地址与orgSlug组织标识参数用于多组织部署场景下的定制跳转。在服务端这些端点由 auth/controller.ts 注册并分别挂接了对应的功能开关FEATURE_KEY.FORGOT_PASSWORD、FEATURE_KEY.RESET_PASSWORD、FEATURE_KEY.VERIFY_RESET_TOKEN、FEATURE_KEY.PASSWORD_EXPIRED_RESET这些枚举定义在 auth/constants/index.ts说明该实例可以按需开启/关闭密码重置相关能力。服务端实现Token 的生成、校验与过期服务端核心逻辑位于 auth/service.ts理解这几段实现有助于排查线上重置链接失效等问题。forgotPassword生成一次性 Token 并发送邮件forgotPassword(email, redirectTo?, orgSlug?)方法源码 L286-L321的执行顺序为按邮箱查找用户若用户不存在直接静默返回而不抛出错误这是为了防止恶意请求通过接口响应差异枚举已注册邮箱防用户名枚举漏洞若用户状态为ARCHIVED已归档则抛出异常提示「You have been archived from this instance...」生成一个uuid.v4()作为一次性重置令牌forgotPasswordToken并根据环境变量LINK_EXPIRY_MINUTES计算令牌过期时间forgotPasswordTokenExpiry将令牌与过期时间写入用户记录通过eventEmitter触发EMAIL_EVENTS.SEND_PASSWORD_RESET_EMAIL邮件事件事件类型定义见 email/constants/index.ts由邮件服务发送包含令牌的重置邮件。resetPassword校验令牌并更新密码resetPassword(token, password)方法源码 L235-L284的执行顺序为服务端再次调用validatePasswordServer(password)校验密码强度前端校验不能替代服务端校验优先按forgotPasswordToken查找用户若未命中则回退按expiredPasswordToken查找——后者对应「密码过期强制重置」流程该流程的链接不设过期时间两种令牌都未命中时抛出NotFoundExceptionInvalid Reset Password URL. Please ensure you have the correct URL for resetting your password.若属于常规忘记密码流程且令牌已过期抛出GoneExceptionReset password link has expired. Please request a new one.若属于密码过期流程还会额外校验新密码不能与当前密码相同通过 bcrypt 比较根据环境变量PASSWORD_EXPIRY_DAYS计算新的密码过期时间并写入用户记录同时清空令牌、重置passwordRetryCount登录重试计数。verifyResetToken链接有效性预检verifyResetToken(token)方法源码 L323-L335用于在用户提交新密码前预检链接是否有效若对应forgotPasswordToken存在且未过期返回{ valid: true }若已过期则返回{ valid: false, reason: expired }若命中expiredPasswordToken则直接视为有效。超级管理员重置密码当用户忘记密码、或因其他原因需要由管理员代为更新密码时实例的 Super Admin 可以在后台直接为用户重置密码。操作步骤点击工作台Dashboard左下角的设置图标⚙️进入Settings All Users页面示例 URLhttps://app.corp.com/instance-settings/all-users在用户列表中找到需要重置密码的用户点击该用户姓名右侧的kebab 菜单三个点图标在下拉菜单中选择Reset Password。两种密码生成方式点击「Reset Password」后会弹出重置密码弹窗提供两种选项a. Automatically Generate Password自动生成密码选择该选项后系统会自动生成一个新密码通常为随机强密码适用于管理员不关心具体密码内容、只需让用户尽快重新登录的场景b. Create Password创建密码选择该选项后Super Admin 可以为用户手动指定一个新密码适用于需要按既定密码策略或约定设置密码的场景。相关环境变量与运维建议密码重置流程的行为受以下两个环境变量影响读取逻辑见 auth/service.ts环境变量作用说明LINK_EXPIRY_MINUTES控制忘记密码重置链接的有效期分钟取值为正数时生效重置链接将在指定分钟后过期未配置或为 0 时链接不设过期时间PASSWORD_EXPIRY_DAYS控制密码过期天数取值为正数时重置后的新密码将在指定天数后过期届时触发「密码过期重置」流程未配置或为 0 时密码永不过期此外发送密码重置邮件依赖实例已正确配置 SMTP 邮件服务。若未配置邮件发送能力用户将无法收到重置链接此时应优先通过超级管理员重置途径处理。常见问题与排错收到「Invalid Reset Password URL」链接中的令牌在数据库中不存在或已被使用。原因通常是链接被重复点击令牌在首次成功后已被清空请重新发起「Forgot Password」获取新链接。收到「Reset password link has expired」令牌已超过LINK_EXPIRY_MINUTES设定的有效期重新发起请求即可。提交新密码后提示不匹配两次输入必须完全一致且满足 5~100 字符的长度要求服务端还会执行二次密码强度校验。忘记密码页面提交后没有任何提示这是服务端的防用户枚举设计用户不存在时静默返回此时请确认邮箱是否与账号注册邮箱完全一致。无法自行重置若实例未启用密码登录或用户已被归档ARCHIVED则无法自助重置请联系 Super Admin 处理。以上流程与源码逻辑均可在仓库对应位置验证前端页面见 ForgotPasswordPage.jsx 与 ResetPasswordPage.jsx服务端实现见 auth/service.ts 与 auth/controller.ts。【免费下载链接】ToolJetOpen-source foundation of ToolJet AI - the enterprise app generation platform for internal tools, dashboards, business applications, workflows and AI agents. Build visually, from a prompt, or from Claude Code, Codex and Cursor over MCP 项目地址: https://gitcode.com/GitHub_Trending/to/ToolJet创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 ToolJet 密码重置实战指南：用户自助重置与超级管理员重置全流程解析
ToolJet 密码重置实战指南用户自助重置与超级管理员重置全流程解析【免费下载链接】ToolJetOpen-source foundation of ToolJet AI - the enterprise app generation platform for internal tools, dashboards, business applications, workflows and AI agents. Build visually, from a prompt, or from Claude Code, Codex and Cursor over MCP 项目地址: https://gitcode.com/GitHub_Trending/to/ToolJet本文以 ToolJet 3.0.0-LTS 版本的用户管理功能为对象系统讲解在启用密码登录后用户如何通过「Forgot Password」自助重置密码以及实例超级管理员Super Admin如何在后台为用户重置密码的完整流程。文章将结合仓库中的前端页面实现与后端认证服务源码说明从邮箱校验、重置链接生成、Token 校验到密码规则校验的完整调用链帮助读者掌握 ToolJet 密码重置功能的操作步骤与底层原理。适用前提密码登录已启用ToolJet 支持多种登录认证方式包括各类 SSO / OAuth 登录。根据官方文档说明只有在该实例启用了「密码登录」Password Login时重置密码功能才可用。若实例配置了其他单点登录方式密码重置流程不适用用户应通过对应的 SSO 流程或联系超级管理员处理。当密码登录启用后用户可以通过两种途径重置密码用户自助重置由用户本人通过登录页的「Forgot Password」发起经邮箱收到重置链接后自行设置新密码超级管理员重置由实例的 Super Admin 在后台「All Users」页面中为指定用户直接重置密码。用户自助重置Forgot Password 完整流程第一步进入忘记密码页面在登录页面点击Forgot Password链接进入忘记密码界面。该界面由仓库中的 ForgotPasswordPage.jsx 实现页面上会展示「Forgot Password」标题、邮箱输入框与「Send a reset link」按钮同时提供「Create an account」注册入口。第二步提交注册邮箱在邮箱输入框中输入与账号关联的注册邮箱地址然后点击Send a reset link按钮。从前端实现看ForgotPasswordPage.jsx 在提交时会先通过validateEmail对邮箱格式做本地校验邮箱为空或格式非法时按钮处于禁用状态或直接提示Invalid Email。校验通过后前端调用authenticationService.forgotPassword(email)向后端发起请求请求成功页面弹出 toast 提示「Please check your email/inbox for the password reset link」并切换到发送成功的信息确认页ForgotPasswordInfoScreen请求失败展示服务端返回的错误信息如「Something went wrong, please try again」。第三步查收密码重置邮件提交邮箱后系统会向该邮箱发送一封密码重置邮件邮件中包含指向密码重置页面的链接。点击邮件中的链接即可进入密码重置页面。第四步设置新密码点击邮件链接进入密码重置页对应前端 ResetPasswordPage.jsx需要完成以下操作在New Password输入框中设置新密码在Re-enter the password输入框中再次输入确认密码点击Reset password按钮完成提交。密码校验规则与表单细节ResetPasswordPage.jsx 中实现了完整的前端密码校验逻辑可作为部署后的行为参考校验项规则界面反馈密码最小长度至少 5 个字符提示「Password should be at least 5 characters」密码最大长度最多 100 个字符提示「Password should be Max 100 characters」两次密码一致password与password_confirmation必须相同提示「Passwords dont match, please re-enter」可见性切换支持通过眼睛图标切换明文/密文显示—「Reset password」按钮的提交条件非常严格只要密码或确认密码不足 5 位、两次输入长度不一致、校验不通过或两次密码不相同按钮均处于禁用状态源码 L261-L269。提交成功后会弹出「Password reset successfully」提示并切换到成功页失败则展示服务端返回的错误。前端调用链从表单到 API前端所有认证请求统一封装在 authentication.service.js 中与密码重置相关的接口如下前端方法HTTP 方法端点请求体/参数forgotPassword(email, redirectTo, orgSlug)POST/forgot-password{ email, redirectTo?, orgSlug? }resetPassword({ token, password })POST/reset-password{ token, password }verifyResetToken(token)GET/reset-password/verify-token?token...查询参数tokenpasswordExpiredReset(email, redirectTo, orgSlug)POST/password-expired-reset{ email, redirectTo?, orgSlug? }其中forgotPassword额外支持可选的redirectTo重置完成后的跳转地址与orgSlug组织标识参数用于多组织部署场景下的定制跳转。在服务端这些端点由 auth/controller.ts 注册并分别挂接了对应的功能开关FEATURE_KEY.FORGOT_PASSWORD、FEATURE_KEY.RESET_PASSWORD、FEATURE_KEY.VERIFY_RESET_TOKEN、FEATURE_KEY.PASSWORD_EXPIRED_RESET这些枚举定义在 auth/constants/index.ts说明该实例可以按需开启/关闭密码重置相关能力。服务端实现Token 的生成、校验与过期服务端核心逻辑位于 auth/service.ts理解这几段实现有助于排查线上重置链接失效等问题。forgotPassword生成一次性 Token 并发送邮件forgotPassword(email, redirectTo?, orgSlug?)方法源码 L286-L321的执行顺序为按邮箱查找用户若用户不存在直接静默返回而不抛出错误这是为了防止恶意请求通过接口响应差异枚举已注册邮箱防用户名枚举漏洞若用户状态为ARCHIVED已归档则抛出异常提示「You have been archived from this instance...」生成一个uuid.v4()作为一次性重置令牌forgotPasswordToken并根据环境变量LINK_EXPIRY_MINUTES计算令牌过期时间forgotPasswordTokenExpiry将令牌与过期时间写入用户记录通过eventEmitter触发EMAIL_EVENTS.SEND_PASSWORD_RESET_EMAIL邮件事件事件类型定义见 email/constants/index.ts由邮件服务发送包含令牌的重置邮件。resetPassword校验令牌并更新密码resetPassword(token, password)方法源码 L235-L284的执行顺序为服务端再次调用validatePasswordServer(password)校验密码强度前端校验不能替代服务端校验优先按forgotPasswordToken查找用户若未命中则回退按expiredPasswordToken查找——后者对应「密码过期强制重置」流程该流程的链接不设过期时间两种令牌都未命中时抛出NotFoundExceptionInvalid Reset Password URL. Please ensure you have the correct URL for resetting your password.若属于常规忘记密码流程且令牌已过期抛出GoneExceptionReset password link has expired. Please request a new one.若属于密码过期流程还会额外校验新密码不能与当前密码相同通过 bcrypt 比较根据环境变量PASSWORD_EXPIRY_DAYS计算新的密码过期时间并写入用户记录同时清空令牌、重置passwordRetryCount登录重试计数。verifyResetToken链接有效性预检verifyResetToken(token)方法源码 L323-L335用于在用户提交新密码前预检链接是否有效若对应forgotPasswordToken存在且未过期返回{ valid: true }若已过期则返回{ valid: false, reason: expired }若命中expiredPasswordToken则直接视为有效。超级管理员重置密码当用户忘记密码、或因其他原因需要由管理员代为更新密码时实例的 Super Admin 可以在后台直接为用户重置密码。操作步骤点击工作台Dashboard左下角的设置图标⚙️进入Settings All Users页面示例 URLhttps://app.corp.com/instance-settings/all-users在用户列表中找到需要重置密码的用户点击该用户姓名右侧的kebab 菜单三个点图标在下拉菜单中选择Reset Password。两种密码生成方式点击「Reset Password」后会弹出重置密码弹窗提供两种选项a. Automatically Generate Password自动生成密码选择该选项后系统会自动生成一个新密码通常为随机强密码适用于管理员不关心具体密码内容、只需让用户尽快重新登录的场景b. Create Password创建密码选择该选项后Super Admin 可以为用户手动指定一个新密码适用于需要按既定密码策略或约定设置密码的场景。相关环境变量与运维建议密码重置流程的行为受以下两个环境变量影响读取逻辑见 auth/service.ts环境变量作用说明LINK_EXPIRY_MINUTES控制忘记密码重置链接的有效期分钟取值为正数时生效重置链接将在指定分钟后过期未配置或为 0 时链接不设过期时间PASSWORD_EXPIRY_DAYS控制密码过期天数取值为正数时重置后的新密码将在指定天数后过期届时触发「密码过期重置」流程未配置或为 0 时密码永不过期此外发送密码重置邮件依赖实例已正确配置 SMTP 邮件服务。若未配置邮件发送能力用户将无法收到重置链接此时应优先通过超级管理员重置途径处理。常见问题与排错收到「Invalid Reset Password URL」链接中的令牌在数据库中不存在或已被使用。原因通常是链接被重复点击令牌在首次成功后已被清空请重新发起「Forgot Password」获取新链接。收到「Reset password link has expired」令牌已超过LINK_EXPIRY_MINUTES设定的有效期重新发起请求即可。提交新密码后提示不匹配两次输入必须完全一致且满足 5~100 字符的长度要求服务端还会执行二次密码强度校验。忘记密码页面提交后没有任何提示这是服务端的防用户枚举设计用户不存在时静默返回此时请确认邮箱是否与账号注册邮箱完全一致。无法自行重置若实例未启用密码登录或用户已被归档ARCHIVED则无法自助重置请联系 Super Admin 处理。以上流程与源码逻辑均可在仓库对应位置验证前端页面见 ForgotPasswordPage.jsx 与 ResetPasswordPage.jsx服务端实现见 auth/service.ts 与 auth/controller.ts。【免费下载链接】ToolJetOpen-source foundation of ToolJet AI - the enterprise app generation platform for internal tools, dashboards, business applications, workflows and AI agents. Build visually, from a prompt, or from Claude Code, Codex and Cursor over MCP 项目地址: https://gitcode.com/GitHub_Trending/to/ToolJet创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考