ARL(资产侦察灯塔系统)-源码搭建

freebuf能力中心开源了一套资产扫描系统(https://github.com/TophantTechnology/ARL)，提供docker版，但并无源码搭建的文档(无完整文档)。于是在星光哥及小明哥指导下完成源码搭建，在这里记录一下。

环境

• centos7.6 2h4g

搭建过程

首先从github下载源码，我下载到opt 目录下。

phantomjs

先在官网下载phantomjs

# 下载
wget https://bitbucket.org/ariya/phantomjs/downloads/phantomjs-2.1.1-linux-x86_64.tar.bz2
# 解压
tar -jxvf phantomjs-2.1.1-linux-x86_64.tar.bz2
# 修改环境变量
vim /etc/profile
# 刷新环境变量
source /etc/profile
# 验证
phantomjs --version

/etc/profile文件末尾增加如下内容(路径看自己解压完放哪)

export PATH=$PATH:/opt/phantomjs-2.1.1-linux-x86_64/bin

报错这个错的话phantomjs: error while loading shared libraries: libfontconfig.so.1: cannot open shared object file
运行

yum -y install fontconfig-devel

安装相关软件包

yum install epel-release
yum install rabbitmq-server supervisor
yum install wqy-microhei-fonts fontconfig

rabbitmq-server

上面已经安装了rabbitmq-server

# 启动
systemctl start rabbitmq-server

# 配置
rabbitmqctl add_user arl arlpassword
rabbitmqctl add_vhost arlvhost
rabbitmqctl set_user_tags arl arltag
rabbitmqctl set_permissions -p arlvhost arl ".*" ".*" ".*"

nmap

下载nmap

https://nmap.org/dist/nmap-7.80-1.x86_64.rpm

# 安装
rpm -ivh nmap-7.80-1.x86_64.rpm

mongoDB

vim /etc/yum.repos.d/mongodb-org-4.0.repo

[mngodb-org]
name=MongoDB Repository
baseurl=http://mirrors.aliyun.com/mongodb/yum/redhat/7Server/mongodb-org/4.0/x86_64/
gpgcheck=0
enabled=1

安装yum -y install mongodb-org

开启无IP限制（方便看数据）

vim /etc/mongod.conf
service mongod restart

mongodb 添加认证

# mongo
> use arl
> db.createUser({user:'admin',pwd:'admin',roles:[{role:'dbOwner',db:'arl'}]})
> exit

开启登录验证

# 关闭数据库
service mongod stop

# 开启验证登录
vim /etc/mongod.conf

security:
  authorization: enabled

# service mongod start

添加账号密码

mongo -u admin -p admin --authenticationDatabase "arl"

use arl
db.user.insert({ username: 'admin123',  password: hex_md5('arlsalt!@#'+'admin123') })
exit

GeoIP数据库

由于官方政策更新请前往maxmind注册下载GeoLite2-City.tar.gz，GeoLite2-ASN.tar.gz 解压。

在config.yaml中配置好相关路径。

我放在了/data/GeoLite2

config.yaml配置

添加并修改配置文件

cp app/config.yaml.example app/config.yaml

我的配置

CELERY:
  BROKER_URL : "amqp://arl:arlpassword@localhost:5672/arlvhost"

MONGO:
  URI : 'mongodb://admin:admin@localhost:27017/arl'
  DB : 'arl'

RISKIQ:
  EMAIL: "jimz123123@qq.com"
  KEY: "3d78801683997245c14192d630d41b1c0ee5f80f12c261e5a1007f5e1ad2a7b7"

GEOIP:
  CITY: '/data/GeoLite2/GeoLite2-City.mmdb'
  ASN: '/data/GeoLite2/GeoLite2-ASN.mmdb'

FOFA:
  EMAIL: ""
  KEY: ""

ARL:
  AUTH: true
  API_KEY: ""
  BLACK_IPS:
    - 127.0.0.0/8
    #- 0.0.0.0/8
    #- 172.16.0.0/12
    #- 100.0.0.0/8
    #- 10.0.0.0/8
    #- 192.168.0.0/16

riskiq可以自行注册。

https://community.riskiq.com/

nginx

# centOS7.6下安装nginx
cd /yum install gcc gcc-c++    # 安装依赖
wget http://nginx.org/download/nginx-1.17.1.tar.gz    # 下载nginx源码
tar -zxvf nginx-1.17.1.tar.gz    # 解压
cd nginx-1.17.1     # 进入解压后的文件夹
./configure --prefix=/usr/local/nginx    # 配置nginx安装路径
make
make install
ln -s /usr/local/nginx/sbin/nginx /usr/bin/nginx    # 创建nginx软链接，若已被占用，则在 /usr/bin 下 rm-rf nginxnginx    # 启动ngixnnginx -s stop     # 停止nginx服务

导入配置nginx.conf，这边直接用root启动了(根据自身修改用户)。

user root;
worker_processes auto;
error_log /var/log/nginx/error.log;
pid /run/nginx.pid;

# Load dynamic modules. See /usr/share/doc/nginx/README.dynamic.
include /usr/share/nginx/modules/*.conf;

events {
    worker_connections 1024;
}

http {
    log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
                      '$status $body_bytes_sent "$http_referer" '
                      '"$http_user_agent" "$http_x_forwarded_for"';

    sendfile            on;
    tcp_nopush          on;
    tcp_nodelay         on;
    keepalive_timeout   65;
    types_hash_max_size 2048;

    include             /usr/local/nginx/conf/mime.types;
    default_type        application/octet-stream;

    # Load modular configuration files from the /etc/nginx/conf.d directory.
    # See http://nginx.org/en/docs/ngx_core_module.html#include
    # for more information.
    include /etc/nginx/conf.d/*.conf;

    server {
        listen       80;
        server_name  _;

        #access_log  logs/host.access.log  main;
        access_log off;
        root    /opt/ARL-master/docker/frontend;

        location / {
            try_files $uri $uri/ /index.html;
            index  index.html index.htm;
        }
        location /api/ {
            proxy_pass http://127.0.0.1:5003/api/;
        }
    }

}

nginx启动。

无报错，前端则启动成功。

后端启动

安装依赖

pip3 install -r requirements.txt

WEB 服务启动

gunicorn -b 0.0.0.0:5003 app.main:arl_app -w 3 --access-logfile arl_web.log

CELERY 启动

celery -A app.celerytask.celery worker -l info -Q arltask -n arltask -c 2 -O fair -f arl_worker.log

利用tmux+supervisior启动。

安装tmux

yum install -y tmux

在项目根目录编写supervisior文件

supervisior.conf

[program:web_api]
command=gunicorn -b 0.0.0.0:5003 app.main:arl_app -w 3 --access-logfile /var/log/arl_web.log
;stdout_logfile=/var/log/web_api_stdout.log
;stderr_logfile=/var/log/web_api_stderr.log
autostart=true
autorestart=true

[program:celery_scan]
command=celery -A app.celerytask.celery worker -l info -Q arltask -n arltask -c 2 -O fair -f arl_worker.log
;stdout_logfile=/var/log/celery_scan_stdout.log
;stderr_logfile=/var/log/celery_scan_stderr.log
autostart=true
autorestart=true

[unix_http_server]
file=/tmp/supervisor.sock   ; the path to the socket file

[supervisord]
logfile=/tmp/supervisord.log ; main log file; default $CWD/supervisord.log
logfile_maxbytes=50MB        ; max main logfile bytes b4 rotation; default 50MB
logfile_backups=10           ; # of main logfile backups; 0 means none, default 10
loglevel=info                ; log level; default info; others: debug,warn,trace
pidfile=/tmp/supervisord.pid ; supervisord pidfile; default supervisord.pid
nodaemon=true              ; start in foreground if true; default false
minfds=1024                  ; min. avail startup file descriptors; default 1024
minprocs=200                 ; min. avail process descriptors;default 200

[rpcinterface:supervisor]
supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface

[supervisorctl]
serverurl=unix:///tmp/supervisor.sock ; use a unix:// URL  for a unix socket

# 新建一个窗口
tmux new -s sp

# 在项目根目录运行
supervisord -c supervisord.conf

# 会话后台运行
ctrl + b + d

# 进入会话
tmux a -t sp

运行成功

使用

直接访问该IP

admin123/admin123登录

添加任务并看结果

API使用

查看API文档并测试

这边只简单提供下现需要的API(添加任务，停止任务，获取任务状态，获取任务结果)。具体需要的可查看文档自行编写。

首先在在app/config.yaml里加入API_KEY。然后重启下就可以了。

#!usr/bin/env python
# !coding=utf-8

__author__ = 'zhengjim'

import requests
import json

IP = "xxx.xxx.xxx.xxx"  # ARL地址
token = "admin123"  # ARL_KEY

headers = {
    "token": token,
    "Content-type": "application/json",
    'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.97 Safari/537.36'
}


# 添加任务
def add_task(name, target):
    url = 'http://' + IP + '/api/task/'
    data = {"name": name, "target": target, "domain_brute_type": "big", "port_scan_type": "top100",
            "domain_brute": False, "alt_dns": False, "riskiq_search": False, "arl_search": False, "port_scan": False,
            "service_detection": False, "os_detection": False, "fofa_search": False, "ssl_cert": False,
            "site_identify": False, "search_engines": False, "site_spider": False, "site_capture": True,
            "file_leak": False}
    r = requests.post(url=url, headers=headers, data=json.dumps(data))
    result = r.json()
    return result

# 停止任务
def stop_task(task_id):
    url = 'http://' + IP + '/task/stop/'
    url = url + task_id
    r = requests.get(url=url, headers=headers)
    result = r.json()
    return result


# 获取任务状态
def get_task_status(task_id):
    if len(task_id) != 24:
        return False
    url = 'http://' + IP + '/api/task/?page=1&size=10&_id={task_id}'.format(task_id=task_id)
    r = requests.get(url=url, headers=headers)
    result = r.json()
    if result['total'] == 0:
        return False
    return {"status": result["items"][0]["status"]}


# 获取任务结果
def get_task_result(task_id):
    if len(task_id) != 24:
        return False
    url = 'http://' + IP + '/api/site/?page=1&size=10&task_id={0}'.format(task_id)
    r = requests.get(url=url, headers=headers)
    result = r.json()
    if result['total'] == 0:
        return False
    return result["items"][0]


if __name__ == '__main__':
    # print(add_task("xxx", "www.baidu.com"))
    # print(get_task_status("xxx"))
    # print(get_task_result("xxx"))
    # print(stop_task("xxx"))

结尾

使用了下，在资产探测收集还是很不错的，日站收集资产神器。而且是开源，也提供了API出来。在后续二开也很方便的。感谢开源！