这是对 Scott Jensen 在 ISC Storm Center 网站上最初以 BACS 论文形式发布的内容以及 Github 上发布的脚本的 fork 和重大更新。
https://github.com/fkadriver/Dshield-ELK
https://isc.sans.edu/diary/DShield+Sensor+Monitoring+with+a+Docker+ELK+Stack+Guest+Diary/30118
这是关于如何使用 DShield-SIEM 进行分析的良好参考:https://isc.sans.edu/diary/30962/
这提供了使用 DShield 传感器进行日志收集的概述。
https://github.com/bruneaug/DShield-SIEM/blob/main/Troubleshooting/DShield-SIEM-Flow.png
此 docker 是定制构建的,用于配合 DShield Honeypot 收集和解析日志并收集数据,以便于为研究目的进行搜索。建议的安装方式是在使用 PI Raspbian OS 的 Raspberry 上或运行 Ubuntu 24.04 LTS 的系统上安装 DShield 传感器,该系统可以位于您的网络中或您选择的云中。
注意:按照以下说明,必须将其安装在单独的服务器上。
注意:要更新 ELK 服务器组件,请按照以下步骤操作:
https://github.com/bruneaug/DShield-SIEM/blob/main/README.md#download-github-update
以用户 ($) 账户安装 docker:
sudo apt-get install ca-certificates curl gnupg network-manager txt2html
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg
Note: You may need to take the next line, remove the backlash () and put everythin in a single line in Notepad to run this echo.
echo "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
"$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update && sudo apt upgrade
sudo reboot (if update were applied)
sudo apt-get install -y jq docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin pip
sudo systemctl enable docker
sudo systemctl start docker.service
确认 docker 服务正在运行
sudo systemctl status docker.service
在 /etc/hosts 中,将以下 ELK 服务器名 es01 kibana fleet-server heartbeat logstash filebeat filebeat01
添加到 IP 地址和服务器名之后:
sudo vi /etc/hosts
在 ELK 服务器 IP 地址之后,将以下内容添加到 /etc/hosts
127.0.0.1 sensor es01 ...
192.168.25.80 sensor es01 ...
es01 kibana fleet-server heartbeat logstash filebeat filebeat01
编辑 sysctl.conf 文件:
sudo vi /etc/sysctl.conf
在文件底部添加以下内容:
vm.max_map_count=262144
添加并保存。这是针对使用 Docker 时的 Elasticsearch。
sudo iptables -nL

使用用户($)账户,运行以下命令:
git clone https://github.com/bruneaug/DShield-SIEM.git
mkdir scripts
mv DShield-SIEM/AddOnScripts/*.sh scripts
chmod 754 scripts/*.sh
cd ~/DShield-SIEM
注意:安装前,你可以编辑 .env 文件(使用 ls -la 查看)以进行任何所需的更改。
- elastic 当前的_默认密码_为 student
.env 中的内存限制是 docker 为每个 ELK 容器分配的最大内存。
Elasticsearch 默认为 3GB,但如果你有足够的资源,可以扩大该值
编辑 .env 文件并根据你自己的 ELK Stack 进行配置
vi .env
cd logstash/pipeline
编辑 heartbeat.yml,将传感器 IP(名为 PI)更改为你自己的传感器 IP。Kibana heartbeat 会检查你服务的状态并确定它们是否可用。
更新此 IP 和主机名以反映你的传感器。
注意:如果你有多个传感器需要监控,可以复制并添加相同的 5 行
可在 Observability -> Uptime Monitors 中查看

此行是传感器 IP 地址。如果在连接 TCP 12222 时未收到响应,它将在界面中将其标记为 down。
这由 ELK 服务器发起,用于检查来自传感器的响应。
更新此行:hosts: ["192.168.25.165"]
vi ~/DShield-SIEM/heartbeat/heartbeat.yml
脚本 change_perms.sh 将在开始安装 docker 组件之前配置部分文件。
该脚本还会将仪表板查询中使用的 IP 地址更新为你的 ELK 栈的 IP 地址。
~/scripts/change_perms.sh
~/scripts/get_researchers.sh
现在执行 docker compose 来构建 ELK 服务器应用程序。
这将构建:Kibana、Elasticsearch、elastic-agent、Logstash,并加载 Cowrie 解析器、配置文件和仪表板。
sudo docker compose up -d
安装完成
sudo cp /var/lib/docker/volumes/dshield-elk_certs/_data/ca/ca.crt /usr/local/share/ca-certificates/dshield.crt
sudo update-ca-certificates
此操作会将 DShield SIEM 仪表板和 SIEM 签名加载到 Kibana 中。
~/scripts/dashboard-setup.sh
此命令显示在所有 Elasticsearch 组件安装完成后所使用的 docker 目录列表。
随着数据被添加到 Elasticsearch,您还可以通过以下命令或在 ELK 中监控可用于存储的磁盘空间量。
sudo du --human-readable --max-depth 1 --no-dereference --one-file-system /var/lib/docker
