WebcatEE 用户接入

本文档描述如何接入应用方自己的用户系统；

1. 修改web.xml, 将自定义的URL加入到SessionFilter的excludes参数中；
2. 应用方将开发好的登录程序放置到应用目录并调试可用；
3. 登录管理后台 - 安全设置，将登录方式修改为自定义，登录URL改为自己的登录地址；

如何用户接入

1. 开发自己的登录页面，并且调用应用方自己的登录逻辑；

2. 在用户登录成功之后调用如下代码，将登录态写入到webcat系统；

# UserUtil.login方法将会做以下两件事情：
# 1. 将user的数据同步到webcat的用户系统中；根据userName检查是否已经存在，如果不存在则创建，否则更新；
# 2. 将用户登录态写入会话中；
UserUtil.login(HttpServletRequest request, HttpServletResponse response, User user);

其中，user必须包含userName, nickName, userMail, password这四个属性；userName, nickName要求全局唯一；

如果不希望webcat记录用户的密码，可生成一个随机串，如果以后需要再改为默认的登录方式，可通过管理后台修改用户密码；

LDAP登录

注意事项：在设置为LDAP登录之前，请先在 webcat 系统中创建其他的系统管理员帐号；因为一些LDAP服务器可能不允许创建名为 admin 的账号, 而 WebcatEE 默认的系统管理员帐号是 admin;

一旦启用 LDAP 登录，而LDAP服务器又无法创建 admin 用户，将导致无法再登录到 webcat 的管理后台；

当出现任何需要回退到默认登录方式的情况时，可以通过手动修改配置文件的方式回退到默认的登录方式；

# ~/WEB-INF/webcat/webcat.conf
# 1: 默认登录方式; 2: LDAP登录; 3: 自定义登录
webcat.login.type = 1