securetea 1.5.1

owasp securetea工具项目

用户指南

请阅读《开发人员指南》此处

简介

owasp securetea项目是一个应用程序，旨在帮助使用物联网（iot）保护个人的笔记本电脑或计算机/服务器，并在用户访问其计算机/服务器时（通过各种通信机制）通知用户。此应用程序使用触摸板/鼠标/无线鼠标来确定活动，使用python开发，并在各种计算机（linux、mac&windows）上进行测试。
该软件仍在开发中，最终将拥有自己的ids（入侵检测系统）/ips（入侵预防系统）、防火墙、防病毒、智能日志监控功能和web破坏检测，并支持更多的通信媒体。

安装

内容：

• 先决条件
• 安装步骤
• 安装后

先决条件

支持的平台

owasp securetea工具项目运行在linux、windows和macos操作系统上。它与Python2和Python3都兼容。

硬件

• linux操作系统/树莓pi-在终端/控制台上有sudo访问权限
• 鼠标/无线鼠标/触摸板先天性笔记本电脑

软件

• python 2.x或3.x
• 角度
• Twitter帐户（可选）
• 电报帐户（可选）
• 空闲帐户（可选）
• Twilio短信帐户（可选）
• 亚马逊网络服务帐户（可选）
• libnetfilter

安装先决条件

巨蟒：
https://www.python.org/

角度：
https://angular.io/

libnetfilter:
https://www.netfilter.org/projects/libnetfilter_queue/

sudo apt-get update
sudo apt-get install build-essential python-dev libnetfilter-queue-dev

雅拉：
https://yara.readthedocs.io/en/v3.7.0/gettingstarted.html

1. 下载最新的yara版本：https://github.com/virustotal/yara/releases" rel="nofollow">https://github.com/virustotal/yara/releases
2. 按顺序执行以下指令：
< > >

tar -zxf yara-3.10.0.tar.gz
cd yara-3.10.0
./bootstrap.sh
sudo apt-get install automake libtool make gcc
sudo apt-get install flex bison
./configure
make
sudo make install
make check

蛤蜊AV:
https://www.clamav.net/

1. 按顺序执行以下指令：
< > >

sudo apt-get install clamav
sudo freshclam

安装步骤

您可以使用以下方法安装owasp securetea工具：

• PYPI
• Github
拉普

设置虚拟环境

1. 安装virtualenv
   pip安装virtualenv
   
2. 创建名为venv1的虚拟环境 virtualenv venv1

3. 激活虚拟环境venv1
源venv1/bin/激活

< > >

pypi

您可以从PYPI软件包管理器安装SecureTea

pip安装securetea

如果失败，请确保安装了所有依赖项。

Github

从github安装包括以下步骤：

1. 克隆存储库
   git克隆https://github.com/owasp/securetea project.git
   
2. 导航到项目目录
   cd securetea项目
   
3. 安装securetea包
   sudo python setup.py安装
   
4. 安装python依赖项
   pip install-r requirements.txt
   
< > >

如果完成，请在安装后继续。

拉链

从ZIP安装包括以下步骤：

1. 下载zip
2. 使用：解压缩master.zip
3. 导航到项目目录
   cd securetea项目
   
4. 安装securetea包
   sudo python setup.py安装
   
5. 安装python依赖项
   pip install-r requirements.txt
   或 pip3 install-r requirements.txt
   提示：如果在安装过程中出现任何错误，请尝试使用apt get install build essential python dev libnetfilter queue dev来解决该错误。
< > >

如果完成，请在安装后继续。

安装后

配置SecureTea

使用文本编辑器编辑配置

默认配置：

{"twitter":{"api_key":"XXXX","api_secret_key":"XXXX","access_token":"XXXX","access_token_secret":"XXXX"},"telegram":{"token":"XXXX","user_id":"XXXX"},"twilio":{"twilio_sid":"XXXX","twilio_token":"XXXX","twilio_from":"XXXX","twilio_to":"XXXX"},"slack":{"token":"XXXX","user_id":"XXXX"},"aws_ses":{"aws_email":"XXXX","aws_access_key":"XXXX","aws_secret_key":"XXXX"},"gmail":{"sender_email":"XXXX","to_email":"XXXX","password":"XXXX"},"firewall":{"interface":"","inbound_IPRule":{"action":"0","ip_inbound":""},"outbound_IPRule":{"action":"0","ip_outbound":""},"protocolRule":{"action":"0","protocols":"ICMP"},"scanLoad":{"action":"0","extensions":".exe"},"source_portRule":{"action":"0","sports":""},"dest_portRule":{"action":"0","dports":""},"HTTPRequest":{"action":"0"},"HTTPResponse":{"action":"0"},"DNSRule":{"action":"0","dns":""},"time":{"time_lb":"00:00","time_ub":"23:59"}},"insecure_headers":{"url":""},"ids":{"threshold":10,"interface":"XXXX"},"server_log":{"log_type":"","log_file":"","window":"30","ip_list":"","status_code":""},"auto-server-patcher":{"url":"XXXX","apache":"1","sysctl":"1","login":"1","ssh":"1"},"antivirus":{"update":"1","custom-scan":"","auto-delete":"0","monitor-usb":"1","monitor-file-changes":"1","virustotal-api-key":"XXXX"},"web-deface":{"path":"","server-name":""},"iot-check":{"shodan-api-key":"XXXX","ip":""},"debug":false}

使用gedit


gedit securetea.conf

使用vim


vi securetea.conf

使用交互式设置模式配置

设置所有功能

1. 无需任何参数即可启动securetea：
   sudo securetea.py
   这将启动交互式设置模式，要跳过特定设置，请输入s或s。
   
   
   
< > >

设置特定功能

参数列表

--telegram     Start Telegram interactive setup
--twitter      Start Twitter interactive setup
--twilio_sms   Start Twilio SMS interactive setup
--firewall     Start Firewall interactive setup
--aws_ses      Start Amazon Web Services(AWS-Simple Email Services) interactive setup
--gmail        Start G-Mail interactive setup

示例：


• 正在启动SecureTea防火墙交互设置：sudo securetea.py--firewall
  
  
  

使用Web UI配置

这仍在开发中。


BR/>
BR/>
BR/>

使用cli参数配置

usage: SecureTea.py [-h] [--conf CONF] [--debug] [--twitter] [--twilio_sms]
                    [--telegram] [--gmail] [--slack] [--aws_ses]
                    [--twitter_api_key TWITTER_API_KEY]
                    [--twitter_api_secret_key TWITTER_API_SECRET_KEY]
                    [--twitter_access_token TWITTER_ACCESS_TOKEN]
                    [--twitter_access_token_secret TWITTER_ACCESS_TOKEN_SECRET]
                    [--telegram_bot_token TELEGRAM_BOT_TOKEN]
                    [--telegram_user_id TELEGRAM_USER_ID]
                    [--twilio_sid TWILIO_SID] [--twilio_token TWILIO_TOKEN]
                    [--twilio_from TWILIO_FROM] [--twilio_to TWILIO_TO]
                    [--slack_token SLACK_TOKEN]
                    [--slack_user_id SLACK_USER_ID]
                    [--sender_email SENDER_EMAIL] [--to_email TO_EMAIL]
                    [--password PASSWORD] [--aws_email AWS_EMAIL]
                    [--aws_secret_key AWS_SECRET_KEY]
                    [--aws_access_key AWS_ACCESS_KEY] [--firewall]
                    [--interface INTERFACE]
                    [--inbound_IP_action INBOUND_IP_ACTION]
                    [--inbound_IP_list INBOUND_IP_LIST]
                    [--outbound_IP_action OUTBOUND_IP_ACTION]
                    [--outbound_IP_list OUTBOUND_IP_LIST]
                    [--protocol_action PROTOCOL_ACTION]
                    [--protocol_list PROTOCOL_LIST]
                    [--scan_action SCAN_ACTION] [--scan_list SCAN_LIST]
                    [--dest_port_action DEST_PORT_ACTION]
                    [--dest_port_list DEST_PORT_LIST]
                    [--source_port_action SOURCE_PORT_ACTION]
                    [--source_port_list SOURCE_PORT_LIST]
                    [--HTTP_request_action HTTP_REQUEST_ACTION]
                    [--HTTP_response_action HTTP_RESPONSE_ACTION]
                    [--dns_action DNS_ACTION] [--dns_list DNS_LIST]
                    [--time_lb TIME_LB] [--time_ub TIME_UB]
                    [--insecure_headers] [--url URL] [--ids]
                    [--threshold THRESHOLD] [--system_log] [--server_log]
                    [--log_file LOG_FILE] [--log_type LOG_TYPE]
                    [--window WINDOW] [--ip_list IP_LIST]
                    [--status-code STATUS_CODE] [--auto-server-patcher]
                    [--ssh] [--sysctl] [--login] [--apache] [--ssl]	
		    [--antivirus] [--update UPDATE]
                    [--custom-scan CUSTOM_SCAN] [--auto-delete]
                    [--monitor-usb] [--monitor-file-changes]
                    [--virustotal-api-key]
                    [--web-deface] [--path PATH] [--server-name SERVER_NAME]	
		    [--iot-checker][--shodan-api-key SHODAN_API_KEY] [--ip IP]		    

示例用法：

• 配置松弛：sudo securetea.py--slack_user_id<；your data>；--slack_token<；your data>；
  
  
  

设置Web用户界面

按照以下步骤设置Web UI

1. CD图形用户界面
2. npm安装
3. ng发球
4. sudo python monitor.py
5. 访问http://localhost:4200 rel="nofollow">http://localhost:4200查看项目，终点是http://localhost:5000 rel="nofollow">http://localhost:5000
< > >

获取令牌

为了使用各种通信媒介，您需要从相应的提供商处获得一个经过验证的令牌。

获取Twitter代币

• 访问https://apps.twitter.com
• 创建新应用程序以获取身份验证和令牌代码。

获取松弛令牌

• 访问https://api.slack.com/apps/new" rel="nofollow">https://api.slack.com/apps/new并创建一个新的机器人应用程序。
• 在机器人应用程序设置中，通过启用事件来设置事件订阅。
• 在需要的工作区中安装机器人应用程序。
• 获取"bot用户oauth访问令牌"，它以xoxb-
开头
• 获取特定工作区的用户ID。

获取电报令牌

• 访问https://core.telegram.org/bots bot父" rel="nofollow">https://core.telegram.org/bots bot父&；按照步骤获取Telegram令牌和用户ID。

获取twilio短信代币

• 访问https://www.twilio.com并点击"获取免费的api密钥"。

获取AWS-SES令牌

• 注册awshttps://aws.amazon.com/（对于新用户）
• 在AWS的搜索栏中搜索简单的电子邮件服务
• 相应地选择您的AWS地区（如美国东部）
• 单击电子邮件地址并验证您的电子邮件
• 单击"我的安全凭据"
• 单击"开始使用IAM用户"并添加一个新用户（您也可以使用根用户的访问代码，但这是不安全的。）
• 单击刚创建的用户的用户名
• 单击"安全凭据"并记下"访问密钥ID（aws_access_key）"和"机密访问密钥（aws_secret_kay）"。 警告：出于安全原因，请勿共享此密钥。
• 将这些密钥和电子邮件放入"securetea.conf"文件。

获取Gmail代币

• 注册一个gmail帐户https://mail.google.com（对于新用户）
• 转到"帐户"并转到"安全"仪表板
• 打开"不太安全的应用程序访问"以允许SecureTea发送电子邮件
• 转到https://accounts.google.com/displayUnlockCaptcha rel="nofollow">https://accounts.google.com/displayUnlockCaptcha并单击继续，然后允许
• 将您的发件人电子邮件ID、密码和目的地电子邮件ID放入securetea.conf文件。

用法

以下参数选项当前可用：

   -h, --help           show this help message and exit
  --conf CONF           Path of config file. default:-
                        "~/.securetea/securetea.conf"
  --debug               Degug true or false
  --twitter             Setup twitter credentials
  --twilio_sms          Setup twilio SMS credentials
  --telegram            Setup telegram SMS credentials
  --gmail               Setup Gmail credentials
  --slack               Setup Slack credentials
  --aws_ses             Setup AWS SES credentials
  --twitter_api_key TWITTER_API_KEY, -tak TWITTER_API_KEY
                        Twitter api key
  --twitter_api_secret_key TWITTER_API_SECRET_KEY, -tas TWITTER_API_SECRET_KEY
                        Twitter api secret
  --twitter_access_token TWITTER_ACCESS_TOKEN, -tat TWITTER_ACCESS_TOKEN
                        Twitter access token
  --twitter_access_token_secret TWITTER_ACCESS_TOKEN_SECRET, -tats TWITTER_ACCESS_TOKEN_SECRET
                        Twitter access token secret
  --telegram_bot_token TELEGRAM_BOT_TOKEN, -tbt TELEGRAM_BOT_TOKEN
                        Telegram Bot Token
  --telegram_user_id TELEGRAM_USER_ID, -tui TELEGRAM_USER_ID
                        Telegram user id
  --twilio_sid TWILIO_SID, -tws TWILIO_SID
                        Twilio SID
  --twilio_token TWILIO_TOKEN, -twt TWILIO_TOKEN
                        Twilio authorization token
  --twilio_from TWILIO_FROM, -twf TWILIO_FROM
                        Twilio (From) phone number
  --twilio_to TWILIO_TO, -twto TWILIO_TO
                        Twilio (To) phone number
  --slack_token SLACK_TOKEN, -st SLACK_TOKEN
                        Slack token
  --slack_user_id SLACK_USER_ID, -suid SLACK_USER_ID
                        Slack user id
  --sender_email SENDER_EMAIL
                        Gmail sender e-mail id
  --to_email TO_EMAIL   Destination of e-mail
  --password PASSWORD   Password for Gmail sender account
  --aws_email AWS_EMAIL, -awse AWS_EMAIL
                        AWS email id
  --aws_secret_key AWS_SECRET_KEY, -awss AWS_SECRET_KEY
                        AWS secret key
  --aws_access_key AWS_ACCESS_KEY, -awsa AWS_ACCESS_KEY
                        AWS access key
  --firewall, -f        Start firewall
  --interface INTERFACE
                        Name of the interface
  --inbound_IP_action INBOUND_IP_ACTION
                        Inbound IP rule action
  --inbound_IP_list INBOUND_IP_LIST
                        List of inbound IPs to look for
  --outbound_IP_action OUTBOUND_IP_ACTION
                        Outbound IP rule action (0: BLOCK, 1: ALLOW)
  --outbound_IP_list OUTBOUND_IP_LIST
                        List of outbound IPs to look for
  --protocol_action PROTOCOL_ACTION
                        Protocol action (0: BLOCK, 1: ALLOW)
  --protocol_list PROTOCOL_LIST
                        List of protocols to look for
  --scan_action SCAN_ACTION
                        Scan load action (0: BLOCK, 1: ALLOW)
  --scan_list SCAN_LIST
                        List of extensions to scan for
  --dest_port_action DEST_PORT_ACTION
                        Destination port action (0: BLOCK, 1: ALLOW)
  --dest_port_list DEST_PORT_LIST
                        List of destination ports to look for
  --source_port_action SOURCE_PORT_ACTION
                        Source port action (0: BLOCK, 1: ALLOW)
  --source_port_list SOURCE_PORT_LIST
                        List of source ports to look for
  --HTTP_request_action HTTP_REQUEST_ACTION
                        HTTP request action (0: BLOCK, 1: ALLOW)
  --HTTP_response_action HTTP_RESPONSE_ACTION
                        HTTP response action (0: BLOCK, 1: ALLOW)
  --dns_action DNS_ACTION
                        DNS action (0: BLOCK, 1: ALLOW)
  --dns_list DNS_LIST   List of DNS to look for
  --time_lb TIME_LB     Time lower bound
  --time_ub TIME_UB     Time upper bound
  --insecure_headers, -ih
                        Test URL for insecure headers
  --url URL, -u URL     URL on which operations are to be performed
  --ids                 Start Intrusion Detection System (IDS)
  --threshold THRESHOLD, -th THRESHOLD
                        Intrusion Detection System (IDS) threshold
  --system_log, -sys_log
                        Start system log monitoring process
  --server_log          Start server log monitoring process
  --log_file LOG_FILE   Path of the log file
  --log_type LOG_TYPE   Type of the log file (Apache/Nginx)
  --window WINDOW       Days old log to process
  --ip_list IP_LIST     List of IPs to grab from log file
  --status_code STATUS_CODE
                        List of status code to grab from log file
  --auto-server-patcher, -asp
                        Start auto server patcher
  --ssh                 Patch SSH config
  --sysctl              Patch system configuration
  --login               Patch login configuration
  --apache              Patch apache configuration
  --ssl                 Scan for SSL vulnerability
  --antivirus           Start AntiVirus
  --update UPDATE       Auto-update AntiVirus or not (1: yes, 0: no)
  --custom-scan CUSTOM_SCAN
			Path to custom scan
  --auto-delete         Auto delete malicious files or manually (1: auto, 0:
			manual)
  --monitor-usb         Monitor USB devices or not (1: yes, 0: no)
  --monitor-file-changes
			Monitor file changes or not (1:yes, 0:no)
  --virustotal-api-key  Virus Total API key  
  --web-deface          Start Web Deface Detection
  --path PATH           Path of the directory
  --server-name SERVER_NAME
                        Name of the server (apache/nginx/etc.)
  --iot-checker, -ic    Start IoT Anonymity Checker
  --shodan-api-key SHODAN_API_KEY, -sak SHODAN_API_KEY
                        Shodan API Key
  --ip IP               IP address on which to perform operation

示例用法

启动Twitter通知程序

用法：


sudo SecureTea.py --twitter_api_key <data> --twitter_api_secret_key <data> --twitter_access_token <data> --twitter_access_token_secret <data>

启动松弛通知程序

用法：


sudo SecureTea.py --slack_token <data> --slack_user_id <data>

启动电报通知程序

用法：


sudo apt-get update
sudo apt-get install build-essential python-dev libnetfilter-queue-dev

0

启动Twilio通知程序

用法：


sudo apt-get update
sudo apt-get install build-essential python-dev libnetfilter-queue-dev

1

启动防火墙

用法：


sudo apt-get update
sudo apt-get install build-essential python-dev libnetfilter-queue-dev

2

启动AWS-SES

用法：


sudo apt-get update
sudo apt-get install build-essential python-dev libnetfilter-queue-dev

3

设置通知程序

设置Twitter

示例用法：


＜H4＞1。使用交互式设置

sudo apt-get update
sudo apt-get install build-essential python-dev libnetfilter-queue-dev

4 ＜H4＞2。参数列表

<表><广告>参数 默认值说明 < /广告><正文>--Twitter API键xxxxTwitter API密钥--Twitter API密钥xxxxTwitter API密钥--Twitter访问令牌xxxxTwitter访问令牌--twitter访问令牌密钥xxxxTwitter访问令牌密钥

设置松弛度

示例用法：


＜H4＞1。使用交互式设置

sudo apt-get update
sudo apt-get install build-essential python-dev libnetfilter-queue-dev

5 ＜H4＞2。参数列表

<表><广告>参数 默认值说明 < /广告><正文>--松弛令牌xxxx松弛令牌--slack_用户idxxxx松弛用户ID

设置Amazon SES

示例用法：


＜H4＞1。使用交互式设置

sudo apt-get update
sudo apt-get install build-essential python-dev libnetfilter-queue-dev

6 ＜H4＞2。参数列表

<表><广告>参数 默认值说明 < /广告><正文>--aws_电子邮件xxxxAWS SES电子邮件--aws_secret_键xxxxAWS SES密钥--aws_access_键xxxxAWS SES访问密钥

设置gmail

示例用法：


＜H4＞1。使用交互式设置

sudo apt-get update
sudo apt-get install build-essential python-dev libnetfilter-queue-dev

7 ＜H4＞2。参数列表

<表><广告>参数 默认值说明 < /广告><正文>--发送电子邮件 xxxxG-mail到电子邮件--发件人电子邮件xxxx电子邮件中的g-mail--密码xxxxG-mail应用程序密码

设置电报

示例用法：


＜H4＞1。使用交互式设置

sudo apt-get update
sudo apt-get install build-essential python-dev libnetfilter-queue-dev

8 ＜H4＞2。参数列表

sudo apt-get update
sudo apt-get install build-essential python-dev libnetfilter-queue-dev

tar -zxf yara-3.10.0.tar.gz
cd yara-3.10.0
./bootstrap.sh
sudo apt-get install automake libtool make gcc
sudo apt-get install flex bison
./configure
make
sudo make install
make check

tar -zxf yara-3.10.0.tar.gz
cd yara-3.10.0
./bootstrap.sh
sudo apt-get install automake libtool make gcc
sudo apt-get install flex bison
./configure
make
sudo make install
make check

tar -zxf yara-3.10.0.tar.gz
cd yara-3.10.0
./bootstrap.sh
sudo apt-get install automake libtool make gcc
sudo apt-get install flex bison
./configure
make
sudo make install
make check

tar -zxf yara-3.10.0.tar.gz
cd yara-3.10.0
./bootstrap.sh
sudo apt-get install automake libtool make gcc
sudo apt-get install flex bison
./configure
make
sudo make install
make check

tar -zxf yara-3.10.0.tar.gz
cd yara-3.10.0
./bootstrap.sh
sudo apt-get install automake libtool make gcc
sudo apt-get install flex bison
./configure
make
sudo make install
make check

tar -zxf yara-3.10.0.tar.gz
cd yara-3.10.0
./bootstrap.sh
sudo apt-get install automake libtool make gcc
sudo apt-get install flex bison
./configure
make
sudo make install
make check

tar -zxf yara-3.10.0.tar.gz
cd yara-3.10.0
./bootstrap.sh
sudo apt-get install automake libtool make gcc
sudo apt-get install flex bison
./configure
make
sudo make install
make check

tar -zxf yara-3.10.0.tar.gz
cd yara-3.10.0
./bootstrap.sh
sudo apt-get install automake libtool make gcc
sudo apt-get install flex bison
./configure
make
sudo make install
make check

tar -zxf yara-3.10.0.tar.gz
cd yara-3.10.0
./bootstrap.sh
sudo apt-get install automake libtool make gcc
sudo apt-get install flex bison
./configure
make
sudo make install
make check

tar -zxf yara-3.10.0.tar.gz
cd yara-3.10.0
./bootstrap.sh
sudo apt-get install automake libtool make gcc
sudo apt-get install flex bison
./configure
make
sudo make install
make check

sudo apt-get install clamav
sudo freshclam