前言

这次发布的版本适合企业使用，兼容堡垒机、LDAP等，目前只支持linux，等哪天有时间在完善windows。适用于云服务器等场景，部署及使用简单方便。同时可做为主机IDS的补充防护,主机IDS毕竟是事中事后防护，JXOTP可以做为事前防护提高服务器的整体安全性。

回顾本系列的第一篇文章：

开源SSH双因素登陆认证系统JXOTP了解一下

部署

服务端部署：

# git clone https://github.com/jx-sec/jxotp.git
# cd jxotp
# pip install -r requirements.txt
# vim jxotp/settings.py

直接拉到最下面：

# 邮件设置 这里以阿里邮箱为例子
EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
EMAIL_USE_TLS = False
EMAIL_HOST = 'smtp.mxhichina.com' #非阿里邮箱需修改
EMAIL_PORT = 25
EMAIL_HOST_USER = 'security@jxwaf.com' # 用户名
EMAIL_HOST_PASSWORD = '*' #密码
DEFAULT_FROM_EMAIL = 'security@jxwaf.com' #同用户名

# login setup
USERNAME = 'admin' # 服务端登陆用户名
PASSWORD = '123456' # 服务端登陆密码
OTP_SECRET_KEY = 'hellojxotp' # OTP客户端与服务端对接的密钥

接下来初使化数据库,启动服务端 PS:例子为非正式部署,需正式部署请使用uwsgi+nginx：

# python manage.py makemigrations
# python manage.py migrate
# python manage.py runserver 0.0.0.0:8000

服务端部署结束。

客户端部署：

# vim jxotp_auth.py

只需修改两个参数的配置：

SERVER_API_URL = "http://1.1.1.1:8000/otp_auth"

OTP_SECRET_KEY = "hellojxotp"

其中 SERVER_API_URL 为你部署服务器的地址,如你服务器地址为 52.163.121.204,则这块应设置为http://52.163.121.204:8000/otp_auth

OTP_SECRET_KEY 为OTP客户端与服务端对接的密钥,需与服务端一致

# setenforce 0 
# sh install_jxotp.sh
# vim /etc/pam.d/sshd

在最顶行添加：

auth optional pam_python.so jxotp_auth.py

到这里客户端和服务端就全部部署完了。

架构及使用说明

架构说明

一旦网络中断或者服务器异常,服务器的OTP验证将自动转为bypass模式,回归密码验证。默认服务端OTP验证为偏移3次，也就是说当前时间两分钟内的OTP验证码都有效，提高易用性。

客户端OTP验证为独立验证，所以不与LDAP等验证冲突，验证失败会将密码重置为空，导致密码验证失败(服务器密码要是为空算你厉害)。

可通过配置服务器验证将堡垒机IP加入白名单，即兼容堡垒机。

可开启防暴力破解功能,例如OTP验证错误超过10次,锁定客户端IP三十分钟,并邮件报警,可针对特定用户开启,也可设置特定IP开启,总之就是灵活,满足大部分应用场景。

使用说明

1、用户管理

新建用户后点击发送邮件：

2、全局设置

default_enable 是否开启服务器自动注册：

默认为true,当有客户端访问JXOTP SERVER时,自动注册,无需管理员手动添加。

default_global_check 是否开启所有用户检测：

默认为false,当值为true时,所有登录的用户都需要进行OTP检验,为false时,仅设置了default_check_user的用户会开启OTP检验。

default_check_user 默认值为root：

当default_global_check为true时生效(不要在意为啥false时不屏蔽该选项),设置需要开启OTP检验的系统用户名

default_white_ip 默认值为false：

当需要设置白名单IP或者已使用堡垒机时,可将相应IP添加进去,中间用逗号(,)隔开,如白名单IP为1.1.1.1,堡垒机IP为2.2.2.2,则值为 1.1.1.1,2.2.2.2。

black_check 默认值为false：

是否开启防暴力破解功能,默认为false,关闭状态。

black_check_time 默认值为5：

暴力破解功能检测时间,单位为分钟,5即检测5分钟内暴力破解的攻击次数。

black_check_count 默认值为 10：

OTP失败次数,10即失败10次开启防暴力破解功能。

black_deny_time 默认值为 720：

检测到暴力破解攻击后封禁IP的时间,单位为分钟,720即封禁IP 12小时。

black_send_email 默认值为 ?：

检测到暴力破解攻击后告警邮箱。

3、服务器管理

自定义设置会覆盖全局配置，其他同全局配置，可手动添加需要开启OTP功能的服务器，也可在全局配置开启default_enable选项,即自动注册服务器。

4、查看日志

Server ip 服务器IP；

Client ip 客户端IP；

Result OTP校验结果；

Message 详细信息；

Check user 登录的系统用户名；

time 登录校验的时间；

User email 登录用户(OTP用户,非服务器系统用户)。

总结

支线任务完结撒花，JXWAF恢复更新。

*本文作者：chenjc，转载请注明来自FreeBuf.COM