宜信开源|漏洞管理平台『洞察』部署指南
2019-07-15 本文已影响3人
宜信技术学院
『洞察』是宜信安全部开发，集成应用系统资产管理、漏洞全生命周期管理、安全知识库管理三位一体的管理平台。
『洞察』使用了Python语言进行开发，利用Flask框架+MySQL+Docker部署实现。
一、部署和启动mysql
docker pull mysql:5.7.13
docker run -d -p 127.0.0.1:6606:3306 \
--name open_source_mysqldb \
-e MYSQL_ROOT_PASSWORD=root \
mysql:5.7.13
二、创建数据库和账号权限配置
$ mysql -h 127.0.0.1 -P 6606 -u root -p
Enter password:root
mysql> CREATE DATABASE IF NOT EXISTS vuldb DEFAULT CHARSET utf8 COLLATE utf8_general_ci;
mysql> grant all on vuldb.* to vuluser@'%' identified by 'vulpassword';
mysql> flush privileges;
mysql> quit
三、部署和启动APP
1、下载源码
$ git clone https://github.com/creditease-sec/insight.git
2、修改srcpm/config.py 配置文件
1）修改公司邮箱后缀
#公司邮箱后缀限制，只能使用公司邮箱注册账号。
CORP_MAIL = '@qq.com'
2）修改邮件CC抄送列表
#平台发送的每封邮件的邮件抄送列表，可以设置发送给安全部邮箱列表，可自行修改，也可以保持不变为空
'''
示例：
CC_EMAIL = ['xxx1@creditease.cn',
'xxx2@creditease.cn',
]
'''
CC_EMAIL = [
]
3）修改开发模式的邮箱服务器和发件邮箱配置
# 以开发模式的配置运行，使用测试邮件服务器，并开启debug模式
# 平台发邮件账号设置
SRCPM_MAIL_SENDER = '安全部 <sec_creditease@sina.com>'
# 发送邮件的服务器设置，邮箱密码由系统变量中读取
MAIL_SERVER = 'smtp.sina.com'
MAIL_PORT = 587
MAIL_USE_TLS = True
MAIL_USERNAME = os.environ.get(
'MAIL_USERNAME') or 'sec_creditease@sina.com'
MAIL_PASSWORD = os.environ.get('MAIL_PASSWORD') or ''
4）修改生产模式的邮箱服务器和发件邮箱配置
# 以生产模式的配置运行，使用生产邮件服务器，并关闭debug模式
# 平台发邮件账号设置
SRCPM_MAIL_SENDER = '安全部 <xxx@creditease.cn>'
# 发送邮件的服务器设置，账号密码由系统变量中读取
MAIL_SERVER = 'x.x.x.x'
MAIL_PORT = 25
MAIL_USE_TLS = False
MAIL_USERNAME = os.environ.get(
'MAIL_USERNAME') or 'xxx@creditease.cn'
MAIL_PASSWORD = os.environ.get('MAIL_PASSWORD') or ''
3、修改定时周期邮件 mail_sender.py 的配置
#平台发送的每封邮件的邮件抄送列表，可以设置发送给安全部邮箱列表，可自行修改，也可以保持不变为空
'''
示例：
CC_EMAIL = ['xxx1@creditease.cn',
'xxx2@creditease.cn',
]
'''
CC_EMAIL = [
]
#主机名设置
SERVER_NAME = 'xxx.creditease.corp'
# 平台发邮件账号设置
SRCPM_MAIL_SENDER = '安全部 <xxx@creditease.cn>'
# 发送邮件的服务器设置，账号密码由系统变量中读取
MAIL_SERVER = 'x.x.x.x'
MAIL_PORT = 25
MAIL_USE_TLS = False
MAIL_USERNAME = os.environ.get(
'MAIL_USERNAME') or 'xxx@creditease.cn'
MAIL_PASSWORD = os.environ.get('MAIL_PASSWORD') or ''
4、修改srcpm/app/src/forms.py 漏洞来源下拉列表
''' 下拉选项 '''
source_choices = [('',''), (u'安全部', u'安全部'), (u'YISRC', u'YISRC'), (u'公众平台', u'公众平台'), (u'合作伙伴', u'合作伙伴')]
5、在项目根目录下部署和启动APP
# 拉取镜像
docker pull daocloud.io/liusheng/vulpm_docker:latest
或
自己构建镜像
docker build -t='vulpm_docker' .
# 在项目目录下启动容器，确保当前目录下存在srcpm文件夹，MAIL_PASSOWRD替换为自己邮箱服务器的密码。
$ docker run -d -p 127.0.0.1:9000:5000 \
--link open_source_mysqldb:db \
--name open_source_srcpm \
-v $PWD/srcpm:/opt/webapp/srcpm \
-e DEV_DATABASE_URL='mysql://vuluser:vulpassword@db/vuldb' \
-e SrcPM_CONFIG=development \
-e MAIL_PASSWORD='xxxxxx' \
daocloud.io/liusheng/vulpm_docker:latest \
sh -c 'supervisord -c srcpm/supervisor.conf && supervisorctl -c srcpm/supervisor.conf start all && tail -f srcpm/log/gunicorn.err && tail -f srcpm/log/mail_sender.err'
四、初始化数据库
方法一：数据库初始化详细配置指南
说明
下面配置在泊坞窗容器中进行，进入搬运工容器命令：
# docker exec -it open_source_srcpm bash
# cd srcpm
数据库初始化详细配置
1）创建数据库表，添加超级管理员账号，账号为admin@admin.com，密码为11。
# python manage.py db init
# python manage.py db migrate
# python manage.py db upgrade
# python manage.py shell
>>> admin = LoginUser(username='admin', email='admin@admin.com', password_hash='pbkdf2:sha1:1000$bLXlzNNn$6f8a286571a361ca99ede2ca3b9163e346f8a3ca', role_name=u'\u8d85\u7ea7\u7ba1\u7406\u5458', confirmed=1)
>>> db.session.add(admin)
>>> db.session.commit()
>>> exit()
2）启动应用
# python manage.py runserver -h 0.0.0.0
3）使用超级管理员账号登录，并设置角色
角色分为：
- 安全管理员
- 安全人员
- 普通用户
增加角色页面URL：http：//127.0.0.1：9000/srcpm/admin/ role_add
并将【普通用户】设置为默认角色。
image
image
4) 设置不同角色的权限
不同角色的详细权限请见：
洞察权限分配一览表：https://github.com/creditease-sec/insight/blob/open-source/docs/permissions.md
角色权限修改方法为：选择角色对应的所有权限之后提交。
方法二：直接导入初始化的sql
导入sql
$ mysql -h127.0.0.1 -P6606 -uroot -p vuldb < srcpm/vuldb_init.sql
Enter password:root
五、访问洞察
5.1 主页
image
5.2 登录页面
http://127.0.0.1:9000/srcpm/auth/login
image
GitHub开源地址：https://github.com/creditease-sec/insight
内容来源：宜信技术学院
