系统安全-在用户登录过程中启用图形验证码-平台部署与配置-O2OA企业应用开发平台-人人都是协同系统开发专家

系统安全-在用户登录过程中启用图形验证码

时间：2023-03-06

内容导读

本篇说明在 O2OA 平台登录过程中启用图形验证码的设置方法。管理员通过系统菜单进入系统设置，在安全配置的登录项中开启图片验证码，等效于把配置文件中的相应开关改为开启状态，重启后登录页就会出现验证码输入框。文中还说明 Linux 环境下因缺少字体支持导致验证码图片异常的排查思路，以及安装字体组件后重启生效的解决办法，便于管理员在登录环节增加防护。

O2OA 平台默认未启用登录过程中的图片验证码，管理员可通过相关设置，要求用户登录时输入验证码，以提升登录安全性。本篇主要说明与登录验证码相关的配置。

一、先决条件：

1、O2Server 服务器正常运行，系统安装部署请参考文档《如何在服务器上安装部署 O2OA》

2、以拥有管理员权限的用户账号登录 O2OA 平台，如：xadmin

O2OA 平台默认的超级管理员账号为 xadmin，密码为 o2oa@2022。

为了确保信息安全，建议正式环境的服务器上，将 xadmin 密码修改为复杂密码。

二、设置过程说明

O2OA 平台自带图片验证码功能，默认处于关闭状态。开发者使用管理员权限登录后，在系统设置中启用相关功能即可完成配置。

1、使用管理员权限登录系统

可使用 xadmin 账号，或使用拥有 manager 角色的任意账号登录 O2OA。

2、进入系统设置

点击左上角的系统菜单，进入系统设置界面。

3、开启图片验证码

可以通过系统配置->；安全配置->；登录配置中启用图片验证码功能，如下图所示界面：

上述界面设置等价于直接修改配置文件 o2server/config/person.json 中的 captchaLogin 项，内容如下：

{
    "captchaLogin": true,
    "###captchaLogin": "是否启用图片验证码登录,默认值:false.###"
}

使用配置界面或配置文件修改完成后，需要重启 O2OA 让配置生效，再次访问系统登录页将增加图形验证码内容，如下图所示：

三、Linux 操作系统环境下的问题

在 Linux 环境下，验证码图片可能出现异常，下图中显示的验证码与常规样式有所不同：

此时在服务器日志中可以查看到以下警告：

原因分析：

原因在于 Linux 环境生成图片验证码需要切换字体，而系统尚未安装 fontconfig。为避免验证码异常导致无法登录，程序会自动切换到 mnist 手写图片进行验证，建议安装 fontconfig 以恢复常规验证码。

安装 fontconfig 解决问题

CentOS

yum install fontconfig

Ubuntu/Debian

sudo apt install fontconfig

安装完成后需重启 O2OA 使配置生效。

以上说明了在 O2OA 平台中启用图形验证码的方法，希望对您有所帮助。