/ARL

ARL官方仓库备份项目:ARL(Asset Reconnaissance Lighthouse)资产侦察灯塔系统旨在快速侦察与目标关联的互联网资产,构建基础资产信息库。 协助甲方安全团队或者渗透测试人员有效侦察和检索资产,发现存在的薄弱点和攻击面。

Primary LanguagePythonMIT LicenseMIT

ARL(Asset Reconnaissance Lighthouse)资产侦察灯塔系统

Python 3.6 Docker Images Github Issues Github Stars

1# 注明

本项目已经替换完毕:如需构建本项目,在拉取和运行脚本时,要将 TophantTechnology/ARL / 1c3z/ARL-NPoC / 1c3z/arl_files 这三个字符串替换为 Aabyss-Team/ARL / Aabyss-Team/ARL-NPoC / Aabyss-Team/arl_files

万分感谢各位师傅的Star

Star History Chart

资产灯塔,不仅仅是域名收集

2# 简介

旨在快速侦察与目标关联的互联网资产,构建基础资产信息库。 协助甲方安全团队或者渗透测试人员有效侦察和检索资产,发现存在的薄弱点和攻击面。

在开始使用之前,请务必阅读并同意免责声明中的条款,否则请勿下载安装使用本系统。

3# 特性

  1. 域名资产发现和整理
  2. IP/IP 段资产整理
  3. 端口扫描和服务识别
  4. WEB 站点指纹识别
  5. 资产分组管理和搜索
  6. 任务策略配置
  7. 计划任务和周期任务
  8. Github 关键字监控
  9. 域名/IP 资产监控
  10. 站点变化监控
  11. 文件泄漏等风险检测
  12. nuclei PoC 调用
  13. WebInfoHunter 调用和监控

4# 系统要求

目前暂不支持Windows,初次体验可采用Docker方式运行,长期使用建议采用源码安装方式运行。系统配置建议:CPU:4线程 内存:8G 带宽:10M。
由于自动资产发现过程中会有大量的的发包,建议采用云服务器可以带来更好的体验。

5# Docker 启动

这里感谢 @本间白猫 师傅,一起研究源码并解决了相关问题

//下载部署脚本项目
git clone https://github.com/honmashironeko/ARL-docker.git

//进入项目文件夹
cd ARL-docker/

//添加运行权限
chmod +x setup_docker.sh

//执行部署脚本
bash setup_docker.sh

Centos以外的版本请注意,脚本采用的是yum安装工具,如果是apt的话请运行:apt install docker.io -y

Clip_2024-05-29_15-38-52

输入数字确认安装版本:1 or 2

//安装完成之后进入容器
docker exec -it arl /bin/bash

//开始完成ARL部署
bash /root/arl/set.sh
  • 前往ARL-Web页面:https://IP:5003/
  • 账号:admin,密码:honmashironeko

Docker安装问题-1:ACCESS_REFUSED

具体为通过Docker方式部署后,添加任务报如下错误 ACCESS_REFUSED - Login was refused using authentication mechanism PLAIN.,解决方法如下:

先进入容器:docker exec -it arl /bin/bash

执行以下命令:

rabbitmqctl add_user arl arlpassword
rabbitmqctl set_user_tags arl administrator
rabbitmqctl add_vhost arlv2host
rabbitmqctl set_permissions -p arlv2host arl ".*" ".*" ".*"

经过测试,docker在PUSH上传后,其他地方PULL下载的时候会出现错误,因此需要这步操作。

6# 截图

一、登录页面

默认端口5003 (https), 默认用户名密码admin/arlpass
登录页面

二、任务页面

任务页面

三、子域名页面

子域名页面

四、站点页面

站点页面

五、资产监控页面

资产监控页面 详细说明可以参考:资产分组和监控功能使用说明

六、策略页面

策略配置页面

七、筛选站点进行任务下发

筛选站点进行任务下发 详细说明可以参考: 2.3-新添加功能详细说明

八、计划任务

计划任务 详细说明可以参考: 2.4.1-新添加功能详细说明

九、GitHub 监控任务

GitHub 监控任务

7# 任务选项说明

编号 选项 说明
1 任务名称 任务名称
2 任务目标 任务目标,支持IP,IP段和域名。可一次性下发多个目标
3 域名爆破类型 对域名爆破字典大小, 大字典:常用2万字典大小。测试:少数几个字典,常用于测试功能是否正常
4 端口扫描类型 ALL:全部端口,TOP1000:常用top 1000端口,TOP100:常用top 100端口,测试:少数几个端口
5 域名爆破 是否开启域名爆破
6 DNS字典智能生成 根据已有的域名生成字典进行爆破
7 域名查询插件 已支持的数据源为13个,alienvault, certspotter,crtsh,fofa,hunter
8 ARL 历史查询 对arl历史任务结果进行查询用于本次任务
9 端口扫描 是否开启端口扫描,不开启站点会默认探测80,443
10 服务识别 是否进行服务识别,有可能会被防火墙拦截导致结果为空
11 操作系统识别 是否进行操作系统识别,有可能会被防火墙拦截导致结果为空
12 SSL 证书获取 对端口进行SSL 证书获取
13 跳过CDN 对判定为CDN的IP, 将不会扫描端口,并认为80,443是端口是开放的
14 站点识别 对站点进行指纹识别
15 搜索引擎调用 利用搜索引擎搜索下发的目标爬取对应的URL和子域名
16 站点爬虫 利用静态爬虫对站点进行爬取对应的URL
17 站点截图 对站点首页进行截图
18 文件泄露 对站点进行文件泄露检测,会被WAF拦截
19 Host 碰撞 对vhost配置不当进行检测
20 nuclei 调用 调用nuclei 默认PoC 对站点进行检测 ,会被WAF拦截,请谨慎使用该功能
21 WIH 调用 调用 WebInfoHunter 工具在JS中收集域名,AK/SK等信息
22 WIH 监控任务 对资产分组中的站点周期性 调用 WebInfoHunter 工具在JS中域名等信息进行监控

8# 配置参数说明

Docker环境配置文件路径 docker/config-docker.yaml

配置 说明
CELERY.BROKER_URL rabbitmq连接信息
MONGO mongo 连接信息
QUERY_PLUGIN 域名查询插件数据源Token 配置
GEOIP GEOIP 数据库路径信息
FOFA FOFA API 配置信息
DINGDING 钉钉消息推送配置
EMAIL 邮箱发送配置
GITHUB.TOKEN GITHUB 搜索 TOKEN
ARL.AUTH 是否开启认证,不开启有安全风险
ARL.API_KEY arl后端API调用key,如果设置了请注意保密
ARL.BLACK_IPS 为了防止SSRF,屏蔽的IP地址或者IP段
ARL.PORT_TOP_10 自定义端口,对应前端端口测试选项
ARL.DOMAIN_DICT 域名爆破字典,对应前端大字典选项
ARL.FILE_LEAK_DICT 文件泄漏字典
ARL.DOMAIN_BRUTE_CONCURRENT 域名爆破并发数配置
ARL.ALT_DNS_CONCURRENT 组合生成的域名爆破并发数
PROXY.HTTP_URL HTTP代理URL设置
FEISHU 飞书消息推送配置
WXWORK 企业微信消息推送

9# 忘记密码重置

当忘记了登录密码,可以执行下面的命令,然后使用 admin/admin123 就可以登录了。

docker exec -ti arl_mongodb mongo -u admin -p admin
use arl
db.user.drop()
db.user.insert({ username: 'admin',  password: hex_md5('arlsalt!@#'+'admin123') })

10# 源码安装

仅仅适配了 centos 7 ,且灯塔安装目录为/opt/ARL 如果在其他目录可以创建软连接,且安装了四个服务分别为arl-web, arl-worker, arl-worker-github, arl-scheduler

wget https://raw.githubusercontent.com/Aabyss-Team/ARL/master/misc/setup-arl.sh
chmod +x setup-arl.sh
./setup-arl.sh

CentOS7 系统上,直接运行本项目内的 misc/setup-arl.sh 即可运行源码安装

本项目已经替换完毕:如需构建本项目,在拉取和运行脚本时,要将 TophantTechnology/ARL / 1c3z/ARL-NPoC / 1c3z/arl_files 这三个字符串替换为 Aabyss-Team/ARL / Aabyss-Team/ARL-NPoC / Aabyss-Team/arl_files

安装问题1:没有可用软件包 nginx

在命令行执行:

sudo yum -y install epel-release
sudo yum makecache
sudo yum install nginx* --skip-broken
sudo setenforce 0
sudo systemctl restart nginx.service

这个是玄学问题,有时候能碰到这个报错,有时候又碰不到。。

安装问题2:脚本跑起来后运行任务显示 error

要赋予 /opt/ARL/app/tools/massdns 目录的执行权限(给777也行)

cd /opt/ARL/app/tools/
sudo chmod +x massdns

然后就可以愉快的玩耍了~~~

11# FAQ

请访问如下链接FAQ

12# 写在最后

目前ARL仅仅只是完成了对资产的部分维度的发现和收集,自动发现过程中难免出现覆盖度不全、不精准、不合理等缺陷的地方还请反馈至我们。