DzzOffice 小胡版 AD与LDAP账户认证插件

# DzzOffice 小胡版 AD与LDAP账户认证插件 ## DzzOffice 小胡团队:https://gitee.com/xiaohu2024 ### 介绍 DzzOffice通过集成AD/LDAP插件，实现了用户信息的自动同步和身份验证功能。用户能够使用他们在Active Directory（AD）或Lightweight Directory Access Protocol（LDAP）中的账户和密码直接登录DzzOffice，无需在DzzOffice系统中单独创建账户，从而提高了登录的便捷性和安全性。 ### 原理与流程： #### 1. 用户登录请求： 用户在DzzOffice的登录界面输入其AD/LDAP账户的用户名和密码，并提交登录请求。 #### 2. 后台验证启动： DzzOffice接收到登录请求后，自动调用已安装并配置好的AD/LDAP插件进行身份验证。 #### 3. AD/LDAP验证过程： AD/LDAP插件将用户输入的账号和密码发送到配置的AD/LDAP服务器进行验证。 验证过程基于管理员在插件配置中指定的用户字段（如用户名）进行，检查用户输入的账号和密码是否与AD/LDAP服务器中存储的信息相匹配。 #### 4. 验证成功处理： DzzOffice查询系统内部是否存在与输入账号（用户名、邮箱、手机号三选一）相匹配的用户。 如果用户已存在，则同步更新用户信息（如用户名、邮箱等），并允许用户登录。 如果用户不存在，则自动创建新用户账号，并尝试从AD/LDAP中获取邮箱信息作为注册信息；若AD/LDAP中无邮箱信息，则使用插件预设的邮箱后缀随机生成邮箱地址进行注册。注册成功后，用户自动登录。 #### 5. 登录结果反馈： 如果整个验证和登录流程成功完成，用户将被成功登录到DzzOffice系统中。 如果在验证、同步、注册或登录过程中的任何一步失败，AD/LDAP插件将终止验证登录流程，由Dzz系统进行下一个验证登录流程。 #### 6. 日志记录： DzzOffice会记录整个登录验证过程中的关键信息（如验证结果、同步状态、注册结果等）到系统日志中，以便管理员进行监控和故障排查。 ### 总结： DzzOffice的AD/LDAP插件通过集成AD/LDAP服务器，实现了用户信息的自动同步和身份验证功能，简化了用户登录流程，提高了系统的便捷性和安全性。同时，通过详细的日志记录功能，帮助管理员更好地监控和维护系统。 #### DzzOffice 小胡版安装和升级插件说明（详细教程请在DzzOffice 笔记中查看）： 1. 下载并解压插件后，请将解压后的插件文件夹以"LDAP"命名的方式放置在网站的"dzz"目录下（若该目录下已存在同名文件夹，请先删除原文件夹后再放置新文件夹）。 2. 升级的用户在系统工具中清理缓存即可; 3. 对于首次安装的用户，请在应用市场右下角选择“导入”功能，然后选择要导入的文件，即文件夹下的“dzz_app_LDAP.xml”。选择文件后点击“提交”按钮完成安装。 请严格按照上述步骤操作，以确保插件能够正确安装和升级。如在操作过程中遇到任何问题，请访问团队主页或查阅DzzOffice 笔记以获取更多帮助。 #### Issues 如您在使用中遇到问题，可以优先在常见问题中查找。仍无法解决，可以向我们提交Issues。 #### 参与贡献 1. Fork 本仓库 2. 新建 Feat_xxx 分支 3. 提交代码 4. 新建 Pull Request #### 常见问题 其他相关内容，如关于DzzOffice的开发与二次开发，技术交流与分享，教程与问题解答，以及开发手册和文档等方面的内容在团队主页中查看