mirror of
https://github.com/telekom-security/tpotce.git
synced 2025-04-19 21:52:27 +00:00
include docker repos
... skip emobility since it is a dev repo
This commit is contained in:
Marco Ochse
parent
f1ada16414
commit
0d5d80b1e3
152 changed files with 22265 additions and 0 deletions
54
docker/conpot/Dockerfile
Normal file
54
docker/conpot/Dockerfile
Normal file
|
|
@ -0,0 +1,54 @@
|
|||
FROM alpine
|
||||
MAINTAINER MO
|
||||
|
||||
# Include dist
|
||||
ADD dist/ /root/dist/
|
||||
|
||||
# Setup apt
|
||||
RUN apk -U add bash \
|
||||
build-base \
|
||||
file \
|
||||
git \
|
||||
libev \
|
||||
libtool \
|
||||
libxslt \
|
||||
libxslt-dev \
|
||||
mariadb-dev \
|
||||
mariadb-client-libs \
|
||||
pkgconfig \
|
||||
python \
|
||||
python-dev \
|
||||
py-cffi && \
|
||||
|
||||
# Setup ConPot
|
||||
git clone https://github.com/mushorg/conpot /opt/conpot/ && \
|
||||
cd /opt/conpot/ && \
|
||||
git checkout d97a68a054e4fe42ff90293188a5702ce8ab09a3 && \
|
||||
cp /root/dist/requirements.txt /opt/conpot/ && \
|
||||
python setup.py install && \
|
||||
cd / && \
|
||||
rm -rf /opt/conpot /tmp/* /var/tmp/* && \
|
||||
|
||||
# Setup user, groups and configs
|
||||
addgroup -g 2000 conpot && \
|
||||
adduser -S -s /bin/bash -u 2000 -D -g 2000 conpot && \
|
||||
mkdir -p /etc/conpot /var/log/conpot && \
|
||||
mv /root/dist/conpot.cfg /etc/conpot/conpot.cfg && \
|
||||
mv /root/dist/kamstrup_382/template.xml /usr/lib/python2.7/site-packages/Conpot-0.5.1-py2.7.egg/conpot/templates/kamstrup_382/ && \
|
||||
|
||||
# Clean up
|
||||
apk del build-base \
|
||||
file \
|
||||
git \
|
||||
libev \
|
||||
libtool \
|
||||
libxslt-dev \
|
||||
mariadb-dev \
|
||||
pkgconfig \
|
||||
python-dev \
|
||||
py-cffi && \
|
||||
rm -rf /root/* && \
|
||||
rm -rf /var/cache/apk/*
|
||||
|
||||
# Run supervisor upon container start
|
||||
CMD ["/usr/bin/conpot", "--template", "kamstrup_382", "--logfile", "/var/log/conpot/conpot.log", "--config", "/etc/conpot/conpot.cfg"]
|
||||
28
docker/conpot/README.md
Normal file
28
docker/conpot/README.md
Normal file
|
|
@ -0,0 +1,28 @@
|
|||
[](https://microbadger.com/images/dtagdevsec/conpot:1706 "Get your own version badge on microbadger.com") [](https://microbadger.com/images/dtagdevsec/conpot:1706 "Get your own image badge on microbadger.com")
|
||||
|
||||
# conpot
|
||||
|
||||
[ConPot](http://conpot.org/) is a low interactive server side Industrial Control Systems honeypot designed to be easy to deploy, modify and extend. By providing a range of common industrial control protocols we created the basics to build your own system, capable to emulate complex infrastructures to convince an adversary that he just found a huge industrial complex. To improve the deceptive capabilities, we also provided the possibility to server a custom human machine interface to increase the honeypots attack surface. The response times of the services can be artificially delayed to mimic the behaviour of a system under constant load. Because we are providing complete stacks of the protocols, Conpot can be accessed with productive HMI's or extended with real hardware. Conpot is developed under the umbrella of the [Honeynet Project](https://www.honeynet.org/) and on the shoulders of a couple of very big giants.
|
||||
|
||||
This repository contains the necessary files to create a *dockerized* version of conpot.
|
||||
|
||||
This dockerized version is part of the **[T-Pot community honeypot](http://dtag-dev-sec.github.io/)** of Deutsche Telekom AG.
|
||||
|
||||
The `Dockerfile` contains the blueprint for the dockerized conpot and will be used to setup the docker image.
|
||||
|
||||
The `supervisord.conf` is used to start conpot under supervision of supervisord.
|
||||
|
||||
Using systemd, copy the `systemd/conpot.service` to `/etc/systemd/system/conpot.service` and start using
|
||||
|
||||
```
|
||||
systemctl enable conpot
|
||||
systemctl start conpot
|
||||
```
|
||||
|
||||
This will make sure that the docker container is started with the appropriate permissions and port mappings. Further, it autostarts during boot.
|
||||
|
||||
By default all data will be stored in `/data/conpot/` until the honeypot service will be restarted which is by default every 24 hours. If you want to keep data persistently simply edit the ``service`` file, find the line that contains ``clean.sh`` and set the option from ``off`` to ``on``. Be advised to establish some sort of log management if you wish to do so.
|
||||
|
||||
# ConPot Dashboard
|
||||
|
||||
|
||||
58
docker/conpot/dist/conpot.cfg
vendored
Normal file
58
docker/conpot/dist/conpot.cfg
vendored
Normal file
|
|
@ -0,0 +1,58 @@
|
|||
[common]
|
||||
sensorid = conpot
|
||||
|
||||
[session]
|
||||
timeout = 30
|
||||
|
||||
[daemon]
|
||||
user = conpot
|
||||
group = conpot
|
||||
|
||||
[json]
|
||||
enabled = True
|
||||
filename = /var/log/conpot/conpot.json
|
||||
|
||||
[sqlite]
|
||||
enabled = False
|
||||
|
||||
[mysql]
|
||||
enabled = False
|
||||
device = /tmp/mysql.sock
|
||||
host = localhost
|
||||
port = 3306
|
||||
db = conpot
|
||||
username = conpot
|
||||
passphrase = conpot
|
||||
socket = tcp ; tcp (sends to host:port), dev (sends to mysql device/socket file)
|
||||
|
||||
[syslog]
|
||||
enabled = False
|
||||
device = /dev/log
|
||||
host = localhost
|
||||
port = 514
|
||||
facility = local0
|
||||
socket = dev ; udp (sends to host:port), dev (sends to device)
|
||||
|
||||
[hpfriends]
|
||||
enabled = False
|
||||
host = hpfriends.honeycloud.net
|
||||
port = 20000
|
||||
ident = 3Ykf9Znv
|
||||
secret = 4nFRhpm44QkG9cvD
|
||||
channels = ["conpot.events", ]
|
||||
|
||||
[taxii]
|
||||
enabled = False
|
||||
host = taxiitest.mitre.org
|
||||
port = 80
|
||||
inbox_path = /services/inbox/default/
|
||||
use_https = False
|
||||
|
||||
[fetch_public_ip]
|
||||
enabled = True
|
||||
urls = ["http://whatismyip.akamai.com/", "http://wgetip.com/"]
|
||||
|
||||
[change_mac_addr]
|
||||
enabled = False
|
||||
iface = eth0
|
||||
addr = 00:de:ad:be:ef:00
|
||||
516
docker/conpot/dist/kamstrup_382/template.xml
vendored
Normal file
516
docker/conpot/dist/kamstrup_382/template.xml
vendored
Normal file
|
|
@ -0,0 +1,516 @@
|
|||
<core>
|
||||
<template>
|
||||
<!-- General information about the template -->
|
||||
<entity name="unit">382</entity>
|
||||
<entity name="vendor">Kamstrup</entity>
|
||||
<entity name="description">Register clone of an existing Kamstrup 382 smart meter</entity>
|
||||
<entity name="protocols">Kamstrup</entity>
|
||||
<entity name="creator">Johnny Vestergaard</entity>
|
||||
</template>
|
||||
<databus>
|
||||
<!-- Core value that can be retrieved from the databus by key -->
|
||||
<key_value_mappings>
|
||||
<key name="power_simulator">
|
||||
<value type="function">conpot.protocols.kamstrup.usage_simulator.UsageSimulator</value>
|
||||
</key>
|
||||
<key name="register_1024">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_2">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_13">
|
||||
<value type="value">71832712</value>
|
||||
</key>
|
||||
<key name="register_14">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1054">
|
||||
<value type="value">228</value>
|
||||
</key>
|
||||
<key name="register_1055">
|
||||
<value type="value">229</value>
|
||||
</key>
|
||||
<key name="register_1056">
|
||||
<value type="value">224</value>
|
||||
</key>
|
||||
<key name="register_1076">
|
||||
<value type="value">511</value>
|
||||
</key>
|
||||
<key name="register_1077">
|
||||
<value type="value">422</value>
|
||||
</key>
|
||||
<key name="register_1078">
|
||||
<value type="value">144</value>
|
||||
</key>
|
||||
<key name="register_1080">
|
||||
<value type="value">1000</value>
|
||||
</key>
|
||||
<key name="register_1081">
|
||||
<value type="value">5499</value>
|
||||
</key>
|
||||
<key name="register_1082">
|
||||
<value type="value">895</value>
|
||||
</key>
|
||||
<key name="register_3">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_4">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_5">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_6">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1025">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1033">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1034">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1035">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1036">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_15">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_16">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_17">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_18">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1027">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_20">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_21">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_22">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_23">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_24">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_25">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_26">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_27">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_28">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_29">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_30">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_31">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_32">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_33">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_34">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_35">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_36">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_37">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_38">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_39">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_40">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_41">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_42">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_43">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_44">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_45">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_46">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1071">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1072">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1073">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_50">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_51">
|
||||
<value type="value">1258679</value>
|
||||
</key>
|
||||
<key name="register_52">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_53">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_54">
|
||||
<value type="value">21000002</value>
|
||||
</key>
|
||||
<key name="register_55">
|
||||
<value type="value">22201011</value>
|
||||
</key>
|
||||
<key name="register_56">
|
||||
<value type="value">1000</value>
|
||||
</key>
|
||||
<key name="register_57">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_58">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1083">
|
||||
<value type="value">34353</value>
|
||||
</key>
|
||||
<key name="register_1084">
|
||||
<value type="value">256</value>
|
||||
</key>
|
||||
<key name="register_1086">
|
||||
<value type="value">101110</value>
|
||||
</key>
|
||||
<key name="register_1205">
|
||||
<value type="value">340282366920938463463374607431768211455</value>
|
||||
</key>
|
||||
<key name="register_1092">
|
||||
<value type="value">1</value>
|
||||
</key>
|
||||
<key name="register_1037">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1038">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1112">
|
||||
<value type="value">30</value>
|
||||
</key>
|
||||
<key name="register_1113">
|
||||
<value type="value">30</value>
|
||||
</key>
|
||||
<key name="register_1114">
|
||||
<value type="value">30</value>
|
||||
</key>
|
||||
<key name="register_1039">
|
||||
<value type="value">99000</value>
|
||||
</key>
|
||||
<key name="register_1121">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1026">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1126">
|
||||
<value type="value">3820031751153221778937193183286</value>
|
||||
</key>
|
||||
<key name="register_19">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1047">
|
||||
<value type="value">9441543881752250126</value>
|
||||
</key>
|
||||
<key name="register_1049">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1050">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1028">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1051">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1189">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1202">
|
||||
<value type="value">340282366920938463463374607431768211455</value>
|
||||
</key>
|
||||
<key name="register_1203">
|
||||
<value type="value">340282366920938463463374607431768211455</value>
|
||||
</key>
|
||||
<key name="register_1204">
|
||||
<value type="value">340282366920938463463374607431768211455</value>
|
||||
</key>
|
||||
<key name="register_1206">
|
||||
<value type="value">340282366920938463463374607431768211455</value>
|
||||
</key>
|
||||
<key name="register_1207">
|
||||
<value type="value">340282366920938463463374607431768211455</value>
|
||||
</key>
|
||||
<key name="register_1208">
|
||||
<value type="value">340282366920938463463374607431768211455</value>
|
||||
</key>
|
||||
<key name="register_1209">
|
||||
<value type="value">340282366920938463463374607431768211455</value>
|
||||
</key>
|
||||
<key name="register_1029">
|
||||
<value type="value">100</value>
|
||||
</key>
|
||||
<key name="register_1058">
|
||||
<value type="value">227691635558201180633139</value>
|
||||
</key>
|
||||
<key name="register_1115">
|
||||
<value type="value">60</value>
|
||||
</key>
|
||||
<key name="register_1059">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1060">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1030">
|
||||
<value type="value">46828625</value>
|
||||
</key>
|
||||
<key name="register_1061">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1062">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1063">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1064">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1065">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1031">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1066">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1067">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1068">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1069">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1070">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1074">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1075">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1079">
|
||||
<value type="value">315</value>
|
||||
</key>
|
||||
<key name="register_1181">
|
||||
<value type="value">433534329705531658</value>
|
||||
</key>
|
||||
<key name="register_1001">
|
||||
<value type="value">15085488</value>
|
||||
</key>
|
||||
<key name="register_1002">
|
||||
<value type="value">203513</value>
|
||||
</key>
|
||||
<key name="register_1003">
|
||||
<value type="value">140727</value>
|
||||
</key>
|
||||
<key name="register_1004">
|
||||
<value type="value">283</value>
|
||||
</key>
|
||||
<key name="register_1005">
|
||||
<value type="value">53011401</value>
|
||||
</key>
|
||||
<key name="register_1010">
|
||||
<value type="value">15085488</value>
|
||||
</key>
|
||||
<key name="register_1021">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="register_1023">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="reboot_signal">
|
||||
<value type="value">0</value>
|
||||
</key>
|
||||
<key name="software_version">
|
||||
<value type="value">'5.5 (E5)'</value>
|
||||
</key>
|
||||
<key name="access_control_status">
|
||||
<value type="value">'DISABLED'</value>
|
||||
</key>
|
||||
<key name="access_control_1">
|
||||
<value type="value">'0.0.0.0'</value>
|
||||
</key>
|
||||
<key name="access_control_2">
|
||||
<value type="value">'0.0.0.0'</value>
|
||||
</key>
|
||||
<key name="access_control_3">
|
||||
<value type="value">'0.0.0.0'</value>
|
||||
</key>
|
||||
<key name="access_control_4">
|
||||
<value type="value">'0.0.0.0'</value>
|
||||
</key>
|
||||
<key name="access_control_5">
|
||||
<value type="value">'0.0.0.0'</value>
|
||||
</key>
|
||||
<key name="device_name">
|
||||
<value type="value">''</value>
|
||||
</key>
|
||||
<key name="nameserver_1">
|
||||
<value type="value">'192.168.254.111'</value>
|
||||
</key>
|
||||
<key name="nameserver_2">
|
||||
<value type="value">'192.168.254.112'</value>
|
||||
</key>
|
||||
<key name="nameserver_3">
|
||||
<value type="value">'0.0.0.0'</value>
|
||||
</key>
|
||||
<key name="mac_address">
|
||||
<value type="value">'00:13:EA:00:72:FA'</value>
|
||||
</key>
|
||||
<key name="use_dhcp">
|
||||
<value type="value">'YES'</value>
|
||||
</key>
|
||||
<key name="ip_addr">
|
||||
<value type="value">'192.168.201.101'</value>
|
||||
</key>
|
||||
<key name="ip_gateway">
|
||||
<value type="value">'192.168.201.254'</value>
|
||||
</key>
|
||||
<key name="ip_subnet">
|
||||
<value type="value">'255.255.255.0'</value>
|
||||
</key>
|
||||
<key name="ip_addr_dhcp">
|
||||
<value type="value">'192.168.200.1'</value>
|
||||
</key>
|
||||
<key name="ip_gateway_dhcp">
|
||||
<value type="value">'192.168.200.254'</value>
|
||||
</key>
|
||||
<key name="ip_subnet_dhcp">
|
||||
<value type="value">'255.255.255.0'</value>
|
||||
</key>
|
||||
<key name="kap_a_server_hostname">
|
||||
<value type="value">'de_fra_lxg00.local.dom'</value>
|
||||
</key>
|
||||
<key name="kap_a_server_ip">
|
||||
<value type="value">'192.168.254.201'</value>
|
||||
</key>
|
||||
<key name="kap_a_server_port">
|
||||
<value type="value">'50'</value>
|
||||
</key>
|
||||
<key name="kap_b_server_ip">
|
||||
<value type="value">'0.0.0.0'</value>
|
||||
</key>
|
||||
<key name="kap_b_server_port">
|
||||
<value type="value">'50'</value>
|
||||
</key>
|
||||
<key name="channel_a_meternumber">
|
||||
<value type="value">'A1 06 A1 02 B7 34 12 00 00 03'</value>
|
||||
</key>
|
||||
<key name="channel_b_meternumber">
|
||||
<value type="value">'A1 06 A1 02 B7 34 12 00 00 03'</value>
|
||||
</key>
|
||||
<key name="channel_a_port">
|
||||
<value type="value">'1025'</value>
|
||||
</key>
|
||||
<key name="channel_b_port">
|
||||
<value type="value">'1027'</value>
|
||||
</key>
|
||||
<key name="kap_ack_server">
|
||||
<value type="value">'NO'</value>
|
||||
</key>
|
||||
<key name="kap_local_port">
|
||||
<value type="value">'800'</value>
|
||||
</key>
|
||||
<key name="alarm_server_status">
|
||||
<value type="value">'DISABLED'</value>
|
||||
</key>
|
||||
<key name="alarm_server_ip">
|
||||
<value type="value">''</value>
|
||||
</key>
|
||||
<key name="alarm_server_port">
|
||||
<value type="value">'4000'</value>
|
||||
</key>
|
||||
<key name="kap_server_lookup">
|
||||
<value type="value">'0 - none'</value>
|
||||
</key>
|
||||
<key name="software_watchdog">
|
||||
<value type="value">'3600'</value>
|
||||
</key>
|
||||
<key name="kap_missing_warning">
|
||||
<value type="value">'60'</value>
|
||||
</key>
|
||||
<key name="keep_alive_timer">
|
||||
<value type="value">'10'</value>
|
||||
</key>
|
||||
<key name="serial_settings_a">
|
||||
<value type="value">'Auto'</value>
|
||||
</key>
|
||||
<key name="serial_settings_b">
|
||||
<value type="value">'115200,8,E,1'</value>
|
||||
</key>
|
||||
<key name="channel_a_connect_socket">
|
||||
<value type="value">'0 - None'</value>
|
||||
</key>
|
||||
<key name="channel_b_connect_socket">
|
||||
<value type="value">'0 - None'</value>
|
||||
</key>
|
||||
</key_value_mappings>
|
||||
</databus>
|
||||
</core>
|
||||
23
docker/conpot/dist/requirements.txt
vendored
Normal file
23
docker/conpot/dist/requirements.txt
vendored
Normal file
|
|
@ -0,0 +1,23 @@
|
|||
gevent>=1.0
|
||||
pysnmp==4.3.5
|
||||
pysmi==0.1.3
|
||||
lxml
|
||||
bottle
|
||||
jinja2
|
||||
beautifulsoup4
|
||||
requests
|
||||
sphinx==1.5.5
|
||||
libtaxii>=1.1.0
|
||||
MySQL-python
|
||||
xlrd
|
||||
crc16
|
||||
enum
|
||||
hpfeeds
|
||||
modbus-tk
|
||||
stix-validator
|
||||
stix
|
||||
cybox
|
||||
bacpypes==0.13.8
|
||||
pyghmi
|
||||
mixbox
|
||||
modbus-tk
|
||||
BIN
docker/conpot/doc/dashboard.png
Normal file
BIN
docker/conpot/doc/dashboard.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 490 KiB |
19
docker/conpot/docker-compose.yml
Normal file
19
docker/conpot/docker-compose.yml
Normal file
|
|
@ -0,0 +1,19 @@
|
|||
version: '2.1'
|
||||
|
||||
networks:
|
||||
conpot_local:
|
||||
|
||||
services:
|
||||
|
||||
# Conpot service
|
||||
conpot:
|
||||
container_name: conpot
|
||||
restart: always
|
||||
networks:
|
||||
- conpot_local
|
||||
ports:
|
||||
- "1025:1025"
|
||||
- "50100:50100"
|
||||
image: "dtagdevsec/conpot:1706"
|
||||
volumes:
|
||||
- /data/conpot/log:/var/log/conpot
|
||||
35
docker/cowrie/Dockerfile
Normal file
35
docker/cowrie/Dockerfile
Normal file
|
|
@ -0,0 +1,35 @@
|
|||
FROM alpine
|
||||
MAINTAINER MO
|
||||
|
||||
# Include dist
|
||||
ADD dist/ /root/dist/
|
||||
|
||||
# Get and install dependencies & packages
|
||||
RUN apk -U upgrade && \
|
||||
apk add git procps py-pip mpfr-dev openssl-dev mpc1-dev libffi-dev build-base python python-dev py-mysqldb py-setuptools gmp-dev && \
|
||||
|
||||
# Setup user
|
||||
addgroup -g 2000 cowrie && \
|
||||
adduser -S -s /bin/bash -u 2000 -D -g 2000 cowrie && \
|
||||
|
||||
# Install cowrie from git
|
||||
git clone https://github.com/micheloosterhof/cowrie.git /home/cowrie/cowrie/ && \
|
||||
cd /home/cowrie/cowrie && \
|
||||
pip install --no-cache-dir --upgrade cffi && \
|
||||
pip install --no-cache-dir -U -r requirements.txt && \
|
||||
|
||||
# Setup user, groups and configs
|
||||
cp /root/dist/cowrie.cfg /home/cowrie/cowrie/cowrie.cfg && \
|
||||
cp /root/dist/userdb.txt /home/cowrie/cowrie/data/userdb.txt && \
|
||||
chown cowrie:cowrie -R /home/cowrie/* && \
|
||||
|
||||
# Clean up
|
||||
rm -rf /root/* && \
|
||||
apk del git py-pip mpfr-dev mpc1-dev libffi-dev build-base py-mysqldb gmp-dev python-dev && \
|
||||
rm -rf /var/cache/apk/*
|
||||
|
||||
# Start cowrie
|
||||
ENV PYTHONPATH /home/cowrie/cowrie
|
||||
WORKDIR /home/cowrie/cowrie
|
||||
USER cowrie
|
||||
CMD ["/usr/bin/twistd", "--nodaemon", "-y", "cowrie.tac", "--pidfile", "var/run/cowrie.pid", "cowrie"]
|
||||
674
docker/cowrie/LICENSE
Normal file
674
docker/cowrie/LICENSE
Normal file
|
|
@ -0,0 +1,674 @@
|
|||
GNU GENERAL PUBLIC LICENSE
|
||||
Version 3, 29 June 2007
|
||||
|
||||
Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
|
||||
Everyone is permitted to copy and distribute verbatim copies
|
||||
of this license document, but changing it is not allowed.
|
||||
|
||||
Preamble
|
||||
|
||||
The GNU General Public License is a free, copyleft license for
|
||||
software and other kinds of works.
|
||||
|
||||
The licenses for most software and other practical works are designed
|
||||
to take away your freedom to share and change the works. By contrast,
|
||||
the GNU General Public License is intended to guarantee your freedom to
|
||||
share and change all versions of a program--to make sure it remains free
|
||||
software for all its users. We, the Free Software Foundation, use the
|
||||
GNU General Public License for most of our software; it applies also to
|
||||
any other work released this way by its authors. You can apply it to
|
||||
your programs, too.
|
||||
|
||||
When we speak of free software, we are referring to freedom, not
|
||||
price. Our General Public Licenses are designed to make sure that you
|
||||
have the freedom to distribute copies of free software (and charge for
|
||||
them if you wish), that you receive source code or can get it if you
|
||||
want it, that you can change the software or use pieces of it in new
|
||||
free programs, and that you know you can do these things.
|
||||
|
||||
To protect your rights, we need to prevent others from denying you
|
||||
these rights or asking you to surrender the rights. Therefore, you have
|
||||
certain responsibilities if you distribute copies of the software, or if
|
||||
you modify it: responsibilities to respect the freedom of others.
|
||||
|
||||
For example, if you distribute copies of such a program, whether
|
||||
gratis or for a fee, you must pass on to the recipients the same
|
||||
freedoms that you received. You must make sure that they, too, receive
|
||||
or can get the source code. And you must show them these terms so they
|
||||
know their rights.
|
||||
|
||||
Developers that use the GNU GPL protect your rights with two steps:
|
||||
(1) assert copyright on the software, and (2) offer you this License
|
||||
giving you legal permission to copy, distribute and/or modify it.
|
||||
|
||||
For the developers' and authors' protection, the GPL clearly explains
|
||||
that there is no warranty for this free software. For both users' and
|
||||
authors' sake, the GPL requires that modified versions be marked as
|
||||
changed, so that their problems will not be attributed erroneously to
|
||||
authors of previous versions.
|
||||
|
||||
Some devices are designed to deny users access to install or run
|
||||
modified versions of the software inside them, although the manufacturer
|
||||
can do so. This is fundamentally incompatible with the aim of
|
||||
protecting users' freedom to change the software. The systematic
|
||||
pattern of such abuse occurs in the area of products for individuals to
|
||||
use, which is precisely where it is most unacceptable. Therefore, we
|
||||
have designed this version of the GPL to prohibit the practice for those
|
||||
products. If such problems arise substantially in other domains, we
|
||||
stand ready to extend this provision to those domains in future versions
|
||||
of the GPL, as needed to protect the freedom of users.
|
||||
|
||||
Finally, every program is threatened constantly by software patents.
|
||||
States should not allow patents to restrict development and use of
|
||||
software on general-purpose computers, but in those that do, we wish to
|
||||
avoid the special danger that patents applied to a free program could
|
||||
make it effectively proprietary. To prevent this, the GPL assures that
|
||||
patents cannot be used to render the program non-free.
|
||||
|
||||
The precise terms and conditions for copying, distribution and
|
||||
modification follow.
|
||||
|
||||
TERMS AND CONDITIONS
|
||||
|
||||
0. Definitions.
|
||||
|
||||
"This License" refers to version 3 of the GNU General Public License.
|
||||
|
||||
"Copyright" also means copyright-like laws that apply to other kinds of
|
||||
works, such as semiconductor masks.
|
||||
|
||||
"The Program" refers to any copyrightable work licensed under this
|
||||
License. Each licensee is addressed as "you". "Licensees" and
|
||||
"recipients" may be individuals or organizations.
|
||||
|
||||
To "modify" a work means to copy from or adapt all or part of the work
|
||||
in a fashion requiring copyright permission, other than the making of an
|
||||
exact copy. The resulting work is called a "modified version" of the
|
||||
earlier work or a work "based on" the earlier work.
|
||||
|
||||
A "covered work" means either the unmodified Program or a work based
|
||||
on the Program.
|
||||
|
||||
To "propagate" a work means to do anything with it that, without
|
||||
permission, would make you directly or secondarily liable for
|
||||
infringement under applicable copyright law, except executing it on a
|
||||
computer or modifying a private copy. Propagation includes copying,
|
||||
distribution (with or without modification), making available to the
|
||||
public, and in some countries other activities as well.
|
||||
|
||||
To "convey" a work means any kind of propagation that enables other
|
||||
parties to make or receive copies. Mere interaction with a user through
|
||||
a computer network, with no transfer of a copy, is not conveying.
|
||||
|
||||
An interactive user interface displays "Appropriate Legal Notices"
|
||||
to the extent that it includes a convenient and prominently visible
|
||||
feature that (1) displays an appropriate copyright notice, and (2)
|
||||
tells the user that there is no warranty for the work (except to the
|
||||
extent that warranties are provided), that licensees may convey the
|
||||
work under this License, and how to view a copy of this License. If
|
||||
the interface presents a list of user commands or options, such as a
|
||||
menu, a prominent item in the list meets this criterion.
|
||||
|
||||
1. Source Code.
|
||||
|
||||
The "source code" for a work means the preferred form of the work
|
||||
for making modifications to it. "Object code" means any non-source
|
||||
form of a work.
|
||||
|
||||
A "Standard Interface" means an interface that either is an official
|
||||
standard defined by a recognized standards body, or, in the case of
|
||||
interfaces specified for a particular programming language, one that
|
||||
is widely used among developers working in that language.
|
||||
|
||||
The "System Libraries" of an executable work include anything, other
|
||||
than the work as a whole, that (a) is included in the normal form of
|
||||
packaging a Major Component, but which is not part of that Major
|
||||
Component, and (b) serves only to enable use of the work with that
|
||||
Major Component, or to implement a Standard Interface for which an
|
||||
implementation is available to the public in source code form. A
|
||||
"Major Component", in this context, means a major essential component
|
||||
(kernel, window system, and so on) of the specific operating system
|
||||
(if any) on which the executable work runs, or a compiler used to
|
||||
produce the work, or an object code interpreter used to run it.
|
||||
|
||||
The "Corresponding Source" for a work in object code form means all
|
||||
the source code needed to generate, install, and (for an executable
|
||||
work) run the object code and to modify the work, including scripts to
|
||||
control those activities. However, it does not include the work's
|
||||
System Libraries, or general-purpose tools or generally available free
|
||||
programs which are used unmodified in performing those activities but
|
||||
which are not part of the work. For example, Corresponding Source
|
||||
includes interface definition files associated with source files for
|
||||
the work, and the source code for shared libraries and dynamically
|
||||
linked subprograms that the work is specifically designed to require,
|
||||
such as by intimate data communication or control flow between those
|
||||
subprograms and other parts of the work.
|
||||
|
||||
The Corresponding Source need not include anything that users
|
||||
can regenerate automatically from other parts of the Corresponding
|
||||
Source.
|
||||
|
||||
The Corresponding Source for a work in source code form is that
|
||||
same work.
|
||||
|
||||
2. Basic Permissions.
|
||||
|
||||
All rights granted under this License are granted for the term of
|
||||
copyright on the Program, and are irrevocable provided the stated
|
||||
conditions are met. This License explicitly affirms your unlimited
|
||||
permission to run the unmodified Program. The output from running a
|
||||
covered work is covered by this License only if the output, given its
|
||||
content, constitutes a covered work. This License acknowledges your
|
||||
rights of fair use or other equivalent, as provided by copyright law.
|
||||
|
||||
You may make, run and propagate covered works that you do not
|
||||
convey, without conditions so long as your license otherwise remains
|
||||
in force. You may convey covered works to others for the sole purpose
|
||||
of having them make modifications exclusively for you, or provide you
|
||||
with facilities for running those works, provided that you comply with
|
||||
the terms of this License in conveying all material for which you do
|
||||
not control copyright. Those thus making or running the covered works
|
||||
for you must do so exclusively on your behalf, under your direction
|
||||
and control, on terms that prohibit them from making any copies of
|
||||
your copyrighted material outside their relationship with you.
|
||||
|
||||
Conveying under any other circumstances is permitted solely under
|
||||
the conditions stated below. Sublicensing is not allowed; section 10
|
||||
makes it unnecessary.
|
||||
|
||||
3. Protecting Users' Legal Rights From Anti-Circumvention Law.
|
||||
|
||||
No covered work shall be deemed part of an effective technological
|
||||
measure under any applicable law fulfilling obligations under article
|
||||
11 of the WIPO copyright treaty adopted on 20 December 1996, or
|
||||
similar laws prohibiting or restricting circumvention of such
|
||||
measures.
|
||||
|
||||
When you convey a covered work, you waive any legal power to forbid
|
||||
circumvention of technological measures to the extent such circumvention
|
||||
is effected by exercising rights under this License with respect to
|
||||
the covered work, and you disclaim any intention to limit operation or
|
||||
modification of the work as a means of enforcing, against the work's
|
||||
users, your or third parties' legal rights to forbid circumvention of
|
||||
technological measures.
|
||||
|
||||
4. Conveying Verbatim Copies.
|
||||
|
||||
You may convey verbatim copies of the Program's source code as you
|
||||
receive it, in any medium, provided that you conspicuously and
|
||||
appropriately publish on each copy an appropriate copyright notice;
|
||||
keep intact all notices stating that this License and any
|
||||
non-permissive terms added in accord with section 7 apply to the code;
|
||||
keep intact all notices of the absence of any warranty; and give all
|
||||
recipients a copy of this License along with the Program.
|
||||
|
||||
You may charge any price or no price for each copy that you convey,
|
||||
and you may offer support or warranty protection for a fee.
|
||||
|
||||
5. Conveying Modified Source Versions.
|
||||
|
||||
You may convey a work based on the Program, or the modifications to
|
||||
produce it from the Program, in the form of source code under the
|
||||
terms of section 4, provided that you also meet all of these conditions:
|
||||
|
||||
a) The work must carry prominent notices stating that you modified
|
||||
it, and giving a relevant date.
|
||||
|
||||
b) The work must carry prominent notices stating that it is
|
||||
released under this License and any conditions added under section
|
||||
7. This requirement modifies the requirement in section 4 to
|
||||
"keep intact all notices".
|
||||
|
||||
c) You must license the entire work, as a whole, under this
|
||||
License to anyone who comes into possession of a copy. This
|
||||
License will therefore apply, along with any applicable section 7
|
||||
additional terms, to the whole of the work, and all its parts,
|
||||
regardless of how they are packaged. This License gives no
|
||||
permission to license the work in any other way, but it does not
|
||||
invalidate such permission if you have separately received it.
|
||||
|
||||
d) If the work has interactive user interfaces, each must display
|
||||
Appropriate Legal Notices; however, if the Program has interactive
|
||||
interfaces that do not display Appropriate Legal Notices, your
|
||||
work need not make them do so.
|
||||
|
||||
A compilation of a covered work with other separate and independent
|
||||
works, which are not by their nature extensions of the covered work,
|
||||
and which are not combined with it such as to form a larger program,
|
||||
in or on a volume of a storage or distribution medium, is called an
|
||||
"aggregate" if the compilation and its resulting copyright are not
|
||||
used to limit the access or legal rights of the compilation's users
|
||||
beyond what the individual works permit. Inclusion of a covered work
|
||||
in an aggregate does not cause this License to apply to the other
|
||||
parts of the aggregate.
|
||||
|
||||
6. Conveying Non-Source Forms.
|
||||
|
||||
You may convey a covered work in object code form under the terms
|
||||
of sections 4 and 5, provided that you also convey the
|
||||
machine-readable Corresponding Source under the terms of this License,
|
||||
in one of these ways:
|
||||
|
||||
a) Convey the object code in, or embodied in, a physical product
|
||||
(including a physical distribution medium), accompanied by the
|
||||
Corresponding Source fixed on a durable physical medium
|
||||
customarily used for software interchange.
|
||||
|
||||
b) Convey the object code in, or embodied in, a physical product
|
||||
(including a physical distribution medium), accompanied by a
|
||||
written offer, valid for at least three years and valid for as
|
||||
long as you offer spare parts or customer support for that product
|
||||
model, to give anyone who possesses the object code either (1) a
|
||||
copy of the Corresponding Source for all the software in the
|
||||
product that is covered by this License, on a durable physical
|
||||
medium customarily used for software interchange, for a price no
|
||||
more than your reasonable cost of physically performing this
|
||||
conveying of source, or (2) access to copy the
|
||||
Corresponding Source from a network server at no charge.
|
||||
|
||||
c) Convey individual copies of the object code with a copy of the
|
||||
written offer to provide the Corresponding Source. This
|
||||
alternative is allowed only occasionally and noncommercially, and
|
||||
only if you received the object code with such an offer, in accord
|
||||
with subsection 6b.
|
||||
|
||||
d) Convey the object code by offering access from a designated
|
||||
place (gratis or for a charge), and offer equivalent access to the
|
||||
Corresponding Source in the same way through the same place at no
|
||||
further charge. You need not require recipients to copy the
|
||||
Corresponding Source along with the object code. If the place to
|
||||
copy the object code is a network server, the Corresponding Source
|
||||
may be on a different server (operated by you or a third party)
|
||||
that supports equivalent copying facilities, provided you maintain
|
||||
clear directions next to the object code saying where to find the
|
||||
Corresponding Source. Regardless of what server hosts the
|
||||
Corresponding Source, you remain obligated to ensure that it is
|
||||
available for as long as needed to satisfy these requirements.
|
||||
|
||||
e) Convey the object code using peer-to-peer transmission, provided
|
||||
you inform other peers where the object code and Corresponding
|
||||
Source of the work are being offered to the general public at no
|
||||
charge under subsection 6d.
|
||||
|
||||
A separable portion of the object code, whose source code is excluded
|
||||
from the Corresponding Source as a System Library, need not be
|
||||
included in conveying the object code work.
|
||||
|
||||
A "User Product" is either (1) a "consumer product", which means any
|
||||
tangible personal property which is normally used for personal, family,
|
||||
or household purposes, or (2) anything designed or sold for incorporation
|
||||
into a dwelling. In determining whether a product is a consumer product,
|
||||
doubtful cases shall be resolved in favor of coverage. For a particular
|
||||
product received by a particular user, "normally used" refers to a
|
||||
typical or common use of that class of product, regardless of the status
|
||||
of the particular user or of the way in which the particular user
|
||||
actually uses, or expects or is expected to use, the product. A product
|
||||
is a consumer product regardless of whether the product has substantial
|
||||
commercial, industrial or non-consumer uses, unless such uses represent
|
||||
the only significant mode of use of the product.
|
||||
|
||||
"Installation Information" for a User Product means any methods,
|
||||
procedures, authorization keys, or other information required to install
|
||||
and execute modified versions of a covered work in that User Product from
|
||||
a modified version of its Corresponding Source. The information must
|
||||
suffice to ensure that the continued functioning of the modified object
|
||||
code is in no case prevented or interfered with solely because
|
||||
modification has been made.
|
||||
|
||||
If you convey an object code work under this section in, or with, or
|
||||
specifically for use in, a User Product, and the conveying occurs as
|
||||
part of a transaction in which the right of possession and use of the
|
||||
User Product is transferred to the recipient in perpetuity or for a
|
||||
fixed term (regardless of how the transaction is characterized), the
|
||||
Corresponding Source conveyed under this section must be accompanied
|
||||
by the Installation Information. But this requirement does not apply
|
||||
if neither you nor any third party retains the ability to install
|
||||
modified object code on the User Product (for example, the work has
|
||||
been installed in ROM).
|
||||
|
||||
The requirement to provide Installation Information does not include a
|
||||
requirement to continue to provide support service, warranty, or updates
|
||||
for a work that has been modified or installed by the recipient, or for
|
||||
the User Product in which it has been modified or installed. Access to a
|
||||
network may be denied when the modification itself materially and
|
||||
adversely affects the operation of the network or violates the rules and
|
||||
protocols for communication across the network.
|
||||
|
||||
Corresponding Source conveyed, and Installation Information provided,
|
||||
in accord with this section must be in a format that is publicly
|
||||
documented (and with an implementation available to the public in
|
||||
source code form), and must require no special password or key for
|
||||
unpacking, reading or copying.
|
||||
|
||||
7. Additional Terms.
|
||||
|
||||
"Additional permissions" are terms that supplement the terms of this
|
||||
License by making exceptions from one or more of its conditions.
|
||||
Additional permissions that are applicable to the entire Program shall
|
||||
be treated as though they were included in this License, to the extent
|
||||
that they are valid under applicable law. If additional permissions
|
||||
apply only to part of the Program, that part may be used separately
|
||||
under those permissions, but the entire Program remains governed by
|
||||
this License without regard to the additional permissions.
|
||||
|
||||
When you convey a copy of a covered work, you may at your option
|
||||
remove any additional permissions from that copy, or from any part of
|
||||
it. (Additional permissions may be written to require their own
|
||||
removal in certain cases when you modify the work.) You may place
|
||||
additional permissions on material, added by you to a covered work,
|
||||
for which you have or can give appropriate copyright permission.
|
||||
|
||||
Notwithstanding any other provision of this License, for material you
|
||||
add to a covered work, you may (if authorized by the copyright holders of
|
||||
that material) supplement the terms of this License with terms:
|
||||
|
||||
a) Disclaiming warranty or limiting liability differently from the
|
||||
terms of sections 15 and 16 of this License; or
|
||||
|
||||
b) Requiring preservation of specified reasonable legal notices or
|
||||
author attributions in that material or in the Appropriate Legal
|
||||
Notices displayed by works containing it; or
|
||||
|
||||
c) Prohibiting misrepresentation of the origin of that material, or
|
||||
requiring that modified versions of such material be marked in
|
||||
reasonable ways as different from the original version; or
|
||||
|
||||
d) Limiting the use for publicity purposes of names of licensors or
|
||||
authors of the material; or
|
||||
|
||||
e) Declining to grant rights under trademark law for use of some
|
||||
trade names, trademarks, or service marks; or
|
||||
|
||||
f) Requiring indemnification of licensors and authors of that
|
||||
material by anyone who conveys the material (or modified versions of
|
||||
it) with contractual assumptions of liability to the recipient, for
|
||||
any liability that these contractual assumptions directly impose on
|
||||
those licensors and authors.
|
||||
|
||||
All other non-permissive additional terms are considered "further
|
||||
restrictions" within the meaning of section 10. If the Program as you
|
||||
received it, or any part of it, contains a notice stating that it is
|
||||
governed by this License along with a term that is a further
|
||||
restriction, you may remove that term. If a license document contains
|
||||
a further restriction but permits relicensing or conveying under this
|
||||
License, you may add to a covered work material governed by the terms
|
||||
of that license document, provided that the further restriction does
|
||||
not survive such relicensing or conveying.
|
||||
|
||||
If you add terms to a covered work in accord with this section, you
|
||||
must place, in the relevant source files, a statement of the
|
||||
additional terms that apply to those files, or a notice indicating
|
||||
where to find the applicable terms.
|
||||
|
||||
Additional terms, permissive or non-permissive, may be stated in the
|
||||
form of a separately written license, or stated as exceptions;
|
||||
the above requirements apply either way.
|
||||
|
||||
8. Termination.
|
||||
|
||||
You may not propagate or modify a covered work except as expressly
|
||||
provided under this License. Any attempt otherwise to propagate or
|
||||
modify it is void, and will automatically terminate your rights under
|
||||
this License (including any patent licenses granted under the third
|
||||
paragraph of section 11).
|
||||
|
||||
However, if you cease all violation of this License, then your
|
||||
license from a particular copyright holder is reinstated (a)
|
||||
provisionally, unless and until the copyright holder explicitly and
|
||||
finally terminates your license, and (b) permanently, if the copyright
|
||||
holder fails to notify you of the violation by some reasonable means
|
||||
prior to 60 days after the cessation.
|
||||
|
||||
Moreover, your license from a particular copyright holder is
|
||||
reinstated permanently if the copyright holder notifies you of the
|
||||
violation by some reasonable means, this is the first time you have
|
||||
received notice of violation of this License (for any work) from that
|
||||
copyright holder, and you cure the violation prior to 30 days after
|
||||
your receipt of the notice.
|
||||
|
||||
Termination of your rights under this section does not terminate the
|
||||
licenses of parties who have received copies or rights from you under
|
||||
this License. If your rights have been terminated and not permanently
|
||||
reinstated, you do not qualify to receive new licenses for the same
|
||||
material under section 10.
|
||||
|
||||
9. Acceptance Not Required for Having Copies.
|
||||
|
||||
You are not required to accept this License in order to receive or
|
||||
run a copy of the Program. Ancillary propagation of a covered work
|
||||
occurring solely as a consequence of using peer-to-peer transmission
|
||||
to receive a copy likewise does not require acceptance. However,
|
||||
nothing other than this License grants you permission to propagate or
|
||||
modify any covered work. These actions infringe copyright if you do
|
||||
not accept this License. Therefore, by modifying or propagating a
|
||||
covered work, you indicate your acceptance of this License to do so.
|
||||
|
||||
10. Automatic Licensing of Downstream Recipients.
|
||||
|
||||
Each time you convey a covered work, the recipient automatically
|
||||
receives a license from the original licensors, to run, modify and
|
||||
propagate that work, subject to this License. You are not responsible
|
||||
for enforcing compliance by third parties with this License.
|
||||
|
||||
An "entity transaction" is a transaction transferring control of an
|
||||
organization, or substantially all assets of one, or subdividing an
|
||||
organization, or merging organizations. If propagation of a covered
|
||||
work results from an entity transaction, each party to that
|
||||
transaction who receives a copy of the work also receives whatever
|
||||
licenses to the work the party's predecessor in interest had or could
|
||||
give under the previous paragraph, plus a right to possession of the
|
||||
Corresponding Source of the work from the predecessor in interest, if
|
||||
the predecessor has it or can get it with reasonable efforts.
|
||||
|
||||
You may not impose any further restrictions on the exercise of the
|
||||
rights granted or affirmed under this License. For example, you may
|
||||
not impose a license fee, royalty, or other charge for exercise of
|
||||
rights granted under this License, and you may not initiate litigation
|
||||
(including a cross-claim or counterclaim in a lawsuit) alleging that
|
||||
any patent claim is infringed by making, using, selling, offering for
|
||||
sale, or importing the Program or any portion of it.
|
||||
|
||||
11. Patents.
|
||||
|
||||
A "contributor" is a copyright holder who authorizes use under this
|
||||
License of the Program or a work on which the Program is based. The
|
||||
work thus licensed is called the contributor's "contributor version".
|
||||
|
||||
A contributor's "essential patent claims" are all patent claims
|
||||
owned or controlled by the contributor, whether already acquired or
|
||||
hereafter acquired, that would be infringed by some manner, permitted
|
||||
by this License, of making, using, or selling its contributor version,
|
||||
but do not include claims that would be infringed only as a
|
||||
consequence of further modification of the contributor version. For
|
||||
purposes of this definition, "control" includes the right to grant
|
||||
patent sublicenses in a manner consistent with the requirements of
|
||||
this License.
|
||||
|
||||
Each contributor grants you a non-exclusive, worldwide, royalty-free
|
||||
patent license under the contributor's essential patent claims, to
|
||||
make, use, sell, offer for sale, import and otherwise run, modify and
|
||||
propagate the contents of its contributor version.
|
||||
|
||||
In the following three paragraphs, a "patent license" is any express
|
||||
agreement or commitment, however denominated, not to enforce a patent
|
||||
(such as an express permission to practice a patent or covenant not to
|
||||
sue for patent infringement). To "grant" such a patent license to a
|
||||
party means to make such an agreement or commitment not to enforce a
|
||||
patent against the party.
|
||||
|
||||
If you convey a covered work, knowingly relying on a patent license,
|
||||
and the Corresponding Source of the work is not available for anyone
|
||||
to copy, free of charge and under the terms of this License, through a
|
||||
publicly available network server or other readily accessible means,
|
||||
then you must either (1) cause the Corresponding Source to be so
|
||||
available, or (2) arrange to deprive yourself of the benefit of the
|
||||
patent license for this particular work, or (3) arrange, in a manner
|
||||
consistent with the requirements of this License, to extend the patent
|
||||
license to downstream recipients. "Knowingly relying" means you have
|
||||
actual knowledge that, but for the patent license, your conveying the
|
||||
covered work in a country, or your recipient's use of the covered work
|
||||
in a country, would infringe one or more identifiable patents in that
|
||||
country that you have reason to believe are valid.
|
||||
|
||||
If, pursuant to or in connection with a single transaction or
|
||||
arrangement, you convey, or propagate by procuring conveyance of, a
|
||||
covered work, and grant a patent license to some of the parties
|
||||
receiving the covered work authorizing them to use, propagate, modify
|
||||
or convey a specific copy of the covered work, then the patent license
|
||||
you grant is automatically extended to all recipients of the covered
|
||||
work and works based on it.
|
||||
|
||||
A patent license is "discriminatory" if it does not include within
|
||||
the scope of its coverage, prohibits the exercise of, or is
|
||||
conditioned on the non-exercise of one or more of the rights that are
|
||||
specifically granted under this License. You may not convey a covered
|
||||
work if you are a party to an arrangement with a third party that is
|
||||
in the business of distributing software, under which you make payment
|
||||
to the third party based on the extent of your activity of conveying
|
||||
the work, and under which the third party grants, to any of the
|
||||
parties who would receive the covered work from you, a discriminatory
|
||||
patent license (a) in connection with copies of the covered work
|
||||
conveyed by you (or copies made from those copies), or (b) primarily
|
||||
for and in connection with specific products or compilations that
|
||||
contain the covered work, unless you entered into that arrangement,
|
||||
or that patent license was granted, prior to 28 March 2007.
|
||||
|
||||
Nothing in this License shall be construed as excluding or limiting
|
||||
any implied license or other defenses to infringement that may
|
||||
otherwise be available to you under applicable patent law.
|
||||
|
||||
12. No Surrender of Others' Freedom.
|
||||
|
||||
If conditions are imposed on you (whether by court order, agreement or
|
||||
otherwise) that contradict the conditions of this License, they do not
|
||||
excuse you from the conditions of this License. If you cannot convey a
|
||||
covered work so as to satisfy simultaneously your obligations under this
|
||||
License and any other pertinent obligations, then as a consequence you may
|
||||
not convey it at all. For example, if you agree to terms that obligate you
|
||||
to collect a royalty for further conveying from those to whom you convey
|
||||
the Program, the only way you could satisfy both those terms and this
|
||||
License would be to refrain entirely from conveying the Program.
|
||||
|
||||
13. Use with the GNU Affero General Public License.
|
||||
|
||||
Notwithstanding any other provision of this License, you have
|
||||
permission to link or combine any covered work with a work licensed
|
||||
under version 3 of the GNU Affero General Public License into a single
|
||||
combined work, and to convey the resulting work. The terms of this
|
||||
License will continue to apply to the part which is the covered work,
|
||||
but the special requirements of the GNU Affero General Public License,
|
||||
section 13, concerning interaction through a network will apply to the
|
||||
combination as such.
|
||||
|
||||
14. Revised Versions of this License.
|
||||
|
||||
The Free Software Foundation may publish revised and/or new versions of
|
||||
the GNU General Public License from time to time. Such new versions will
|
||||
be similar in spirit to the present version, but may differ in detail to
|
||||
address new problems or concerns.
|
||||
|
||||
Each version is given a distinguishing version number. If the
|
||||
Program specifies that a certain numbered version of the GNU General
|
||||
Public License "or any later version" applies to it, you have the
|
||||
option of following the terms and conditions either of that numbered
|
||||
version or of any later version published by the Free Software
|
||||
Foundation. If the Program does not specify a version number of the
|
||||
GNU General Public License, you may choose any version ever published
|
||||
by the Free Software Foundation.
|
||||
|
||||
If the Program specifies that a proxy can decide which future
|
||||
versions of the GNU General Public License can be used, that proxy's
|
||||
public statement of acceptance of a version permanently authorizes you
|
||||
to choose that version for the Program.
|
||||
|
||||
Later license versions may give you additional or different
|
||||
permissions. However, no additional obligations are imposed on any
|
||||
author or copyright holder as a result of your choosing to follow a
|
||||
later version.
|
||||
|
||||
15. Disclaimer of Warranty.
|
||||
|
||||
THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
|
||||
APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
|
||||
HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
|
||||
OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
|
||||
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
||||
PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
|
||||
IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
|
||||
ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
|
||||
|
||||
16. Limitation of Liability.
|
||||
|
||||
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
|
||||
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
|
||||
THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
|
||||
GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
|
||||
USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
|
||||
DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
|
||||
PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
|
||||
EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
|
||||
SUCH DAMAGES.
|
||||
|
||||
17. Interpretation of Sections 15 and 16.
|
||||
|
||||
If the disclaimer of warranty and limitation of liability provided
|
||||
above cannot be given local legal effect according to their terms,
|
||||
reviewing courts shall apply local law that most closely approximates
|
||||
an absolute waiver of all civil liability in connection with the
|
||||
Program, unless a warranty or assumption of liability accompanies a
|
||||
copy of the Program in return for a fee.
|
||||
|
||||
END OF TERMS AND CONDITIONS
|
||||
|
||||
How to Apply These Terms to Your New Programs
|
||||
|
||||
If you develop a new program, and you want it to be of the greatest
|
||||
possible use to the public, the best way to achieve this is to make it
|
||||
free software which everyone can redistribute and change under these terms.
|
||||
|
||||
To do so, attach the following notices to the program. It is safest
|
||||
to attach them to the start of each source file to most effectively
|
||||
state the exclusion of warranty; and each file should have at least
|
||||
the "copyright" line and a pointer to where the full notice is found.
|
||||
|
||||
{one line to give the program's name and a brief idea of what it does.}
|
||||
Copyright (C) {year} {name of author}
|
||||
|
||||
This program is free software: you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation, either version 3 of the License, or
|
||||
(at your option) any later version.
|
||||
|
||||
This program is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
||||
|
||||
Also add information on how to contact you by electronic and paper mail.
|
||||
|
||||
If the program does terminal interaction, make it output a short
|
||||
notice like this when it starts in an interactive mode:
|
||||
|
||||
{project} Copyright (C) {year} {fullname}
|
||||
This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
|
||||
This is free software, and you are welcome to redistribute it
|
||||
under certain conditions; type `show c' for details.
|
||||
|
||||
The hypothetical commands `show w' and `show c' should show the appropriate
|
||||
parts of the General Public License. Of course, your program's commands
|
||||
might be different; for a GUI interface, you would use an "about box".
|
||||
|
||||
You should also get your employer (if you work as a programmer) or school,
|
||||
if any, to sign a "copyright disclaimer" for the program, if necessary.
|
||||
For more information on this, and how to apply and follow the GNU GPL, see
|
||||
<http://www.gnu.org/licenses/>.
|
||||
|
||||
The GNU General Public License does not permit incorporating your program
|
||||
into proprietary programs. If your program is a subroutine library, you
|
||||
may consider it more useful to permit linking proprietary applications with
|
||||
the library. If this is what you want to do, use the GNU Lesser General
|
||||
Public License instead of this License. But first, please read
|
||||
<http://www.gnu.org/philosophy/why-not-lgpl.html>.
|
||||
32
docker/cowrie/README.md
Normal file
32
docker/cowrie/README.md
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
# dockerized cowrie
|
||||
|
||||
|
||||
[cowrie](http://www.micheloosterhof.com/cowrie/) is an extended fork of the medium interaction honeypot [kippo](https://github.com/desaster/kippo).
|
||||
|
||||
This repository contains the necessary files to create a *dockerized* version of cowrie.
|
||||
|
||||
This dockerized version is part of the **[T-Pot community honeypot](http://dtag-dev-sec.github.io/)** of Deutsche Telekom AG.
|
||||
|
||||
The `Dockerfile` contains the blueprint for the dockerized cowrie and will be used to setup the docker image.
|
||||
|
||||
The `cowrie.cfg` is tailored to fit the T-Pot environment.
|
||||
|
||||
The `setup.sql` is also tailored to fit the T-Pot environment.
|
||||
|
||||
The `supervisord.conf` is used to start cowrie under supervision of supervisord.
|
||||
|
||||
Using systemd, copy the `systemd/cowrie.service` to `/etc/systemd/system/cowrie.service` and start using
|
||||
|
||||
```
|
||||
systemctl enable cowrie
|
||||
systemctl start cowrie
|
||||
```
|
||||
|
||||
This will make sure that the docker container is started with the appropriate permissions and port mappings. Further, it autostarts during boot.
|
||||
|
||||
By default all data will be stored in `/data/cowrie/` until the honeypot service will be restarted which is by default every 24 hours. If you want to keep data persistently simply edit the ``service`` file, find the line that contains ``clean.sh`` and set the option from ``off`` to ``on``. Be advised to establish some sort of log management if you wish to do so.
|
||||
|
||||
|
||||
# Cowrie Dashboard
|
||||
|
||||
|
||||
472
docker/cowrie/dist/cowrie.cfg
vendored
Normal file
472
docker/cowrie/dist/cowrie.cfg
vendored
Normal file
|
|
@ -0,0 +1,472 @@
|
|||
#
|
||||
# Cowrie configuration file (cowrie.cfg)
|
||||
#
|
||||
|
||||
# ============================================================================
|
||||
# General Honeypot Options
|
||||
# ============================================================================
|
||||
[honeypot]
|
||||
|
||||
# Sensor name is used to identify this Cowrie instance. Used by the database
|
||||
# logging modules such as mysql.
|
||||
#
|
||||
# If not specified, the logging modules will instead use the IP address of the
|
||||
# server as the sensor name.
|
||||
#
|
||||
# (default: not specified)
|
||||
#sensor_name=t-pot
|
||||
|
||||
# Hostname for the honeypot. Displayed by the shell prompt of the virtual
|
||||
# environment
|
||||
#
|
||||
# (default: svr04)
|
||||
hostname = ubuntu
|
||||
|
||||
|
||||
# Directory where to save log files in.
|
||||
#
|
||||
# (default: log)
|
||||
log_path = log
|
||||
|
||||
|
||||
# Directory where to save downloaded artifacts in.
|
||||
#
|
||||
# (default: dl)
|
||||
download_path = dl
|
||||
|
||||
|
||||
# Directory for miscellaneous data files, such as the password database.
|
||||
#
|
||||
# (default: data_path)
|
||||
data_path = data
|
||||
|
||||
|
||||
# Directory where virtual file contents are kept in.
|
||||
#
|
||||
# This is only used by commands like 'cat' to display the contents of files.
|
||||
# Adding files here is not enough for them to appear in the honeypot - the
|
||||
# actual virtual filesystem is kept in filesystem_file (see below)
|
||||
#
|
||||
# (default: honeyfs)
|
||||
contents_path = honeyfs
|
||||
|
||||
|
||||
# File in the Python pickle format containing the virtual filesystem.
|
||||
#
|
||||
# This includes the filenames, paths, permissions for the Cowrie filesystem,
|
||||
# but not the file contents. This is created by the bin/createfs utility from
|
||||
# a real template linux installation.
|
||||
#
|
||||
# (default: fs.pickle)
|
||||
filesystem_file = data/fs.pickle
|
||||
|
||||
|
||||
# Directory for creating simple commands that only output text.
|
||||
#
|
||||
# The command must be placed under this directory with the proper path, such
|
||||
# as:
|
||||
# txtcmds/usr/bin/vi
|
||||
# The contents of the file will be the output of the command when run inside
|
||||
# the honeypot.
|
||||
#
|
||||
# In addition to this, the file must exist in the virtual filesystem
|
||||
#
|
||||
# (default: txtcmds)
|
||||
txtcmds_path = txtcmds
|
||||
|
||||
|
||||
# Maximum file size (in bytes) for downloaded files to be stored in 'download_path'.
|
||||
# A value of 0 means no limit. If the file size is known to be too big from the start,
|
||||
# the file will not be stored on disk at all.
|
||||
#
|
||||
# (default: 0)
|
||||
#download_limit_size = 10485760
|
||||
|
||||
|
||||
# TTY logging will log a transcript of the complete terminal interaction in UML
|
||||
# compatible format.
|
||||
# (default: true)
|
||||
ttylog = true
|
||||
|
||||
|
||||
|
||||
# ============================================================================
|
||||
# Network Specific Options
|
||||
# ============================================================================
|
||||
|
||||
|
||||
# IP address to bind to when opening outgoing connections. Used by wget and
|
||||
# curl commands.
|
||||
#
|
||||
# (default: not specified)
|
||||
#out_addr = 0.0.0.0
|
||||
|
||||
|
||||
# Fake address displayed as the address of the incoming connection.
|
||||
# This doesn't affect logging, and is only used by honeypot commands such as
|
||||
# 'w' and 'last'
|
||||
#
|
||||
# If not specified, the actual IP address is displayed instead (default
|
||||
# behaviour).
|
||||
#
|
||||
# (default: not specified)
|
||||
#fake_addr = 192.168.66.254
|
||||
|
||||
|
||||
# The IP address on which this machine is reachable on from the internet.
|
||||
# Useful if you use portforwarding or other mechanisms. If empty, Cowrie
|
||||
# will determine by itself. Used in 'netstat' output
|
||||
#
|
||||
#internet_facing_ip = 9.9.9.9
|
||||
|
||||
|
||||
# Enable to log the public IP of the honeypot (useful if listening on 127.0.0.1)
|
||||
# IP address is obtained by querying http://myip.threatstream.com
|
||||
report_public_ip = true
|
||||
|
||||
|
||||
|
||||
# ============================================================================
|
||||
# Authentication Specific Options
|
||||
# ============================================================================
|
||||
|
||||
|
||||
# Class that implements the checklogin() method.
|
||||
#
|
||||
# Class must be defined in cowrie/core/auth.py
|
||||
# Default is the 'UserDB' class which uses the password database.
|
||||
#
|
||||
# Alternatively the 'AuthRandom' class can be used, which will let
|
||||
# a user login after a random number of attempts.
|
||||
# It will also cache username/password combinations that allow login.
|
||||
#
|
||||
#auth_class = UserDB
|
||||
|
||||
# When AuthRandom is used also set the
|
||||
# auth_class_parameters: <min try>, <max try>, <maxcache>
|
||||
# for example: 2, 5, 10 = allows access after randint(2,5) attempts
|
||||
# and cache 10 combinations.
|
||||
#
|
||||
auth_class = AuthRandom
|
||||
auth_class_parameters = 2, 5, 10
|
||||
|
||||
|
||||
# No authentication checking at all
|
||||
# enabling 'auth_none' will enable the ssh2 'auth_none' authentication method
|
||||
# this allows the requested user in without any verification at all
|
||||
#
|
||||
# (default: false)
|
||||
#auth_none_enabled = false
|
||||
|
||||
|
||||
|
||||
# ============================================================================
|
||||
# Historical SSH Specific Options
|
||||
# historical options in [honeypot] that have not yet been moved to [ssh]
|
||||
# ============================================================================
|
||||
|
||||
# Source Port to report in logs (useful if you use iptables to forward ports to Cowrie)
|
||||
reported_ssh_port = 22
|
||||
|
||||
|
||||
|
||||
# ============================================================================
|
||||
# SSH Specific Options
|
||||
# ============================================================================
|
||||
[ssh]
|
||||
|
||||
# Enable SSH support
|
||||
# (default: true)
|
||||
enabled = true
|
||||
|
||||
|
||||
# Public and private SSH key files. If these don't exist, they are created
|
||||
# automatically.
|
||||
rsa_public_key = etc/ssh_host_rsa_key.pub
|
||||
rsa_private_key = etc/ssh_host_rsa_key
|
||||
dsa_public_key = etc/ssh_host_dsa_key.pub
|
||||
dsa_private_key = etc/ssh_host_dsa_key
|
||||
|
||||
# SSH Version String
|
||||
#
|
||||
# Use these to disguise your honeypot from a simple SSH version scan
|
||||
# Examples:
|
||||
# SSH-2.0-OpenSSH_5.1p1 Debian-5
|
||||
# SSH-1.99-OpenSSH_4.3
|
||||
# SSH-1.99-OpenSSH_4.7
|
||||
# SSH-1.99-Sun_SSH_1.1
|
||||
# SSH-2.0-OpenSSH_4.2p1 Debian-7ubuntu3.1
|
||||
# SSH-2.0-OpenSSH_4.3
|
||||
# SSH-2.0-OpenSSH_4.6
|
||||
# SSH-2.0-OpenSSH_5.1p1 Debian-5
|
||||
# SSH-2.0-OpenSSH_5.1p1 FreeBSD-20080901
|
||||
# SSH-2.0-OpenSSH_5.3p1 Debian-3ubuntu5
|
||||
# SSH-2.0-OpenSSH_5.3p1 Debian-3ubuntu6
|
||||
# SSH-2.0-OpenSSH_5.3p1 Debian-3ubuntu7
|
||||
# SSH-2.0-OpenSSH_5.5p1 Debian-6
|
||||
# SSH-2.0-OpenSSH_5.5p1 Debian-6+squeeze1
|
||||
# SSH-2.0-OpenSSH_5.5p1 Debian-6+squeeze2
|
||||
# SSH-2.0-OpenSSH_5.8p2_hpn13v11 FreeBSD-20110503
|
||||
# SSH-2.0-OpenSSH_5.9p1 Debian-5ubuntu1
|
||||
# SSH-2.0-OpenSSH_6.0p1 Debian-4+deb7u2
|
||||
# SSH-2.0-OpenSSH_5.9
|
||||
#
|
||||
# (default: "SSH-2.0-SSH-2.0-OpenSSH_6.0p1 Debian-4+deb7u2")
|
||||
version = SSH-2.0-OpenSSH_7.2p2 Ubuntu-4ubuntu2.2
|
||||
|
||||
|
||||
# IP addresses to listen for incoming SSH connections.
|
||||
#
|
||||
# (default: 0.0.0.0) = any IPv4 address
|
||||
#listen_addr = 0.0.0.0
|
||||
# (use :: for listen to all IPv6 and IPv4 addresses)
|
||||
#listen_addr = ::
|
||||
|
||||
|
||||
# Port to listen for incoming SSH connections.
|
||||
#
|
||||
# (default: 2222)
|
||||
#listen_port = 22
|
||||
|
||||
|
||||
# sftp_enabled enables the sftp subsystem
|
||||
sftp_enabled = true
|
||||
|
||||
|
||||
# Enable SSH direct-tcpip forwarding
|
||||
# (default: true)
|
||||
forwarding = true
|
||||
|
||||
|
||||
# This enables redirecting forwarding requests to another address
|
||||
# Useful for forwarding protocols to other honeypots
|
||||
# (default: false)
|
||||
forward_redirect = false
|
||||
|
||||
|
||||
# Configure where to forward the data to.
|
||||
# forward_redirect_<portnumber> = <redirect ip>:<redirect port>
|
||||
|
||||
# Redirect http/https
|
||||
forward_redirect_80 = 127.0.0.1:8000
|
||||
forward_redirect_443 = 127.0.0.1:8443
|
||||
|
||||
# To record SMTP traffic, install an SMTP honeypoint.
|
||||
# (e.g https://github.com/awhitehatter/mailoney), run
|
||||
# python mailoney.py -s yahoo.com -t schizo_open_relay -p 12525
|
||||
forward_redirect_25 = 127.0.0.1:12525
|
||||
forward_redirect_587 = 127.0.0.1:12525
|
||||
|
||||
|
||||
|
||||
# ============================================================================
|
||||
# Telnet Specific Options
|
||||
# ============================================================================
|
||||
[telnet]
|
||||
|
||||
# Enable Telnet support, disabled by default
|
||||
enabled = true
|
||||
|
||||
# IP addresses to listen for incoming Telnet connections.
|
||||
#
|
||||
# (default: 0.0.0.0) = any IPv4 address
|
||||
#listen_addr = 0.0.0.0
|
||||
# (use :: for listen to all IPv6 and IPv4 addresses)
|
||||
#listen_addr = ::
|
||||
|
||||
|
||||
# Port to listen for incoming Telnet connections.
|
||||
#
|
||||
# (default: 2223)
|
||||
#listen_port = 23
|
||||
|
||||
# Source Port to report in logs (useful if you use iptables to forward ports to Cowrie)
|
||||
reported_port = 23
|
||||
|
||||
|
||||
|
||||
# ============================================================================
|
||||
# Database logging Specific Options
|
||||
# ============================================================================
|
||||
|
||||
# XMPP Logging
|
||||
# Log to an xmpp server.
|
||||
#
|
||||
#[database_xmpp]
|
||||
#server = sensors.carnivore.it
|
||||
#user = anonymous@sensors.carnivore.it
|
||||
#password = anonymous
|
||||
#muc = dionaea.sensors.carnivore.it
|
||||
#signal_createsession = cowrie-events
|
||||
#signal_connectionlost = cowrie-events
|
||||
#signal_loginfailed = cowrie-events
|
||||
#signal_loginsucceeded = cowrie-events
|
||||
#signal_command = cowrie-events
|
||||
#signal_clientversion = cowrie-events
|
||||
#debug=true
|
||||
|
||||
|
||||
|
||||
# ============================================================================
|
||||
# Output Plugins
|
||||
# These provide an extensible mechanism to send audit log entries to third
|
||||
# parties. The audit entries contain information on clients connecting to
|
||||
# the honeypot.
|
||||
# ============================================================================
|
||||
|
||||
|
||||
# JSON based logging module
|
||||
#
|
||||
[output_jsonlog]
|
||||
logfile = log/cowrie.json
|
||||
|
||||
|
||||
# Supports logging to Elasticsearch
|
||||
# This is a simple early release
|
||||
#
|
||||
#[output_elasticsearch]
|
||||
#host = localhost
|
||||
#port = 9200
|
||||
#index = cowrie
|
||||
#type = cowrie
|
||||
|
||||
|
||||
# Send login attemp information to SANS DShield
|
||||
# See https://isc.sans.edu/ssh.html
|
||||
# You must signup for an api key.
|
||||
# Once registered, find your details at: https://isc.sans.edu/myaccount.html
|
||||
#
|
||||
#[output_dshield]
|
||||
#userid = userid_here
|
||||
#auth_key = auth_key_here
|
||||
#batch_size = 100
|
||||
|
||||
|
||||
# Local Syslog output module
|
||||
#
|
||||
# This sends log messages to the local syslog daemon.
|
||||
# Facility can be:
|
||||
# KERN, USER, MAIL, DAEMON, AUTH, LPR, NEWS, UUCP, CRON, SYSLOG and LOCAL0 to LOCAL7.
|
||||
#
|
||||
# Format can be:
|
||||
# text, cef
|
||||
#
|
||||
#[output_localsyslog]
|
||||
#facility = USER
|
||||
#format = text
|
||||
|
||||
|
||||
# Text output
|
||||
# This writes audit log entries to a text file
|
||||
#
|
||||
# Format can be:
|
||||
# text, cef
|
||||
#
|
||||
[output_textlog]
|
||||
logfile = log/cowrie-textlog.log
|
||||
format = text
|
||||
|
||||
|
||||
# MySQL logging module
|
||||
# Database structure for this module is supplied in doc/sql/mysql.sql
|
||||
#
|
||||
# MySQL logging requires extra software: sudo apt-get install libmysqlclient-dev
|
||||
# MySQL logging requires an extra Python module: pip install mysql-python
|
||||
#
|
||||
#[output_mysql]
|
||||
#host = localhost
|
||||
#database = cowrie
|
||||
#username = cowrie
|
||||
#password = secret
|
||||
#port = 3306
|
||||
#debug = false
|
||||
|
||||
# Rethinkdb output module
|
||||
# Rethinkdb output module requires extra Python module: pip install rethinkdb
|
||||
|
||||
#[output_rethinkdblog]
|
||||
#host = 127.0.0.1
|
||||
#port = 28015
|
||||
#table = output
|
||||
#password =
|
||||
#db = cowrie
|
||||
|
||||
# SQLite3 logging module
|
||||
#
|
||||
# Logging to SQLite3 database. To init the database, use the script
|
||||
# doc/sql/sqlite3.sql:
|
||||
# sqlite3 <db_file> < doc/sql/sqlite3.sql
|
||||
#
|
||||
#[output_sqlite]
|
||||
#db_file = cowrie.db
|
||||
|
||||
# MongoDB logging module
|
||||
#
|
||||
# MongoDB logging requires an extra Python module: pip install pymongo
|
||||
#
|
||||
#[output_mongodb]
|
||||
#connection_string = mongodb://username:password@host:port/database
|
||||
#database = dbname
|
||||
|
||||
|
||||
# Splunk SDK output module - Legacy. Requires Splunk API installed
|
||||
# This sends logs directly to Splunk using the Python REST SDK
|
||||
#
|
||||
#[output_splunklegacy]
|
||||
#host = localhost
|
||||
#port = 8889
|
||||
#username = admin
|
||||
#password = password
|
||||
#index = cowrie
|
||||
|
||||
|
||||
# Splunk HTTP Event Collector (HEC) output module
|
||||
# Sends JSON directly to Splunk over HTTPS
|
||||
# mandatory fields: url, token
|
||||
# optional fields: index, source, sourcetype, host
|
||||
#
|
||||
#[output_splunk]
|
||||
#url = https://localhost:8088/services/collector/event
|
||||
#token = 6A0EA6C6-8006-4E39-FC44-C35FF6E561A8
|
||||
#index = cowrie
|
||||
#sourcetype = cowrie
|
||||
#source = cowrie
|
||||
|
||||
|
||||
# HPFeeds
|
||||
#
|
||||
#[output_hpfeeds]
|
||||
#server = hpfeeds.mysite.org
|
||||
#port = 10000
|
||||
#identifier = abc123
|
||||
#secret = secret
|
||||
#debug=false
|
||||
|
||||
|
||||
# VirusTotal output module
|
||||
# You must signup for an api key.
|
||||
#
|
||||
#[output_virustotal]
|
||||
#api_key = 0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef
|
||||
#
|
||||
|
||||
#[output_slack]
|
||||
# This will produce a _lot_ of messages - you have been warned....
|
||||
#channel = channel_that_events_should_be_posted_in
|
||||
#token = slack_token_for_your_bot
|
||||
##debug=true
|
||||
|
||||
|
||||
# https://csirtg.io
|
||||
# You must signup for an api key.
|
||||
#
|
||||
#[output_csirtg]
|
||||
#username=wes
|
||||
#feed=scanners
|
||||
#description=random scanning activity
|
||||
#token=0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef
|
||||
|
||||
|
||||
#[output_socketlog]
|
||||
#address = 127.0.0.1:9000
|
||||
#timeout = 5
|
||||
1
docker/cowrie/dist/userdb.txt
vendored
Normal file
1
docker/cowrie/dist/userdb.txt
vendored
Normal file
|
|
@ -0,0 +1 @@
|
|||
root:0:password
|
||||
BIN
docker/cowrie/doc/dashboard.png
Normal file
BIN
docker/cowrie/doc/dashboard.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 847 KiB |
26
docker/cowrie/docker-compose.yml
Normal file
26
docker/cowrie/docker-compose.yml
Normal file
|
|
@ -0,0 +1,26 @@
|
|||
# T-Pot (Standard)
|
||||
# For docker-compose ...
|
||||
version: '2.1'
|
||||
|
||||
networks:
|
||||
cowrie_local:
|
||||
|
||||
services:
|
||||
|
||||
# Cowrie service
|
||||
cowrie:
|
||||
container_name: cowrie
|
||||
restart: always
|
||||
networks:
|
||||
- cowrie_local
|
||||
cap_add:
|
||||
- NET_BIND_SERVICE
|
||||
ports:
|
||||
- "22:2222"
|
||||
- "23:2223"
|
||||
image: "dtagdevsec/cowrie:1706"
|
||||
volumes:
|
||||
- /data/cowrie/downloads:/home/cowrie/cowrie/dl
|
||||
- /data/cowrie/keys:/home/cowrie/cowrie/etc
|
||||
- /data/cowrie/log:/home/cowrie/cowrie/log
|
||||
- /data/cowrie/log/tty:/home/cowrie/cowrie/log/tty
|
||||
110
docker/dionaea/Dockerfile
Normal file
110
docker/dionaea/Dockerfile
Normal file
|
|
@ -0,0 +1,110 @@
|
|||
FROM debian:stretch-slim
|
||||
MAINTAINER MO
|
||||
ENV DEBIAN_FRONTEND noninteractive
|
||||
|
||||
# Include dist
|
||||
ADD dist/ /root/dist/
|
||||
|
||||
# Install dependencies and packages
|
||||
RUN apt-get update -y && \
|
||||
apt-get upgrade -y && \
|
||||
apt-get install -y --no-install-recommends \
|
||||
autoconf \
|
||||
automake \
|
||||
build-essential \
|
||||
ca-certificates \
|
||||
check \
|
||||
cython3 \
|
||||
git \
|
||||
libcurl4-openssl-dev \
|
||||
libemu-dev \
|
||||
libev-dev \
|
||||
libglib2.0-dev \
|
||||
libloudmouth1-dev \
|
||||
libnetfilter-queue-dev \
|
||||
libnl-3-dev \
|
||||
libpcap-dev \
|
||||
libssl-dev \
|
||||
libtool \
|
||||
libudns-dev \
|
||||
procps \
|
||||
python3 \
|
||||
python3-dev \
|
||||
python3-bson \
|
||||
python3-yaml && \
|
||||
|
||||
# Get and install dionaea
|
||||
git clone https://github.com/dinotools/dionaea /root/dionaea/ && \
|
||||
cd /root/dionaea && \
|
||||
# git checkout 99e9cfc88cfa8f3715813b18ec7006bca2622d76 && \
|
||||
autoreconf -vi && \
|
||||
./configure \
|
||||
--prefix=/opt/dionaea \
|
||||
--with-python=/usr/bin/python3 \
|
||||
--with-cython-dir=/usr/bin \
|
||||
--enable-ev \
|
||||
--with-ev-include=/usr/include \
|
||||
--with-ev-lib=/usr/lib \
|
||||
--with-emu-lib=/usr/lib/libemu \
|
||||
--with-emu-include=/usr/include \
|
||||
--with-nl-include=/usr/include/libnl3 \
|
||||
--with-nl-lib=/usr/lib \
|
||||
--enable-static && \
|
||||
make && \
|
||||
make install && \
|
||||
|
||||
# Setup user and groups
|
||||
addgroup --gid 2000 dionaea && \
|
||||
adduser --system --no-create-home --shell /bin/bash --uid 2000 --disabled-password --disabled-login --gid 2000 dionaea && \
|
||||
|
||||
# Supply configs and set permissions
|
||||
chown -R dionaea:dionaea /opt/dionaea/var && \
|
||||
rm -rf /opt/dionaea/etc/dionaea/* && \
|
||||
mv /root/dist/etc/* /opt/dionaea/etc/dionaea/ && \
|
||||
|
||||
# Setup runtime and clean up
|
||||
apt-get purge -y \
|
||||
autoconf \
|
||||
automake \
|
||||
build-essential \
|
||||
ca-certificates \
|
||||
check \
|
||||
cython3 \
|
||||
git \
|
||||
libcurl4-openssl-dev \
|
||||
libemu-dev \
|
||||
libev-dev \
|
||||
libglib2.0-dev \
|
||||
libloudmouth1-dev \
|
||||
libnetfilter-queue-dev \
|
||||
libnl-3-dev \
|
||||
libpcap-dev \
|
||||
libssl-dev \
|
||||
libtool \
|
||||
libudns-dev \
|
||||
python3 \
|
||||
python3-dev \
|
||||
python3-bson \
|
||||
python3-yaml && \
|
||||
|
||||
apt-get install -y \
|
||||
ca-certificates \
|
||||
python3 \
|
||||
python3-bson \
|
||||
python3-yaml \
|
||||
libcurl3 \
|
||||
libemu2 \
|
||||
libev4 \
|
||||
libglib2.0-0 \
|
||||
libnetfilter-queue1 \
|
||||
libnl-3-200 \
|
||||
libpcap0.8 \
|
||||
libpython3.5 \
|
||||
libudns0 && \
|
||||
|
||||
apt-get autoremove --purge -y && \
|
||||
apt-get clean && \
|
||||
rm -rf /root/* /var/lib/apt/lists/* /tmp/* /var/tmp/*
|
||||
|
||||
# Start dionaea
|
||||
CMD ["/opt/dionaea/bin/dionaea", "-u", "dionaea", "-g", "dionaea", "-c", "/opt/dionaea/etc/dionaea/dionaea.cfg"]
|
||||
674
docker/dionaea/LICENSE
Normal file
674
docker/dionaea/LICENSE
Normal file
|
|
@ -0,0 +1,674 @@
|
|||
GNU GENERAL PUBLIC LICENSE
|
||||
Version 3, 29 June 2007
|
||||
|
||||
Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
|
||||
Everyone is permitted to copy and distribute verbatim copies
|
||||
of this license document, but changing it is not allowed.
|
||||
|
||||
Preamble
|
||||
|
||||
The GNU General Public License is a free, copyleft license for
|
||||
software and other kinds of works.
|
||||
|
||||
The licenses for most software and other practical works are designed
|
||||
to take away your freedom to share and change the works. By contrast,
|
||||
the GNU General Public License is intended to guarantee your freedom to
|
||||
share and change all versions of a program--to make sure it remains free
|
||||
software for all its users. We, the Free Software Foundation, use the
|
||||
GNU General Public License for most of our software; it applies also to
|
||||
any other work released this way by its authors. You can apply it to
|
||||
your programs, too.
|
||||
|
||||
When we speak of free software, we are referring to freedom, not
|
||||
price. Our General Public Licenses are designed to make sure that you
|
||||
have the freedom to distribute copies of free software (and charge for
|
||||
them if you wish), that you receive source code or can get it if you
|
||||
want it, that you can change the software or use pieces of it in new
|
||||
free programs, and that you know you can do these things.
|
||||
|
||||
To protect your rights, we need to prevent others from denying you
|
||||
these rights or asking you to surrender the rights. Therefore, you have
|
||||
certain responsibilities if you distribute copies of the software, or if
|
||||
you modify it: responsibilities to respect the freedom of others.
|
||||
|
||||
For example, if you distribute copies of such a program, whether
|
||||
gratis or for a fee, you must pass on to the recipients the same
|
||||
freedoms that you received. You must make sure that they, too, receive
|
||||
or can get the source code. And you must show them these terms so they
|
||||
know their rights.
|
||||
|
||||
Developers that use the GNU GPL protect your rights with two steps:
|
||||
(1) assert copyright on the software, and (2) offer you this License
|
||||
giving you legal permission to copy, distribute and/or modify it.
|
||||
|
||||
For the developers' and authors' protection, the GPL clearly explains
|
||||
that there is no warranty for this free software. For both users' and
|
||||
authors' sake, the GPL requires that modified versions be marked as
|
||||
changed, so that their problems will not be attributed erroneously to
|
||||
authors of previous versions.
|
||||
|
||||
Some devices are designed to deny users access to install or run
|
||||
modified versions of the software inside them, although the manufacturer
|
||||
can do so. This is fundamentally incompatible with the aim of
|
||||
protecting users' freedom to change the software. The systematic
|
||||
pattern of such abuse occurs in the area of products for individuals to
|
||||
use, which is precisely where it is most unacceptable. Therefore, we
|
||||
have designed this version of the GPL to prohibit the practice for those
|
||||
products. If such problems arise substantially in other domains, we
|
||||
stand ready to extend this provision to those domains in future versions
|
||||
of the GPL, as needed to protect the freedom of users.
|
||||
|
||||
Finally, every program is threatened constantly by software patents.
|
||||
States should not allow patents to restrict development and use of
|
||||
software on general-purpose computers, but in those that do, we wish to
|
||||
avoid the special danger that patents applied to a free program could
|
||||
make it effectively proprietary. To prevent this, the GPL assures that
|
||||
patents cannot be used to render the program non-free.
|
||||
|
||||
The precise terms and conditions for copying, distribution and
|
||||
modification follow.
|
||||
|
||||
TERMS AND CONDITIONS
|
||||
|
||||
0. Definitions.
|
||||
|
||||
"This License" refers to version 3 of the GNU General Public License.
|
||||
|
||||
"Copyright" also means copyright-like laws that apply to other kinds of
|
||||
works, such as semiconductor masks.
|
||||
|
||||
"The Program" refers to any copyrightable work licensed under this
|
||||
License. Each licensee is addressed as "you". "Licensees" and
|
||||
"recipients" may be individuals or organizations.
|
||||
|
||||
To "modify" a work means to copy from or adapt all or part of the work
|
||||
in a fashion requiring copyright permission, other than the making of an
|
||||
exact copy. The resulting work is called a "modified version" of the
|
||||
earlier work or a work "based on" the earlier work.
|
||||
|
||||
A "covered work" means either the unmodified Program or a work based
|
||||
on the Program.
|
||||
|
||||
To "propagate" a work means to do anything with it that, without
|
||||
permission, would make you directly or secondarily liable for
|
||||
infringement under applicable copyright law, except executing it on a
|
||||
computer or modifying a private copy. Propagation includes copying,
|
||||
distribution (with or without modification), making available to the
|
||||
public, and in some countries other activities as well.
|
||||
|
||||
To "convey" a work means any kind of propagation that enables other
|
||||
parties to make or receive copies. Mere interaction with a user through
|
||||
a computer network, with no transfer of a copy, is not conveying.
|
||||
|
||||
An interactive user interface displays "Appropriate Legal Notices"
|
||||
to the extent that it includes a convenient and prominently visible
|
||||
feature that (1) displays an appropriate copyright notice, and (2)
|
||||
tells the user that there is no warranty for the work (except to the
|
||||
extent that warranties are provided), that licensees may convey the
|
||||
work under this License, and how to view a copy of this License. If
|
||||
the interface presents a list of user commands or options, such as a
|
||||
menu, a prominent item in the list meets this criterion.
|
||||
|
||||
1. Source Code.
|
||||
|
||||
The "source code" for a work means the preferred form of the work
|
||||
for making modifications to it. "Object code" means any non-source
|
||||
form of a work.
|
||||
|
||||
A "Standard Interface" means an interface that either is an official
|
||||
standard defined by a recognized standards body, or, in the case of
|
||||
interfaces specified for a particular programming language, one that
|
||||
is widely used among developers working in that language.
|
||||
|
||||
The "System Libraries" of an executable work include anything, other
|
||||
than the work as a whole, that (a) is included in the normal form of
|
||||
packaging a Major Component, but which is not part of that Major
|
||||
Component, and (b) serves only to enable use of the work with that
|
||||
Major Component, or to implement a Standard Interface for which an
|
||||
implementation is available to the public in source code form. A
|
||||
"Major Component", in this context, means a major essential component
|
||||
(kernel, window system, and so on) of the specific operating system
|
||||
(if any) on which the executable work runs, or a compiler used to
|
||||
produce the work, or an object code interpreter used to run it.
|
||||
|
||||
The "Corresponding Source" for a work in object code form means all
|
||||
the source code needed to generate, install, and (for an executable
|
||||
work) run the object code and to modify the work, including scripts to
|
||||
control those activities. However, it does not include the work's
|
||||
System Libraries, or general-purpose tools or generally available free
|
||||
programs which are used unmodified in performing those activities but
|
||||
which are not part of the work. For example, Corresponding Source
|
||||
includes interface definition files associated with source files for
|
||||
the work, and the source code for shared libraries and dynamically
|
||||
linked subprograms that the work is specifically designed to require,
|
||||
such as by intimate data communication or control flow between those
|
||||
subprograms and other parts of the work.
|
||||
|
||||
The Corresponding Source need not include anything that users
|
||||
can regenerate automatically from other parts of the Corresponding
|
||||
Source.
|
||||
|
||||
The Corresponding Source for a work in source code form is that
|
||||
same work.
|
||||
|
||||
2. Basic Permissions.
|
||||
|
||||
All rights granted under this License are granted for the term of
|
||||
copyright on the Program, and are irrevocable provided the stated
|
||||
conditions are met. This License explicitly affirms your unlimited
|
||||
permission to run the unmodified Program. The output from running a
|
||||
covered work is covered by this License only if the output, given its
|
||||
content, constitutes a covered work. This License acknowledges your
|
||||
rights of fair use or other equivalent, as provided by copyright law.
|
||||
|
||||
You may make, run and propagate covered works that you do not
|
||||
convey, without conditions so long as your license otherwise remains
|
||||
in force. You may convey covered works to others for the sole purpose
|
||||
of having them make modifications exclusively for you, or provide you
|
||||
with facilities for running those works, provided that you comply with
|
||||
the terms of this License in conveying all material for which you do
|
||||
not control copyright. Those thus making or running the covered works
|
||||
for you must do so exclusively on your behalf, under your direction
|
||||
and control, on terms that prohibit them from making any copies of
|
||||
your copyrighted material outside their relationship with you.
|
||||
|
||||
Conveying under any other circumstances is permitted solely under
|
||||
the conditions stated below. Sublicensing is not allowed; section 10
|
||||
makes it unnecessary.
|
||||
|
||||
3. Protecting Users' Legal Rights From Anti-Circumvention Law.
|
||||
|
||||
No covered work shall be deemed part of an effective technological
|
||||
measure under any applicable law fulfilling obligations under article
|
||||
11 of the WIPO copyright treaty adopted on 20 December 1996, or
|
||||
similar laws prohibiting or restricting circumvention of such
|
||||
measures.
|
||||
|
||||
When you convey a covered work, you waive any legal power to forbid
|
||||
circumvention of technological measures to the extent such circumvention
|
||||
is effected by exercising rights under this License with respect to
|
||||
the covered work, and you disclaim any intention to limit operation or
|
||||
modification of the work as a means of enforcing, against the work's
|
||||
users, your or third parties' legal rights to forbid circumvention of
|
||||
technological measures.
|
||||
|
||||
4. Conveying Verbatim Copies.
|
||||
|
||||
You may convey verbatim copies of the Program's source code as you
|
||||
receive it, in any medium, provided that you conspicuously and
|
||||
appropriately publish on each copy an appropriate copyright notice;
|
||||
keep intact all notices stating that this License and any
|
||||
non-permissive terms added in accord with section 7 apply to the code;
|
||||
keep intact all notices of the absence of any warranty; and give all
|
||||
recipients a copy of this License along with the Program.
|
||||
|
||||
You may charge any price or no price for each copy that you convey,
|
||||
and you may offer support or warranty protection for a fee.
|
||||
|
||||
5. Conveying Modified Source Versions.
|
||||
|
||||
You may convey a work based on the Program, or the modifications to
|
||||
produce it from the Program, in the form of source code under the
|
||||
terms of section 4, provided that you also meet all of these conditions:
|
||||
|
||||
a) The work must carry prominent notices stating that you modified
|
||||
it, and giving a relevant date.
|
||||
|
||||
b) The work must carry prominent notices stating that it is
|
||||
released under this License and any conditions added under section
|
||||
7. This requirement modifies the requirement in section 4 to
|
||||
"keep intact all notices".
|
||||
|
||||
c) You must license the entire work, as a whole, under this
|
||||
License to anyone who comes into possession of a copy. This
|
||||
License will therefore apply, along with any applicable section 7
|
||||
additional terms, to the whole of the work, and all its parts,
|
||||
regardless of how they are packaged. This License gives no
|
||||
permission to license the work in any other way, but it does not
|
||||
invalidate such permission if you have separately received it.
|
||||
|
||||
d) If the work has interactive user interfaces, each must display
|
||||
Appropriate Legal Notices; however, if the Program has interactive
|
||||
interfaces that do not display Appropriate Legal Notices, your
|
||||
work need not make them do so.
|
||||
|
||||
A compilation of a covered work with other separate and independent
|
||||
works, which are not by their nature extensions of the covered work,
|
||||
and which are not combined with it such as to form a larger program,
|
||||
in or on a volume of a storage or distribution medium, is called an
|
||||
"aggregate" if the compilation and its resulting copyright are not
|
||||
used to limit the access or legal rights of the compilation's users
|
||||
beyond what the individual works permit. Inclusion of a covered work
|
||||
in an aggregate does not cause this License to apply to the other
|
||||
parts of the aggregate.
|
||||
|
||||
6. Conveying Non-Source Forms.
|
||||
|
||||
You may convey a covered work in object code form under the terms
|
||||
of sections 4 and 5, provided that you also convey the
|
||||
machine-readable Corresponding Source under the terms of this License,
|
||||
in one of these ways:
|
||||
|
||||
a) Convey the object code in, or embodied in, a physical product
|
||||
(including a physical distribution medium), accompanied by the
|
||||
Corresponding Source fixed on a durable physical medium
|
||||
customarily used for software interchange.
|
||||
|
||||
b) Convey the object code in, or embodied in, a physical product
|
||||
(including a physical distribution medium), accompanied by a
|
||||
written offer, valid for at least three years and valid for as
|
||||
long as you offer spare parts or customer support for that product
|
||||
model, to give anyone who possesses the object code either (1) a
|
||||
copy of the Corresponding Source for all the software in the
|
||||
product that is covered by this License, on a durable physical
|
||||
medium customarily used for software interchange, for a price no
|
||||
more than your reasonable cost of physically performing this
|
||||
conveying of source, or (2) access to copy the
|
||||
Corresponding Source from a network server at no charge.
|
||||
|
||||
c) Convey individual copies of the object code with a copy of the
|
||||
written offer to provide the Corresponding Source. This
|
||||
alternative is allowed only occasionally and noncommercially, and
|
||||
only if you received the object code with such an offer, in accord
|
||||
with subsection 6b.
|
||||
|
||||
d) Convey the object code by offering access from a designated
|
||||
place (gratis or for a charge), and offer equivalent access to the
|
||||
Corresponding Source in the same way through the same place at no
|
||||
further charge. You need not require recipients to copy the
|
||||
Corresponding Source along with the object code. If the place to
|
||||
copy the object code is a network server, the Corresponding Source
|
||||
may be on a different server (operated by you or a third party)
|
||||
that supports equivalent copying facilities, provided you maintain
|
||||
clear directions next to the object code saying where to find the
|
||||
Corresponding Source. Regardless of what server hosts the
|
||||
Corresponding Source, you remain obligated to ensure that it is
|
||||
available for as long as needed to satisfy these requirements.
|
||||
|
||||
e) Convey the object code using peer-to-peer transmission, provided
|
||||
you inform other peers where the object code and Corresponding
|
||||
Source of the work are being offered to the general public at no
|
||||
charge under subsection 6d.
|
||||
|
||||
A separable portion of the object code, whose source code is excluded
|
||||
from the Corresponding Source as a System Library, need not be
|
||||
included in conveying the object code work.
|
||||
|
||||
A "User Product" is either (1) a "consumer product", which means any
|
||||
tangible personal property which is normally used for personal, family,
|
||||
or household purposes, or (2) anything designed or sold for incorporation
|
||||
into a dwelling. In determining whether a product is a consumer product,
|
||||
doubtful cases shall be resolved in favor of coverage. For a particular
|
||||
product received by a particular user, "normally used" refers to a
|
||||
typical or common use of that class of product, regardless of the status
|
||||
of the particular user or of the way in which the particular user
|
||||
actually uses, or expects or is expected to use, the product. A product
|
||||
is a consumer product regardless of whether the product has substantial
|
||||
commercial, industrial or non-consumer uses, unless such uses represent
|
||||
the only significant mode of use of the product.
|
||||
|
||||
"Installation Information" for a User Product means any methods,
|
||||
procedures, authorization keys, or other information required to install
|
||||
and execute modified versions of a covered work in that User Product from
|
||||
a modified version of its Corresponding Source. The information must
|
||||
suffice to ensure that the continued functioning of the modified object
|
||||
code is in no case prevented or interfered with solely because
|
||||
modification has been made.
|
||||
|
||||
If you convey an object code work under this section in, or with, or
|
||||
specifically for use in, a User Product, and the conveying occurs as
|
||||
part of a transaction in which the right of possession and use of the
|
||||
User Product is transferred to the recipient in perpetuity or for a
|
||||
fixed term (regardless of how the transaction is characterized), the
|
||||
Corresponding Source conveyed under this section must be accompanied
|
||||
by the Installation Information. But this requirement does not apply
|
||||
if neither you nor any third party retains the ability to install
|
||||
modified object code on the User Product (for example, the work has
|
||||
been installed in ROM).
|
||||
|
||||
The requirement to provide Installation Information does not include a
|
||||
requirement to continue to provide support service, warranty, or updates
|
||||
for a work that has been modified or installed by the recipient, or for
|
||||
the User Product in which it has been modified or installed. Access to a
|
||||
network may be denied when the modification itself materially and
|
||||
adversely affects the operation of the network or violates the rules and
|
||||
protocols for communication across the network.
|
||||
|
||||
Corresponding Source conveyed, and Installation Information provided,
|
||||
in accord with this section must be in a format that is publicly
|
||||
documented (and with an implementation available to the public in
|
||||
source code form), and must require no special password or key for
|
||||
unpacking, reading or copying.
|
||||
|
||||
7. Additional Terms.
|
||||
|
||||
"Additional permissions" are terms that supplement the terms of this
|
||||
License by making exceptions from one or more of its conditions.
|
||||
Additional permissions that are applicable to the entire Program shall
|
||||
be treated as though they were included in this License, to the extent
|
||||
that they are valid under applicable law. If additional permissions
|
||||
apply only to part of the Program, that part may be used separately
|
||||
under those permissions, but the entire Program remains governed by
|
||||
this License without regard to the additional permissions.
|
||||
|
||||
When you convey a copy of a covered work, you may at your option
|
||||
remove any additional permissions from that copy, or from any part of
|
||||
it. (Additional permissions may be written to require their own
|
||||
removal in certain cases when you modify the work.) You may place
|
||||
additional permissions on material, added by you to a covered work,
|
||||
for which you have or can give appropriate copyright permission.
|
||||
|
||||
Notwithstanding any other provision of this License, for material you
|
||||
add to a covered work, you may (if authorized by the copyright holders of
|
||||
that material) supplement the terms of this License with terms:
|
||||
|
||||
a) Disclaiming warranty or limiting liability differently from the
|
||||
terms of sections 15 and 16 of this License; or
|
||||
|
||||
b) Requiring preservation of specified reasonable legal notices or
|
||||
author attributions in that material or in the Appropriate Legal
|
||||
Notices displayed by works containing it; or
|
||||
|
||||
c) Prohibiting misrepresentation of the origin of that material, or
|
||||
requiring that modified versions of such material be marked in
|
||||
reasonable ways as different from the original version; or
|
||||
|
||||
d) Limiting the use for publicity purposes of names of licensors or
|
||||
authors of the material; or
|
||||
|
||||
e) Declining to grant rights under trademark law for use of some
|
||||
trade names, trademarks, or service marks; or
|
||||
|
||||
f) Requiring indemnification of licensors and authors of that
|
||||
material by anyone who conveys the material (or modified versions of
|
||||
it) with contractual assumptions of liability to the recipient, for
|
||||
any liability that these contractual assumptions directly impose on
|
||||
those licensors and authors.
|
||||
|
||||
All other non-permissive additional terms are considered "further
|
||||
restrictions" within the meaning of section 10. If the Program as you
|
||||
received it, or any part of it, contains a notice stating that it is
|
||||
governed by this License along with a term that is a further
|
||||
restriction, you may remove that term. If a license document contains
|
||||
a further restriction but permits relicensing or conveying under this
|
||||
License, you may add to a covered work material governed by the terms
|
||||
of that license document, provided that the further restriction does
|
||||
not survive such relicensing or conveying.
|
||||
|
||||
If you add terms to a covered work in accord with this section, you
|
||||
must place, in the relevant source files, a statement of the
|
||||
additional terms that apply to those files, or a notice indicating
|
||||
where to find the applicable terms.
|
||||
|
||||
Additional terms, permissive or non-permissive, may be stated in the
|
||||
form of a separately written license, or stated as exceptions;
|
||||
the above requirements apply either way.
|
||||
|
||||
8. Termination.
|
||||
|
||||
You may not propagate or modify a covered work except as expressly
|
||||
provided under this License. Any attempt otherwise to propagate or
|
||||
modify it is void, and will automatically terminate your rights under
|
||||
this License (including any patent licenses granted under the third
|
||||
paragraph of section 11).
|
||||
|
||||
However, if you cease all violation of this License, then your
|
||||
license from a particular copyright holder is reinstated (a)
|
||||
provisionally, unless and until the copyright holder explicitly and
|
||||
finally terminates your license, and (b) permanently, if the copyright
|
||||
holder fails to notify you of the violation by some reasonable means
|
||||
prior to 60 days after the cessation.
|
||||
|
||||
Moreover, your license from a particular copyright holder is
|
||||
reinstated permanently if the copyright holder notifies you of the
|
||||
violation by some reasonable means, this is the first time you have
|
||||
received notice of violation of this License (for any work) from that
|
||||
copyright holder, and you cure the violation prior to 30 days after
|
||||
your receipt of the notice.
|
||||
|
||||
Termination of your rights under this section does not terminate the
|
||||
licenses of parties who have received copies or rights from you under
|
||||
this License. If your rights have been terminated and not permanently
|
||||
reinstated, you do not qualify to receive new licenses for the same
|
||||
material under section 10.
|
||||
|
||||
9. Acceptance Not Required for Having Copies.
|
||||
|
||||
You are not required to accept this License in order to receive or
|
||||
run a copy of the Program. Ancillary propagation of a covered work
|
||||
occurring solely as a consequence of using peer-to-peer transmission
|
||||
to receive a copy likewise does not require acceptance. However,
|
||||
nothing other than this License grants you permission to propagate or
|
||||
modify any covered work. These actions infringe copyright if you do
|
||||
not accept this License. Therefore, by modifying or propagating a
|
||||
covered work, you indicate your acceptance of this License to do so.
|
||||
|
||||
10. Automatic Licensing of Downstream Recipients.
|
||||
|
||||
Each time you convey a covered work, the recipient automatically
|
||||
receives a license from the original licensors, to run, modify and
|
||||
propagate that work, subject to this License. You are not responsible
|
||||
for enforcing compliance by third parties with this License.
|
||||
|
||||
An "entity transaction" is a transaction transferring control of an
|
||||
organization, or substantially all assets of one, or subdividing an
|
||||
organization, or merging organizations. If propagation of a covered
|
||||
work results from an entity transaction, each party to that
|
||||
transaction who receives a copy of the work also receives whatever
|
||||
licenses to the work the party's predecessor in interest had or could
|
||||
give under the previous paragraph, plus a right to possession of the
|
||||
Corresponding Source of the work from the predecessor in interest, if
|
||||
the predecessor has it or can get it with reasonable efforts.
|
||||
|
||||
You may not impose any further restrictions on the exercise of the
|
||||
rights granted or affirmed under this License. For example, you may
|
||||
not impose a license fee, royalty, or other charge for exercise of
|
||||
rights granted under this License, and you may not initiate litigation
|
||||
(including a cross-claim or counterclaim in a lawsuit) alleging that
|
||||
any patent claim is infringed by making, using, selling, offering for
|
||||
sale, or importing the Program or any portion of it.
|
||||
|
||||
11. Patents.
|
||||
|
||||
A "contributor" is a copyright holder who authorizes use under this
|
||||
License of the Program or a work on which the Program is based. The
|
||||
work thus licensed is called the contributor's "contributor version".
|
||||
|
||||
A contributor's "essential patent claims" are all patent claims
|
||||
owned or controlled by the contributor, whether already acquired or
|
||||
hereafter acquired, that would be infringed by some manner, permitted
|
||||
by this License, of making, using, or selling its contributor version,
|
||||
but do not include claims that would be infringed only as a
|
||||
consequence of further modification of the contributor version. For
|
||||
purposes of this definition, "control" includes the right to grant
|
||||
patent sublicenses in a manner consistent with the requirements of
|
||||
this License.
|
||||
|
||||
Each contributor grants you a non-exclusive, worldwide, royalty-free
|
||||
patent license under the contributor's essential patent claims, to
|
||||
make, use, sell, offer for sale, import and otherwise run, modify and
|
||||
propagate the contents of its contributor version.
|
||||
|
||||
In the following three paragraphs, a "patent license" is any express
|
||||
agreement or commitment, however denominated, not to enforce a patent
|
||||
(such as an express permission to practice a patent or covenant not to
|
||||
sue for patent infringement). To "grant" such a patent license to a
|
||||
party means to make such an agreement or commitment not to enforce a
|
||||
patent against the party.
|
||||
|
||||
If you convey a covered work, knowingly relying on a patent license,
|
||||
and the Corresponding Source of the work is not available for anyone
|
||||
to copy, free of charge and under the terms of this License, through a
|
||||
publicly available network server or other readily accessible means,
|
||||
then you must either (1) cause the Corresponding Source to be so
|
||||
available, or (2) arrange to deprive yourself of the benefit of the
|
||||
patent license for this particular work, or (3) arrange, in a manner
|
||||
consistent with the requirements of this License, to extend the patent
|
||||
license to downstream recipients. "Knowingly relying" means you have
|
||||
actual knowledge that, but for the patent license, your conveying the
|
||||
covered work in a country, or your recipient's use of the covered work
|
||||
in a country, would infringe one or more identifiable patents in that
|
||||
country that you have reason to believe are valid.
|
||||
|
||||
If, pursuant to or in connection with a single transaction or
|
||||
arrangement, you convey, or propagate by procuring conveyance of, a
|
||||
covered work, and grant a patent license to some of the parties
|
||||
receiving the covered work authorizing them to use, propagate, modify
|
||||
or convey a specific copy of the covered work, then the patent license
|
||||
you grant is automatically extended to all recipients of the covered
|
||||
work and works based on it.
|
||||
|
||||
A patent license is "discriminatory" if it does not include within
|
||||
the scope of its coverage, prohibits the exercise of, or is
|
||||
conditioned on the non-exercise of one or more of the rights that are
|
||||
specifically granted under this License. You may not convey a covered
|
||||
work if you are a party to an arrangement with a third party that is
|
||||
in the business of distributing software, under which you make payment
|
||||
to the third party based on the extent of your activity of conveying
|
||||
the work, and under which the third party grants, to any of the
|
||||
parties who would receive the covered work from you, a discriminatory
|
||||
patent license (a) in connection with copies of the covered work
|
||||
conveyed by you (or copies made from those copies), or (b) primarily
|
||||
for and in connection with specific products or compilations that
|
||||
contain the covered work, unless you entered into that arrangement,
|
||||
or that patent license was granted, prior to 28 March 2007.
|
||||
|
||||
Nothing in this License shall be construed as excluding or limiting
|
||||
any implied license or other defenses to infringement that may
|
||||
otherwise be available to you under applicable patent law.
|
||||
|
||||
12. No Surrender of Others' Freedom.
|
||||
|
||||
If conditions are imposed on you (whether by court order, agreement or
|
||||
otherwise) that contradict the conditions of this License, they do not
|
||||
excuse you from the conditions of this License. If you cannot convey a
|
||||
covered work so as to satisfy simultaneously your obligations under this
|
||||
License and any other pertinent obligations, then as a consequence you may
|
||||
not convey it at all. For example, if you agree to terms that obligate you
|
||||
to collect a royalty for further conveying from those to whom you convey
|
||||
the Program, the only way you could satisfy both those terms and this
|
||||
License would be to refrain entirely from conveying the Program.
|
||||
|
||||
13. Use with the GNU Affero General Public License.
|
||||
|
||||
Notwithstanding any other provision of this License, you have
|
||||
permission to link or combine any covered work with a work licensed
|
||||
under version 3 of the GNU Affero General Public License into a single
|
||||
combined work, and to convey the resulting work. The terms of this
|
||||
License will continue to apply to the part which is the covered work,
|
||||
but the special requirements of the GNU Affero General Public License,
|
||||
section 13, concerning interaction through a network will apply to the
|
||||
combination as such.
|
||||
|
||||
14. Revised Versions of this License.
|
||||
|
||||
The Free Software Foundation may publish revised and/or new versions of
|
||||
the GNU General Public License from time to time. Such new versions will
|
||||
be similar in spirit to the present version, but may differ in detail to
|
||||
address new problems or concerns.
|
||||
|
||||
Each version is given a distinguishing version number. If the
|
||||
Program specifies that a certain numbered version of the GNU General
|
||||
Public License "or any later version" applies to it, you have the
|
||||
option of following the terms and conditions either of that numbered
|
||||
version or of any later version published by the Free Software
|
||||
Foundation. If the Program does not specify a version number of the
|
||||
GNU General Public License, you may choose any version ever published
|
||||
by the Free Software Foundation.
|
||||
|
||||
If the Program specifies that a proxy can decide which future
|
||||
versions of the GNU General Public License can be used, that proxy's
|
||||
public statement of acceptance of a version permanently authorizes you
|
||||
to choose that version for the Program.
|
||||
|
||||
Later license versions may give you additional or different
|
||||
permissions. However, no additional obligations are imposed on any
|
||||
author or copyright holder as a result of your choosing to follow a
|
||||
later version.
|
||||
|
||||
15. Disclaimer of Warranty.
|
||||
|
||||
THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
|
||||
APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
|
||||
HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
|
||||
OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
|
||||
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
||||
PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
|
||||
IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
|
||||
ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
|
||||
|
||||
16. Limitation of Liability.
|
||||
|
||||
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
|
||||
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
|
||||
THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
|
||||
GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
|
||||
USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
|
||||
DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
|
||||
PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
|
||||
EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
|
||||
SUCH DAMAGES.
|
||||
|
||||
17. Interpretation of Sections 15 and 16.
|
||||
|
||||
If the disclaimer of warranty and limitation of liability provided
|
||||
above cannot be given local legal effect according to their terms,
|
||||
reviewing courts shall apply local law that most closely approximates
|
||||
an absolute waiver of all civil liability in connection with the
|
||||
Program, unless a warranty or assumption of liability accompanies a
|
||||
copy of the Program in return for a fee.
|
||||
|
||||
END OF TERMS AND CONDITIONS
|
||||
|
||||
How to Apply These Terms to Your New Programs
|
||||
|
||||
If you develop a new program, and you want it to be of the greatest
|
||||
possible use to the public, the best way to achieve this is to make it
|
||||
free software which everyone can redistribute and change under these terms.
|
||||
|
||||
To do so, attach the following notices to the program. It is safest
|
||||
to attach them to the start of each source file to most effectively
|
||||
state the exclusion of warranty; and each file should have at least
|
||||
the "copyright" line and a pointer to where the full notice is found.
|
||||
|
||||
{one line to give the program's name and a brief idea of what it does.}
|
||||
Copyright (C) {year} {name of author}
|
||||
|
||||
This program is free software: you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation, either version 3 of the License, or
|
||||
(at your option) any later version.
|
||||
|
||||
This program is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
||||
|
||||
Also add information on how to contact you by electronic and paper mail.
|
||||
|
||||
If the program does terminal interaction, make it output a short
|
||||
notice like this when it starts in an interactive mode:
|
||||
|
||||
{project} Copyright (C) {year} {fullname}
|
||||
This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
|
||||
This is free software, and you are welcome to redistribute it
|
||||
under certain conditions; type `show c' for details.
|
||||
|
||||
The hypothetical commands `show w' and `show c' should show the appropriate
|
||||
parts of the General Public License. Of course, your program's commands
|
||||
might be different; for a GUI interface, you would use an "about box".
|
||||
|
||||
You should also get your employer (if you work as a programmer) or school,
|
||||
if any, to sign a "copyright disclaimer" for the program, if necessary.
|
||||
For more information on this, and how to apply and follow the GNU GPL, see
|
||||
<http://www.gnu.org/licenses/>.
|
||||
|
||||
The GNU General Public License does not permit incorporating your program
|
||||
into proprietary programs. If your program is a subroutine library, you
|
||||
may consider it more useful to permit linking proprietary applications with
|
||||
the library. If this is what you want to do, use the GNU Lesser General
|
||||
Public License instead of this License. But first, please read
|
||||
<http://www.gnu.org/philosophy/why-not-lgpl.html>.
|
||||
29
docker/dionaea/README.md
Normal file
29
docker/dionaea/README.md
Normal file
|
|
@ -0,0 +1,29 @@
|
|||
# dockerized dionaea
|
||||
|
||||
|
||||
[dionaea](https://github.com/DinoTools/dionaea) is a low interaction honeypot with focus on capturing malware.
|
||||
|
||||
This repository contains the necessary files to create a *dockerized* version of dionaea.
|
||||
|
||||
This dockerized version is part of the **[T-Pot community honeypot](http://dtag-dev-sec.github.io/)** of Deutsche Telekom AG.
|
||||
|
||||
The `Dockerfile` contains the blueprint for the dockerized dionaea and will be used to setup the docker image.
|
||||
|
||||
The `dionaea.conf` is tailored to fit the T-Pot environment.
|
||||
|
||||
The `supervisord.conf` is used to start dionaea under supervision of supervisord.
|
||||
|
||||
Using systemd, copy the `systemd/dionaea.service` to `/etc/systemd/system/dionaea.service` and start using
|
||||
|
||||
```
|
||||
systemctl enable dionaea
|
||||
systemctl start dionaea
|
||||
```
|
||||
|
||||
This will make sure that the docker container is started with the appropriate permissions and port mappings. Further, it autostarts during boot.
|
||||
|
||||
By default all data will be stored in `/data/dionaea/` until the honeypot service will be restarted which is by default every 24 hours. If you want to keep data persistently simply edit the ``service`` file, find the line that contains ``clean.sh`` and set the option from ``off`` to ``on``. Be advised to establish some sort of log management if you wish to do so.
|
||||
|
||||
# Dionaea Dashboard
|
||||
|
||||
|
||||
66
docker/dionaea/dist/etc/dionaea.cfg
vendored
Normal file
66
docker/dionaea/dist/etc/dionaea.cfg
vendored
Normal file
|
|
@ -0,0 +1,66 @@
|
|||
[dionaea]
|
||||
download.dir=/opt/dionaea/var/dionaea/binaries/
|
||||
modules=curl,python,emu
|
||||
processors=filter_streamdumper,filter_emu
|
||||
|
||||
listen.mode=getifaddrs
|
||||
# listen.addresses=127.0.0.1
|
||||
# listen.interfaces=eth0,tap0
|
||||
|
||||
# Country
|
||||
ssl.default.c=CN
|
||||
# Common Name/domain name
|
||||
ssl.default.cn=
|
||||
# Organization
|
||||
ssl.default.o=
|
||||
# Organizational Unit
|
||||
ssl.default.ou=
|
||||
|
||||
[logging]
|
||||
#default.filename=/opt/dionaea/var/dionaea/dionaea.log
|
||||
#default.levels=all
|
||||
#default.domains=*
|
||||
|
||||
errors.filename=/opt/dionaea/var/dionaea/dionaea-errors.log
|
||||
errors.levels=warning,error
|
||||
errors.domains=*
|
||||
|
||||
[processor.filter_streamdumper]
|
||||
name=filter
|
||||
config.allow.0.types=accept
|
||||
config.allow.1.types=connect
|
||||
config.allow.1.protocols=ftpctrl
|
||||
config.deny.0.protocols=ftpdata,ftpdatacon,xmppclient
|
||||
next=streamdumper
|
||||
|
||||
[processor.streamdumper]
|
||||
name=streamdumper
|
||||
config.path=/opt/dionaea/var/dionaea/bistreams/%Y-%m-%d/
|
||||
|
||||
[processor.filter_emu]
|
||||
name=filter
|
||||
config.allow.0.protocols=smbd,epmapper,nfqmirrord,mssqld
|
||||
next=emu
|
||||
|
||||
[processor.emu]
|
||||
name=emu
|
||||
config.limits.files=3
|
||||
#512 * 1024
|
||||
config.limits.filesize=524288
|
||||
config.limits.sockets=3
|
||||
config.limits.sustain=120
|
||||
config.limits.idle=30
|
||||
config.limits.listen=30
|
||||
config.limits.cpu=120
|
||||
#// 1024 * 1024 * 1024
|
||||
config.limits.steps=1073741824
|
||||
|
||||
[module.nl]
|
||||
# set to yes in case you are interested in the mac address of the remote (only works for lan)
|
||||
lookup_ethernet_addr=yes
|
||||
|
||||
[module.python]
|
||||
imports=dionaea.log,dionaea.services,dionaea.ihandlers
|
||||
sys_paths=default
|
||||
service_configs=/opt/dionaea/etc/dionaea/services/*.yaml
|
||||
ihandler_configs=/opt/dionaea/etc/dionaea/ihandlers/*.yaml
|
||||
1
docker/dionaea/dist/etc/ihandlers/cmdshell.yaml
vendored
Normal file
1
docker/dionaea/dist/etc/ihandlers/cmdshell.yaml
vendored
Normal file
|
|
@ -0,0 +1 @@
|
|||
- name: cmdshell
|
||||
1
docker/dionaea/dist/etc/ihandlers/emuprofile.yaml
vendored
Normal file
1
docker/dionaea/dist/etc/ihandlers/emuprofile.yaml
vendored
Normal file
|
|
@ -0,0 +1 @@
|
|||
- name: emuprofile
|
||||
10
docker/dionaea/dist/etc/ihandlers/ftp.yaml
vendored
Normal file
10
docker/dionaea/dist/etc/ihandlers/ftp.yaml
vendored
Normal file
|
|
@ -0,0 +1,10 @@
|
|||
# ftp client section
|
||||
- name: ftp
|
||||
config:
|
||||
# host for active ftp via NAT
|
||||
# * 0.0.0.0 - the initiating connection ip is used for active ftp
|
||||
# * not 0.0.0.0 - gets resolved as hostname and used
|
||||
active_host: "0.0.0.0"
|
||||
|
||||
# ports for active ftp; string indicating a range
|
||||
active_ports: 63001-64000
|
||||
7
docker/dionaea/dist/etc/ihandlers/log_json.yaml
vendored
Normal file
7
docker/dionaea/dist/etc/ihandlers/log_json.yaml
vendored
Normal file
|
|
@ -0,0 +1,7 @@
|
|||
- name: log_json
|
||||
config:
|
||||
# Uncomment next line to flatten object lists to work with ELK
|
||||
flat_data: true
|
||||
handlers:
|
||||
#- http://127.0.0.1:8080/
|
||||
- file:///opt/dionaea/var/log/dionaea.json
|
||||
3
docker/dionaea/dist/etc/ihandlers/log_sqlite.yaml
vendored
Normal file
3
docker/dionaea/dist/etc/ihandlers/log_sqlite.yaml
vendored
Normal file
|
|
@ -0,0 +1,3 @@
|
|||
- name: log_sqlite
|
||||
config:
|
||||
file: /opt/dionaea/var/log/dionaea.sqlite
|
||||
1
docker/dionaea/dist/etc/ihandlers/store.yaml
vendored
Normal file
1
docker/dionaea/dist/etc/ihandlers/store.yaml
vendored
Normal file
|
|
@ -0,0 +1 @@
|
|||
- name: store
|
||||
1
docker/dionaea/dist/etc/ihandlers/tftp_download.yaml
vendored
Normal file
1
docker/dionaea/dist/etc/ihandlers/tftp_download.yaml
vendored
Normal file
|
|
@ -0,0 +1 @@
|
|||
- name: tftp_download
|
||||
1
docker/dionaea/dist/etc/services/epmap.yaml
vendored
Normal file
1
docker/dionaea/dist/etc/services/epmap.yaml
vendored
Normal file
|
|
@ -0,0 +1 @@
|
|||
- name: epmap
|
||||
5
docker/dionaea/dist/etc/services/ftp.yaml
vendored
Normal file
5
docker/dionaea/dist/etc/services/ftp.yaml
vendored
Normal file
|
|
@ -0,0 +1,5 @@
|
|||
- name: ftp
|
||||
config:
|
||||
root: /opt/dionaea/var/dionaea/roots/ftp
|
||||
response_messages:
|
||||
welcome_msg: 220 FTP server ready.
|
||||
17
docker/dionaea/dist/etc/services/http.yaml
vendored
Normal file
17
docker/dionaea/dist/etc/services/http.yaml
vendored
Normal file
|
|
@ -0,0 +1,17 @@
|
|||
- name: http
|
||||
config:
|
||||
root: "/opt/dionaea/var/dionaea/roots/www"
|
||||
ports:
|
||||
- 80
|
||||
ssl_ports:
|
||||
- 443
|
||||
max_request_size: 32768 # maximum size in kbytes of the request (32MB)
|
||||
global_headers:
|
||||
- ["Server", "nginx"]
|
||||
headers:
|
||||
- filename_pattern: ".*\\.php"
|
||||
headers:
|
||||
- ["Content-Type", "text/html; charset=utf-8"]
|
||||
- ["Content-Length", "{content_length}"]
|
||||
- ["Connection", "{connection}"]
|
||||
- ["X-Powered-By", "PHP/5.6"]
|
||||
1
docker/dionaea/dist/etc/services/mirror.yaml
vendored
Normal file
1
docker/dionaea/dist/etc/services/mirror.yaml
vendored
Normal file
|
|
@ -0,0 +1 @@
|
|||
- name: mirror
|
||||
1
docker/dionaea/dist/etc/services/mongo.yaml
vendored
Normal file
1
docker/dionaea/dist/etc/services/mongo.yaml
vendored
Normal file
|
|
@ -0,0 +1 @@
|
|||
- name: mongo
|
||||
1
docker/dionaea/dist/etc/services/mqtt.yaml
vendored
Normal file
1
docker/dionaea/dist/etc/services/mqtt.yaml
vendored
Normal file
|
|
@ -0,0 +1 @@
|
|||
- name: mqtt
|
||||
1
docker/dionaea/dist/etc/services/mssql.yaml
vendored
Normal file
1
docker/dionaea/dist/etc/services/mssql.yaml
vendored
Normal file
|
|
@ -0,0 +1 @@
|
|||
- name: mssql
|
||||
10
docker/dionaea/dist/etc/services/mysql.yaml
vendored
Normal file
10
docker/dionaea/dist/etc/services/mysql.yaml
vendored
Normal file
|
|
@ -0,0 +1,10 @@
|
|||
- name: mysql
|
||||
config:
|
||||
databases:
|
||||
information_schema:
|
||||
path: ":memory:"
|
||||
# example how to extend this
|
||||
# just provide a databasename and path to the database
|
||||
# the database can be altered by attackers, so ... better use a copy
|
||||
# psn:
|
||||
# path: "/path/to/cc_info.sqlite"
|
||||
26
docker/dionaea/dist/etc/services/pptp.yaml
vendored
Normal file
26
docker/dionaea/dist/etc/services/pptp.yaml
vendored
Normal file
|
|
@ -0,0 +1,26 @@
|
|||
- name: pptp
|
||||
config:
|
||||
# Cisco PIX
|
||||
# firmware_revision: 4608
|
||||
# hostname:
|
||||
# vendor_name: Cisco Systems
|
||||
|
||||
# DrayTek
|
||||
# firmware: 1
|
||||
# hostname: Vigor
|
||||
# vendor_name: DrayTek
|
||||
|
||||
# Linux
|
||||
firmware: 1
|
||||
hostname: local
|
||||
vendor_name: linux
|
||||
|
||||
# Windows
|
||||
# firmware_revision: 0
|
||||
# hostname:
|
||||
# vendor_name: Microsoft
|
||||
|
||||
# MikroTik router
|
||||
# firmware_revision: 1
|
||||
# hostname: MikroTik
|
||||
# vendor_name: MikroTik
|
||||
40
docker/dionaea/dist/etc/services/sip.yaml
vendored
Normal file
40
docker/dionaea/dist/etc/services/sip.yaml
vendored
Normal file
|
|
@ -0,0 +1,40 @@
|
|||
- name: sip
|
||||
config:
|
||||
udp_ports:
|
||||
- 5060
|
||||
tcp_ports:
|
||||
- 5060
|
||||
tls_ports:
|
||||
- 5061
|
||||
users: "/opt/dionaea/var/dionaea/sipaccounts.sqlite"
|
||||
rtp:
|
||||
enable: true
|
||||
# how to dump the rtp stream
|
||||
# bistream = dump as bistream
|
||||
modes:
|
||||
- bistream
|
||||
- pcap
|
||||
pcap:
|
||||
path: "var/dionaea/rtp/{personality}/%Y-%m-%d/"
|
||||
filename: "%H:%M:%S_{remote_host}_{remote_port}_in.pcap"
|
||||
personalities:
|
||||
default:
|
||||
domain: "localhost"
|
||||
name: "softphone"
|
||||
personality: "generic"
|
||||
# next-server:
|
||||
# domain: "my-domain"
|
||||
# name: "my server"
|
||||
# personality: "generic"
|
||||
# serve: ["10.0.0.1"]
|
||||
# default_sdp: "default"
|
||||
# handle: ["REGISTER", "INVITE", "BYE", "CANCEL", "ACK"]
|
||||
|
||||
actions:
|
||||
bank-redirect:
|
||||
do: "redirect"
|
||||
params:
|
||||
play-hello:
|
||||
do: "play"
|
||||
params:
|
||||
file: "var/dionaea/.../file.ext"
|
||||
57
docker/dionaea/dist/etc/services/smb.yaml
vendored
Normal file
57
docker/dionaea/dist/etc/services/smb.yaml
vendored
Normal file
|
|
@ -0,0 +1,57 @@
|
|||
- name: smb
|
||||
config:
|
||||
|
||||
## Generic setting ##
|
||||
|
||||
# 1:"Windows XP Service Pack 0/1",
|
||||
# 2:"Windows XP Service Pack 2",
|
||||
# 3:"Windows XP Service Pack 3",
|
||||
# 4:"Windows 7 Service Pack 1",
|
||||
# 5:"Linux Samba 4.3.11"
|
||||
os_type: 4
|
||||
|
||||
# Additional config
|
||||
primary_domain: WORKGROUP
|
||||
oem_domain_name: WORKGROUP
|
||||
server_name: WIN_SRV
|
||||
|
||||
## Windows 7 ##
|
||||
native_os: Windows 7 Professional 7600
|
||||
native_lan_manager: Windows 7 Professional 6.1
|
||||
shares:
|
||||
ADMIN$:
|
||||
comment: Remote Admin
|
||||
path: C:\\Windows
|
||||
type: disktree
|
||||
C$:
|
||||
coment: Default Share
|
||||
path: C:\\
|
||||
type:
|
||||
- disktree
|
||||
- special
|
||||
IPC$:
|
||||
comment: Remote IPC
|
||||
type: ipc
|
||||
Printer:
|
||||
comment: Microsoft XPS Document Writer
|
||||
type: printq
|
||||
|
||||
## Samba ##
|
||||
# native_os: Windows 6.1
|
||||
# native_lan_manager: Samba 4.3.11
|
||||
# shares:
|
||||
# admin:
|
||||
# comment: Remote Admin
|
||||
# path: \\home\\admin
|
||||
# type: disktree
|
||||
# share:
|
||||
# coment: Default Share
|
||||
# path: \\share
|
||||
# type: disktree
|
||||
# IPC$:
|
||||
# comment: Remote IPC
|
||||
# path: IPC Service
|
||||
# type: ipc
|
||||
# Printer:
|
||||
# comment: Printer Drivers
|
||||
# type: printq
|
||||
3
docker/dionaea/dist/etc/services/tftp.yaml
vendored
Normal file
3
docker/dionaea/dist/etc/services/tftp.yaml
vendored
Normal file
|
|
@ -0,0 +1,3 @@
|
|||
- name: tftp
|
||||
config:
|
||||
root: /opt/dionaea/var/dionaea/roots/tftp
|
||||
28
docker/dionaea/dist/etc/services/upnp.yaml
vendored
Normal file
28
docker/dionaea/dist/etc/services/upnp.yaml
vendored
Normal file
|
|
@ -0,0 +1,28 @@
|
|||
- name: upnp
|
||||
config:
|
||||
root: /opt/dionaea/var/dionaea/roots/upnp
|
||||
# maximum size in kbytes of the request (32MB)
|
||||
max_request_size: 32768
|
||||
personality:
|
||||
# default
|
||||
cache: "CACHE-CONTROL: max-age=120\r\n"
|
||||
st: "ST: upnp:rootdevice\r\n"
|
||||
usn: "USN: uuid:Upnp-IPMI-1_0-1234567890001::upnp:rootdevice\r\n"
|
||||
server: "SERVER: Linux/2.6.17.WB_WPCM450.1.3 UPnP/1.0, Intel SDK for UPnP devices/1.3.1\r\n"
|
||||
location: "LOCATION: http://192.168.0.1:49152/IPMIdevicedesc.xml\r\n"
|
||||
opt: "OPT: http://schemas.upnp.org/upnp/1/0/\r\n"
|
||||
# # Samsung TV
|
||||
# cache: "CACHE-CONTROL: max-age=900\r\n"
|
||||
# st: "ST: uuid:c1fd12b2-d954-4dba-9e92-a697e1558fb4\r\n"
|
||||
# usn: "USN: uuid:c1fd12b2-d954-4dba-9e92-a697e1558fb4\r\n"
|
||||
# server: "SERVER: SHP, UPnP/1.0, Samsung UPnP SDK/1.0\r\n"
|
||||
# location: "LOCATION: http://192.168.0.10:7677/MainTVServer2\r\n"
|
||||
# opt: "OPT: http://schemas.upnp.org/upnp/1/0/\r\n"
|
||||
#
|
||||
# # XBOX 360
|
||||
# cache: "CACHE-CONTROL: max-age=1800\r\n"
|
||||
# st: "ST: urn:microsoft.com:service:X_MS_MediaReceiverRegistrar:1\r\n"
|
||||
# usn: "USN: uuid:531c567a-8c46-4201-bcd4-09afa554d859::urn:microsoft.com:service:X_MS_MediaReceiverRegistrar:1\r\n"
|
||||
# server: "SERVER: Microsoft-Windows/6.3 UPnP/1.0 UPnP-Device-Host/1.0\r\n"
|
||||
# location: "LOCATION: http://192.168.0.10:1055/upnphost/udhisapi.dll?content=uuid:531c567a-8c46-4201-bcd4-09afa554d859\r\n"
|
||||
# opt: "OPT: http://schemas.upnp.org/upnp/1/0/\r\n"
|
||||
BIN
docker/dionaea/doc/dashboard.png
Normal file
BIN
docker/dionaea/doc/dashboard.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 621 KiB |
46
docker/dionaea/docker-compose.yml
Normal file
46
docker/dionaea/docker-compose.yml
Normal file
|
|
@ -0,0 +1,46 @@
|
|||
# T-Pot (Standard)
|
||||
# For docker-compose ...
|
||||
version: '2.1'
|
||||
|
||||
networks:
|
||||
dionaea_local:
|
||||
|
||||
services:
|
||||
|
||||
# Dionaea service
|
||||
dionaea:
|
||||
container_name: dionaea
|
||||
stdin_open: true
|
||||
restart: always
|
||||
networks:
|
||||
- dionaea_local
|
||||
cap_add:
|
||||
- NET_BIND_SERVICE
|
||||
ports:
|
||||
- "20:20"
|
||||
- "21:21"
|
||||
- "42:42"
|
||||
- "69:69/udp"
|
||||
- "8081:80"
|
||||
- "135:135"
|
||||
- "443:443"
|
||||
- "445:445"
|
||||
- "1433:1433"
|
||||
- "1723:1723"
|
||||
- "1883:1883"
|
||||
- "1900:1900/udp"
|
||||
- "3306:3306"
|
||||
- "5060:5060"
|
||||
- "5060:5060/udp"
|
||||
- "5061:5061"
|
||||
- "27017:27017"
|
||||
image: "dtagdevsec/dionaea:1706"
|
||||
volumes:
|
||||
- /data/dionaea/roots/ftp:/opt/dionaea/var/dionaea/roots/ftp
|
||||
- /data/dionaea/roots/tftp:/opt/dionaea/var/dionaea/roots/tftp
|
||||
- /data/dionaea/roots/www:/opt/dionaea/var/dionaea/roots/www
|
||||
- /data/dionaea/roots/upnp:/opt/dionaea/var/dionaea/roots/upnp
|
||||
- /data/dionaea:/opt/dionaea/var/dionaea
|
||||
- /data/dionaea/binaries:/opt/dionaea/var/dionaea/binaries
|
||||
- /data/dionaea/log:/opt/dionaea/var/log
|
||||
- /data/dionaea/rtp:/opt/dionaea/var/dionaea/rtp
|
||||
30
docker/elasticpot/Dockerfile
Normal file
30
docker/elasticpot/Dockerfile
Normal file
|
|
@ -0,0 +1,30 @@
|
|||
FROM alpine
|
||||
MAINTAINER MS/MO
|
||||
|
||||
# Include dist
|
||||
ADD dist/ /root/dist/
|
||||
|
||||
# Install packages
|
||||
RUN apk -U upgrade && \
|
||||
apk add bash python3 git && \
|
||||
pip3 install --upgrade pip && \
|
||||
pip3 install bottle requests configparser datetime && \
|
||||
mkdir -p /opt && \
|
||||
cd /opt/ && \
|
||||
git clone https://github.com/schmalle/ElasticpotPY.git && \
|
||||
|
||||
# Setup user, groups and configs
|
||||
addgroup -g 2000 elasticpot && \
|
||||
adduser -S -H -s /bin/bash -u 2000 -D -g 2000 elasticpot && \
|
||||
mv /root/dist/elasticpot.cfg /opt/ElasticpotPY/ && \
|
||||
mkdir /opt/ElasticpotPY/log && \
|
||||
|
||||
# Clean up
|
||||
apk del git && \
|
||||
rm -rf /root/* && \
|
||||
rm -rf /var/cache/apk/*
|
||||
|
||||
# Start elasticpot
|
||||
USER elasticpot
|
||||
WORKDIR /opt/ElasticpotPY/
|
||||
CMD ["/usr/bin/python3","main.py"]
|
||||
27
docker/elasticpot/README.md
Normal file
27
docker/elasticpot/README.md
Normal file
|
|
@ -0,0 +1,27 @@
|
|||
# dockerized elasticpot
|
||||
|
||||
|
||||
[elasticpot](https://github.com/schmalle/ElasticPot) elasticpot is a simple elastic search honeypot.
|
||||
|
||||
This repository contains the necessary files to create a *dockerized* version of elasticpot.
|
||||
|
||||
This dockerized version is part of the **[T-Pot community honeypot](http://dtag-dev-sec.github.io/)** of Deutsche Telekom AG.
|
||||
|
||||
The `Dockerfile` contains the blueprint for the dockerized elasticpot and will be used to setup the docker image.
|
||||
|
||||
The `supervisord.conf` is used to start elasticpot under supervision of supervisord.
|
||||
|
||||
Using systemd, copy the `systemd/elasticpot.service` to `/etc/systemd/system/elasticpot.service` and start using
|
||||
|
||||
```
|
||||
systemctl enable elasticpot
|
||||
systemctl start elasticpot
|
||||
```
|
||||
|
||||
This will make sure that the docker container is started with the appropriate permissions and port mappings. Further, it autostarts during boot.
|
||||
|
||||
By default all data will be stored in `/data/elasticpot/` until the honeypot service will be restarted which is by default every 24 hours. If you want to keep data persistently simply edit the ``service`` file, find the line that contains ``clean.sh`` and set the option from ``off`` to ``on``. Be advised to establish some sort of log management if you wish to do so.
|
||||
|
||||
# ElasticPot Dashboard
|
||||
|
||||
|
||||
31
docker/elasticpot/dist/elasticpot.cfg
vendored
Normal file
31
docker/elasticpot/dist/elasticpot.cfg
vendored
Normal file
|
|
@ -0,0 +1,31 @@
|
|||
# ElasticPot Config
|
||||
|
||||
[MAIN]
|
||||
# Manually set the externally accessible IP of the honeypot
|
||||
ip = 192.168.1.1
|
||||
|
||||
|
||||
[ELASTICPOT]
|
||||
# ID pf the elasticpot instance
|
||||
nodeid = elasticpot-community-01
|
||||
|
||||
# Location of the json logfile
|
||||
logfile = log/elasticpot.log
|
||||
|
||||
# Set elasticpot = False to disable json logging and enable automatic attack submission to ews backend (soap)
|
||||
elasticpot = True
|
||||
|
||||
|
||||
[EWS]
|
||||
# Note: Only relevant if "elasticpot = False"
|
||||
# Username for ews submission
|
||||
username = community-01-user
|
||||
|
||||
# Token for ews submission
|
||||
token = foth{a5maiCee8fineu7
|
||||
|
||||
# API endpoint for ews submission
|
||||
rhost_first = https://community.sicherheitstacho.eu/ews-0.1/alert/postSimpleMessage
|
||||
|
||||
# Ignore certificate warnings
|
||||
ignorecert = false
|
||||
BIN
docker/elasticpot/doc/dashboard.png
Normal file
BIN
docker/elasticpot/doc/dashboard.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 472 KiB |
18
docker/elasticpot/docker-compose.yml
Normal file
18
docker/elasticpot/docker-compose.yml
Normal file
|
|
@ -0,0 +1,18 @@
|
|||
version: '2.1'
|
||||
|
||||
networks:
|
||||
elasticpot_local:
|
||||
|
||||
services:
|
||||
|
||||
# Elasticpot service
|
||||
elasticpot:
|
||||
container_name: elasticpot
|
||||
restart: always
|
||||
networks:
|
||||
- elasticpot_local
|
||||
ports:
|
||||
- "9200:9200"
|
||||
image: "dtagdevsec/elasticpot:1706"
|
||||
volumes:
|
||||
- /data/elasticpot/log:/opt/ElasticpotPY/log
|
||||
674
docker/elk/LICENSE
Normal file
674
docker/elk/LICENSE
Normal file
|
|
@ -0,0 +1,674 @@
|
|||
GNU GENERAL PUBLIC LICENSE
|
||||
Version 3, 29 June 2007
|
||||
|
||||
Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
|
||||
Everyone is permitted to copy and distribute verbatim copies
|
||||
of this license document, but changing it is not allowed.
|
||||
|
||||
Preamble
|
||||
|
||||
The GNU General Public License is a free, copyleft license for
|
||||
software and other kinds of works.
|
||||
|
||||
The licenses for most software and other practical works are designed
|
||||
to take away your freedom to share and change the works. By contrast,
|
||||
the GNU General Public License is intended to guarantee your freedom to
|
||||
share and change all versions of a program--to make sure it remains free
|
||||
software for all its users. We, the Free Software Foundation, use the
|
||||
GNU General Public License for most of our software; it applies also to
|
||||
any other work released this way by its authors. You can apply it to
|
||||
your programs, too.
|
||||
|
||||
When we speak of free software, we are referring to freedom, not
|
||||
price. Our General Public Licenses are designed to make sure that you
|
||||
have the freedom to distribute copies of free software (and charge for
|
||||
them if you wish), that you receive source code or can get it if you
|
||||
want it, that you can change the software or use pieces of it in new
|
||||
free programs, and that you know you can do these things.
|
||||
|
||||
To protect your rights, we need to prevent others from denying you
|
||||
these rights or asking you to surrender the rights. Therefore, you have
|
||||
certain responsibilities if you distribute copies of the software, or if
|
||||
you modify it: responsibilities to respect the freedom of others.
|
||||
|
||||
For example, if you distribute copies of such a program, whether
|
||||
gratis or for a fee, you must pass on to the recipients the same
|
||||
freedoms that you received. You must make sure that they, too, receive
|
||||
or can get the source code. And you must show them these terms so they
|
||||
know their rights.
|
||||
|
||||
Developers that use the GNU GPL protect your rights with two steps:
|
||||
(1) assert copyright on the software, and (2) offer you this License
|
||||
giving you legal permission to copy, distribute and/or modify it.
|
||||
|
||||
For the developers' and authors' protection, the GPL clearly explains
|
||||
that there is no warranty for this free software. For both users' and
|
||||
authors' sake, the GPL requires that modified versions be marked as
|
||||
changed, so that their problems will not be attributed erroneously to
|
||||
authors of previous versions.
|
||||
|
||||
Some devices are designed to deny users access to install or run
|
||||
modified versions of the software inside them, although the manufacturer
|
||||
can do so. This is fundamentally incompatible with the aim of
|
||||
protecting users' freedom to change the software. The systematic
|
||||
pattern of such abuse occurs in the area of products for individuals to
|
||||
use, which is precisely where it is most unacceptable. Therefore, we
|
||||
have designed this version of the GPL to prohibit the practice for those
|
||||
products. If such problems arise substantially in other domains, we
|
||||
stand ready to extend this provision to those domains in future versions
|
||||
of the GPL, as needed to protect the freedom of users.
|
||||
|
||||
Finally, every program is threatened constantly by software patents.
|
||||
States should not allow patents to restrict development and use of
|
||||
software on general-purpose computers, but in those that do, we wish to
|
||||
avoid the special danger that patents applied to a free program could
|
||||
make it effectively proprietary. To prevent this, the GPL assures that
|
||||
patents cannot be used to render the program non-free.
|
||||
|
||||
The precise terms and conditions for copying, distribution and
|
||||
modification follow.
|
||||
|
||||
TERMS AND CONDITIONS
|
||||
|
||||
0. Definitions.
|
||||
|
||||
"This License" refers to version 3 of the GNU General Public License.
|
||||
|
||||
"Copyright" also means copyright-like laws that apply to other kinds of
|
||||
works, such as semiconductor masks.
|
||||
|
||||
"The Program" refers to any copyrightable work licensed under this
|
||||
License. Each licensee is addressed as "you". "Licensees" and
|
||||
"recipients" may be individuals or organizations.
|
||||
|
||||
To "modify" a work means to copy from or adapt all or part of the work
|
||||
in a fashion requiring copyright permission, other than the making of an
|
||||
exact copy. The resulting work is called a "modified version" of the
|
||||
earlier work or a work "based on" the earlier work.
|
||||
|
||||
A "covered work" means either the unmodified Program or a work based
|
||||
on the Program.
|
||||
|
||||
To "propagate" a work means to do anything with it that, without
|
||||
permission, would make you directly or secondarily liable for
|
||||
infringement under applicable copyright law, except executing it on a
|
||||
computer or modifying a private copy. Propagation includes copying,
|
||||
distribution (with or without modification), making available to the
|
||||
public, and in some countries other activities as well.
|
||||
|
||||
To "convey" a work means any kind of propagation that enables other
|
||||
parties to make or receive copies. Mere interaction with a user through
|
||||
a computer network, with no transfer of a copy, is not conveying.
|
||||
|
||||
An interactive user interface displays "Appropriate Legal Notices"
|
||||
to the extent that it includes a convenient and prominently visible
|
||||
feature that (1) displays an appropriate copyright notice, and (2)
|
||||
tells the user that there is no warranty for the work (except to the
|
||||
extent that warranties are provided), that licensees may convey the
|
||||
work under this License, and how to view a copy of this License. If
|
||||
the interface presents a list of user commands or options, such as a
|
||||
menu, a prominent item in the list meets this criterion.
|
||||
|
||||
1. Source Code.
|
||||
|
||||
The "source code" for a work means the preferred form of the work
|
||||
for making modifications to it. "Object code" means any non-source
|
||||
form of a work.
|
||||
|
||||
A "Standard Interface" means an interface that either is an official
|
||||
standard defined by a recognized standards body, or, in the case of
|
||||
interfaces specified for a particular programming language, one that
|
||||
is widely used among developers working in that language.
|
||||
|
||||
The "System Libraries" of an executable work include anything, other
|
||||
than the work as a whole, that (a) is included in the normal form of
|
||||
packaging a Major Component, but which is not part of that Major
|
||||
Component, and (b) serves only to enable use of the work with that
|
||||
Major Component, or to implement a Standard Interface for which an
|
||||
implementation is available to the public in source code form. A
|
||||
"Major Component", in this context, means a major essential component
|
||||
(kernel, window system, and so on) of the specific operating system
|
||||
(if any) on which the executable work runs, or a compiler used to
|
||||
produce the work, or an object code interpreter used to run it.
|
||||
|
||||
The "Corresponding Source" for a work in object code form means all
|
||||
the source code needed to generate, install, and (for an executable
|
||||
work) run the object code and to modify the work, including scripts to
|
||||
control those activities. However, it does not include the work's
|
||||
System Libraries, or general-purpose tools or generally available free
|
||||
programs which are used unmodified in performing those activities but
|
||||
which are not part of the work. For example, Corresponding Source
|
||||
includes interface definition files associated with source files for
|
||||
the work, and the source code for shared libraries and dynamically
|
||||
linked subprograms that the work is specifically designed to require,
|
||||
such as by intimate data communication or control flow between those
|
||||
subprograms and other parts of the work.
|
||||
|
||||
The Corresponding Source need not include anything that users
|
||||
can regenerate automatically from other parts of the Corresponding
|
||||
Source.
|
||||
|
||||
The Corresponding Source for a work in source code form is that
|
||||
same work.
|
||||
|
||||
2. Basic Permissions.
|
||||
|
||||
All rights granted under this License are granted for the term of
|
||||
copyright on the Program, and are irrevocable provided the stated
|
||||
conditions are met. This License explicitly affirms your unlimited
|
||||
permission to run the unmodified Program. The output from running a
|
||||
covered work is covered by this License only if the output, given its
|
||||
content, constitutes a covered work. This License acknowledges your
|
||||
rights of fair use or other equivalent, as provided by copyright law.
|
||||
|
||||
You may make, run and propagate covered works that you do not
|
||||
convey, without conditions so long as your license otherwise remains
|
||||
in force. You may convey covered works to others for the sole purpose
|
||||
of having them make modifications exclusively for you, or provide you
|
||||
with facilities for running those works, provided that you comply with
|
||||
the terms of this License in conveying all material for which you do
|
||||
not control copyright. Those thus making or running the covered works
|
||||
for you must do so exclusively on your behalf, under your direction
|
||||
and control, on terms that prohibit them from making any copies of
|
||||
your copyrighted material outside their relationship with you.
|
||||
|
||||
Conveying under any other circumstances is permitted solely under
|
||||
the conditions stated below. Sublicensing is not allowed; section 10
|
||||
makes it unnecessary.
|
||||
|
||||
3. Protecting Users' Legal Rights From Anti-Circumvention Law.
|
||||
|
||||
No covered work shall be deemed part of an effective technological
|
||||
measure under any applicable law fulfilling obligations under article
|
||||
11 of the WIPO copyright treaty adopted on 20 December 1996, or
|
||||
similar laws prohibiting or restricting circumvention of such
|
||||
measures.
|
||||
|
||||
When you convey a covered work, you waive any legal power to forbid
|
||||
circumvention of technological measures to the extent such circumvention
|
||||
is effected by exercising rights under this License with respect to
|
||||
the covered work, and you disclaim any intention to limit operation or
|
||||
modification of the work as a means of enforcing, against the work's
|
||||
users, your or third parties' legal rights to forbid circumvention of
|
||||
technological measures.
|
||||
|
||||
4. Conveying Verbatim Copies.
|
||||
|
||||
You may convey verbatim copies of the Program's source code as you
|
||||
receive it, in any medium, provided that you conspicuously and
|
||||
appropriately publish on each copy an appropriate copyright notice;
|
||||
keep intact all notices stating that this License and any
|
||||
non-permissive terms added in accord with section 7 apply to the code;
|
||||
keep intact all notices of the absence of any warranty; and give all
|
||||
recipients a copy of this License along with the Program.
|
||||
|
||||
You may charge any price or no price for each copy that you convey,
|
||||
and you may offer support or warranty protection for a fee.
|
||||
|
||||
5. Conveying Modified Source Versions.
|
||||
|
||||
You may convey a work based on the Program, or the modifications to
|
||||
produce it from the Program, in the form of source code under the
|
||||
terms of section 4, provided that you also meet all of these conditions:
|
||||
|
||||
a) The work must carry prominent notices stating that you modified
|
||||
it, and giving a relevant date.
|
||||
|
||||
b) The work must carry prominent notices stating that it is
|
||||
released under this License and any conditions added under section
|
||||
7. This requirement modifies the requirement in section 4 to
|
||||
"keep intact all notices".
|
||||
|
||||
c) You must license the entire work, as a whole, under this
|
||||
License to anyone who comes into possession of a copy. This
|
||||
License will therefore apply, along with any applicable section 7
|
||||
additional terms, to the whole of the work, and all its parts,
|
||||
regardless of how they are packaged. This License gives no
|
||||
permission to license the work in any other way, but it does not
|
||||
invalidate such permission if you have separately received it.
|
||||
|
||||
d) If the work has interactive user interfaces, each must display
|
||||
Appropriate Legal Notices; however, if the Program has interactive
|
||||
interfaces that do not display Appropriate Legal Notices, your
|
||||
work need not make them do so.
|
||||
|
||||
A compilation of a covered work with other separate and independent
|
||||
works, which are not by their nature extensions of the covered work,
|
||||
and which are not combined with it such as to form a larger program,
|
||||
in or on a volume of a storage or distribution medium, is called an
|
||||
"aggregate" if the compilation and its resulting copyright are not
|
||||
used to limit the access or legal rights of the compilation's users
|
||||
beyond what the individual works permit. Inclusion of a covered work
|
||||
in an aggregate does not cause this License to apply to the other
|
||||
parts of the aggregate.
|
||||
|
||||
6. Conveying Non-Source Forms.
|
||||
|
||||
You may convey a covered work in object code form under the terms
|
||||
of sections 4 and 5, provided that you also convey the
|
||||
machine-readable Corresponding Source under the terms of this License,
|
||||
in one of these ways:
|
||||
|
||||
a) Convey the object code in, or embodied in, a physical product
|
||||
(including a physical distribution medium), accompanied by the
|
||||
Corresponding Source fixed on a durable physical medium
|
||||
customarily used for software interchange.
|
||||
|
||||
b) Convey the object code in, or embodied in, a physical product
|
||||
(including a physical distribution medium), accompanied by a
|
||||
written offer, valid for at least three years and valid for as
|
||||
long as you offer spare parts or customer support for that product
|
||||
model, to give anyone who possesses the object code either (1) a
|
||||
copy of the Corresponding Source for all the software in the
|
||||
product that is covered by this License, on a durable physical
|
||||
medium customarily used for software interchange, for a price no
|
||||
more than your reasonable cost of physically performing this
|
||||
conveying of source, or (2) access to copy the
|
||||
Corresponding Source from a network server at no charge.
|
||||
|
||||
c) Convey individual copies of the object code with a copy of the
|
||||
written offer to provide the Corresponding Source. This
|
||||
alternative is allowed only occasionally and noncommercially, and
|
||||
only if you received the object code with such an offer, in accord
|
||||
with subsection 6b.
|
||||
|
||||
d) Convey the object code by offering access from a designated
|
||||
place (gratis or for a charge), and offer equivalent access to the
|
||||
Corresponding Source in the same way through the same place at no
|
||||
further charge. You need not require recipients to copy the
|
||||
Corresponding Source along with the object code. If the place to
|
||||
copy the object code is a network server, the Corresponding Source
|
||||
may be on a different server (operated by you or a third party)
|
||||
that supports equivalent copying facilities, provided you maintain
|
||||
clear directions next to the object code saying where to find the
|
||||
Corresponding Source. Regardless of what server hosts the
|
||||
Corresponding Source, you remain obligated to ensure that it is
|
||||
available for as long as needed to satisfy these requirements.
|
||||
|
||||
e) Convey the object code using peer-to-peer transmission, provided
|
||||
you inform other peers where the object code and Corresponding
|
||||
Source of the work are being offered to the general public at no
|
||||
charge under subsection 6d.
|
||||
|
||||
A separable portion of the object code, whose source code is excluded
|
||||
from the Corresponding Source as a System Library, need not be
|
||||
included in conveying the object code work.
|
||||
|
||||
A "User Product" is either (1) a "consumer product", which means any
|
||||
tangible personal property which is normally used for personal, family,
|
||||
or household purposes, or (2) anything designed or sold for incorporation
|
||||
into a dwelling. In determining whether a product is a consumer product,
|
||||
doubtful cases shall be resolved in favor of coverage. For a particular
|
||||
product received by a particular user, "normally used" refers to a
|
||||
typical or common use of that class of product, regardless of the status
|
||||
of the particular user or of the way in which the particular user
|
||||
actually uses, or expects or is expected to use, the product. A product
|
||||
is a consumer product regardless of whether the product has substantial
|
||||
commercial, industrial or non-consumer uses, unless such uses represent
|
||||
the only significant mode of use of the product.
|
||||
|
||||
"Installation Information" for a User Product means any methods,
|
||||
procedures, authorization keys, or other information required to install
|
||||
and execute modified versions of a covered work in that User Product from
|
||||
a modified version of its Corresponding Source. The information must
|
||||
suffice to ensure that the continued functioning of the modified object
|
||||
code is in no case prevented or interfered with solely because
|
||||
modification has been made.
|
||||
|
||||
If you convey an object code work under this section in, or with, or
|
||||
specifically for use in, a User Product, and the conveying occurs as
|
||||
part of a transaction in which the right of possession and use of the
|
||||
User Product is transferred to the recipient in perpetuity or for a
|
||||
fixed term (regardless of how the transaction is characterized), the
|
||||
Corresponding Source conveyed under this section must be accompanied
|
||||
by the Installation Information. But this requirement does not apply
|
||||
if neither you nor any third party retains the ability to install
|
||||
modified object code on the User Product (for example, the work has
|
||||
been installed in ROM).
|
||||
|
||||
The requirement to provide Installation Information does not include a
|
||||
requirement to continue to provide support service, warranty, or updates
|
||||
for a work that has been modified or installed by the recipient, or for
|
||||
the User Product in which it has been modified or installed. Access to a
|
||||
network may be denied when the modification itself materially and
|
||||
adversely affects the operation of the network or violates the rules and
|
||||
protocols for communication across the network.
|
||||
|
||||
Corresponding Source conveyed, and Installation Information provided,
|
||||
in accord with this section must be in a format that is publicly
|
||||
documented (and with an implementation available to the public in
|
||||
source code form), and must require no special password or key for
|
||||
unpacking, reading or copying.
|
||||
|
||||
7. Additional Terms.
|
||||
|
||||
"Additional permissions" are terms that supplement the terms of this
|
||||
License by making exceptions from one or more of its conditions.
|
||||
Additional permissions that are applicable to the entire Program shall
|
||||
be treated as though they were included in this License, to the extent
|
||||
that they are valid under applicable law. If additional permissions
|
||||
apply only to part of the Program, that part may be used separately
|
||||
under those permissions, but the entire Program remains governed by
|
||||
this License without regard to the additional permissions.
|
||||
|
||||
When you convey a copy of a covered work, you may at your option
|
||||
remove any additional permissions from that copy, or from any part of
|
||||
it. (Additional permissions may be written to require their own
|
||||
removal in certain cases when you modify the work.) You may place
|
||||
additional permissions on material, added by you to a covered work,
|
||||
for which you have or can give appropriate copyright permission.
|
||||
|
||||
Notwithstanding any other provision of this License, for material you
|
||||
add to a covered work, you may (if authorized by the copyright holders of
|
||||
that material) supplement the terms of this License with terms:
|
||||
|
||||
a) Disclaiming warranty or limiting liability differently from the
|
||||
terms of sections 15 and 16 of this License; or
|
||||
|
||||
b) Requiring preservation of specified reasonable legal notices or
|
||||
author attributions in that material or in the Appropriate Legal
|
||||
Notices displayed by works containing it; or
|
||||
|
||||
c) Prohibiting misrepresentation of the origin of that material, or
|
||||
requiring that modified versions of such material be marked in
|
||||
reasonable ways as different from the original version; or
|
||||
|
||||
d) Limiting the use for publicity purposes of names of licensors or
|
||||
authors of the material; or
|
||||
|
||||
e) Declining to grant rights under trademark law for use of some
|
||||
trade names, trademarks, or service marks; or
|
||||
|
||||
f) Requiring indemnification of licensors and authors of that
|
||||
material by anyone who conveys the material (or modified versions of
|
||||
it) with contractual assumptions of liability to the recipient, for
|
||||
any liability that these contractual assumptions directly impose on
|
||||
those licensors and authors.
|
||||
|
||||
All other non-permissive additional terms are considered "further
|
||||
restrictions" within the meaning of section 10. If the Program as you
|
||||
received it, or any part of it, contains a notice stating that it is
|
||||
governed by this License along with a term that is a further
|
||||
restriction, you may remove that term. If a license document contains
|
||||
a further restriction but permits relicensing or conveying under this
|
||||
License, you may add to a covered work material governed by the terms
|
||||
of that license document, provided that the further restriction does
|
||||
not survive such relicensing or conveying.
|
||||
|
||||
If you add terms to a covered work in accord with this section, you
|
||||
must place, in the relevant source files, a statement of the
|
||||
additional terms that apply to those files, or a notice indicating
|
||||
where to find the applicable terms.
|
||||
|
||||
Additional terms, permissive or non-permissive, may be stated in the
|
||||
form of a separately written license, or stated as exceptions;
|
||||
the above requirements apply either way.
|
||||
|
||||
8. Termination.
|
||||
|
||||
You may not propagate or modify a covered work except as expressly
|
||||
provided under this License. Any attempt otherwise to propagate or
|
||||
modify it is void, and will automatically terminate your rights under
|
||||
this License (including any patent licenses granted under the third
|
||||
paragraph of section 11).
|
||||
|
||||
However, if you cease all violation of this License, then your
|
||||
license from a particular copyright holder is reinstated (a)
|
||||
provisionally, unless and until the copyright holder explicitly and
|
||||
finally terminates your license, and (b) permanently, if the copyright
|
||||
holder fails to notify you of the violation by some reasonable means
|
||||
prior to 60 days after the cessation.
|
||||
|
||||
Moreover, your license from a particular copyright holder is
|
||||
reinstated permanently if the copyright holder notifies you of the
|
||||
violation by some reasonable means, this is the first time you have
|
||||
received notice of violation of this License (for any work) from that
|
||||
copyright holder, and you cure the violation prior to 30 days after
|
||||
your receipt of the notice.
|
||||
|
||||
Termination of your rights under this section does not terminate the
|
||||
licenses of parties who have received copies or rights from you under
|
||||
this License. If your rights have been terminated and not permanently
|
||||
reinstated, you do not qualify to receive new licenses for the same
|
||||
material under section 10.
|
||||
|
||||
9. Acceptance Not Required for Having Copies.
|
||||
|
||||
You are not required to accept this License in order to receive or
|
||||
run a copy of the Program. Ancillary propagation of a covered work
|
||||
occurring solely as a consequence of using peer-to-peer transmission
|
||||
to receive a copy likewise does not require acceptance. However,
|
||||
nothing other than this License grants you permission to propagate or
|
||||
modify any covered work. These actions infringe copyright if you do
|
||||
not accept this License. Therefore, by modifying or propagating a
|
||||
covered work, you indicate your acceptance of this License to do so.
|
||||
|
||||
10. Automatic Licensing of Downstream Recipients.
|
||||
|
||||
Each time you convey a covered work, the recipient automatically
|
||||
receives a license from the original licensors, to run, modify and
|
||||
propagate that work, subject to this License. You are not responsible
|
||||
for enforcing compliance by third parties with this License.
|
||||
|
||||
An "entity transaction" is a transaction transferring control of an
|
||||
organization, or substantially all assets of one, or subdividing an
|
||||
organization, or merging organizations. If propagation of a covered
|
||||
work results from an entity transaction, each party to that
|
||||
transaction who receives a copy of the work also receives whatever
|
||||
licenses to the work the party's predecessor in interest had or could
|
||||
give under the previous paragraph, plus a right to possession of the
|
||||
Corresponding Source of the work from the predecessor in interest, if
|
||||
the predecessor has it or can get it with reasonable efforts.
|
||||
|
||||
You may not impose any further restrictions on the exercise of the
|
||||
rights granted or affirmed under this License. For example, you may
|
||||
not impose a license fee, royalty, or other charge for exercise of
|
||||
rights granted under this License, and you may not initiate litigation
|
||||
(including a cross-claim or counterclaim in a lawsuit) alleging that
|
||||
any patent claim is infringed by making, using, selling, offering for
|
||||
sale, or importing the Program or any portion of it.
|
||||
|
||||
11. Patents.
|
||||
|
||||
A "contributor" is a copyright holder who authorizes use under this
|
||||
License of the Program or a work on which the Program is based. The
|
||||
work thus licensed is called the contributor's "contributor version".
|
||||
|
||||
A contributor's "essential patent claims" are all patent claims
|
||||
owned or controlled by the contributor, whether already acquired or
|
||||
hereafter acquired, that would be infringed by some manner, permitted
|
||||
by this License, of making, using, or selling its contributor version,
|
||||
but do not include claims that would be infringed only as a
|
||||
consequence of further modification of the contributor version. For
|
||||
purposes of this definition, "control" includes the right to grant
|
||||
patent sublicenses in a manner consistent with the requirements of
|
||||
this License.
|
||||
|
||||
Each contributor grants you a non-exclusive, worldwide, royalty-free
|
||||
patent license under the contributor's essential patent claims, to
|
||||
make, use, sell, offer for sale, import and otherwise run, modify and
|
||||
propagate the contents of its contributor version.
|
||||
|
||||
In the following three paragraphs, a "patent license" is any express
|
||||
agreement or commitment, however denominated, not to enforce a patent
|
||||
(such as an express permission to practice a patent or covenant not to
|
||||
sue for patent infringement). To "grant" such a patent license to a
|
||||
party means to make such an agreement or commitment not to enforce a
|
||||
patent against the party.
|
||||
|
||||
If you convey a covered work, knowingly relying on a patent license,
|
||||
and the Corresponding Source of the work is not available for anyone
|
||||
to copy, free of charge and under the terms of this License, through a
|
||||
publicly available network server or other readily accessible means,
|
||||
then you must either (1) cause the Corresponding Source to be so
|
||||
available, or (2) arrange to deprive yourself of the benefit of the
|
||||
patent license for this particular work, or (3) arrange, in a manner
|
||||
consistent with the requirements of this License, to extend the patent
|
||||
license to downstream recipients. "Knowingly relying" means you have
|
||||
actual knowledge that, but for the patent license, your conveying the
|
||||
covered work in a country, or your recipient's use of the covered work
|
||||
in a country, would infringe one or more identifiable patents in that
|
||||
country that you have reason to believe are valid.
|
||||
|
||||
If, pursuant to or in connection with a single transaction or
|
||||
arrangement, you convey, or propagate by procuring conveyance of, a
|
||||
covered work, and grant a patent license to some of the parties
|
||||
receiving the covered work authorizing them to use, propagate, modify
|
||||
or convey a specific copy of the covered work, then the patent license
|
||||
you grant is automatically extended to all recipients of the covered
|
||||
work and works based on it.
|
||||
|
||||
A patent license is "discriminatory" if it does not include within
|
||||
the scope of its coverage, prohibits the exercise of, or is
|
||||
conditioned on the non-exercise of one or more of the rights that are
|
||||
specifically granted under this License. You may not convey a covered
|
||||
work if you are a party to an arrangement with a third party that is
|
||||
in the business of distributing software, under which you make payment
|
||||
to the third party based on the extent of your activity of conveying
|
||||
the work, and under which the third party grants, to any of the
|
||||
parties who would receive the covered work from you, a discriminatory
|
||||
patent license (a) in connection with copies of the covered work
|
||||
conveyed by you (or copies made from those copies), or (b) primarily
|
||||
for and in connection with specific products or compilations that
|
||||
contain the covered work, unless you entered into that arrangement,
|
||||
or that patent license was granted, prior to 28 March 2007.
|
||||
|
||||
Nothing in this License shall be construed as excluding or limiting
|
||||
any implied license or other defenses to infringement that may
|
||||
otherwise be available to you under applicable patent law.
|
||||
|
||||
12. No Surrender of Others' Freedom.
|
||||
|
||||
If conditions are imposed on you (whether by court order, agreement or
|
||||
otherwise) that contradict the conditions of this License, they do not
|
||||
excuse you from the conditions of this License. If you cannot convey a
|
||||
covered work so as to satisfy simultaneously your obligations under this
|
||||
License and any other pertinent obligations, then as a consequence you may
|
||||
not convey it at all. For example, if you agree to terms that obligate you
|
||||
to collect a royalty for further conveying from those to whom you convey
|
||||
the Program, the only way you could satisfy both those terms and this
|
||||
License would be to refrain entirely from conveying the Program.
|
||||
|
||||
13. Use with the GNU Affero General Public License.
|
||||
|
||||
Notwithstanding any other provision of this License, you have
|
||||
permission to link or combine any covered work with a work licensed
|
||||
under version 3 of the GNU Affero General Public License into a single
|
||||
combined work, and to convey the resulting work. The terms of this
|
||||
License will continue to apply to the part which is the covered work,
|
||||
but the special requirements of the GNU Affero General Public License,
|
||||
section 13, concerning interaction through a network will apply to the
|
||||
combination as such.
|
||||
|
||||
14. Revised Versions of this License.
|
||||
|
||||
The Free Software Foundation may publish revised and/or new versions of
|
||||
the GNU General Public License from time to time. Such new versions will
|
||||
be similar in spirit to the present version, but may differ in detail to
|
||||
address new problems or concerns.
|
||||
|
||||
Each version is given a distinguishing version number. If the
|
||||
Program specifies that a certain numbered version of the GNU General
|
||||
Public License "or any later version" applies to it, you have the
|
||||
option of following the terms and conditions either of that numbered
|
||||
version or of any later version published by the Free Software
|
||||
Foundation. If the Program does not specify a version number of the
|
||||
GNU General Public License, you may choose any version ever published
|
||||
by the Free Software Foundation.
|
||||
|
||||
If the Program specifies that a proxy can decide which future
|
||||
versions of the GNU General Public License can be used, that proxy's
|
||||
public statement of acceptance of a version permanently authorizes you
|
||||
to choose that version for the Program.
|
||||
|
||||
Later license versions may give you additional or different
|
||||
permissions. However, no additional obligations are imposed on any
|
||||
author or copyright holder as a result of your choosing to follow a
|
||||
later version.
|
||||
|
||||
15. Disclaimer of Warranty.
|
||||
|
||||
THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
|
||||
APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
|
||||
HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
|
||||
OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
|
||||
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
||||
PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
|
||||
IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
|
||||
ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
|
||||
|
||||
16. Limitation of Liability.
|
||||
|
||||
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
|
||||
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
|
||||
THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
|
||||
GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
|
||||
USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
|
||||
DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
|
||||
PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
|
||||
EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
|
||||
SUCH DAMAGES.
|
||||
|
||||
17. Interpretation of Sections 15 and 16.
|
||||
|
||||
If the disclaimer of warranty and limitation of liability provided
|
||||
above cannot be given local legal effect according to their terms,
|
||||
reviewing courts shall apply local law that most closely approximates
|
||||
an absolute waiver of all civil liability in connection with the
|
||||
Program, unless a warranty or assumption of liability accompanies a
|
||||
copy of the Program in return for a fee.
|
||||
|
||||
END OF TERMS AND CONDITIONS
|
||||
|
||||
How to Apply These Terms to Your New Programs
|
||||
|
||||
If you develop a new program, and you want it to be of the greatest
|
||||
possible use to the public, the best way to achieve this is to make it
|
||||
free software which everyone can redistribute and change under these terms.
|
||||
|
||||
To do so, attach the following notices to the program. It is safest
|
||||
to attach them to the start of each source file to most effectively
|
||||
state the exclusion of warranty; and each file should have at least
|
||||
the "copyright" line and a pointer to where the full notice is found.
|
||||
|
||||
{one line to give the program's name and a brief idea of what it does.}
|
||||
Copyright (C) {year} {name of author}
|
||||
|
||||
This program is free software: you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation, either version 3 of the License, or
|
||||
(at your option) any later version.
|
||||
|
||||
This program is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
||||
|
||||
Also add information on how to contact you by electronic and paper mail.
|
||||
|
||||
If the program does terminal interaction, make it output a short
|
||||
notice like this when it starts in an interactive mode:
|
||||
|
||||
{project} Copyright (C) {year} {fullname}
|
||||
This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
|
||||
This is free software, and you are welcome to redistribute it
|
||||
under certain conditions; type `show c' for details.
|
||||
|
||||
The hypothetical commands `show w' and `show c' should show the appropriate
|
||||
parts of the General Public License. Of course, your program's commands
|
||||
might be different; for a GUI interface, you would use an "about box".
|
||||
|
||||
You should also get your employer (if you work as a programmer) or school,
|
||||
if any, to sign a "copyright disclaimer" for the program, if necessary.
|
||||
For more information on this, and how to apply and follow the GNU GPL, see
|
||||
<http://www.gnu.org/licenses/>.
|
||||
|
||||
The GNU General Public License does not permit incorporating your program
|
||||
into proprietary programs. If your program is a subroutine library, you
|
||||
may consider it more useful to permit linking proprietary applications with
|
||||
the library. If this is what you want to do, use the GNU Lesser General
|
||||
Public License instead of this License. But first, please read
|
||||
<http://www.gnu.org/philosophy/why-not-lgpl.html>.
|
||||
33
docker/elk/README.md
Normal file
33
docker/elk/README.md
Normal file
|
|
@ -0,0 +1,33 @@
|
|||
# dockerized elk stack
|
||||
|
||||
|
||||
[elk](http://www.elasticsearch.org/overview/) is a stack combining elasticsearch, logstash and the kibana dashboard. It is used to structure and vizualize data in realtime.
|
||||
|
||||
This repository contains the necessary files to create a *dockerized* version of the elk stack.
|
||||
|
||||
This dockerized version is part of the **[T-Pot community honeypot](http://dtag-dev-sec.github.io/)** of Deutsche Telekom AG.
|
||||
|
||||
The `Dockerfile` contains the blueprint for the dockerized elk stack and will be used to setup the docker image.
|
||||
|
||||
Further, `elasticsearch.yml`, `logstash.conf`, `elkbase.tar.gz`, `elk.ico` and `kibana.svg`, are all tailored to fit the T-Pot environment.
|
||||
|
||||
The `supervisord.conf` is used to start elk under supervision of supervisord.
|
||||
|
||||
Using systemd, copy the `systemd/elk.service` to `/etc/systemd/system/elk.service` and start using
|
||||
|
||||
```
|
||||
systemctl enable elk
|
||||
systemctl start elk
|
||||
```
|
||||
|
||||
This will make sure that the docker container is started with the appropriate permissions and port mappings. Further, it autostarts during boot.
|
||||
|
||||
Starting with T-Pot 16.10 you can simply access the kibana dashboard by browsing to ``https://<your.ip>:64297`` and enter your web user credentials.
|
||||
|
||||
Note: The kibana dashboard can be customized to fit your needs.
|
||||
|
||||
By default all data will be persistently stored in `/data/elk/`. Indexed events older than 90 days will be deleted. You can adjust this behavior in `/etc/crontab` to fit your needs, but be advised to provide enough RAM and free disk-space if you wish to do so.
|
||||
|
||||
# T-Pot Dashboard
|
||||
|
||||
|
||||
BIN
docker/elk/doc/dashboard.png
Normal file
BIN
docker/elk/doc/dashboard.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 910 KiB |
36
docker/elk/elasticsearch/Dockerfile
Normal file
36
docker/elk/elasticsearch/Dockerfile
Normal file
|
|
@ -0,0 +1,36 @@
|
|||
FROM alpine
|
||||
MAINTAINER MO
|
||||
|
||||
# Include dist
|
||||
ADD dist/ /root/dist/
|
||||
|
||||
# Setup env and apt
|
||||
RUN apk -U upgrade && \
|
||||
apk add bash curl openjdk8-jre procps wget && \
|
||||
|
||||
# Get and install packages
|
||||
cd /root/dist/ && \
|
||||
mkdir -p /usr/share/elasticsearch/ && \
|
||||
wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-5.6.1.tar.gz && \
|
||||
tar xvfz elasticsearch-5.6.1.tar.gz --strip-components=1 -C /usr/share/elasticsearch/ && \
|
||||
|
||||
# Add and move files
|
||||
cd /root/dist/ && \
|
||||
mkdir -p /usr/share/elasticsearch/config && \
|
||||
cp elasticsearch.yml /usr/share/elasticsearch/config/ && \
|
||||
|
||||
# Setup user, groups and configs
|
||||
addgroup -g 2000 elasticsearch && \
|
||||
adduser -S -H -s /bin/bash -u 2000 -D -g 2000 elasticsearch && \
|
||||
chown -R elasticsearch:elasticsearch /usr/share/elasticsearch/ && \
|
||||
|
||||
# Clean up
|
||||
apk del wget && \
|
||||
rm -rf /root/*
|
||||
|
||||
# Healthcheck
|
||||
HEALTHCHECK --retries=10 CMD curl -s -XGET 'http://127.0.0.1:9200/_cat/health'
|
||||
|
||||
# Start ELK
|
||||
USER elasticsearch
|
||||
CMD ["/usr/share/elasticsearch/bin/elasticsearch"]
|
||||
8
docker/elk/elasticsearch/dist/elasticsearch.yml
vendored
Normal file
8
docker/elk/elasticsearch/dist/elasticsearch.yml
vendored
Normal file
|
|
@ -0,0 +1,8 @@
|
|||
cluster.name: tpotcluster
|
||||
node.name: "tpotcluster-node-01"
|
||||
path:
|
||||
logs: /data/elk/log
|
||||
data: /data/elk/data
|
||||
http.host: 0.0.0.0
|
||||
http.cors.enabled: true
|
||||
http.cors.allow-origin: "*"
|
||||
32
docker/elk/head/Dockerfile
Normal file
32
docker/elk/head/Dockerfile
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
# Elasticsearch-head Dockerfile by MO
|
||||
#
|
||||
# VERSION 17.06
|
||||
FROM alpine
|
||||
MAINTAINER MO
|
||||
|
||||
# Setup env and apt
|
||||
RUN apk -U upgrade && \
|
||||
apk add bash curl nodejs nodejs-npm git procps && \
|
||||
|
||||
# Get and install packages
|
||||
mkdir -p /usr/src/app/ && \
|
||||
cd /usr/src/app/ && \
|
||||
git clone https://github.com/mobz/elasticsearch-head . && \
|
||||
npm install http-server && \
|
||||
sed -i 's/\"http\:\/\/localhost\:9200\"/\"https\:\/\/\<FQDN\>\:64297\/es\/\"/' /usr/src/app/_site/app.js && \
|
||||
|
||||
# Setup user, groups and configs
|
||||
addgroup -g 2000 head && \
|
||||
adduser -S -H -s /bin/bash -u 2000 -D -g 2000 head && \
|
||||
chown -R head:head /usr/src/app/ && \
|
||||
|
||||
# Clean up
|
||||
apk del git
|
||||
|
||||
# Healthcheck
|
||||
HEALTHCHECK --retries=10 CMD curl -s -XGET 'http://127.0.0.1:9100'
|
||||
|
||||
# Start elasticsearch-head
|
||||
USER head
|
||||
WORKDIR /usr/src/app
|
||||
CMD ["node_modules/http-server/bin/http-server", "_site", "-p", "9100"]
|
||||
52
docker/elk/kibana/Dockerfile
Normal file
52
docker/elk/kibana/Dockerfile
Normal file
|
|
@ -0,0 +1,52 @@
|
|||
FROM alpine
|
||||
MAINTAINER MO
|
||||
|
||||
# Include dist
|
||||
ADD dist/ /root/dist/
|
||||
|
||||
# Setup env and apt
|
||||
RUN apk -U upgrade && \
|
||||
apk add bash curl nodejs procps wget && \
|
||||
|
||||
# Get and install packages
|
||||
cd /root/dist/ && \
|
||||
mkdir -p /usr/share/kibana/ && \
|
||||
wget https://artifacts.elastic.co/downloads/kibana/kibana-5.6.1-linux-x86_64.tar.gz && \
|
||||
tar xvfz kibana-5.6.1-linux-x86_64.tar.gz --strip-components=1 -C /usr/share/kibana/ && \
|
||||
|
||||
# Kibana's bundled node does not work in alpine
|
||||
rm /usr/share/kibana/node/bin/node && \
|
||||
rm /usr/share/kibana/node/bin/npm && \
|
||||
ln -s /usr/bin/node /usr/share/kibana/node/bin/node && \
|
||||
ln -s /usr/bin/npm /usr/share/kibana/node/bin/npm && \
|
||||
|
||||
# Add and move files
|
||||
cd /root/dist/ && \
|
||||
cp kibana.svg /usr/share/kibana/src/ui/public/images/kibana.svg && \
|
||||
cp kibana.svg /usr/share/kibana/src/ui/public/icons/kibana.svg && \
|
||||
cp elk.ico /usr/share/kibana/src/ui/public/assets/favicons/favicon.ico && \
|
||||
cp elk.ico /usr/share/kibana/src/ui/public/assets/favicons/favicon-16x16.png && \
|
||||
cp elk.ico /usr/share/kibana/src/ui/public/assets/favicons/favicon-32x32.png && \
|
||||
cp create_kibana_index.js /usr/share/kibana/src/core_plugins/elasticsearch/lib/ && \
|
||||
cd / && \
|
||||
|
||||
# Setup user, groups and configs
|
||||
sed -i 's/#server.basePath: ""/server.basePath: "\/kibana"/' /usr/share/kibana/config/kibana.yml && \
|
||||
sed -i 's/#kibana.defaultAppId: "discover"/kibana.defaultAppId: "dashboards"/' /usr/share/kibana/config/kibana.yml && \
|
||||
sed -i 's/#server.host: "localhost"/server.host: "0.0.0.0"/' /usr/share/kibana/config/kibana.yml && \
|
||||
sed -i 's/#elasticsearch.url: "http:\/\/localhost:9200"/elasticsearch.url: "http:\/\/elasticsearch:9200"/' /usr/share/kibana/config/kibana.yml && \
|
||||
/usr/share/kibana/bin/kibana 2>&1 | grep -m 1 "Optimization of bundles" && \
|
||||
addgroup -g 2000 kibana && \
|
||||
adduser -S -H -s /bin/bash -u 2000 -D -g 2000 kibana && \
|
||||
chown -R kibana:kibana /usr/share/kibana/ && \
|
||||
|
||||
# Clean up
|
||||
apk del wget && \
|
||||
rm -rf /root/*
|
||||
|
||||
# Healthcheck
|
||||
HEALTHCHECK --retries=10 CMD curl -s -XGET 'http://127.0.0.1:5601'
|
||||
|
||||
# Start kibana
|
||||
USER kibana
|
||||
CMD ["/usr/share/kibana/bin/kibana"]
|
||||
176
docker/elk/kibana/dashboard/es_kibana.json
Normal file
176
docker/elk/kibana/dashboard/es_kibana.json
Normal file
File diff suppressed because one or more lines are too long
1
docker/elk/kibana/dashboard/kibana-patterns.json
Normal file
1
docker/elk/kibana/dashboard/kibana-patterns.json
Normal file
File diff suppressed because one or more lines are too long
38
docker/elk/kibana/dist/create_kibana_index.js
vendored
Normal file
38
docker/elk/kibana/dist/create_kibana_index.js
vendored
Normal file
|
|
@ -0,0 +1,38 @@
|
|||
'use strict';
|
||||
|
||||
var _setup_error = require('./setup_error');
|
||||
|
||||
var _setup_error2 = _interopRequireDefault(_setup_error);
|
||||
|
||||
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
||||
|
||||
module.exports = function (server, mappings) {
|
||||
var _server$plugins$elast = server.plugins.elasticsearch.getCluster('admin');
|
||||
|
||||
const callWithInternalUser = _server$plugins$elast.callWithInternalUser;
|
||||
|
||||
const index = server.config().get('kibana.index');
|
||||
|
||||
function handleError(message) {
|
||||
return function (err) {
|
||||
throw new _setup_error2.default(server, message, err);
|
||||
};
|
||||
}
|
||||
|
||||
return callWithInternalUser('indices.create', {
|
||||
index: index,
|
||||
body: {
|
||||
settings: {
|
||||
number_of_shards: 1,
|
||||
number_of_replicas: 0,
|
||||
'index.mapper.dynamic': false
|
||||
},
|
||||
mappings
|
||||
}
|
||||
}).catch(handleError('Unable to create Kibana index "<%= kibana.index %>"')).then(function () {
|
||||
return callWithInternalUser('cluster.health', {
|
||||
waitForStatus: 'yellow',
|
||||
index: index
|
||||
}).catch(handleError('Waiting for Kibana index "<%= kibana.index %>" to come online failed.'));
|
||||
});
|
||||
};
|
||||
BIN
docker/elk/kibana/dist/elk.ico
vendored
Normal file
BIN
docker/elk/kibana/dist/elk.ico
vendored
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 805 B |
64
docker/elk/kibana/dist/kibana.svg
vendored
Normal file
64
docker/elk/kibana/dist/kibana.svg
vendored
Normal file
File diff suppressed because one or more lines are too long
|
After Width: | Height: | Size: 7 KiB |
BIN
docker/elk/kibana/elkbase.tgz
Normal file
BIN
docker/elk/kibana/elkbase.tgz
Normal file
Binary file not shown.
38
docker/elk/logstash/Dockerfile
Normal file
38
docker/elk/logstash/Dockerfile
Normal file
|
|
@ -0,0 +1,38 @@
|
|||
FROM alpine
|
||||
MAINTAINER MO
|
||||
|
||||
# Include dist
|
||||
ADD dist/ /root/dist/
|
||||
|
||||
# Setup env and apt
|
||||
RUN apk -U upgrade && \
|
||||
apk add bash curl git libc6-compat libzmq openjdk8-jre procps wget && \
|
||||
|
||||
# Get and install packages
|
||||
git clone https://github.com/dtag-dev-sec/listbot /etc/listbot && \
|
||||
cd /root/dist/ && \
|
||||
mkdir -p /usr/share/logstash/ && \
|
||||
wget https://artifacts.elastic.co/downloads/logstash/logstash-5.6.1.tar.gz && \
|
||||
wget http://geolite.maxmind.com/download/geoip/database/GeoLite2-ASN.tar.gz && \
|
||||
tar xvfz logstash-5.6.1.tar.gz --strip-components=1 -C /usr/share/logstash/ && \
|
||||
/usr/share/logstash/bin/logstash-plugin install logstash-filter-translate && \
|
||||
/usr/share/logstash/bin/logstash-plugin install logstash-output-syslog && \
|
||||
tar xvfz GeoLite2-ASN.tar.gz --strip-components=1 -C /usr/share/logstash/vendor/bundle/jruby/1.9/gems/logstash-filter-geoip-4.3.1-java/vendor/ && \
|
||||
|
||||
# Add and move files
|
||||
cd /root/dist/ && \
|
||||
cp update.sh /usr/bin/ && \
|
||||
chmod u+x /usr/bin/update.sh && \
|
||||
mkdir -p /etc/logstash/conf.d && \
|
||||
cp logstash.conf /etc/logstash/conf.d/ && \
|
||||
cp elasticsearch-template-es5x.json /usr/share/logstash/vendor/bundle/jruby/1.9/gems/logstash-output-elasticsearch-7.4.0-java/lib/logstash/outputs/elasticsearch/ && \
|
||||
|
||||
# Clean up
|
||||
apk del wget && \
|
||||
rm -rf /root/*
|
||||
|
||||
# Healthcheck
|
||||
HEALTHCHECK --retries=10 CMD curl -s -XGET 'http://127.0.0.1:9600'
|
||||
|
||||
# Start logstash
|
||||
CMD update.sh && /usr/share/logstash/bin/logstash -f /etc/logstash/conf.d/logstash.conf
|
||||
48
docker/elk/logstash/dist/elasticsearch-template-es5x.json
vendored
Normal file
48
docker/elk/logstash/dist/elasticsearch-template-es5x.json
vendored
Normal file
|
|
@ -0,0 +1,48 @@
|
|||
{
|
||||
"template" : "logstash-*",
|
||||
"version" : 50001,
|
||||
"settings" : {
|
||||
"index.refresh_interval" : "5s",
|
||||
"index.number_of_shards" : "1",
|
||||
"index.number_of_replicas" : "0"
|
||||
},
|
||||
"mappings" : {
|
||||
"_default_" : {
|
||||
"_all" : {"enabled" : true, "norms" : false},
|
||||
"dynamic_templates" : [ {
|
||||
"message_field" : {
|
||||
"path_match" : "message",
|
||||
"match_mapping_type" : "string",
|
||||
"mapping" : {
|
||||
"type" : "text",
|
||||
"norms" : false
|
||||
}
|
||||
}
|
||||
}, {
|
||||
"string_fields" : {
|
||||
"match" : "*",
|
||||
"match_mapping_type" : "string",
|
||||
"mapping" : {
|
||||
"type" : "text", "norms" : false,
|
||||
"fields" : {
|
||||
"keyword" : { "type": "keyword", "ignore_above": 256 }
|
||||
}
|
||||
}
|
||||
}
|
||||
} ],
|
||||
"properties" : {
|
||||
"@timestamp": { "type": "date", "include_in_all": false },
|
||||
"@version": { "type": "keyword", "include_in_all": false },
|
||||
"geoip" : {
|
||||
"dynamic": true,
|
||||
"properties" : {
|
||||
"ip": { "type": "ip" },
|
||||
"location" : { "type" : "geo_point" },
|
||||
"latitude" : { "type" : "half_float" },
|
||||
"longitude" : { "type" : "half_float" }
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
32
docker/elk/logstash/dist/gen_cve_map.sh
vendored
Executable file
32
docker/elk/logstash/dist/gen_cve_map.sh
vendored
Executable file
|
|
@ -0,0 +1,32 @@
|
|||
#!/bin/bash
|
||||
myURL="https://rules.emergingthreats.net/open/suricata-4.0/rules/sid-msg.map"
|
||||
myRULESFILE="sid-msg.map"
|
||||
myCVEMAP="cve.yaml"
|
||||
|
||||
# Clear cve map
|
||||
rm $myCVEMAP
|
||||
|
||||
# Download SID map from ET if server offers newer file
|
||||
wget -N $myURL
|
||||
myRULESCOUNT=$(wc -l < $myRULESFILE)
|
||||
|
||||
# Just extract rules with CVE ID, for proper matching we also need SID
|
||||
let i=0
|
||||
let j=0
|
||||
while read -r myRULE
|
||||
do
|
||||
(( ++i ))
|
||||
echo -ne "Processing rules, please be patient ($i / $myRULESCOUNT)\r"
|
||||
myCVE=$(echo $myRULE | grep -o -E "(cve,|CVE-|CAN-)([0-9]{4}-([0-9]{4}|[0-9]{5}))" | tr a-z A-Z | tr ",|-" " " | awk '{ print $1"-"$2"-"$3 }')
|
||||
if [ "$myCVE" != "" ]
|
||||
then
|
||||
mySID=$(echo $myRULE | awk '{ print $1 }')
|
||||
echo \"$mySID\": \"$myCVE\" >> $myCVEMAP
|
||||
(( ++j ))
|
||||
fi
|
||||
done < "$myRULESFILE"
|
||||
echo
|
||||
echo "Done. $j CVE IDs have been mapped."
|
||||
|
||||
# Clean up
|
||||
rm $myRULESFILE
|
||||
127
docker/elk/logstash/dist/gen_iprep_map.sh
vendored
Executable file
127
docker/elk/logstash/dist/gen_iprep_map.sh
vendored
Executable file
|
|
@ -0,0 +1,127 @@
|
|||
#!/bin/bash
|
||||
myIPREPMAP="iprep.yaml"
|
||||
myRED="[0;31m"
|
||||
myGREEN="[0;32m"
|
||||
myBLUE="[0;34m"
|
||||
myWHITE="[0;0m"
|
||||
|
||||
# Prepare for new files
|
||||
rm -rf *.raw *.yaml.tmp iprep.yaml
|
||||
|
||||
### Define repeating commands as functions
|
||||
# Download only if host is up, file is newer and follow redirects
|
||||
fuCURL () {
|
||||
local myFILE=$1
|
||||
local myURL=$2
|
||||
local myHOST=$(echo $2 | cut -d "/" -f3)
|
||||
|
||||
echo -n "[ Now checking host ] [$myBLUE $myHOST $myWHITE] "
|
||||
curl --connect-timeout 5 -IsS $myHOST 2>&1>/dev/null
|
||||
if [ $? -eq 0 ];
|
||||
then
|
||||
echo "[$myGREEN OK $myWHITE]"
|
||||
echo -n "[ Now downloading ] [$myBLUE $myURL $myWHITE] "
|
||||
curl -fLso $myFILE -z $myFILE $myURL
|
||||
if [ $? -eq 0 ];
|
||||
then
|
||||
echo "[$myGREEN OK $myWHITE]"
|
||||
else
|
||||
echo "[$myRED ERROR $myWHITE]"
|
||||
fi
|
||||
else
|
||||
echo "[$myRED ERROR $myWHITE]"
|
||||
fi
|
||||
}
|
||||
|
||||
# Only match lines with CIDR addresses, unzip if necessary
|
||||
# Duplicates will be eliminated for the final translation map!
|
||||
fuMATCHCIDR () {
|
||||
local myFILE=$1
|
||||
|
||||
if [ -f $myFILE ];
|
||||
then
|
||||
myZIP=$(file $myFILE | grep -c "Zip")
|
||||
if [ "$myZIP" == "1" ]
|
||||
then
|
||||
unzip -p $myFILE | grep -o -P "\b(?:\d{1,3}\.){3}\d{1,3}/\d{1,2}\b" | xargs -I '{}' prips '{}'
|
||||
else
|
||||
grep -o -P "\b(?:\d{1,3}\.){3}\d{1,3}/\d{1,2}\b" $myFILE | xargs -I '{}' prips '{}'
|
||||
fi
|
||||
fi
|
||||
}
|
||||
|
||||
# Only match lines with IPv4 addresses, unzip if necessary
|
||||
# Duplicates will be eliminated for the final translation map!
|
||||
fuMATCHIP () {
|
||||
local myFILE=$1
|
||||
|
||||
if [ -f $myFILE ];
|
||||
then
|
||||
myZIP=$(file $myFILE | grep -c "Zip")
|
||||
if [ "$myZIP" == "1" ]
|
||||
then
|
||||
unzip -p $myFILE | grep -o -P "\b(?:\d{1,3}\.){3}\d{1,3}\b"
|
||||
else
|
||||
grep -o -P "\b(?:\d{1,3}\.){3}\d{1,3}\b" $myFILE
|
||||
fi
|
||||
fi
|
||||
}
|
||||
|
||||
### Define download function
|
||||
fuDOWNLOAD () {
|
||||
local myURL=$1
|
||||
local myTAG=$2
|
||||
local myTMPFILE="$3.tmp"
|
||||
local myYAMLFILE="$3.raw"
|
||||
|
||||
fuCURL $myTMPFILE $myURL
|
||||
fuMATCHCIDR $myTMPFILE | awk '{ print "\""$1"\": \"" "'"$myTAG"'" "\"" }' > $myYAMLFILE
|
||||
fuMATCHIP $myTMPFILE | awk '{ print "\""$1"\": \"" "'"$myTAG"'" "\"" }' >> $myYAMLFILE
|
||||
mySIZE=$(wc -l < $myYAMLFILE)
|
||||
if [ "$mySIZE" != "0" ]
|
||||
then
|
||||
echo "[ Control output ] [$myBLUE $(head -n 1 $myYAMLFILE) $myWHITE]"
|
||||
else
|
||||
echo "[ Control output ] [$myRED EMPTY FILE $myWHITE]"
|
||||
fi
|
||||
}
|
||||
|
||||
# Download reputation lists
|
||||
fuDOWNLOAD "https://reputation.alienvault.com/reputation.generic" "bad reputation" "alienvault"
|
||||
fuDOWNLOAD "https://www.badips.com/get/list/any/2" "known attacker" "badips"
|
||||
fuDOWNLOAD "http://osint.bambenekconsulting.com/feeds/c2-ipmasterlist.txt" "C2 server" "bambenek"
|
||||
fuDOWNLOAD "https://lists.blocklist.de/lists/all.txt" "known attacker" "blocklist"
|
||||
fuDOWNLOAD "https://raw.githubusercontent.com/firehol/blocklist-ipsets/master/botscout_1d.ipset" "form spammer" "firehol_botscout"
|
||||
fuDOWNLOAD "https://raw.githubusercontent.com/firehol/blocklist-ipsets/master/cruzit_web_attacks.ipset" "known attacker" "firehol_cruzit"
|
||||
fuDOWNLOAD "https://raw.githubusercontent.com/firehol/blocklist-ipsets/master/malwaredomainlist.ipset" "known atttacker" "firehol_mwdomainlist"
|
||||
fuDOWNLOAD "https://raw.githubusercontent.com/firehol/blocklist-ipsets/master/proxylists_1d.ipset" "anonymizer" "firehol_proxylists"
|
||||
fuDOWNLOAD "https://raw.githubusercontent.com/firehol/blocklist-ipsets/master/proxyrss_1d.ipset" "anonymizer" "firehol_proxyrss"
|
||||
fuDOWNLOAD "https://raw.githubusercontent.com/firehol/blocklist-ipsets/master/proxyspy_1d.ipset" "anonymizer" "firehol_proxyspy"
|
||||
fuDOWNLOAD "https://raw.githubusercontent.com/firehol/blocklist-ipsets/master/ri_web_proxies_30d.ipset" "anonymizer" "firehol_web_proxies"
|
||||
fuDOWNLOAD "https://raw.githubusercontent.com/firehol/blocklist-ipsets/master/socks_proxy_7d.ipset" "anonymizer" "firehol_socks_proxy"
|
||||
fuDOWNLOAD "https://raw.githubusercontent.com/firehol/blocklist-ipsets/master/sslproxies_1d.ipset" "anonymizer" "firehol_sslproxies"
|
||||
fuDOWNLOAD "http://danger.rulez.sk/projects/bruteforceblocker/blist.php" "known attacker" "rulez"
|
||||
fuDOWNLOAD "http://cinsscore.com/list/ci-badguys.txt" "known attacker" "cinsscore"
|
||||
fuDOWNLOAD "https://rules.emergingthreats.net/open/suricata/rules/compromised-ips.txt" "compromised" "et_compromised"
|
||||
fuDOWNLOAD "http://blocklist.greensnow.co/greensnow.txt" "known attacker" "greensnow"
|
||||
fuDOWNLOAD "http://www.nothink.org/blacklist/blacklist_malware_irc.txt" "malware" "nothink"
|
||||
fuDOWNLOAD "http://cybersweat.shop/iprep/iprep_ramnode.txt" "known attacker" "cybersweat"
|
||||
fuDOWNLOAD "http://spys.me/proxy.txt" "anonymizer" "spys"
|
||||
fuDOWNLOAD "http://ransomwaretracker.abuse.ch/downloads/RW_IPBL.txt" "ransomware" "ransomwaretracker"
|
||||
fuDOWNLOAD "https://report.cs.rutgers.edu/DROP/attackers" "known attacker" "rutgers"
|
||||
fuDOWNLOAD "http://sblam.com/blacklist.txt" "form spammer" "sblam"
|
||||
fuDOWNLOAD "https://sslbl.abuse.ch/blacklist/sslipblacklist.csv" "C2 server" "sslbl"
|
||||
fuDOWNLOAD "http://www.talosintelligence.com/feeds/ip-filter.blf" "bad reputation" "talos"
|
||||
fuDOWNLOAD "https://check.torproject.org/cgi-bin/TorBulkExitList.py?ip=1.1.1.1" "tor exit node" "torexit"
|
||||
fuDOWNLOAD "https://torstatus.blutmagie.de/ip_list_all.php/Tor_ip_list_ALL.csv" "tor exit node" "torip"
|
||||
fuDOWNLOAD "https://www.turris.cz/greylist-data/greylist-latest.csv" "bad reputation" "turris"
|
||||
fuDOWNLOAD "https://zeustracker.abuse.ch/blocklist.php?download=badips" "malware" "zeustracker"
|
||||
fuDOWNLOAD "https://raw.githubusercontent.com/stamparm/maltrail/master/trails/static/mass_scanner.txt" "mass scanner" "maltrail_mass_scanner"
|
||||
fuDOWNLOAD "https://myip.ms/files/blacklist/general/full_blacklist_database.zip" "bot, crawler" "myip"
|
||||
|
||||
# Generate logstash translation map for ip reputation lookup
|
||||
echo -n "[ Building translation map ] "
|
||||
cat *.raw > $myIPREPMAP.tmp
|
||||
# Remove duplicates
|
||||
sort -u $myIPREPMAP.tmp > $myIPREPMAP
|
||||
echo "[$myGREEN DONE $myWHITE]"
|
||||
416
docker/elk/logstash/dist/logstash.conf
vendored
Normal file
416
docker/elk/logstash/dist/logstash.conf
vendored
Normal file
|
|
@ -0,0 +1,416 @@
|
|||
# Input section
|
||||
input {
|
||||
|
||||
# Suricata
|
||||
file {
|
||||
path => ["/data/suricata/log/eve.json"]
|
||||
codec => json
|
||||
type => "Suricata"
|
||||
}
|
||||
|
||||
# P0f
|
||||
file {
|
||||
path => ["/data/p0f/log/p0f.json"]
|
||||
codec => json
|
||||
type => "P0f"
|
||||
}
|
||||
|
||||
# Conpot
|
||||
file {
|
||||
path => ["/data/conpot/log/conpot.json"]
|
||||
codec => json
|
||||
type => "ConPot"
|
||||
}
|
||||
|
||||
# Cowrie
|
||||
file {
|
||||
path => ["/data/cowrie/log/cowrie.json"]
|
||||
codec => json
|
||||
type => "Cowrie"
|
||||
}
|
||||
|
||||
# Dionaea
|
||||
file {
|
||||
path => ["/data/dionaea/log/dionaea.json"]
|
||||
codec => json
|
||||
type => "Dionaea"
|
||||
}
|
||||
|
||||
# Elasticpot
|
||||
file {
|
||||
path => ["/data/elasticpot/log/elasticpot.log"]
|
||||
codec => json
|
||||
type => "ElasticPot"
|
||||
}
|
||||
|
||||
# eMobility
|
||||
file {
|
||||
path => ["/data/emobility/log/centralsystemEWS.log"]
|
||||
type => "eMobility"
|
||||
}
|
||||
|
||||
# Glastopf
|
||||
file {
|
||||
path => ["/data/glastopf/log/glastopf.log"]
|
||||
type => "Glastopf"
|
||||
}
|
||||
|
||||
# Honeytrap
|
||||
file {
|
||||
path => ["/data/honeytrap/log/attackers.json"]
|
||||
codec => json
|
||||
type => "Honeytrap"
|
||||
}
|
||||
|
||||
# Mailoney
|
||||
file {
|
||||
path => ["/data/mailoney/log/commands.log"]
|
||||
type => "Mailoney"
|
||||
}
|
||||
|
||||
# Rdpy
|
||||
file {
|
||||
path => ["/data/rdpy/log/rdpy.log"]
|
||||
type => "Rdpy"
|
||||
}
|
||||
|
||||
# Host Syslog
|
||||
file {
|
||||
path => ["/data/host/log/auth.log"]
|
||||
codec => plain
|
||||
type => "Syslog"
|
||||
}
|
||||
|
||||
# Host NGINX
|
||||
file {
|
||||
path => ["/data/host/log/nginx/access.log"]
|
||||
codec => json
|
||||
type => "NGINX"
|
||||
}
|
||||
|
||||
# Vnclowpot
|
||||
file {
|
||||
path => ["/data/vnclowpot/log/vnclowpot.log"]
|
||||
type => "Vnclowpot"
|
||||
}
|
||||
}
|
||||
|
||||
# Filter Section
|
||||
filter {
|
||||
|
||||
# Suricata
|
||||
if [type] == "Suricata" {
|
||||
date {
|
||||
match => [ "timestamp", "ISO8601" ]
|
||||
}
|
||||
translate {
|
||||
refresh_interval => 86400
|
||||
field => "[alert][signature_id]"
|
||||
destination => "[alert][cve_id]"
|
||||
dictionary_path => "/etc/listbot/cve.yaml"
|
||||
}
|
||||
}
|
||||
|
||||
# P0f
|
||||
if [type] == "P0f" {
|
||||
date {
|
||||
match => [ "timestamp", "yyyy'/'MM'/'dd HH:mm:ss" ]
|
||||
remove_field => ["timestamp"]
|
||||
}
|
||||
mutate {
|
||||
rename => {
|
||||
"server_port" => "dest_port"
|
||||
"server_ip" => "dest_ip"
|
||||
"client_port" => "src_port"
|
||||
"client_ip" => "src_ip"
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
# Conpot
|
||||
if [type] == "ConPot" {
|
||||
date {
|
||||
match => [ "timestamp", "ISO8601" ]
|
||||
}
|
||||
}
|
||||
|
||||
# Cowrie
|
||||
if [type] == "Cowrie" {
|
||||
date {
|
||||
match => [ "timestamp", "ISO8601" ]
|
||||
}
|
||||
mutate {
|
||||
rename => {
|
||||
"dst_port" => "dest_port"
|
||||
"dst_ip" => "dest_ip"
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
# Dionaea
|
||||
if [type] == "Dionaea" {
|
||||
date {
|
||||
match => [ "timestamp", "ISO8601" ]
|
||||
}
|
||||
mutate {
|
||||
rename => {
|
||||
"dst_port" => "dest_port"
|
||||
"dst_ip" => "dest_ip"
|
||||
}
|
||||
gsub => [
|
||||
"src_ip", "::ffff:", "",
|
||||
"dest_ip", "::ffff:", ""
|
||||
]
|
||||
}
|
||||
if [credentials] {
|
||||
mutate {
|
||||
add_field => {
|
||||
"login.username" => "%{[credentials][username]}"
|
||||
"login.password" => "%{[credentials][password]}"
|
||||
}
|
||||
remove_field => "[credentials]"
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
# ElasticPot
|
||||
if [type] == "ElasticPot" {
|
||||
date {
|
||||
match => [ "timestamp", "ISO8601" ]
|
||||
}
|
||||
}
|
||||
|
||||
# eMobility
|
||||
if [type] == "eMobility" {
|
||||
grok {
|
||||
match => [ "message", "\A%{IP:src_ip}\.%{POSINT:src_port:integer}\|%{IP:dest_ip}\.%{POSINT:dest_port:integer}:%{SPACE}%{SYSLOG5424PRINTASCII}%{SPACE}%{SYSLOG5424PRINTASCII}%{SPACE}%{SYSLOG5424PRINTASCII}%{SPACE}%{SYSLOG5424PRINTASCII}%{SPACE}%{SYSLOG5424PRINTASCII}%{SPACE}%{SYSLOG5424PRINTASCII}%{SPACE}%{SYSLOG5424PRINTASCII}%{SPACE}%{SYSLOG5424PRINTASCII}%{SPACE}%{SYSLOG5424PRINTASCII}%{SPACE}%{SYSLOG5424SD}%{SYSLOG5424PRINTASCII}%{SPACE}%{SYSLOG5424PRINTASCII}%{SPACE}%{SYSLOG5424PRINTASCII}%{SPACE}%{URIPROTO:http_method}\|%{URIPATH:http_uri}\|%{TIMESTAMP_ISO8601:timestamp}" ]
|
||||
}
|
||||
date {
|
||||
match => [ "timestamp", "ISO8601" ]
|
||||
}
|
||||
}
|
||||
|
||||
# Glastopf
|
||||
if [type] == "Glastopf" {
|
||||
grok {
|
||||
match => [ "message", "\A%{TIMESTAMP_ISO8601:timestamp}%{SPACE}%{NOTSPACE}%{SPACE}%{IP:src_ip}%{SPACE}%{WORD}%{SPACE}%{URIPROTO:http_method}%{SPACE}%{NOTSPACE:http_uri}%{SPACE}%{NOTSPACE}%{SPACE}%{HOSTNAME}:%{NUMBER:dest_port:integer}" ]
|
||||
}
|
||||
date {
|
||||
match => [ "timestamp", "yyyy-MM-dd HH:mm:ss,SSS" ]
|
||||
remove_field => ["timestamp"]
|
||||
}
|
||||
}
|
||||
|
||||
# Honeytrap
|
||||
if [type] == "Honeytrap" {
|
||||
date {
|
||||
match => [ "timestamp", "ISO8601" ]
|
||||
}
|
||||
mutate {
|
||||
rename => {
|
||||
"[attack_connection][local_port]" => "dest_port"
|
||||
"[attack_connection][local_ip]" => "dest_ip"
|
||||
"[attack_connection][remote_port]" => "src_port"
|
||||
"[attack_connection][remote_ip]" => "src_ip"
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
# Mailoney
|
||||
if [type] == "Mailoney" {
|
||||
grok {
|
||||
match => [ "message", "\A%{NAGIOSTIME}\[%{IPV4:src_ip}:%{INT:src_port:integer}] %{GREEDYDATA:smtp_input}" ]
|
||||
}
|
||||
mutate {
|
||||
add_field => {
|
||||
"dest_port" => "25"
|
||||
}
|
||||
}
|
||||
date {
|
||||
match => [ "nagios_epoch", "UNIX" ]
|
||||
remove_field => ["nagios_epoch"]
|
||||
}
|
||||
}
|
||||
|
||||
# Rdpy
|
||||
if [type] == "Rdpy" {
|
||||
grok { match => { "message" => [ "\A%{TIMESTAMP_ISO8601:timestamp},domain:%{CISCO_REASON:domain},username:%{CISCO_REASON:username},password:%{CISCO_REASON:password},hostname:%{GREEDYDATA:hostname}", "\A%{TIMESTAMP_ISO8601:timestamp},Connection from %{IPV4:src_ip}:%{INT:src_port:integer}" ] } }
|
||||
date {
|
||||
match => [ "timestamp", "ISO8601" ]
|
||||
remove_field => ["timestamp"]
|
||||
}
|
||||
mutate {
|
||||
add_field => {
|
||||
"dest_port" => "3389"
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
# Syslog
|
||||
if [type] == "Syslog" {
|
||||
grok {
|
||||
match => {
|
||||
"message" => ["%{SYSLOGPAMSESSION}", "%{CRONLOG}", "%{SYSLOGLINE}"]
|
||||
}
|
||||
overwrite => "message"
|
||||
}
|
||||
date {
|
||||
match => [ "timestamp", "MMM d HH:mm:ss", "MMM dd HH:mm:ss" ]
|
||||
remove_field => ["timestamp"]
|
||||
}
|
||||
date {
|
||||
match => ["timestamp8601", "ISO8601"]
|
||||
remove_field => ["timestamp8601"]
|
||||
}
|
||||
grok {
|
||||
match => { "message" => "Connection closed by %{IP:src_ip}" }
|
||||
add_tag => [ "ssh_connection_closed" ]
|
||||
tag_on_failure => []
|
||||
}
|
||||
grok {
|
||||
match => { "message" => "Received disconnect from %{IP:src_ip}" }
|
||||
add_tag => [ "ssh_connection_disconnect" ]
|
||||
tag_on_failure => []
|
||||
}
|
||||
grok {
|
||||
match => { "message" => "Failed password for invalid user %{USERNAME:username} from %{IP:src_ip} port %{BASE10NUM:port} ssh2" }
|
||||
add_tag => [ "ssh_failed_password" ]
|
||||
tag_on_failure => []
|
||||
}
|
||||
grok {
|
||||
match => { "message" => "Did not receive identification string from %{IP:src_ip}" }
|
||||
add_tag => [ "ssh_no_id" ]
|
||||
tag_on_failure => []
|
||||
}
|
||||
grok {
|
||||
match => { "message" => "User %{USERNAME:username} from %{IP:src_ip} not allowed because not listed in AllowUsers" }
|
||||
add_tag => [ "ssh_user_not_allowed" ]
|
||||
tag_on_failure => []
|
||||
}
|
||||
grok {
|
||||
match => { "message" => "authentication failure; logname=%{USERNAME:logname} uid=%{BASE10NUM:uid} euid=%{BASE10NUM:euid} tty=%{TTY:tty} ruser=%{USERNAME:ruser} rhost=(?:%{HOSTNAME:remote_host}|\s*) user=%{USERNAME:user}"}
|
||||
add_tag => [ "ssh_auth_failure" ]
|
||||
tag_on_failure => []
|
||||
}
|
||||
grok {
|
||||
match => { "message" => "pam_unix\(sshd:auth\): authentication failure; logname= uid=0 euid=0 tty=%{NOTSPACE:tty} ruser= rhost=(?:%{HOSTNAME:remote_host}|\s*) user=%{USERNAME:user}"}
|
||||
add_tag => [ "ssh_auth_failure" ]
|
||||
tag_on_failure => []
|
||||
}
|
||||
grok {
|
||||
match => { "message" => "Failed password for %{USERNAME:username} from %{IP:src_ip} port %{BASE10NUM:port} ssh2"}
|
||||
add_tag => [ "ssh_failed_password" ]
|
||||
tag_on_failure => []
|
||||
}
|
||||
grok {
|
||||
match => { "message" => "Accepted password for %{USERNAME:username} from %{IP:src_ip} port %{BASE10NUM:port} ssh2"}
|
||||
add_tag => [ "ssh_accepted_password" ]
|
||||
tag_on_failure => []
|
||||
}
|
||||
grok {
|
||||
match => { "message" => "Accepted publickey for %{USERNAME:username} from %{IP:src_ip} port %{BASE10NUM:port} ssh2"}
|
||||
add_tag => [ "ssh_accepted_pubkey" ]
|
||||
tag_on_failure => []
|
||||
}
|
||||
grok {
|
||||
match => { "message" => "Accepted keyboard-interactive/pam for %{USERNAME:username} from %{IP:src_ip} port %{BASE10NUM:port} ssh2"}
|
||||
add_tag => [ "ssh_accepted_interactive" ]
|
||||
tag_on_failure => []
|
||||
}
|
||||
}
|
||||
|
||||
# NGINX
|
||||
if [type] == "NGINX" {
|
||||
date {
|
||||
match => [ "timestamp", "ISO8601" ]
|
||||
}
|
||||
}
|
||||
|
||||
# Vnclowpot
|
||||
if [type] == "Vnclowpot" {
|
||||
grok {
|
||||
match => [ "message", "\A%{NOTSPACE}%{SPACE}%{TIME}%{SPACE}%{IPV4:src_ip}:%{INT:src_port}%{SPACE}%{NOTSPACE:vnc_handshake}" ]
|
||||
}
|
||||
date {
|
||||
match => [ "timestamp", "yyyy/MM/dd HH:mm:ss" ]
|
||||
remove_field => ["timestamp"]
|
||||
}
|
||||
mutate {
|
||||
add_field => {
|
||||
"dest_port" => "5900"
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
# Drop if parse fails
|
||||
if "_grokparsefailure" in [tags] { drop {} }
|
||||
|
||||
# Add geo coordinates / ASN info / IP rep.
|
||||
if [src_ip] {
|
||||
geoip {
|
||||
cache_size => 10000
|
||||
source => "src_ip"
|
||||
database => "/usr/share/logstash/vendor/bundle/jruby/1.9/gems/logstash-filter-geoip-4.3.1-java/vendor/GeoLite2-City.mmdb"
|
||||
}
|
||||
geoip {
|
||||
cache_size => 10000
|
||||
source => "src_ip"
|
||||
database => "/usr/share/logstash/vendor/bundle/jruby/1.9/gems/logstash-filter-geoip-4.3.1-java/vendor/GeoLite2-ASN.mmdb"
|
||||
}
|
||||
translate {
|
||||
refresh_interval => 86400
|
||||
field => "src_ip"
|
||||
destination => "ip_rep"
|
||||
dictionary_path => "/etc/listbot/iprep.yaml"
|
||||
}
|
||||
}
|
||||
|
||||
# In some rare conditions dest_port, src_port is indexed as string, forcing integer for now
|
||||
if [dest_port] {
|
||||
mutate {
|
||||
convert => { "dest_port" => "integer" }
|
||||
}
|
||||
}
|
||||
if [src_port] {
|
||||
mutate {
|
||||
convert => { "src_port" => "integer" }
|
||||
}
|
||||
}
|
||||
|
||||
# Add T-Pot hostname and external IP
|
||||
if [type] == "ConPot" or [type] == "Cowrie" or [type] == "Dionaea" or [type] == "ElasticPot" or [type] == "eMobility" or [type] == "Glastopf" or [type] == "Honeytrap" or [type] == "Mailoney" or [type] == "Rdpy" or [type] == "Suricata" or [type] == "Vnclowpot" {
|
||||
mutate {
|
||||
add_field => {
|
||||
"t-pot_ip_ext" => "${MY_EXTIP}"
|
||||
"t-pot_ip_int" => "${MY_INTIP}"
|
||||
"t-pot_hostname" => "${MY_HOSTNAME}"
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
# Output section
|
||||
output {
|
||||
elasticsearch {
|
||||
hosts => ["elasticsearch:9200"]
|
||||
}
|
||||
|
||||
if [type] == "Suricata" {
|
||||
file {
|
||||
file_mode => 0760
|
||||
path => "/data/suricata/log/suricata_ews.log"
|
||||
}
|
||||
}
|
||||
# Debug output
|
||||
#if [type] == "XYZ" {
|
||||
# stdout {
|
||||
# codec => rubydebug
|
||||
# }
|
||||
#}
|
||||
# Debug output
|
||||
#stdout {
|
||||
# codec => rubydebug
|
||||
#}
|
||||
|
||||
}
|
||||
12
docker/elk/logstash/dist/update.sh
vendored
Normal file
12
docker/elk/logstash/dist/update.sh
vendored
Normal file
|
|
@ -0,0 +1,12 @@
|
|||
#!/bin/bash
|
||||
|
||||
# Let's ensure normal operation on exit or if interrupted ...
|
||||
function fuCLEANUP {
|
||||
exit 0
|
||||
}
|
||||
trap fuCLEANUP EXIT
|
||||
|
||||
# Download updated translation maps
|
||||
cd /etc/listbot
|
||||
git pull
|
||||
cd /
|
||||
32
docker/ews/Dockerfile
Normal file
32
docker/ews/Dockerfile
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
FROM alpine
|
||||
MAINTAINER MO
|
||||
|
||||
# Include dist
|
||||
ADD dist/ /root/dist/
|
||||
|
||||
# Install packages
|
||||
RUN apk -U upgrade && \
|
||||
apk add build-base git libssl1.0 openssl-dev python-dev py-cffi py-ipaddress py-lxml py-mysqldb py-pip py-pysqlite py-requests py-setuptools && \
|
||||
pip install pyOpenSSL==16.2.0 && \
|
||||
|
||||
# Setup ewsposter
|
||||
git clone https://github.com/rep/hpfeeds /opt/hpfeeds && \
|
||||
cd /opt/hpfeeds && \
|
||||
python setup.py install && \
|
||||
git clone https://github.com/vorband/ewsposter /opt/ewsposter && \
|
||||
mkdir -p /opt/ewsposter/spool /opt/ewsposter/log && \
|
||||
|
||||
# Setup user and groups
|
||||
addgroup -g 2000 ews && \
|
||||
adduser -S -H -u 2000 -D -g 2000 ews && \
|
||||
|
||||
# Supply configs
|
||||
mv /root/dist/ews.cfg /opt/ewsposter/ && \
|
||||
|
||||
# Clean up
|
||||
apk del build-base git openssl-dev python-dev py-pip py-setuptools && \
|
||||
rm -rf /root/* && \
|
||||
rm -rf /var/cache/apk/*
|
||||
|
||||
# Run ewsposter
|
||||
CMD sleep 10 && /usr/bin/python /opt/ewsposter/ews.py -l 60
|
||||
14
docker/ews/README.md
Normal file
14
docker/ews/README.md
Normal file
|
|
@ -0,0 +1,14 @@
|
|||
[](https://microbadger.com/images/dtagdevsec/ewsposter:1706 "Get your own version badge on microbadger.com") [](https://microbadger.com/images/dtagdevsec/ewsposter:1706 "Get your own image badge on microbadger.com")
|
||||
|
||||
# dockerized ewsposter
|
||||
|
||||
|
||||
[ewsposter](https://github.com/dtag-dev-sec/ews) is a python application that collects information from multiple honeypot sources and posts it to central collection services like the DTAG early warning system and hpfeeds.
|
||||
|
||||
This dockerized version is part of the **[T-Pot community honeypot](http://github.com/dtag-dev-sec/tpotce)** of Deutsche Telekom AG.
|
||||
|
||||
The `Dockerfile` contains the blueprint for the dockerized ewsposter and will be used to setup the docker image.
|
||||
|
||||
The `ews.cfg` is tailored to fit the T-Pot environment.
|
||||
|
||||
The `supervisord.conf` is used to start ewsposter under supervision of supervisord.
|
||||
98
docker/ews/dist/ews.cfg
vendored
Normal file
98
docker/ews/dist/ews.cfg
vendored
Normal file
|
|
@ -0,0 +1,98 @@
|
|||
[MAIN]
|
||||
homedir = /opt/ewsposter/
|
||||
spooldir = /opt/ewsposter/spool/
|
||||
logdir = /opt/ewsposter/log/
|
||||
del_malware_after_send = false
|
||||
send_malware = false
|
||||
sendlimit = 500
|
||||
contact = your_email_address
|
||||
proxy =
|
||||
ip =
|
||||
|
||||
[EWS]
|
||||
ews = true
|
||||
username = community-01-user
|
||||
token = foth{a5maiCee8fineu7
|
||||
rhost_first = https://community.sicherheitstacho.eu/ews-0.1/alert/postSimpleMessage
|
||||
rhost_second = https://community.sicherheitstacho.eu/ews-0.1/alert/postSimpleMessage
|
||||
ignorecert = false
|
||||
|
||||
[HPFEED]
|
||||
hpfeed = false
|
||||
host = 0.0.0.0
|
||||
port = 0
|
||||
channels = 0
|
||||
ident = 0
|
||||
secret= 0
|
||||
|
||||
[EWSJSON]
|
||||
json = false
|
||||
jsondir = /data/ews/json/
|
||||
|
||||
[GLASTOPFV3]
|
||||
glastopfv3 = true
|
||||
nodeid = glastopfv3-community-01
|
||||
sqlitedb = /data/glastopf/db/glastopf.db
|
||||
malwaredir = /data/glastopf/data/files/
|
||||
|
||||
[GLASTOPFV2]
|
||||
glastopfv2 = false
|
||||
nodeid =
|
||||
mysqlhost =
|
||||
mysqldb =
|
||||
mysqluser =
|
||||
mysqlpw =
|
||||
malwaredir =
|
||||
|
||||
[KIPPO]
|
||||
kippo = false
|
||||
nodeid =
|
||||
mysqlhost =
|
||||
mysqldb =
|
||||
mysqluser =
|
||||
mysqlpw =
|
||||
malwaredir =
|
||||
|
||||
[COWRIE]
|
||||
cowrie = true
|
||||
nodeid = cowrie-community-01
|
||||
logfile = /data/cowrie/log/cowrie.json
|
||||
|
||||
[DIONAEA]
|
||||
dionaea = true
|
||||
nodeid = dionaea-community-01
|
||||
malwaredir = /data/dionaea/binaries/
|
||||
sqlitedb = /data/dionaea/log/dionaea.sqlite
|
||||
|
||||
[HONEYTRAP]
|
||||
honeytrap = true
|
||||
nodeid = honeytrap-community-01
|
||||
newversion = true
|
||||
payloaddir = /data/honeytrap/attacks/
|
||||
attackerfile = /data/honeytrap/log/attacker.log
|
||||
|
||||
[RDPDETECT]
|
||||
rdpdetect = false
|
||||
nodeid =
|
||||
iptableslog =
|
||||
targetip =
|
||||
|
||||
[EMOBILITY]
|
||||
eMobility = true
|
||||
nodeid = emobility-community-01
|
||||
logfile = /data/emobility/log/centralsystemEWS.log
|
||||
|
||||
[CONPOT]
|
||||
conpot = true
|
||||
nodeid = conpot-community-01
|
||||
logfile = /data/conpot/log/conpot.json
|
||||
|
||||
[ELASTICPOT]
|
||||
elasticpot = true
|
||||
nodeid = elasticpot-community-01
|
||||
logfile = /data/elasticpot/log/elasticpot.log
|
||||
|
||||
[SURICATA]
|
||||
suricata = true
|
||||
nodeid = suricata-community-01
|
||||
logfile = /data/suricata/log/suricata_ews.log
|
||||
50
docker/glastopf/Dockerfile
Normal file
50
docker/glastopf/Dockerfile
Normal file
|
|
@ -0,0 +1,50 @@
|
|||
FROM alpine
|
||||
MAINTAINER MO
|
||||
|
||||
# Include dist
|
||||
ADD dist/ /root/dist/
|
||||
|
||||
# Install packages
|
||||
RUN apk -U upgrade && \
|
||||
apk add autoconf bash bind-tools build-base cython git libffi libffi-dev make py-asn1 \
|
||||
py-cffi py-chardet py-chardet py-cparser py-cryptography py-dateutil \
|
||||
py-enum34 py-idna py-ipaddress py-jinja2 py-lxml py-mysqldb py-openssl \
|
||||
py-pip py-requests py-setuptools python python-dev && \
|
||||
apk -U add --repository http://dl-3.alpinelinux.org/alpine/edge/testing/ \
|
||||
py-beautifulsoup4 php7 php7-dev py-cssselect py-gevent py-greenlet py-mongo \
|
||||
py-sqlalchemy py-webob && \
|
||||
|
||||
# Install php sandbox from git
|
||||
git clone https://github.com/glastopf/BFR.git /opt/BFR && \
|
||||
cd /opt/BFR && \
|
||||
phpize7 && \
|
||||
./configure \
|
||||
--with-php-config=/usr/bin/php-config7 \
|
||||
--enable-bfr && \
|
||||
make && \
|
||||
make install && \
|
||||
cd / && \
|
||||
rm -rf /opt/BFR /tmp/* /var/tmp/* && \
|
||||
echo "zend_extension = "$(find /usr -name bfr.so) >> /etc/php7/php.ini && \
|
||||
|
||||
# Install glastopf from git
|
||||
git clone https://github.com/mushorg/glastopf.git /opt/glastopf && \
|
||||
cd /opt/glastopf && \
|
||||
python setup.py install && \
|
||||
cd / && \
|
||||
rm -rf /opt/glastopf /tmp/* /var/tmp/* && \
|
||||
|
||||
# Setup user, groups and configs
|
||||
addgroup -g 2000 glastopf && \
|
||||
adduser -S -H -u 2000 -D -g 2000 glastopf && \
|
||||
mkdir -p /opt/glastopf && \
|
||||
mv /root/dist/glastopf.cfg /opt/glastopf/ && \
|
||||
|
||||
# Clean up
|
||||
apk del autoconf build-base git libffi-dev php7-dev python-dev && \
|
||||
rm -rf /root/* && \
|
||||
rm -rf /var/cache/apk/*
|
||||
|
||||
# Set workdir and start glastopf
|
||||
WORKDIR /opt/glastopf/
|
||||
CMD ["glastopf-runner"]
|
||||
31
docker/glastopf/README.md
Normal file
31
docker/glastopf/README.md
Normal file
|
|
@ -0,0 +1,31 @@
|
|||
[](https://microbadger.com/images/dtagdevsec/glastopf:1706 "Get your own version badge on microbadger.com") [](https://microbadger.com/images/dtagdevsec/glastopf:1706 "Get your own image badge on microbadger.com")
|
||||
|
||||
# dockerized glastopf v3
|
||||
|
||||
|
||||
[glastopf](https://github.com/glastopf/glastopf) is a python web application honeypot.
|
||||
|
||||
This repository contains the necessary files to create a *dockerized* version of glastopf v3.
|
||||
|
||||
This dockerized version is part of the **[T-Pot community honeypot](http://dtag-dev-sec.github.io/)** of Deutsche Telekom AG.
|
||||
|
||||
The `Dockerfile` contains the blueprint for the dockerized glastopf and will be used to setup the docker image.
|
||||
|
||||
The `glastopf.cfg` is tailored to fit the T-Pot environment.
|
||||
|
||||
The `supervisord.conf` is used to start glastopf under supervision of supervisord.
|
||||
|
||||
Using systemd, copy the `systemd/glastopf.service` to `/etc/systemd/system/glastopf.service` and start using
|
||||
|
||||
```
|
||||
systemctl enable glastopf
|
||||
systemctl start glastopf
|
||||
```
|
||||
|
||||
This will make sure that the docker container is started with the appropriate permissions and port mappings. Further, it autostarts during boot.
|
||||
|
||||
By default all data will be stored in `/data/glastopf/` until the honeypot service will be restarted which is by default every 24 hours. If you want to keep data persistently simply edit the ``service`` file, find the line that contains ``clean.sh`` and set the option from ``off`` to ``on``. Be advised to establish some sort of log management if you wish to do so.
|
||||
|
||||
# Glastopf Dashboard
|
||||
|
||||
|
||||
106
docker/glastopf/dist/glastopf.cfg
vendored
Normal file
106
docker/glastopf/dist/glastopf.cfg
vendored
Normal file
|
|
@ -0,0 +1,106 @@
|
|||
[webserver]
|
||||
host = 0.0.0.0
|
||||
port = 80
|
||||
uid = glastopf
|
||||
gid = glastopf
|
||||
proxy_enabled = False
|
||||
|
||||
[ssl]
|
||||
enabled = False
|
||||
certfile =
|
||||
keyfile =
|
||||
|
||||
#Generic logging for general monitoring
|
||||
[logging]
|
||||
consolelog_enabled = True
|
||||
filelog_enabled = True
|
||||
logfile = log/glastopf.log
|
||||
|
||||
[dork-db]
|
||||
enabled = True
|
||||
pattern = rfi
|
||||
# Extracts dorks from a online dorks service operated by The Honeynet Project
|
||||
# This service is down until further notice!
|
||||
mnem_service = False
|
||||
|
||||
[hpfeed]
|
||||
enabled = False
|
||||
host = hpfriends.honeycloud.net
|
||||
port = 20000
|
||||
secret = 3wis3l2u5l7r3cew
|
||||
# channels comma separated
|
||||
chan_events = glastopf.events
|
||||
chan_files = glastopf.files
|
||||
ident = x8yer@hp1
|
||||
|
||||
[main-database]
|
||||
#If disabled a sqlite database will be created (db/glastopf.db)
|
||||
#to be used as dork storage.
|
||||
enabled = True
|
||||
#mongodb or sqlalchemy connection string, ex:
|
||||
#mongodb://localhost:27017/glastopf
|
||||
#mongodb://james:bond@localhost:27017/glastopf
|
||||
#mysql://james:bond@somehost.com/glastopf
|
||||
connection_string = sqlite:///db/glastopf.db
|
||||
|
||||
[surfcertids]
|
||||
enabled = False
|
||||
host = localhost
|
||||
port = 5432
|
||||
user =
|
||||
password =
|
||||
database = idsserver
|
||||
|
||||
[syslog]
|
||||
enabled = False
|
||||
socket = /dev/log
|
||||
|
||||
[mail]
|
||||
enabled = False
|
||||
# an email notification will be sent only if a specified matched pattern is identified.
|
||||
# Use the wildcard char *, to be notified every time
|
||||
patterns = rfi,lfi
|
||||
user =
|
||||
pwd =
|
||||
mail_from =
|
||||
mail_to =
|
||||
smtp_host = smtp.gmail.com
|
||||
smtp_port = 587
|
||||
|
||||
[taxii]
|
||||
enabled = False
|
||||
host = taxiitest.mitre.org
|
||||
port = 80
|
||||
inbox_path = /services/inbox/default/
|
||||
use_https = False
|
||||
use_auth_basic = False
|
||||
auth_basic_username = your_username
|
||||
auth_basic_password = your_password
|
||||
use_auth_certificate = False
|
||||
auth_certificate_keyfile = full_path_to_keyfile
|
||||
auth_certificate_certfile = full_path_to_certfile
|
||||
include_contact_info = False
|
||||
contact_name = ...
|
||||
contact_email = ...
|
||||
|
||||
[logstash]
|
||||
enabled = False
|
||||
host = localhost
|
||||
port = 5659
|
||||
handler = AMQP/TCP/UDP
|
||||
|
||||
[misc]
|
||||
# set webserver banner
|
||||
banner = Apache/2.0.48
|
||||
|
||||
[surface]
|
||||
#https://www.google.com/webmasters/
|
||||
google_meta =
|
||||
#http://www.bing.com/toolbox/webmaster
|
||||
bing_meta =
|
||||
|
||||
[sensor]
|
||||
sensorid = None
|
||||
|
||||
[profiler]
|
||||
enabled = False
|
||||
BIN
docker/glastopf/doc/dashboard.png
Normal file
BIN
docker/glastopf/doc/dashboard.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 502 KiB |
19
docker/glastopf/docker-compose.yml
Normal file
19
docker/glastopf/docker-compose.yml
Normal file
|
|
@ -0,0 +1,19 @@
|
|||
version: '2.1'
|
||||
|
||||
networks:
|
||||
glastopf_local:
|
||||
|
||||
services:
|
||||
|
||||
# Glastopf service
|
||||
glastopf:
|
||||
container_name: glastopf
|
||||
restart: always
|
||||
networks:
|
||||
- glastopf_local
|
||||
ports:
|
||||
- "80:80"
|
||||
image: "dtagdevsec/glastopf:1706"
|
||||
volumes:
|
||||
- /data/glastopf/db:/opt/glastopf/db
|
||||
- /data/glastopf/log:/opt/glastopf/log
|
||||
44
docker/honeytrap/Dockerfile
Normal file
44
docker/honeytrap/Dockerfile
Normal file
|
|
@ -0,0 +1,44 @@
|
|||
FROM debian:stretch-slim
|
||||
MAINTAINER MO
|
||||
|
||||
ENV DEBIAN_FRONTEND noninteractive
|
||||
|
||||
# Include dist
|
||||
ADD dist/ /root/dist/
|
||||
|
||||
# Setup apt
|
||||
RUN apt-get update -y && \
|
||||
apt-get dist-upgrade -y && \
|
||||
|
||||
# Install packages
|
||||
apt-get install -y autoconf build-essential git iptables libnetfilter-queue1 libnetfilter-queue-dev \
|
||||
libjson-c-dev libtool libpq5 libpq-dev netbase procps wget && \
|
||||
|
||||
# Install honeytrap from source
|
||||
cd /root/ && \
|
||||
git clone https://github.com/armedpot/honeytrap && \
|
||||
cd /root/honeytrap/ && \
|
||||
autoreconf -vfi && \
|
||||
./configure \
|
||||
--with-stream-mon=nfq \
|
||||
--with-logattacker \
|
||||
--with-logjson \
|
||||
--prefix=/opt/honeytrap && \
|
||||
make && \
|
||||
make install && \
|
||||
make clean && \
|
||||
|
||||
# Setup user, groups and configs
|
||||
addgroup --gid 2000 honeytrap && \
|
||||
adduser --system --no-create-home --shell /bin/bash --uid 2000 --disabled-password --disabled-login --gid 2000 honeytrap && \
|
||||
mkdir -p /opt/honeytrap/etc/honeytrap/ /opt/honeytrap/var/attacks /opt/honeytrap/var/downloads /opt/honeytrap/var/log && \
|
||||
mv /root/dist/honeytrap.conf /opt/honeytrap/etc/honeytrap/ && \
|
||||
|
||||
# Clean up
|
||||
rm -rf /root/* && \
|
||||
apt-get purge -y autoconf build-essential git libnetfilter-queue-dev libpq-dev && \
|
||||
apt-get autoremove -y --purge && \
|
||||
apt-get clean && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*
|
||||
|
||||
# Start honeytrap
|
||||
CMD ["/opt/honeytrap/sbin/honeytrap", "-D", "-C", "/opt/honeytrap/etc/honeytrap/honeytrap.conf", "-t", "5", "-u", "honeytrap", "-g", "honeytrap"]
|
||||
674
docker/honeytrap/LICENSE
Normal file
674
docker/honeytrap/LICENSE
Normal file
|
|
@ -0,0 +1,674 @@
|
|||
GNU GENERAL PUBLIC LICENSE
|
||||
Version 3, 29 June 2007
|
||||
|
||||
Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
|
||||
Everyone is permitted to copy and distribute verbatim copies
|
||||
of this license document, but changing it is not allowed.
|
||||
|
||||
Preamble
|
||||
|
||||
The GNU General Public License is a free, copyleft license for
|
||||
software and other kinds of works.
|
||||
|
||||
The licenses for most software and other practical works are designed
|
||||
to take away your freedom to share and change the works. By contrast,
|
||||
the GNU General Public License is intended to guarantee your freedom to
|
||||
share and change all versions of a program--to make sure it remains free
|
||||
software for all its users. We, the Free Software Foundation, use the
|
||||
GNU General Public License for most of our software; it applies also to
|
||||
any other work released this way by its authors. You can apply it to
|
||||
your programs, too.
|
||||
|
||||
When we speak of free software, we are referring to freedom, not
|
||||
price. Our General Public Licenses are designed to make sure that you
|
||||
have the freedom to distribute copies of free software (and charge for
|
||||
them if you wish), that you receive source code or can get it if you
|
||||
want it, that you can change the software or use pieces of it in new
|
||||
free programs, and that you know you can do these things.
|
||||
|
||||
To protect your rights, we need to prevent others from denying you
|
||||
these rights or asking you to surrender the rights. Therefore, you have
|
||||
certain responsibilities if you distribute copies of the software, or if
|
||||
you modify it: responsibilities to respect the freedom of others.
|
||||
|
||||
For example, if you distribute copies of such a program, whether
|
||||
gratis or for a fee, you must pass on to the recipients the same
|
||||
freedoms that you received. You must make sure that they, too, receive
|
||||
or can get the source code. And you must show them these terms so they
|
||||
know their rights.
|
||||
|
||||
Developers that use the GNU GPL protect your rights with two steps:
|
||||
(1) assert copyright on the software, and (2) offer you this License
|
||||
giving you legal permission to copy, distribute and/or modify it.
|
||||
|
||||
For the developers' and authors' protection, the GPL clearly explains
|
||||
that there is no warranty for this free software. For both users' and
|
||||
authors' sake, the GPL requires that modified versions be marked as
|
||||
changed, so that their problems will not be attributed erroneously to
|
||||
authors of previous versions.
|
||||
|
||||
Some devices are designed to deny users access to install or run
|
||||
modified versions of the software inside them, although the manufacturer
|
||||
can do so. This is fundamentally incompatible with the aim of
|
||||
protecting users' freedom to change the software. The systematic
|
||||
pattern of such abuse occurs in the area of products for individuals to
|
||||
use, which is precisely where it is most unacceptable. Therefore, we
|
||||
have designed this version of the GPL to prohibit the practice for those
|
||||
products. If such problems arise substantially in other domains, we
|
||||
stand ready to extend this provision to those domains in future versions
|
||||
of the GPL, as needed to protect the freedom of users.
|
||||
|
||||
Finally, every program is threatened constantly by software patents.
|
||||
States should not allow patents to restrict development and use of
|
||||
software on general-purpose computers, but in those that do, we wish to
|
||||
avoid the special danger that patents applied to a free program could
|
||||
make it effectively proprietary. To prevent this, the GPL assures that
|
||||
patents cannot be used to render the program non-free.
|
||||
|
||||
The precise terms and conditions for copying, distribution and
|
||||
modification follow.
|
||||
|
||||
TERMS AND CONDITIONS
|
||||
|
||||
0. Definitions.
|
||||
|
||||
"This License" refers to version 3 of the GNU General Public License.
|
||||
|
||||
"Copyright" also means copyright-like laws that apply to other kinds of
|
||||
works, such as semiconductor masks.
|
||||
|
||||
"The Program" refers to any copyrightable work licensed under this
|
||||
License. Each licensee is addressed as "you". "Licensees" and
|
||||
"recipients" may be individuals or organizations.
|
||||
|
||||
To "modify" a work means to copy from or adapt all or part of the work
|
||||
in a fashion requiring copyright permission, other than the making of an
|
||||
exact copy. The resulting work is called a "modified version" of the
|
||||
earlier work or a work "based on" the earlier work.
|
||||
|
||||
A "covered work" means either the unmodified Program or a work based
|
||||
on the Program.
|
||||
|
||||
To "propagate" a work means to do anything with it that, without
|
||||
permission, would make you directly or secondarily liable for
|
||||
infringement under applicable copyright law, except executing it on a
|
||||
computer or modifying a private copy. Propagation includes copying,
|
||||
distribution (with or without modification), making available to the
|
||||
public, and in some countries other activities as well.
|
||||
|
||||
To "convey" a work means any kind of propagation that enables other
|
||||
parties to make or receive copies. Mere interaction with a user through
|
||||
a computer network, with no transfer of a copy, is not conveying.
|
||||
|
||||
An interactive user interface displays "Appropriate Legal Notices"
|
||||
to the extent that it includes a convenient and prominently visible
|
||||
feature that (1) displays an appropriate copyright notice, and (2)
|
||||
tells the user that there is no warranty for the work (except to the
|
||||
extent that warranties are provided), that licensees may convey the
|
||||
work under this License, and how to view a copy of this License. If
|
||||
the interface presents a list of user commands or options, such as a
|
||||
menu, a prominent item in the list meets this criterion.
|
||||
|
||||
1. Source Code.
|
||||
|
||||
The "source code" for a work means the preferred form of the work
|
||||
for making modifications to it. "Object code" means any non-source
|
||||
form of a work.
|
||||
|
||||
A "Standard Interface" means an interface that either is an official
|
||||
standard defined by a recognized standards body, or, in the case of
|
||||
interfaces specified for a particular programming language, one that
|
||||
is widely used among developers working in that language.
|
||||
|
||||
The "System Libraries" of an executable work include anything, other
|
||||
than the work as a whole, that (a) is included in the normal form of
|
||||
packaging a Major Component, but which is not part of that Major
|
||||
Component, and (b) serves only to enable use of the work with that
|
||||
Major Component, or to implement a Standard Interface for which an
|
||||
implementation is available to the public in source code form. A
|
||||
"Major Component", in this context, means a major essential component
|
||||
(kernel, window system, and so on) of the specific operating system
|
||||
(if any) on which the executable work runs, or a compiler used to
|
||||
produce the work, or an object code interpreter used to run it.
|
||||
|
||||
The "Corresponding Source" for a work in object code form means all
|
||||
the source code needed to generate, install, and (for an executable
|
||||
work) run the object code and to modify the work, including scripts to
|
||||
control those activities. However, it does not include the work's
|
||||
System Libraries, or general-purpose tools or generally available free
|
||||
programs which are used unmodified in performing those activities but
|
||||
which are not part of the work. For example, Corresponding Source
|
||||
includes interface definition files associated with source files for
|
||||
the work, and the source code for shared libraries and dynamically
|
||||
linked subprograms that the work is specifically designed to require,
|
||||
such as by intimate data communication or control flow between those
|
||||
subprograms and other parts of the work.
|
||||
|
||||
The Corresponding Source need not include anything that users
|
||||
can regenerate automatically from other parts of the Corresponding
|
||||
Source.
|
||||
|
||||
The Corresponding Source for a work in source code form is that
|
||||
same work.
|
||||
|
||||
2. Basic Permissions.
|
||||
|
||||
All rights granted under this License are granted for the term of
|
||||
copyright on the Program, and are irrevocable provided the stated
|
||||
conditions are met. This License explicitly affirms your unlimited
|
||||
permission to run the unmodified Program. The output from running a
|
||||
covered work is covered by this License only if the output, given its
|
||||
content, constitutes a covered work. This License acknowledges your
|
||||
rights of fair use or other equivalent, as provided by copyright law.
|
||||
|
||||
You may make, run and propagate covered works that you do not
|
||||
convey, without conditions so long as your license otherwise remains
|
||||
in force. You may convey covered works to others for the sole purpose
|
||||
of having them make modifications exclusively for you, or provide you
|
||||
with facilities for running those works, provided that you comply with
|
||||
the terms of this License in conveying all material for which you do
|
||||
not control copyright. Those thus making or running the covered works
|
||||
for you must do so exclusively on your behalf, under your direction
|
||||
and control, on terms that prohibit them from making any copies of
|
||||
your copyrighted material outside their relationship with you.
|
||||
|
||||
Conveying under any other circumstances is permitted solely under
|
||||
the conditions stated below. Sublicensing is not allowed; section 10
|
||||
makes it unnecessary.
|
||||
|
||||
3. Protecting Users' Legal Rights From Anti-Circumvention Law.
|
||||
|
||||
No covered work shall be deemed part of an effective technological
|
||||
measure under any applicable law fulfilling obligations under article
|
||||
11 of the WIPO copyright treaty adopted on 20 December 1996, or
|
||||
similar laws prohibiting or restricting circumvention of such
|
||||
measures.
|
||||
|
||||
When you convey a covered work, you waive any legal power to forbid
|
||||
circumvention of technological measures to the extent such circumvention
|
||||
is effected by exercising rights under this License with respect to
|
||||
the covered work, and you disclaim any intention to limit operation or
|
||||
modification of the work as a means of enforcing, against the work's
|
||||
users, your or third parties' legal rights to forbid circumvention of
|
||||
technological measures.
|
||||
|
||||
4. Conveying Verbatim Copies.
|
||||
|
||||
You may convey verbatim copies of the Program's source code as you
|
||||
receive it, in any medium, provided that you conspicuously and
|
||||
appropriately publish on each copy an appropriate copyright notice;
|
||||
keep intact all notices stating that this License and any
|
||||
non-permissive terms added in accord with section 7 apply to the code;
|
||||
keep intact all notices of the absence of any warranty; and give all
|
||||
recipients a copy of this License along with the Program.
|
||||
|
||||
You may charge any price or no price for each copy that you convey,
|
||||
and you may offer support or warranty protection for a fee.
|
||||
|
||||
5. Conveying Modified Source Versions.
|
||||
|
||||
You may convey a work based on the Program, or the modifications to
|
||||
produce it from the Program, in the form of source code under the
|
||||
terms of section 4, provided that you also meet all of these conditions:
|
||||
|
||||
a) The work must carry prominent notices stating that you modified
|
||||
it, and giving a relevant date.
|
||||
|
||||
b) The work must carry prominent notices stating that it is
|
||||
released under this License and any conditions added under section
|
||||
7. This requirement modifies the requirement in section 4 to
|
||||
"keep intact all notices".
|
||||
|
||||
c) You must license the entire work, as a whole, under this
|
||||
License to anyone who comes into possession of a copy. This
|
||||
License will therefore apply, along with any applicable section 7
|
||||
additional terms, to the whole of the work, and all its parts,
|
||||
regardless of how they are packaged. This License gives no
|
||||
permission to license the work in any other way, but it does not
|
||||
invalidate such permission if you have separately received it.
|
||||
|
||||
d) If the work has interactive user interfaces, each must display
|
||||
Appropriate Legal Notices; however, if the Program has interactive
|
||||
interfaces that do not display Appropriate Legal Notices, your
|
||||
work need not make them do so.
|
||||
|
||||
A compilation of a covered work with other separate and independent
|
||||
works, which are not by their nature extensions of the covered work,
|
||||
and which are not combined with it such as to form a larger program,
|
||||
in or on a volume of a storage or distribution medium, is called an
|
||||
"aggregate" if the compilation and its resulting copyright are not
|
||||
used to limit the access or legal rights of the compilation's users
|
||||
beyond what the individual works permit. Inclusion of a covered work
|
||||
in an aggregate does not cause this License to apply to the other
|
||||
parts of the aggregate.
|
||||
|
||||
6. Conveying Non-Source Forms.
|
||||
|
||||
You may convey a covered work in object code form under the terms
|
||||
of sections 4 and 5, provided that you also convey the
|
||||
machine-readable Corresponding Source under the terms of this License,
|
||||
in one of these ways:
|
||||
|
||||
a) Convey the object code in, or embodied in, a physical product
|
||||
(including a physical distribution medium), accompanied by the
|
||||
Corresponding Source fixed on a durable physical medium
|
||||
customarily used for software interchange.
|
||||
|
||||
b) Convey the object code in, or embodied in, a physical product
|
||||
(including a physical distribution medium), accompanied by a
|
||||
written offer, valid for at least three years and valid for as
|
||||
long as you offer spare parts or customer support for that product
|
||||
model, to give anyone who possesses the object code either (1) a
|
||||
copy of the Corresponding Source for all the software in the
|
||||
product that is covered by this License, on a durable physical
|
||||
medium customarily used for software interchange, for a price no
|
||||
more than your reasonable cost of physically performing this
|
||||
conveying of source, or (2) access to copy the
|
||||
Corresponding Source from a network server at no charge.
|
||||
|
||||
c) Convey individual copies of the object code with a copy of the
|
||||
written offer to provide the Corresponding Source. This
|
||||
alternative is allowed only occasionally and noncommercially, and
|
||||
only if you received the object code with such an offer, in accord
|
||||
with subsection 6b.
|
||||
|
||||
d) Convey the object code by offering access from a designated
|
||||
place (gratis or for a charge), and offer equivalent access to the
|
||||
Corresponding Source in the same way through the same place at no
|
||||
further charge. You need not require recipients to copy the
|
||||
Corresponding Source along with the object code. If the place to
|
||||
copy the object code is a network server, the Corresponding Source
|
||||
may be on a different server (operated by you or a third party)
|
||||
that supports equivalent copying facilities, provided you maintain
|
||||
clear directions next to the object code saying where to find the
|
||||
Corresponding Source. Regardless of what server hosts the
|
||||
Corresponding Source, you remain obligated to ensure that it is
|
||||
available for as long as needed to satisfy these requirements.
|
||||
|
||||
e) Convey the object code using peer-to-peer transmission, provided
|
||||
you inform other peers where the object code and Corresponding
|
||||
Source of the work are being offered to the general public at no
|
||||
charge under subsection 6d.
|
||||
|
||||
A separable portion of the object code, whose source code is excluded
|
||||
from the Corresponding Source as a System Library, need not be
|
||||
included in conveying the object code work.
|
||||
|
||||
A "User Product" is either (1) a "consumer product", which means any
|
||||
tangible personal property which is normally used for personal, family,
|
||||
or household purposes, or (2) anything designed or sold for incorporation
|
||||
into a dwelling. In determining whether a product is a consumer product,
|
||||
doubtful cases shall be resolved in favor of coverage. For a particular
|
||||
product received by a particular user, "normally used" refers to a
|
||||
typical or common use of that class of product, regardless of the status
|
||||
of the particular user or of the way in which the particular user
|
||||
actually uses, or expects or is expected to use, the product. A product
|
||||
is a consumer product regardless of whether the product has substantial
|
||||
commercial, industrial or non-consumer uses, unless such uses represent
|
||||
the only significant mode of use of the product.
|
||||
|
||||
"Installation Information" for a User Product means any methods,
|
||||
procedures, authorization keys, or other information required to install
|
||||
and execute modified versions of a covered work in that User Product from
|
||||
a modified version of its Corresponding Source. The information must
|
||||
suffice to ensure that the continued functioning of the modified object
|
||||
code is in no case prevented or interfered with solely because
|
||||
modification has been made.
|
||||
|
||||
If you convey an object code work under this section in, or with, or
|
||||
specifically for use in, a User Product, and the conveying occurs as
|
||||
part of a transaction in which the right of possession and use of the
|
||||
User Product is transferred to the recipient in perpetuity or for a
|
||||
fixed term (regardless of how the transaction is characterized), the
|
||||
Corresponding Source conveyed under this section must be accompanied
|
||||
by the Installation Information. But this requirement does not apply
|
||||
if neither you nor any third party retains the ability to install
|
||||
modified object code on the User Product (for example, the work has
|
||||
been installed in ROM).
|
||||
|
||||
The requirement to provide Installation Information does not include a
|
||||
requirement to continue to provide support service, warranty, or updates
|
||||
for a work that has been modified or installed by the recipient, or for
|
||||
the User Product in which it has been modified or installed. Access to a
|
||||
network may be denied when the modification itself materially and
|
||||
adversely affects the operation of the network or violates the rules and
|
||||
protocols for communication across the network.
|
||||
|
||||
Corresponding Source conveyed, and Installation Information provided,
|
||||
in accord with this section must be in a format that is publicly
|
||||
documented (and with an implementation available to the public in
|
||||
source code form), and must require no special password or key for
|
||||
unpacking, reading or copying.
|
||||
|
||||
7. Additional Terms.
|
||||
|
||||
"Additional permissions" are terms that supplement the terms of this
|
||||
License by making exceptions from one or more of its conditions.
|
||||
Additional permissions that are applicable to the entire Program shall
|
||||
be treated as though they were included in this License, to the extent
|
||||
that they are valid under applicable law. If additional permissions
|
||||
apply only to part of the Program, that part may be used separately
|
||||
under those permissions, but the entire Program remains governed by
|
||||
this License without regard to the additional permissions.
|
||||
|
||||
When you convey a copy of a covered work, you may at your option
|
||||
remove any additional permissions from that copy, or from any part of
|
||||
it. (Additional permissions may be written to require their own
|
||||
removal in certain cases when you modify the work.) You may place
|
||||
additional permissions on material, added by you to a covered work,
|
||||
for which you have or can give appropriate copyright permission.
|
||||
|
||||
Notwithstanding any other provision of this License, for material you
|
||||
add to a covered work, you may (if authorized by the copyright holders of
|
||||
that material) supplement the terms of this License with terms:
|
||||
|
||||
a) Disclaiming warranty or limiting liability differently from the
|
||||
terms of sections 15 and 16 of this License; or
|
||||
|
||||
b) Requiring preservation of specified reasonable legal notices or
|
||||
author attributions in that material or in the Appropriate Legal
|
||||
Notices displayed by works containing it; or
|
||||
|
||||
c) Prohibiting misrepresentation of the origin of that material, or
|
||||
requiring that modified versions of such material be marked in
|
||||
reasonable ways as different from the original version; or
|
||||
|
||||
d) Limiting the use for publicity purposes of names of licensors or
|
||||
authors of the material; or
|
||||
|
||||
e) Declining to grant rights under trademark law for use of some
|
||||
trade names, trademarks, or service marks; or
|
||||
|
||||
f) Requiring indemnification of licensors and authors of that
|
||||
material by anyone who conveys the material (or modified versions of
|
||||
it) with contractual assumptions of liability to the recipient, for
|
||||
any liability that these contractual assumptions directly impose on
|
||||
those licensors and authors.
|
||||
|
||||
All other non-permissive additional terms are considered "further
|
||||
restrictions" within the meaning of section 10. If the Program as you
|
||||
received it, or any part of it, contains a notice stating that it is
|
||||
governed by this License along with a term that is a further
|
||||
restriction, you may remove that term. If a license document contains
|
||||
a further restriction but permits relicensing or conveying under this
|
||||
License, you may add to a covered work material governed by the terms
|
||||
of that license document, provided that the further restriction does
|
||||
not survive such relicensing or conveying.
|
||||
|
||||
If you add terms to a covered work in accord with this section, you
|
||||
must place, in the relevant source files, a statement of the
|
||||
additional terms that apply to those files, or a notice indicating
|
||||
where to find the applicable terms.
|
||||
|
||||
Additional terms, permissive or non-permissive, may be stated in the
|
||||
form of a separately written license, or stated as exceptions;
|
||||
the above requirements apply either way.
|
||||
|
||||
8. Termination.
|
||||
|
||||
You may not propagate or modify a covered work except as expressly
|
||||
provided under this License. Any attempt otherwise to propagate or
|
||||
modify it is void, and will automatically terminate your rights under
|
||||
this License (including any patent licenses granted under the third
|
||||
paragraph of section 11).
|
||||
|
||||
However, if you cease all violation of this License, then your
|
||||
license from a particular copyright holder is reinstated (a)
|
||||
provisionally, unless and until the copyright holder explicitly and
|
||||
finally terminates your license, and (b) permanently, if the copyright
|
||||
holder fails to notify you of the violation by some reasonable means
|
||||
prior to 60 days after the cessation.
|
||||
|
||||
Moreover, your license from a particular copyright holder is
|
||||
reinstated permanently if the copyright holder notifies you of the
|
||||
violation by some reasonable means, this is the first time you have
|
||||
received notice of violation of this License (for any work) from that
|
||||
copyright holder, and you cure the violation prior to 30 days after
|
||||
your receipt of the notice.
|
||||
|
||||
Termination of your rights under this section does not terminate the
|
||||
licenses of parties who have received copies or rights from you under
|
||||
this License. If your rights have been terminated and not permanently
|
||||
reinstated, you do not qualify to receive new licenses for the same
|
||||
material under section 10.
|
||||
|
||||
9. Acceptance Not Required for Having Copies.
|
||||
|
||||
You are not required to accept this License in order to receive or
|
||||
run a copy of the Program. Ancillary propagation of a covered work
|
||||
occurring solely as a consequence of using peer-to-peer transmission
|
||||
to receive a copy likewise does not require acceptance. However,
|
||||
nothing other than this License grants you permission to propagate or
|
||||
modify any covered work. These actions infringe copyright if you do
|
||||
not accept this License. Therefore, by modifying or propagating a
|
||||
covered work, you indicate your acceptance of this License to do so.
|
||||
|
||||
10. Automatic Licensing of Downstream Recipients.
|
||||
|
||||
Each time you convey a covered work, the recipient automatically
|
||||
receives a license from the original licensors, to run, modify and
|
||||
propagate that work, subject to this License. You are not responsible
|
||||
for enforcing compliance by third parties with this License.
|
||||
|
||||
An "entity transaction" is a transaction transferring control of an
|
||||
organization, or substantially all assets of one, or subdividing an
|
||||
organization, or merging organizations. If propagation of a covered
|
||||
work results from an entity transaction, each party to that
|
||||
transaction who receives a copy of the work also receives whatever
|
||||
licenses to the work the party's predecessor in interest had or could
|
||||
give under the previous paragraph, plus a right to possession of the
|
||||
Corresponding Source of the work from the predecessor in interest, if
|
||||
the predecessor has it or can get it with reasonable efforts.
|
||||
|
||||
You may not impose any further restrictions on the exercise of the
|
||||
rights granted or affirmed under this License. For example, you may
|
||||
not impose a license fee, royalty, or other charge for exercise of
|
||||
rights granted under this License, and you may not initiate litigation
|
||||
(including a cross-claim or counterclaim in a lawsuit) alleging that
|
||||
any patent claim is infringed by making, using, selling, offering for
|
||||
sale, or importing the Program or any portion of it.
|
||||
|
||||
11. Patents.
|
||||
|
||||
A "contributor" is a copyright holder who authorizes use under this
|
||||
License of the Program or a work on which the Program is based. The
|
||||
work thus licensed is called the contributor's "contributor version".
|
||||
|
||||
A contributor's "essential patent claims" are all patent claims
|
||||
owned or controlled by the contributor, whether already acquired or
|
||||
hereafter acquired, that would be infringed by some manner, permitted
|
||||
by this License, of making, using, or selling its contributor version,
|
||||
but do not include claims that would be infringed only as a
|
||||
consequence of further modification of the contributor version. For
|
||||
purposes of this definition, "control" includes the right to grant
|
||||
patent sublicenses in a manner consistent with the requirements of
|
||||
this License.
|
||||
|
||||
Each contributor grants you a non-exclusive, worldwide, royalty-free
|
||||
patent license under the contributor's essential patent claims, to
|
||||
make, use, sell, offer for sale, import and otherwise run, modify and
|
||||
propagate the contents of its contributor version.
|
||||
|
||||
In the following three paragraphs, a "patent license" is any express
|
||||
agreement or commitment, however denominated, not to enforce a patent
|
||||
(such as an express permission to practice a patent or covenant not to
|
||||
sue for patent infringement). To "grant" such a patent license to a
|
||||
party means to make such an agreement or commitment not to enforce a
|
||||
patent against the party.
|
||||
|
||||
If you convey a covered work, knowingly relying on a patent license,
|
||||
and the Corresponding Source of the work is not available for anyone
|
||||
to copy, free of charge and under the terms of this License, through a
|
||||
publicly available network server or other readily accessible means,
|
||||
then you must either (1) cause the Corresponding Source to be so
|
||||
available, or (2) arrange to deprive yourself of the benefit of the
|
||||
patent license for this particular work, or (3) arrange, in a manner
|
||||
consistent with the requirements of this License, to extend the patent
|
||||
license to downstream recipients. "Knowingly relying" means you have
|
||||
actual knowledge that, but for the patent license, your conveying the
|
||||
covered work in a country, or your recipient's use of the covered work
|
||||
in a country, would infringe one or more identifiable patents in that
|
||||
country that you have reason to believe are valid.
|
||||
|
||||
If, pursuant to or in connection with a single transaction or
|
||||
arrangement, you convey, or propagate by procuring conveyance of, a
|
||||
covered work, and grant a patent license to some of the parties
|
||||
receiving the covered work authorizing them to use, propagate, modify
|
||||
or convey a specific copy of the covered work, then the patent license
|
||||
you grant is automatically extended to all recipients of the covered
|
||||
work and works based on it.
|
||||
|
||||
A patent license is "discriminatory" if it does not include within
|
||||
the scope of its coverage, prohibits the exercise of, or is
|
||||
conditioned on the non-exercise of one or more of the rights that are
|
||||
specifically granted under this License. You may not convey a covered
|
||||
work if you are a party to an arrangement with a third party that is
|
||||
in the business of distributing software, under which you make payment
|
||||
to the third party based on the extent of your activity of conveying
|
||||
the work, and under which the third party grants, to any of the
|
||||
parties who would receive the covered work from you, a discriminatory
|
||||
patent license (a) in connection with copies of the covered work
|
||||
conveyed by you (or copies made from those copies), or (b) primarily
|
||||
for and in connection with specific products or compilations that
|
||||
contain the covered work, unless you entered into that arrangement,
|
||||
or that patent license was granted, prior to 28 March 2007.
|
||||
|
||||
Nothing in this License shall be construed as excluding or limiting
|
||||
any implied license or other defenses to infringement that may
|
||||
otherwise be available to you under applicable patent law.
|
||||
|
||||
12. No Surrender of Others' Freedom.
|
||||
|
||||
If conditions are imposed on you (whether by court order, agreement or
|
||||
otherwise) that contradict the conditions of this License, they do not
|
||||
excuse you from the conditions of this License. If you cannot convey a
|
||||
covered work so as to satisfy simultaneously your obligations under this
|
||||
License and any other pertinent obligations, then as a consequence you may
|
||||
not convey it at all. For example, if you agree to terms that obligate you
|
||||
to collect a royalty for further conveying from those to whom you convey
|
||||
the Program, the only way you could satisfy both those terms and this
|
||||
License would be to refrain entirely from conveying the Program.
|
||||
|
||||
13. Use with the GNU Affero General Public License.
|
||||
|
||||
Notwithstanding any other provision of this License, you have
|
||||
permission to link or combine any covered work with a work licensed
|
||||
under version 3 of the GNU Affero General Public License into a single
|
||||
combined work, and to convey the resulting work. The terms of this
|
||||
License will continue to apply to the part which is the covered work,
|
||||
but the special requirements of the GNU Affero General Public License,
|
||||
section 13, concerning interaction through a network will apply to the
|
||||
combination as such.
|
||||
|
||||
14. Revised Versions of this License.
|
||||
|
||||
The Free Software Foundation may publish revised and/or new versions of
|
||||
the GNU General Public License from time to time. Such new versions will
|
||||
be similar in spirit to the present version, but may differ in detail to
|
||||
address new problems or concerns.
|
||||
|
||||
Each version is given a distinguishing version number. If the
|
||||
Program specifies that a certain numbered version of the GNU General
|
||||
Public License "or any later version" applies to it, you have the
|
||||
option of following the terms and conditions either of that numbered
|
||||
version or of any later version published by the Free Software
|
||||
Foundation. If the Program does not specify a version number of the
|
||||
GNU General Public License, you may choose any version ever published
|
||||
by the Free Software Foundation.
|
||||
|
||||
If the Program specifies that a proxy can decide which future
|
||||
versions of the GNU General Public License can be used, that proxy's
|
||||
public statement of acceptance of a version permanently authorizes you
|
||||
to choose that version for the Program.
|
||||
|
||||
Later license versions may give you additional or different
|
||||
permissions. However, no additional obligations are imposed on any
|
||||
author or copyright holder as a result of your choosing to follow a
|
||||
later version.
|
||||
|
||||
15. Disclaimer of Warranty.
|
||||
|
||||
THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
|
||||
APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
|
||||
HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
|
||||
OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
|
||||
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
||||
PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
|
||||
IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
|
||||
ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
|
||||
|
||||
16. Limitation of Liability.
|
||||
|
||||
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
|
||||
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
|
||||
THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
|
||||
GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
|
||||
USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
|
||||
DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
|
||||
PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
|
||||
EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
|
||||
SUCH DAMAGES.
|
||||
|
||||
17. Interpretation of Sections 15 and 16.
|
||||
|
||||
If the disclaimer of warranty and limitation of liability provided
|
||||
above cannot be given local legal effect according to their terms,
|
||||
reviewing courts shall apply local law that most closely approximates
|
||||
an absolute waiver of all civil liability in connection with the
|
||||
Program, unless a warranty or assumption of liability accompanies a
|
||||
copy of the Program in return for a fee.
|
||||
|
||||
END OF TERMS AND CONDITIONS
|
||||
|
||||
How to Apply These Terms to Your New Programs
|
||||
|
||||
If you develop a new program, and you want it to be of the greatest
|
||||
possible use to the public, the best way to achieve this is to make it
|
||||
free software which everyone can redistribute and change under these terms.
|
||||
|
||||
To do so, attach the following notices to the program. It is safest
|
||||
to attach them to the start of each source file to most effectively
|
||||
state the exclusion of warranty; and each file should have at least
|
||||
the "copyright" line and a pointer to where the full notice is found.
|
||||
|
||||
{one line to give the program's name and a brief idea of what it does.}
|
||||
Copyright (C) {year} {name of author}
|
||||
|
||||
This program is free software: you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation, either version 3 of the License, or
|
||||
(at your option) any later version.
|
||||
|
||||
This program is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
||||
|
||||
Also add information on how to contact you by electronic and paper mail.
|
||||
|
||||
If the program does terminal interaction, make it output a short
|
||||
notice like this when it starts in an interactive mode:
|
||||
|
||||
{project} Copyright (C) {year} {fullname}
|
||||
This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
|
||||
This is free software, and you are welcome to redistribute it
|
||||
under certain conditions; type `show c' for details.
|
||||
|
||||
The hypothetical commands `show w' and `show c' should show the appropriate
|
||||
parts of the General Public License. Of course, your program's commands
|
||||
might be different; for a GUI interface, you would use an "about box".
|
||||
|
||||
You should also get your employer (if you work as a programmer) or school,
|
||||
if any, to sign a "copyright disclaimer" for the program, if necessary.
|
||||
For more information on this, and how to apply and follow the GNU GPL, see
|
||||
<http://www.gnu.org/licenses/>.
|
||||
|
||||
The GNU General Public License does not permit incorporating your program
|
||||
into proprietary programs. If your program is a subroutine library, you
|
||||
may consider it more useful to permit linking proprietary applications with
|
||||
the library. If this is what you want to do, use the GNU Lesser General
|
||||
Public License instead of this License. But first, please read
|
||||
<http://www.gnu.org/philosophy/why-not-lgpl.html>.
|
||||
35
docker/honeytrap/README.md
Normal file
35
docker/honeytrap/README.md
Normal file
|
|
@ -0,0 +1,35 @@
|
|||
[](https://microbadger.com/images/dtagdevsec/honeytrap:1706 "Get your own version badge on microbadger.com") [](https://microbadger.com/images/dtagdevsec/honeytrap:1706 "Get your own image badge on microbadger.com")
|
||||
|
||||
# dockerized honeytrap
|
||||
|
||||
|
||||
[honeytrap](https://github.com/armedpot/honeytrap) is a low-interaction honeypot daemon for observing attacks against network services. In contrast to other honeypots, which often focus on malware collection, honeytrap aims for catching the initial exploit – It collects and further processes attack traces.
|
||||
|
||||
This repository contains the necessary files to create a *dockerized* version of honeytrap.
|
||||
|
||||
This dockerized version is part of the **[T-Pot community honeypot](http://dtag-dev-sec.github.io/)** of Deutsche Telekom AG.
|
||||
For this setup, honeytrap is configured to use the logattacker module only.
|
||||
|
||||
The `Dockerfile` contains the blueprint for the dockerized honeytrap and will be used to setup the docker image.
|
||||
|
||||
The `honeytrap.conf` is tailored to fit the T-Pot environment.
|
||||
|
||||
The `supervisord.conf` is used to start honeytrap under supervision of supervisord.
|
||||
|
||||
In case you want to run the dockerized honeytrap independently, you must modify the config files to match your environment and rebuild the docker image.
|
||||
|
||||
Using systemd, copy the `systemd/honeytrap.service` to `/etc/systemd/system/honeytrap.service` and start using
|
||||
|
||||
```
|
||||
systemctl enable honeytrap
|
||||
systemctl start honeytrap
|
||||
```
|
||||
|
||||
This will make sure that the docker container is started with the appropriate rights and iptables forwards are implemented. Further, it autostarts during boot.
|
||||
In the T-Pot setup, some ports are excluded as they need to be reserved for other honeypot daemons running in parallel.
|
||||
|
||||
By default all data will be stored in `/data/honeytrap/` until the honeypot service will be restarted which is by default every 24 hours. If you want to keep data persistently simply edit the ``service`` file, find the line that contains ``clean.sh`` and set the option from ``off`` to ``on``. Be advised to establish some sort of log management if you wish to do so.
|
||||
|
||||
# Honeytrap Dashboard
|
||||
|
||||
|
||||
143
docker/honeytrap/dist/honeytrap.conf
vendored
Normal file
143
docker/honeytrap/dist/honeytrap.conf
vendored
Normal file
|
|
@ -0,0 +1,143 @@
|
|||
/*
|
||||
* honeytrap 1.0.1 configuration file template -- please adjust
|
||||
* (c) Tillmann Werner <tillmann.werner@gmx.de>
|
||||
*/
|
||||
|
||||
// log to this file
|
||||
logfile = "/opt/honeytrap/var/log/honeytrap.log"
|
||||
|
||||
// store process ID in this file
|
||||
pidfile = "/var/run/honeytrap.pid"
|
||||
|
||||
/* where to look for default responses
|
||||
* these are sent for connections handled in "normal mode" */
|
||||
response_dir = "/opt/honeytrap/etc/honeytrap/responses"
|
||||
|
||||
// replace rfc1918 IP addresses with attacking IP address
|
||||
replace_private_ips = "no"
|
||||
|
||||
// bind dynamic servers to a specific address
|
||||
//bind_address = "127.0.0.1"
|
||||
|
||||
/* put network interface into promiscuous mode
|
||||
* (only availabel when compiled with --with-stream-mon=pcap) */
|
||||
//promisc = "on"
|
||||
|
||||
/* the user and group under which honeytrap should run
|
||||
* should be set to non-root */
|
||||
user = "honeytrap"
|
||||
group = "honeytrap"
|
||||
|
||||
// do not read more than 20 MB - used to prevent DoS attacks
|
||||
read_limit = "20971520"
|
||||
|
||||
|
||||
/* ----- plugin stuff below ----- */
|
||||
|
||||
/* where to look for plugins
|
||||
needs to be set before loading plugins */
|
||||
plugin_dir = "/opt/honeytrap/etc/honeytrap/plugins"
|
||||
|
||||
|
||||
// include a plugin via plugin-[ModuleName] = ""
|
||||
|
||||
// plugin-magicPE = ""
|
||||
plugin-ftpDownload = ""
|
||||
plugin-tftpDownload = ""
|
||||
plugin-b64Decode = ""
|
||||
plugin-deUnicode = ""
|
||||
plugin-vncDownload = ""
|
||||
|
||||
|
||||
// store attacks on disk
|
||||
plugin-SaveFile = {
|
||||
attacks_dir = "/opt/honeytrap/var/attacks"
|
||||
downloads_dir = "/opt/honeytrap/var/downloads"
|
||||
}
|
||||
|
||||
|
||||
// plugin for shellcode detection and emulation
|
||||
/*
|
||||
plugin-cpuEmu = {
|
||||
execute_shellcode = "no"
|
||||
createprocess_cmd = "/bin/sh -c \"cd /opt/honeytrap-libemu/.wine/drive_c/windows/system32; WINEPREFIX='/opt/honeytrap-libemu/.wine/' WINEDEBUG='-all' wine 'c:\\windows\\system32\\cmd_orig.exe'\""
|
||||
}
|
||||
*/
|
||||
|
||||
|
||||
|
||||
// scan downloaded samples with ClamAV engine
|
||||
/*
|
||||
plugin-ClamAV = {
|
||||
temp_dir = "/tmp"
|
||||
clamdb_path = "/var/lib/clamav"
|
||||
}
|
||||
*/
|
||||
|
||||
|
||||
// calculate locality sensitive hashes
|
||||
/*
|
||||
plugin-SpamSum = {
|
||||
md5sum_sigfile = "/opt/honeytrap/md5sum.sigs"
|
||||
spamsum_sigfile = "/opt/honeytrap/spamsum.sigs"
|
||||
}
|
||||
*/
|
||||
|
||||
plugin-logAttacker = { logfile = "/opt/honeytrap/var/log/attacker.log" }
|
||||
|
||||
// log attack details in JSON format
|
||||
plugin-logJSON = { logfile = "/opt/honeytrap/var/log/attackers.json" }
|
||||
|
||||
|
||||
// store attacks in PostgeSQL database
|
||||
/*
|
||||
plugin-SavePostgres = {
|
||||
db_host = "localhost"
|
||||
db_name = "some_db"
|
||||
db_user = "some_user"
|
||||
db_pass = "some_pass"
|
||||
// db_port = "some_port" // defaults to 5432/tcp if not set
|
||||
}
|
||||
*/
|
||||
|
||||
|
||||
// invoke an external program (f.e. wget) to download files via http
|
||||
/*
|
||||
plugin-httpDownload = {
|
||||
http_program = "/usr/bin/wget"
|
||||
http_options = "-q -t1 -T1 -O-"
|
||||
}
|
||||
*/
|
||||
|
||||
|
||||
// submit downloaded malware samples to the mwcollect alliance
|
||||
/*
|
||||
plugin-submitMWserv = {
|
||||
mwserv_url = "https://submission-url/"
|
||||
guid = "your-guid"
|
||||
maintainer = "your-maintainer"
|
||||
secret = "your-secret"
|
||||
timeout = "120"
|
||||
}
|
||||
*/
|
||||
|
||||
/* ----- port mode configuration below ----- */
|
||||
|
||||
// default port configuration (ignore, normal or mirror)
|
||||
// ignore: just ignore connection attempts
|
||||
// normal: send a default response
|
||||
// mirror: mirror connections back to the initiator (use with caution!)
|
||||
portconf_default = "normal"
|
||||
|
||||
// explicit port configuration
|
||||
/* portconf = {
|
||||
// ignore connection requests on these ports
|
||||
ignore = {
|
||||
protocol = "tcp"
|
||||
port = "22"
|
||||
}
|
||||
}
|
||||
*/
|
||||
|
||||
// include a file
|
||||
//include = "ports.conf"
|
||||
BIN
docker/honeytrap/doc/dashboard.png
Normal file
BIN
docker/honeytrap/doc/dashboard.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 690 KiB |
19
docker/honeytrap/docker-compose.yml
Normal file
19
docker/honeytrap/docker-compose.yml
Normal file
|
|
@ -0,0 +1,19 @@
|
|||
version: '2.1'
|
||||
|
||||
networks:
|
||||
honeytrap_local:
|
||||
|
||||
services:
|
||||
|
||||
# Honeytrap service
|
||||
honeytrap:
|
||||
container_name: honeytrap
|
||||
restart: always
|
||||
network_mode: "host"
|
||||
cap_add:
|
||||
- NET_ADMIN
|
||||
image: "dtagdevsec/honeytrap:1706"
|
||||
volumes:
|
||||
- /data/honeytrap/attacks:/opt/honeytrap/var/attacks
|
||||
- /data/honeytrap/downloads:/opt/honeytrap/var/downloads
|
||||
- /data/honeytrap/log:/opt/honeytrap/var/log
|
||||
35
docker/mailoney/Dockerfile
Normal file
35
docker/mailoney/Dockerfile
Normal file
|
|
@ -0,0 +1,35 @@
|
|||
FROM alpine
|
||||
MAINTAINER MO
|
||||
|
||||
# Install packages
|
||||
RUN apk -U upgrade && \
|
||||
apk add autoconf automake bash build-base git libtool procps py-pip python python-dev && \
|
||||
|
||||
# Install libemu
|
||||
git clone https://github.com/buffer/libemu /root/libemu/ && \
|
||||
cd /root/libemu/ && \
|
||||
autoreconf -vi && \
|
||||
./configure && \
|
||||
make && \
|
||||
make install && \
|
||||
|
||||
# Install libemu python wrapper
|
||||
pip install pylibemu && \
|
||||
|
||||
# Install mailoney from git
|
||||
git clone https://github.com/awhitehatter/mailoney /opt/mailoney && \
|
||||
|
||||
# Setup user, groups and configs
|
||||
addgroup -g 2000 mailoney && \
|
||||
adduser -S -H -s /bin/bash -u 2000 -D -g 2000 mailoney && \
|
||||
chown -R mailoney:mailoney /opt/mailoney && \
|
||||
|
||||
# Clean up
|
||||
apk del autoconf automake build-base git py-pip python-dev && \
|
||||
rm -rf /root/* && \
|
||||
rm -rf /var/cache/apk/*
|
||||
|
||||
# Set workdir and start glastopf
|
||||
USER mailoney
|
||||
WORKDIR /opt/mailoney/
|
||||
CMD ["/usr/bin/python","mailoney.py","-i","0.0.0.0","-p","2525","-s","mailserver","-t","schizo_open_relay"]
|
||||
4
docker/mailoney/README.md
Normal file
4
docker/mailoney/README.md
Normal file
|
|
@ -0,0 +1,4 @@
|
|||
[](https://microbadger.com/images/dtagdevsec/mailoney:1706 "Get your own version badge on microbadger.com") [](https://microbadger.com/images/dtagdevsec/mailoney:1706 "Get your own image badge on microbadger.com")
|
||||
|
||||
# mailoney
|
||||
Dockerized mailoney for use in T-Pot
|
||||
18
docker/mailoney/docker-compose.yml
Normal file
18
docker/mailoney/docker-compose.yml
Normal file
|
|
@ -0,0 +1,18 @@
|
|||
version: '2.1'
|
||||
|
||||
networks:
|
||||
mailoney_local:
|
||||
|
||||
services:
|
||||
|
||||
# Mailoney service
|
||||
mailoney:
|
||||
container_name: mailoney
|
||||
restart: always
|
||||
networks:
|
||||
- mailoney_local
|
||||
ports:
|
||||
- "25:2525"
|
||||
image: "dtagdevsec/mailoney:1706"
|
||||
# volumes:
|
||||
# - /data/mailoney/log:/opt/mailoney/logs
|
||||
31
docker/netdata/Dockerfile
Normal file
31
docker/netdata/Dockerfile
Normal file
|
|
@ -0,0 +1,31 @@
|
|||
FROM alpine
|
||||
MAINTAINER MO
|
||||
|
||||
# Install packages
|
||||
RUN apk -U upgrade && \
|
||||
apk add alpine-sdk autoconf automake bash curl gawk gcc iw jq libmnl-dev libuuid linux-headers lm_sensors make musl-dev netcat-openbsd util-linux-dev pkgconf python py-requests py-yaml zlib-dev && \
|
||||
|
||||
# Install netdata
|
||||
cd /root && \
|
||||
git clone https://github.com/firehol/netdata && \
|
||||
cd netdata && \
|
||||
./netdata-installer.sh --dont-wait --dont-start-it && \
|
||||
sed -i "s/#local:/local:/" /etc/netdata/python.d/elasticsearch.conf && \
|
||||
sed -i "s/# host: '127.0.0.1'/host: '127.0.0.1'/" /etc/netdata/python.d/elasticsearch.conf && \
|
||||
sed -i "s/port: '9200'/port: '64298'/" /etc/netdata/python.d/elasticsearch.conf && \
|
||||
sed -i "s/# cluster_health: True/cluster_health: True/" /etc/netdata/python.d/elasticsearch.conf && \
|
||||
sed -i "s/# cluster_stats: True/cluster_stats: True/" /etc/netdata/python.d/elasticsearch.conf && \
|
||||
sed -i 's/SEND_EMAIL="YES"/SEND_EMAIL="NO"/' /etc/netdata/health_alarm_notify.conf && \
|
||||
cd / && \
|
||||
|
||||
# Clean up
|
||||
apk del alpine-sdk autoconf automake gcc libmnl-dev linux-headers make musl-dev pkgconf util-linux-dev zlib-dev && \
|
||||
rm -rf /root/* && \
|
||||
rm -rf /var/cache/apk/*
|
||||
|
||||
# Healthcheck
|
||||
HEALTHCHECK --retries=10 CMD curl -s -XGET 'http://127.0.0.1:64301'
|
||||
|
||||
# Start netdata
|
||||
WORKDIR /
|
||||
CMD ["/usr/sbin/netdata","-D","-s","/host","-i","127.0.0.1","-p","64301"]
|
||||
674
docker/netdata/LICENSE
Normal file
674
docker/netdata/LICENSE
Normal file
|
|
@ -0,0 +1,674 @@
|
|||
GNU GENERAL PUBLIC LICENSE
|
||||
Version 3, 29 June 2007
|
||||
|
||||
Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
|
||||
Everyone is permitted to copy and distribute verbatim copies
|
||||
of this license document, but changing it is not allowed.
|
||||
|
||||
Preamble
|
||||
|
||||
The GNU General Public License is a free, copyleft license for
|
||||
software and other kinds of works.
|
||||
|
||||
The licenses for most software and other practical works are designed
|
||||
to take away your freedom to share and change the works. By contrast,
|
||||
the GNU General Public License is intended to guarantee your freedom to
|
||||
share and change all versions of a program--to make sure it remains free
|
||||
software for all its users. We, the Free Software Foundation, use the
|
||||
GNU General Public License for most of our software; it applies also to
|
||||
any other work released this way by its authors. You can apply it to
|
||||
your programs, too.
|
||||
|
||||
When we speak of free software, we are referring to freedom, not
|
||||
price. Our General Public Licenses are designed to make sure that you
|
||||
have the freedom to distribute copies of free software (and charge for
|
||||
them if you wish), that you receive source code or can get it if you
|
||||
want it, that you can change the software or use pieces of it in new
|
||||
free programs, and that you know you can do these things.
|
||||
|
||||
To protect your rights, we need to prevent others from denying you
|
||||
these rights or asking you to surrender the rights. Therefore, you have
|
||||
certain responsibilities if you distribute copies of the software, or if
|
||||
you modify it: responsibilities to respect the freedom of others.
|
||||
|
||||
For example, if you distribute copies of such a program, whether
|
||||
gratis or for a fee, you must pass on to the recipients the same
|
||||
freedoms that you received. You must make sure that they, too, receive
|
||||
or can get the source code. And you must show them these terms so they
|
||||
know their rights.
|
||||
|
||||
Developers that use the GNU GPL protect your rights with two steps:
|
||||
(1) assert copyright on the software, and (2) offer you this License
|
||||
giving you legal permission to copy, distribute and/or modify it.
|
||||
|
||||
For the developers' and authors' protection, the GPL clearly explains
|
||||
that there is no warranty for this free software. For both users' and
|
||||
authors' sake, the GPL requires that modified versions be marked as
|
||||
changed, so that their problems will not be attributed erroneously to
|
||||
authors of previous versions.
|
||||
|
||||
Some devices are designed to deny users access to install or run
|
||||
modified versions of the software inside them, although the manufacturer
|
||||
can do so. This is fundamentally incompatible with the aim of
|
||||
protecting users' freedom to change the software. The systematic
|
||||
pattern of such abuse occurs in the area of products for individuals to
|
||||
use, which is precisely where it is most unacceptable. Therefore, we
|
||||
have designed this version of the GPL to prohibit the practice for those
|
||||
products. If such problems arise substantially in other domains, we
|
||||
stand ready to extend this provision to those domains in future versions
|
||||
of the GPL, as needed to protect the freedom of users.
|
||||
|
||||
Finally, every program is threatened constantly by software patents.
|
||||
States should not allow patents to restrict development and use of
|
||||
software on general-purpose computers, but in those that do, we wish to
|
||||
avoid the special danger that patents applied to a free program could
|
||||
make it effectively proprietary. To prevent this, the GPL assures that
|
||||
patents cannot be used to render the program non-free.
|
||||
|
||||
The precise terms and conditions for copying, distribution and
|
||||
modification follow.
|
||||
|
||||
TERMS AND CONDITIONS
|
||||
|
||||
0. Definitions.
|
||||
|
||||
"This License" refers to version 3 of the GNU General Public License.
|
||||
|
||||
"Copyright" also means copyright-like laws that apply to other kinds of
|
||||
works, such as semiconductor masks.
|
||||
|
||||
"The Program" refers to any copyrightable work licensed under this
|
||||
License. Each licensee is addressed as "you". "Licensees" and
|
||||
"recipients" may be individuals or organizations.
|
||||
|
||||
To "modify" a work means to copy from or adapt all or part of the work
|
||||
in a fashion requiring copyright permission, other than the making of an
|
||||
exact copy. The resulting work is called a "modified version" of the
|
||||
earlier work or a work "based on" the earlier work.
|
||||
|
||||
A "covered work" means either the unmodified Program or a work based
|
||||
on the Program.
|
||||
|
||||
To "propagate" a work means to do anything with it that, without
|
||||
permission, would make you directly or secondarily liable for
|
||||
infringement under applicable copyright law, except executing it on a
|
||||
computer or modifying a private copy. Propagation includes copying,
|
||||
distribution (with or without modification), making available to the
|
||||
public, and in some countries other activities as well.
|
||||
|
||||
To "convey" a work means any kind of propagation that enables other
|
||||
parties to make or receive copies. Mere interaction with a user through
|
||||
a computer network, with no transfer of a copy, is not conveying.
|
||||
|
||||
An interactive user interface displays "Appropriate Legal Notices"
|
||||
to the extent that it includes a convenient and prominently visible
|
||||
feature that (1) displays an appropriate copyright notice, and (2)
|
||||
tells the user that there is no warranty for the work (except to the
|
||||
extent that warranties are provided), that licensees may convey the
|
||||
work under this License, and how to view a copy of this License. If
|
||||
the interface presents a list of user commands or options, such as a
|
||||
menu, a prominent item in the list meets this criterion.
|
||||
|
||||
1. Source Code.
|
||||
|
||||
The "source code" for a work means the preferred form of the work
|
||||
for making modifications to it. "Object code" means any non-source
|
||||
form of a work.
|
||||
|
||||
A "Standard Interface" means an interface that either is an official
|
||||
standard defined by a recognized standards body, or, in the case of
|
||||
interfaces specified for a particular programming language, one that
|
||||
is widely used among developers working in that language.
|
||||
|
||||
The "System Libraries" of an executable work include anything, other
|
||||
than the work as a whole, that (a) is included in the normal form of
|
||||
packaging a Major Component, but which is not part of that Major
|
||||
Component, and (b) serves only to enable use of the work with that
|
||||
Major Component, or to implement a Standard Interface for which an
|
||||
implementation is available to the public in source code form. A
|
||||
"Major Component", in this context, means a major essential component
|
||||
(kernel, window system, and so on) of the specific operating system
|
||||
(if any) on which the executable work runs, or a compiler used to
|
||||
produce the work, or an object code interpreter used to run it.
|
||||
|
||||
The "Corresponding Source" for a work in object code form means all
|
||||
the source code needed to generate, install, and (for an executable
|
||||
work) run the object code and to modify the work, including scripts to
|
||||
control those activities. However, it does not include the work's
|
||||
System Libraries, or general-purpose tools or generally available free
|
||||
programs which are used unmodified in performing those activities but
|
||||
which are not part of the work. For example, Corresponding Source
|
||||
includes interface definition files associated with source files for
|
||||
the work, and the source code for shared libraries and dynamically
|
||||
linked subprograms that the work is specifically designed to require,
|
||||
such as by intimate data communication or control flow between those
|
||||
subprograms and other parts of the work.
|
||||
|
||||
The Corresponding Source need not include anything that users
|
||||
can regenerate automatically from other parts of the Corresponding
|
||||
Source.
|
||||
|
||||
The Corresponding Source for a work in source code form is that
|
||||
same work.
|
||||
|
||||
2. Basic Permissions.
|
||||
|
||||
All rights granted under this License are granted for the term of
|
||||
copyright on the Program, and are irrevocable provided the stated
|
||||
conditions are met. This License explicitly affirms your unlimited
|
||||
permission to run the unmodified Program. The output from running a
|
||||
covered work is covered by this License only if the output, given its
|
||||
content, constitutes a covered work. This License acknowledges your
|
||||
rights of fair use or other equivalent, as provided by copyright law.
|
||||
|
||||
You may make, run and propagate covered works that you do not
|
||||
convey, without conditions so long as your license otherwise remains
|
||||
in force. You may convey covered works to others for the sole purpose
|
||||
of having them make modifications exclusively for you, or provide you
|
||||
with facilities for running those works, provided that you comply with
|
||||
the terms of this License in conveying all material for which you do
|
||||
not control copyright. Those thus making or running the covered works
|
||||
for you must do so exclusively on your behalf, under your direction
|
||||
and control, on terms that prohibit them from making any copies of
|
||||
your copyrighted material outside their relationship with you.
|
||||
|
||||
Conveying under any other circumstances is permitted solely under
|
||||
the conditions stated below. Sublicensing is not allowed; section 10
|
||||
makes it unnecessary.
|
||||
|
||||
3. Protecting Users' Legal Rights From Anti-Circumvention Law.
|
||||
|
||||
No covered work shall be deemed part of an effective technological
|
||||
measure under any applicable law fulfilling obligations under article
|
||||
11 of the WIPO copyright treaty adopted on 20 December 1996, or
|
||||
similar laws prohibiting or restricting circumvention of such
|
||||
measures.
|
||||
|
||||
When you convey a covered work, you waive any legal power to forbid
|
||||
circumvention of technological measures to the extent such circumvention
|
||||
is effected by exercising rights under this License with respect to
|
||||
the covered work, and you disclaim any intention to limit operation or
|
||||
modification of the work as a means of enforcing, against the work's
|
||||
users, your or third parties' legal rights to forbid circumvention of
|
||||
technological measures.
|
||||
|
||||
4. Conveying Verbatim Copies.
|
||||
|
||||
You may convey verbatim copies of the Program's source code as you
|
||||
receive it, in any medium, provided that you conspicuously and
|
||||
appropriately publish on each copy an appropriate copyright notice;
|
||||
keep intact all notices stating that this License and any
|
||||
non-permissive terms added in accord with section 7 apply to the code;
|
||||
keep intact all notices of the absence of any warranty; and give all
|
||||
recipients a copy of this License along with the Program.
|
||||
|
||||
You may charge any price or no price for each copy that you convey,
|
||||
and you may offer support or warranty protection for a fee.
|
||||
|
||||
5. Conveying Modified Source Versions.
|
||||
|
||||
You may convey a work based on the Program, or the modifications to
|
||||
produce it from the Program, in the form of source code under the
|
||||
terms of section 4, provided that you also meet all of these conditions:
|
||||
|
||||
a) The work must carry prominent notices stating that you modified
|
||||
it, and giving a relevant date.
|
||||
|
||||
b) The work must carry prominent notices stating that it is
|
||||
released under this License and any conditions added under section
|
||||
7. This requirement modifies the requirement in section 4 to
|
||||
"keep intact all notices".
|
||||
|
||||
c) You must license the entire work, as a whole, under this
|
||||
License to anyone who comes into possession of a copy. This
|
||||
License will therefore apply, along with any applicable section 7
|
||||
additional terms, to the whole of the work, and all its parts,
|
||||
regardless of how they are packaged. This License gives no
|
||||
permission to license the work in any other way, but it does not
|
||||
invalidate such permission if you have separately received it.
|
||||
|
||||
d) If the work has interactive user interfaces, each must display
|
||||
Appropriate Legal Notices; however, if the Program has interactive
|
||||
interfaces that do not display Appropriate Legal Notices, your
|
||||
work need not make them do so.
|
||||
|
||||
A compilation of a covered work with other separate and independent
|
||||
works, which are not by their nature extensions of the covered work,
|
||||
and which are not combined with it such as to form a larger program,
|
||||
in or on a volume of a storage or distribution medium, is called an
|
||||
"aggregate" if the compilation and its resulting copyright are not
|
||||
used to limit the access or legal rights of the compilation's users
|
||||
beyond what the individual works permit. Inclusion of a covered work
|
||||
in an aggregate does not cause this License to apply to the other
|
||||
parts of the aggregate.
|
||||
|
||||
6. Conveying Non-Source Forms.
|
||||
|
||||
You may convey a covered work in object code form under the terms
|
||||
of sections 4 and 5, provided that you also convey the
|
||||
machine-readable Corresponding Source under the terms of this License,
|
||||
in one of these ways:
|
||||
|
||||
a) Convey the object code in, or embodied in, a physical product
|
||||
(including a physical distribution medium), accompanied by the
|
||||
Corresponding Source fixed on a durable physical medium
|
||||
customarily used for software interchange.
|
||||
|
||||
b) Convey the object code in, or embodied in, a physical product
|
||||
(including a physical distribution medium), accompanied by a
|
||||
written offer, valid for at least three years and valid for as
|
||||
long as you offer spare parts or customer support for that product
|
||||
model, to give anyone who possesses the object code either (1) a
|
||||
copy of the Corresponding Source for all the software in the
|
||||
product that is covered by this License, on a durable physical
|
||||
medium customarily used for software interchange, for a price no
|
||||
more than your reasonable cost of physically performing this
|
||||
conveying of source, or (2) access to copy the
|
||||
Corresponding Source from a network server at no charge.
|
||||
|
||||
c) Convey individual copies of the object code with a copy of the
|
||||
written offer to provide the Corresponding Source. This
|
||||
alternative is allowed only occasionally and noncommercially, and
|
||||
only if you received the object code with such an offer, in accord
|
||||
with subsection 6b.
|
||||
|
||||
d) Convey the object code by offering access from a designated
|
||||
place (gratis or for a charge), and offer equivalent access to the
|
||||
Corresponding Source in the same way through the same place at no
|
||||
further charge. You need not require recipients to copy the
|
||||
Corresponding Source along with the object code. If the place to
|
||||
copy the object code is a network server, the Corresponding Source
|
||||
may be on a different server (operated by you or a third party)
|
||||
that supports equivalent copying facilities, provided you maintain
|
||||
clear directions next to the object code saying where to find the
|
||||
Corresponding Source. Regardless of what server hosts the
|
||||
Corresponding Source, you remain obligated to ensure that it is
|
||||
available for as long as needed to satisfy these requirements.
|
||||
|
||||
e) Convey the object code using peer-to-peer transmission, provided
|
||||
you inform other peers where the object code and Corresponding
|
||||
Source of the work are being offered to the general public at no
|
||||
charge under subsection 6d.
|
||||
|
||||
A separable portion of the object code, whose source code is excluded
|
||||
from the Corresponding Source as a System Library, need not be
|
||||
included in conveying the object code work.
|
||||
|
||||
A "User Product" is either (1) a "consumer product", which means any
|
||||
tangible personal property which is normally used for personal, family,
|
||||
or household purposes, or (2) anything designed or sold for incorporation
|
||||
into a dwelling. In determining whether a product is a consumer product,
|
||||
doubtful cases shall be resolved in favor of coverage. For a particular
|
||||
product received by a particular user, "normally used" refers to a
|
||||
typical or common use of that class of product, regardless of the status
|
||||
of the particular user or of the way in which the particular user
|
||||
actually uses, or expects or is expected to use, the product. A product
|
||||
is a consumer product regardless of whether the product has substantial
|
||||
commercial, industrial or non-consumer uses, unless such uses represent
|
||||
the only significant mode of use of the product.
|
||||
|
||||
"Installation Information" for a User Product means any methods,
|
||||
procedures, authorization keys, or other information required to install
|
||||
and execute modified versions of a covered work in that User Product from
|
||||
a modified version of its Corresponding Source. The information must
|
||||
suffice to ensure that the continued functioning of the modified object
|
||||
code is in no case prevented or interfered with solely because
|
||||
modification has been made.
|
||||
|
||||
If you convey an object code work under this section in, or with, or
|
||||
specifically for use in, a User Product, and the conveying occurs as
|
||||
part of a transaction in which the right of possession and use of the
|
||||
User Product is transferred to the recipient in perpetuity or for a
|
||||
fixed term (regardless of how the transaction is characterized), the
|
||||
Corresponding Source conveyed under this section must be accompanied
|
||||
by the Installation Information. But this requirement does not apply
|
||||
if neither you nor any third party retains the ability to install
|
||||
modified object code on the User Product (for example, the work has
|
||||
been installed in ROM).
|
||||
|
||||
The requirement to provide Installation Information does not include a
|
||||
requirement to continue to provide support service, warranty, or updates
|
||||
for a work that has been modified or installed by the recipient, or for
|
||||
the User Product in which it has been modified or installed. Access to a
|
||||
network may be denied when the modification itself materially and
|
||||
adversely affects the operation of the network or violates the rules and
|
||||
protocols for communication across the network.
|
||||
|
||||
Corresponding Source conveyed, and Installation Information provided,
|
||||
in accord with this section must be in a format that is publicly
|
||||
documented (and with an implementation available to the public in
|
||||
source code form), and must require no special password or key for
|
||||
unpacking, reading or copying.
|
||||
|
||||
7. Additional Terms.
|
||||
|
||||
"Additional permissions" are terms that supplement the terms of this
|
||||
License by making exceptions from one or more of its conditions.
|
||||
Additional permissions that are applicable to the entire Program shall
|
||||
be treated as though they were included in this License, to the extent
|
||||
that they are valid under applicable law. If additional permissions
|
||||
apply only to part of the Program, that part may be used separately
|
||||
under those permissions, but the entire Program remains governed by
|
||||
this License without regard to the additional permissions.
|
||||
|
||||
When you convey a copy of a covered work, you may at your option
|
||||
remove any additional permissions from that copy, or from any part of
|
||||
it. (Additional permissions may be written to require their own
|
||||
removal in certain cases when you modify the work.) You may place
|
||||
additional permissions on material, added by you to a covered work,
|
||||
for which you have or can give appropriate copyright permission.
|
||||
|
||||
Notwithstanding any other provision of this License, for material you
|
||||
add to a covered work, you may (if authorized by the copyright holders of
|
||||
that material) supplement the terms of this License with terms:
|
||||
|
||||
a) Disclaiming warranty or limiting liability differently from the
|
||||
terms of sections 15 and 16 of this License; or
|
||||
|
||||
b) Requiring preservation of specified reasonable legal notices or
|
||||
author attributions in that material or in the Appropriate Legal
|
||||
Notices displayed by works containing it; or
|
||||
|
||||
c) Prohibiting misrepresentation of the origin of that material, or
|
||||
requiring that modified versions of such material be marked in
|
||||
reasonable ways as different from the original version; or
|
||||
|
||||
d) Limiting the use for publicity purposes of names of licensors or
|
||||
authors of the material; or
|
||||
|
||||
e) Declining to grant rights under trademark law for use of some
|
||||
trade names, trademarks, or service marks; or
|
||||
|
||||
f) Requiring indemnification of licensors and authors of that
|
||||
material by anyone who conveys the material (or modified versions of
|
||||
it) with contractual assumptions of liability to the recipient, for
|
||||
any liability that these contractual assumptions directly impose on
|
||||
those licensors and authors.
|
||||
|
||||
All other non-permissive additional terms are considered "further
|
||||
restrictions" within the meaning of section 10. If the Program as you
|
||||
received it, or any part of it, contains a notice stating that it is
|
||||
governed by this License along with a term that is a further
|
||||
restriction, you may remove that term. If a license document contains
|
||||
a further restriction but permits relicensing or conveying under this
|
||||
License, you may add to a covered work material governed by the terms
|
||||
of that license document, provided that the further restriction does
|
||||
not survive such relicensing or conveying.
|
||||
|
||||
If you add terms to a covered work in accord with this section, you
|
||||
must place, in the relevant source files, a statement of the
|
||||
additional terms that apply to those files, or a notice indicating
|
||||
where to find the applicable terms.
|
||||
|
||||
Additional terms, permissive or non-permissive, may be stated in the
|
||||
form of a separately written license, or stated as exceptions;
|
||||
the above requirements apply either way.
|
||||
|
||||
8. Termination.
|
||||
|
||||
You may not propagate or modify a covered work except as expressly
|
||||
provided under this License. Any attempt otherwise to propagate or
|
||||
modify it is void, and will automatically terminate your rights under
|
||||
this License (including any patent licenses granted under the third
|
||||
paragraph of section 11).
|
||||
|
||||
However, if you cease all violation of this License, then your
|
||||
license from a particular copyright holder is reinstated (a)
|
||||
provisionally, unless and until the copyright holder explicitly and
|
||||
finally terminates your license, and (b) permanently, if the copyright
|
||||
holder fails to notify you of the violation by some reasonable means
|
||||
prior to 60 days after the cessation.
|
||||
|
||||
Moreover, your license from a particular copyright holder is
|
||||
reinstated permanently if the copyright holder notifies you of the
|
||||
violation by some reasonable means, this is the first time you have
|
||||
received notice of violation of this License (for any work) from that
|
||||
copyright holder, and you cure the violation prior to 30 days after
|
||||
your receipt of the notice.
|
||||
|
||||
Termination of your rights under this section does not terminate the
|
||||
licenses of parties who have received copies or rights from you under
|
||||
this License. If your rights have been terminated and not permanently
|
||||
reinstated, you do not qualify to receive new licenses for the same
|
||||
material under section 10.
|
||||
|
||||
9. Acceptance Not Required for Having Copies.
|
||||
|
||||
You are not required to accept this License in order to receive or
|
||||
run a copy of the Program. Ancillary propagation of a covered work
|
||||
occurring solely as a consequence of using peer-to-peer transmission
|
||||
to receive a copy likewise does not require acceptance. However,
|
||||
nothing other than this License grants you permission to propagate or
|
||||
modify any covered work. These actions infringe copyright if you do
|
||||
not accept this License. Therefore, by modifying or propagating a
|
||||
covered work, you indicate your acceptance of this License to do so.
|
||||
|
||||
10. Automatic Licensing of Downstream Recipients.
|
||||
|
||||
Each time you convey a covered work, the recipient automatically
|
||||
receives a license from the original licensors, to run, modify and
|
||||
propagate that work, subject to this License. You are not responsible
|
||||
for enforcing compliance by third parties with this License.
|
||||
|
||||
An "entity transaction" is a transaction transferring control of an
|
||||
organization, or substantially all assets of one, or subdividing an
|
||||
organization, or merging organizations. If propagation of a covered
|
||||
work results from an entity transaction, each party to that
|
||||
transaction who receives a copy of the work also receives whatever
|
||||
licenses to the work the party's predecessor in interest had or could
|
||||
give under the previous paragraph, plus a right to possession of the
|
||||
Corresponding Source of the work from the predecessor in interest, if
|
||||
the predecessor has it or can get it with reasonable efforts.
|
||||
|
||||
You may not impose any further restrictions on the exercise of the
|
||||
rights granted or affirmed under this License. For example, you may
|
||||
not impose a license fee, royalty, or other charge for exercise of
|
||||
rights granted under this License, and you may not initiate litigation
|
||||
(including a cross-claim or counterclaim in a lawsuit) alleging that
|
||||
any patent claim is infringed by making, using, selling, offering for
|
||||
sale, or importing the Program or any portion of it.
|
||||
|
||||
11. Patents.
|
||||
|
||||
A "contributor" is a copyright holder who authorizes use under this
|
||||
License of the Program or a work on which the Program is based. The
|
||||
work thus licensed is called the contributor's "contributor version".
|
||||
|
||||
A contributor's "essential patent claims" are all patent claims
|
||||
owned or controlled by the contributor, whether already acquired or
|
||||
hereafter acquired, that would be infringed by some manner, permitted
|
||||
by this License, of making, using, or selling its contributor version,
|
||||
but do not include claims that would be infringed only as a
|
||||
consequence of further modification of the contributor version. For
|
||||
purposes of this definition, "control" includes the right to grant
|
||||
patent sublicenses in a manner consistent with the requirements of
|
||||
this License.
|
||||
|
||||
Each contributor grants you a non-exclusive, worldwide, royalty-free
|
||||
patent license under the contributor's essential patent claims, to
|
||||
make, use, sell, offer for sale, import and otherwise run, modify and
|
||||
propagate the contents of its contributor version.
|
||||
|
||||
In the following three paragraphs, a "patent license" is any express
|
||||
agreement or commitment, however denominated, not to enforce a patent
|
||||
(such as an express permission to practice a patent or covenant not to
|
||||
sue for patent infringement). To "grant" such a patent license to a
|
||||
party means to make such an agreement or commitment not to enforce a
|
||||
patent against the party.
|
||||
|
||||
If you convey a covered work, knowingly relying on a patent license,
|
||||
and the Corresponding Source of the work is not available for anyone
|
||||
to copy, free of charge and under the terms of this License, through a
|
||||
publicly available network server or other readily accessible means,
|
||||
then you must either (1) cause the Corresponding Source to be so
|
||||
available, or (2) arrange to deprive yourself of the benefit of the
|
||||
patent license for this particular work, or (3) arrange, in a manner
|
||||
consistent with the requirements of this License, to extend the patent
|
||||
license to downstream recipients. "Knowingly relying" means you have
|
||||
actual knowledge that, but for the patent license, your conveying the
|
||||
covered work in a country, or your recipient's use of the covered work
|
||||
in a country, would infringe one or more identifiable patents in that
|
||||
country that you have reason to believe are valid.
|
||||
|
||||
If, pursuant to or in connection with a single transaction or
|
||||
arrangement, you convey, or propagate by procuring conveyance of, a
|
||||
covered work, and grant a patent license to some of the parties
|
||||
receiving the covered work authorizing them to use, propagate, modify
|
||||
or convey a specific copy of the covered work, then the patent license
|
||||
you grant is automatically extended to all recipients of the covered
|
||||
work and works based on it.
|
||||
|
||||
A patent license is "discriminatory" if it does not include within
|
||||
the scope of its coverage, prohibits the exercise of, or is
|
||||
conditioned on the non-exercise of one or more of the rights that are
|
||||
specifically granted under this License. You may not convey a covered
|
||||
work if you are a party to an arrangement with a third party that is
|
||||
in the business of distributing software, under which you make payment
|
||||
to the third party based on the extent of your activity of conveying
|
||||
the work, and under which the third party grants, to any of the
|
||||
parties who would receive the covered work from you, a discriminatory
|
||||
patent license (a) in connection with copies of the covered work
|
||||
conveyed by you (or copies made from those copies), or (b) primarily
|
||||
for and in connection with specific products or compilations that
|
||||
contain the covered work, unless you entered into that arrangement,
|
||||
or that patent license was granted, prior to 28 March 2007.
|
||||
|
||||
Nothing in this License shall be construed as excluding or limiting
|
||||
any implied license or other defenses to infringement that may
|
||||
otherwise be available to you under applicable patent law.
|
||||
|
||||
12. No Surrender of Others' Freedom.
|
||||
|
||||
If conditions are imposed on you (whether by court order, agreement or
|
||||
otherwise) that contradict the conditions of this License, they do not
|
||||
excuse you from the conditions of this License. If you cannot convey a
|
||||
covered work so as to satisfy simultaneously your obligations under this
|
||||
License and any other pertinent obligations, then as a consequence you may
|
||||
not convey it at all. For example, if you agree to terms that obligate you
|
||||
to collect a royalty for further conveying from those to whom you convey
|
||||
the Program, the only way you could satisfy both those terms and this
|
||||
License would be to refrain entirely from conveying the Program.
|
||||
|
||||
13. Use with the GNU Affero General Public License.
|
||||
|
||||
Notwithstanding any other provision of this License, you have
|
||||
permission to link or combine any covered work with a work licensed
|
||||
under version 3 of the GNU Affero General Public License into a single
|
||||
combined work, and to convey the resulting work. The terms of this
|
||||
License will continue to apply to the part which is the covered work,
|
||||
but the special requirements of the GNU Affero General Public License,
|
||||
section 13, concerning interaction through a network will apply to the
|
||||
combination as such.
|
||||
|
||||
14. Revised Versions of this License.
|
||||
|
||||
The Free Software Foundation may publish revised and/or new versions of
|
||||
the GNU General Public License from time to time. Such new versions will
|
||||
be similar in spirit to the present version, but may differ in detail to
|
||||
address new problems or concerns.
|
||||
|
||||
Each version is given a distinguishing version number. If the
|
||||
Program specifies that a certain numbered version of the GNU General
|
||||
Public License "or any later version" applies to it, you have the
|
||||
option of following the terms and conditions either of that numbered
|
||||
version or of any later version published by the Free Software
|
||||
Foundation. If the Program does not specify a version number of the
|
||||
GNU General Public License, you may choose any version ever published
|
||||
by the Free Software Foundation.
|
||||
|
||||
If the Program specifies that a proxy can decide which future
|
||||
versions of the GNU General Public License can be used, that proxy's
|
||||
public statement of acceptance of a version permanently authorizes you
|
||||
to choose that version for the Program.
|
||||
|
||||
Later license versions may give you additional or different
|
||||
permissions. However, no additional obligations are imposed on any
|
||||
author or copyright holder as a result of your choosing to follow a
|
||||
later version.
|
||||
|
||||
15. Disclaimer of Warranty.
|
||||
|
||||
THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
|
||||
APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
|
||||
HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
|
||||
OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
|
||||
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
||||
PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
|
||||
IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
|
||||
ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
|
||||
|
||||
16. Limitation of Liability.
|
||||
|
||||
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
|
||||
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
|
||||
THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
|
||||
GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
|
||||
USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
|
||||
DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
|
||||
PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
|
||||
EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
|
||||
SUCH DAMAGES.
|
||||
|
||||
17. Interpretation of Sections 15 and 16.
|
||||
|
||||
If the disclaimer of warranty and limitation of liability provided
|
||||
above cannot be given local legal effect according to their terms,
|
||||
reviewing courts shall apply local law that most closely approximates
|
||||
an absolute waiver of all civil liability in connection with the
|
||||
Program, unless a warranty or assumption of liability accompanies a
|
||||
copy of the Program in return for a fee.
|
||||
|
||||
END OF TERMS AND CONDITIONS
|
||||
|
||||
How to Apply These Terms to Your New Programs
|
||||
|
||||
If you develop a new program, and you want it to be of the greatest
|
||||
possible use to the public, the best way to achieve this is to make it
|
||||
free software which everyone can redistribute and change under these terms.
|
||||
|
||||
To do so, attach the following notices to the program. It is safest
|
||||
to attach them to the start of each source file to most effectively
|
||||
state the exclusion of warranty; and each file should have at least
|
||||
the "copyright" line and a pointer to where the full notice is found.
|
||||
|
||||
{one line to give the program's name and a brief idea of what it does.}
|
||||
Copyright (C) {year} {name of author}
|
||||
|
||||
This program is free software: you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation, either version 3 of the License, or
|
||||
(at your option) any later version.
|
||||
|
||||
This program is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
||||
|
||||
Also add information on how to contact you by electronic and paper mail.
|
||||
|
||||
If the program does terminal interaction, make it output a short
|
||||
notice like this when it starts in an interactive mode:
|
||||
|
||||
{project} Copyright (C) {year} {fullname}
|
||||
This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
|
||||
This is free software, and you are welcome to redistribute it
|
||||
under certain conditions; type `show c' for details.
|
||||
|
||||
The hypothetical commands `show w' and `show c' should show the appropriate
|
||||
parts of the General Public License. Of course, your program's commands
|
||||
might be different; for a GUI interface, you would use an "about box".
|
||||
|
||||
You should also get your employer (if you work as a programmer) or school,
|
||||
if any, to sign a "copyright disclaimer" for the program, if necessary.
|
||||
For more information on this, and how to apply and follow the GNU GPL, see
|
||||
<http://www.gnu.org/licenses/>.
|
||||
|
||||
The GNU General Public License does not permit incorporating your program
|
||||
into proprietary programs. If your program is a subroutine library, you
|
||||
may consider it more useful to permit linking proprietary applications with
|
||||
the library. If this is what you want to do, use the GNU Lesser General
|
||||
Public License instead of this License. But first, please read
|
||||
<http://www.gnu.org/philosophy/why-not-lgpl.html>.
|
||||
25
docker/netdata/README.md
Normal file
25
docker/netdata/README.md
Normal file
|
|
@ -0,0 +1,25 @@
|
|||
[](https://microbadger.com/images/dtagdevsec/netdata:1706 "Get your own version badge on microbadger.com") [](https://microbadger.com/images/dtagdevsec/netdata:1706 "Get your own image badge on microbadger.com")
|
||||
|
||||
# dockerized netdata
|
||||
|
||||
|
||||
[netdata](http://my-netdata.io/) netdata is a system for distributed real-time performance and health monitoring. It provides unparalleled insights, in real-time, of everything happening on the system it runs (including applications such as web, or database servers), using modern interactive web dashboards. netdata is fast and efficient, designed to permanently run on all systems (physical & virtual servers, containers, IoT devices), without disrupting their core function.
|
||||
|
||||
This repository contains the necessary files to create a *dockerized* version of netdata.
|
||||
|
||||
This dockerized version is part of the **[T-Pot community honeypot](http://dtag-dev-sec.github.io/)** of Deutsche Telekom AG.
|
||||
|
||||
The `Dockerfile` contains the blueprint for the dockerized netdata and will be used to setup the docker image.
|
||||
|
||||
Using systemd, copy the `systemd/netdata.service` to `/etc/systemd/system/netdata.service` and start using
|
||||
|
||||
```
|
||||
systemctl enable netdata
|
||||
systemctl start netdata
|
||||
```
|
||||
|
||||
This will make sure that the docker container is started with the appropriate permissions and port mappings. Further, it autostarts during boot.
|
||||
|
||||
# Netdata Dashboard
|
||||
|
||||
|
||||
BIN
docker/netdata/doc/dashboard.png
Normal file
BIN
docker/netdata/doc/dashboard.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 264 KiB |
19
docker/netdata/docker-compose.yml
Normal file
19
docker/netdata/docker-compose.yml
Normal file
|
|
@ -0,0 +1,19 @@
|
|||
version: '2.1'
|
||||
|
||||
services:
|
||||
|
||||
# Netdata service
|
||||
netdata:
|
||||
container_name: netdata
|
||||
restart: always
|
||||
network_mode: "host"
|
||||
cap_add:
|
||||
- SYS_PTRACE
|
||||
security_opt:
|
||||
- apparmor=unconfined
|
||||
image: "dtagdevsec/netdata:1706"
|
||||
volumes:
|
||||
- /proc:/host/proc:ro
|
||||
- /sys:/host/sys:ro
|
||||
- /var/run/docker.sock:/var/run/docker.sock
|
||||
command: ["/usr/sbin/netdata","-D","-s","/host","-p","19999"]
|
||||
27
docker/p0f/Dockerfile
Normal file
27
docker/p0f/Dockerfile
Normal file
|
|
@ -0,0 +1,27 @@
|
|||
FROM alpine
|
||||
MAINTAINER MO
|
||||
|
||||
# Add source
|
||||
ADD . /opt/p0f
|
||||
|
||||
# Install packages
|
||||
RUN apk -U upgrade && \
|
||||
apk add bash build-base git jansson-dev libpcap-dev procps && \
|
||||
|
||||
# Setup user, groups and configs
|
||||
addgroup -g 2000 p0f && \
|
||||
adduser -S -s /bin/bash -u 2000 -D -g 2000 p0f && \
|
||||
|
||||
# Download and compile p0f
|
||||
cd /opt/p0f && \
|
||||
./build.sh && \
|
||||
|
||||
# Clean up
|
||||
apk del build-base git jansson-dev libpcap-dev && \
|
||||
apk add jansson libpcap && \
|
||||
rm -rf /root/* && \
|
||||
rm -rf /var/cache/apk/*
|
||||
|
||||
# Start suricata
|
||||
WORKDIR /opt/p0f
|
||||
CMD /bin/bash -c "exec /opt/p0f/p0f -u p0f -j -o /var/log/p0f/p0f.json -i $(/sbin/ip address | grep '^2: ' | awk '{ print $2 }' | tr -d [:punct:])"
|
||||
21
docker/p0f/Makefile
Normal file
21
docker/p0f/Makefile
Normal file
|
|
@ -0,0 +1,21 @@
|
|||
#
|
||||
# p0f - make wrapper
|
||||
# ------------------
|
||||
#
|
||||
# Copyright (C) 2012 by Michal Zalewski <lcamtuf@coredump.cx>
|
||||
#
|
||||
# Distributed under the terms and conditions of GNU LGPL.
|
||||
#
|
||||
|
||||
all:
|
||||
@./build.sh all
|
||||
|
||||
debug:
|
||||
@./build.sh debug
|
||||
|
||||
clean:
|
||||
@./build.sh clean
|
||||
|
||||
publish:
|
||||
@./build.sh publish
|
||||
|
||||
4
docker/p0f/README.md
Normal file
4
docker/p0f/README.md
Normal file
|
|
@ -0,0 +1,4 @@
|
|||
[](https://microbadger.com/images/dtagdevsec/p0f:1706 "Get your own version badge on microbadger.com") [](https://microbadger.com/images/dtagdevsec/p0f:1706 "Get your own image badge on microbadger.com")
|
||||
|
||||
# dockerized p0f
|
||||
|
||||
485
docker/p0f/alloc-inl.h
Normal file
485
docker/p0f/alloc-inl.h
Normal file
|
|
@ -0,0 +1,485 @@
|
|||
/*
|
||||
p0f - error-checking, memory-zeroing alloc routines
|
||||
---------------------------------------------------
|
||||
|
||||
Copyright (C) 2012 by Michal Zalewski <lcamtuf@coredump.cx>
|
||||
|
||||
Distributed under the terms and conditions of GNU LGPL.
|
||||
|
||||
*/
|
||||
|
||||
#ifndef _HAVE_ALLOC_INL_H
|
||||
#define _HAVE_ALLOC_INL_H
|
||||
|
||||
#include <stdlib.h>
|
||||
#include <string.h>
|
||||
|
||||
#include "config.h"
|
||||
#include "types.h"
|
||||
#include "debug.h"
|
||||
|
||||
#define ALLOC_CHECK_SIZE(_s) do { \
|
||||
if ((_s) > MAX_ALLOC) \
|
||||
ABORT("Bad alloc request: %u bytes", (_s)); \
|
||||
} while (0)
|
||||
|
||||
#define ALLOC_CHECK_RESULT(_r,_s) do { \
|
||||
if (!(_r)) \
|
||||
ABORT("Out of memory: can't allocate %u bytes", (_s)); \
|
||||
} while (0)
|
||||
|
||||
#define ALLOC_MAGIC 0xFF00
|
||||
#define ALLOC_MAGIC_F 0xFE00
|
||||
|
||||
#define ALLOC_C(_ptr) (((u16*)(_ptr))[-3])
|
||||
#define ALLOC_S(_ptr) (((u32*)(_ptr))[-1])
|
||||
|
||||
#define CHECK_PTR(_p) do { \
|
||||
if ((_p) && ALLOC_C(_p) != ALLOC_MAGIC) {\
|
||||
if (ALLOC_C(_p) == ALLOC_MAGIC_F) \
|
||||
ABORT("Use after free."); \
|
||||
else \
|
||||
ABORT("Bad alloc canary."); \
|
||||
} \
|
||||
} while (0)
|
||||
|
||||
|
||||
#define CHECK_PTR_EXPR(_p) ({ \
|
||||
typeof (_p) _tmp = (_p); \
|
||||
CHECK_PTR(_tmp); \
|
||||
_tmp; \
|
||||
})
|
||||
|
||||
#ifdef CHECK_UAF
|
||||
# define CP(_p) CHECK_PTR_EXPR(_p)
|
||||
#else
|
||||
# define CP(_p) (_p)
|
||||
#endif /* ^CHECK_UAF */
|
||||
|
||||
#ifdef ALIGN_ACCESS
|
||||
# define ALLOC_OFF 8
|
||||
#else
|
||||
# define ALLOC_OFF 6
|
||||
#endif /* ^ALIGN_ACCESS */
|
||||
|
||||
|
||||
static inline void* DFL_ck_alloc(u32 size) {
|
||||
void* ret;
|
||||
|
||||
if (!size) return NULL;
|
||||
|
||||
ALLOC_CHECK_SIZE(size);
|
||||
ret = malloc(size + ALLOC_OFF);
|
||||
ALLOC_CHECK_RESULT(ret, size);
|
||||
|
||||
ret += ALLOC_OFF;
|
||||
|
||||
ALLOC_C(ret) = ALLOC_MAGIC;
|
||||
ALLOC_S(ret) = size;
|
||||
|
||||
return memset(ret, 0, size);
|
||||
}
|
||||
|
||||
|
||||
static inline void* DFL_ck_realloc(void* orig, u32 size) {
|
||||
void* ret;
|
||||
u32 old_size = 0;
|
||||
|
||||
if (!size) {
|
||||
|
||||
if (orig) {
|
||||
|
||||
CHECK_PTR(orig);
|
||||
|
||||
/* Catch pointer issues sooner. */
|
||||
|
||||
#ifdef DEBUG_BUILD
|
||||
memset(orig - ALLOC_OFF, 0xFF, ALLOC_S(orig) + ALLOC_OFF);
|
||||
#endif /* DEBUG_BUILD */
|
||||
|
||||
free(orig - ALLOC_OFF);
|
||||
|
||||
}
|
||||
|
||||
return NULL;
|
||||
|
||||
}
|
||||
|
||||
if (orig) {
|
||||
|
||||
CHECK_PTR(orig);
|
||||
|
||||
#ifndef DEBUG_BUILD
|
||||
ALLOC_C(orig) = ALLOC_MAGIC_F;
|
||||
#endif /* !DEBUG_BUILD */
|
||||
|
||||
old_size = ALLOC_S(orig);
|
||||
orig -= ALLOC_OFF;
|
||||
|
||||
ALLOC_CHECK_SIZE(old_size);
|
||||
|
||||
}
|
||||
|
||||
ALLOC_CHECK_SIZE(size);
|
||||
|
||||
#ifndef DEBUG_BUILD
|
||||
|
||||
ret = realloc(orig, size + ALLOC_OFF);
|
||||
ALLOC_CHECK_RESULT(ret, size);
|
||||
|
||||
#else
|
||||
|
||||
/* Catch pointer issues sooner: force relocation and make sure that the
|
||||
original buffer is wiped. */
|
||||
|
||||
ret = malloc(size + ALLOC_OFF);
|
||||
ALLOC_CHECK_RESULT(ret, size);
|
||||
|
||||
if (orig) {
|
||||
|
||||
memcpy(ret + ALLOC_OFF, orig + ALLOC_OFF, MIN(size, old_size));
|
||||
memset(orig, 0xFF, old_size + ALLOC_OFF);
|
||||
|
||||
ALLOC_C(orig + ALLOC_OFF) = ALLOC_MAGIC_F;
|
||||
|
||||
free(orig);
|
||||
|
||||
}
|
||||
|
||||
#endif /* ^!DEBUG_BUILD */
|
||||
|
||||
ret += ALLOC_OFF;
|
||||
|
||||
ALLOC_C(ret) = ALLOC_MAGIC;
|
||||
ALLOC_S(ret) = size;
|
||||
|
||||
if (size > old_size)
|
||||
memset(ret + old_size, 0, size - old_size);
|
||||
|
||||
return ret;
|
||||
}
|
||||
|
||||
|
||||
static inline void* DFL_ck_realloc_kb(void* orig, u32 size) {
|
||||
|
||||
#ifndef DEBUG_BUILD
|
||||
|
||||
if (orig) {
|
||||
|
||||
CHECK_PTR(orig);
|
||||
|
||||
if (ALLOC_S(orig) >= size) return orig;
|
||||
|
||||
size = ((size >> 10) + 1) << 10;
|
||||
}
|
||||
|
||||
#endif /* !DEBUG_BUILD */
|
||||
|
||||
return DFL_ck_realloc(orig, size);
|
||||
}
|
||||
|
||||
|
||||
static inline u8* DFL_ck_strdup(u8* str) {
|
||||
void* ret;
|
||||
u32 size;
|
||||
|
||||
if (!str) return NULL;
|
||||
|
||||
size = strlen((char*)str) + 1;
|
||||
|
||||
ALLOC_CHECK_SIZE(size);
|
||||
ret = malloc(size + ALLOC_OFF);
|
||||
ALLOC_CHECK_RESULT(ret, size);
|
||||
|
||||
ret += ALLOC_OFF;
|
||||
|
||||
ALLOC_C(ret) = ALLOC_MAGIC;
|
||||
ALLOC_S(ret) = size;
|
||||
|
||||
return memcpy(ret, str, size);
|
||||
}
|
||||
|
||||
|
||||
static inline void* DFL_ck_memdup(void* mem, u32 size) {
|
||||
void* ret;
|
||||
|
||||
if (!mem || !size) return NULL;
|
||||
|
||||
ALLOC_CHECK_SIZE(size);
|
||||
ret = malloc(size + ALLOC_OFF);
|
||||
ALLOC_CHECK_RESULT(ret, size);
|
||||
|
||||
ret += ALLOC_OFF;
|
||||
|
||||
ALLOC_C(ret) = ALLOC_MAGIC;
|
||||
ALLOC_S(ret) = size;
|
||||
|
||||
return memcpy(ret, mem, size);
|
||||
}
|
||||
|
||||
|
||||
static inline u8* DFL_ck_memdup_str(u8* mem, u32 size) {
|
||||
u8* ret;
|
||||
|
||||
if (!mem || !size) return NULL;
|
||||
|
||||
ALLOC_CHECK_SIZE(size);
|
||||
ret = malloc(size + ALLOC_OFF + 1);
|
||||
ALLOC_CHECK_RESULT(ret, size);
|
||||
|
||||
ret += ALLOC_OFF;
|
||||
|
||||
ALLOC_C(ret) = ALLOC_MAGIC;
|
||||
ALLOC_S(ret) = size;
|
||||
|
||||
memcpy(ret, mem, size);
|
||||
ret[size] = 0;
|
||||
|
||||
return ret;
|
||||
}
|
||||
|
||||
|
||||
static inline void DFL_ck_free(void* mem) {
|
||||
|
||||
if (mem) {
|
||||
|
||||
CHECK_PTR(mem);
|
||||
|
||||
#ifdef DEBUG_BUILD
|
||||
|
||||
/* Catch pointer issues sooner. */
|
||||
memset(mem - ALLOC_OFF, 0xFF, ALLOC_S(mem) + ALLOC_OFF);
|
||||
|
||||
#endif /* DEBUG_BUILD */
|
||||
|
||||
ALLOC_C(mem) = ALLOC_MAGIC_F;
|
||||
|
||||
free(mem - ALLOC_OFF);
|
||||
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
#ifndef DEBUG_BUILD
|
||||
|
||||
/* Non-debugging mode - straightforward aliasing. */
|
||||
|
||||
#define ck_alloc DFL_ck_alloc
|
||||
#define ck_realloc DFL_ck_realloc
|
||||
#define ck_realloc_kb DFL_ck_realloc_kb
|
||||
#define ck_strdup DFL_ck_strdup
|
||||
#define ck_memdup DFL_ck_memdup
|
||||
#define ck_memdup_str DFL_ck_memdup_str
|
||||
#define ck_free DFL_ck_free
|
||||
|
||||
#else
|
||||
|
||||
/* Debugging mode - include additional structures and support code. */
|
||||
|
||||
#define ALLOC_BUCKETS 4096
|
||||
#define ALLOC_TRK_CHUNK 256
|
||||
|
||||
struct TRK_obj {
|
||||
void *ptr;
|
||||
char *file, *func;
|
||||
u32 line;
|
||||
};
|
||||
|
||||
|
||||
extern struct TRK_obj* TRK[ALLOC_BUCKETS];
|
||||
extern u32 TRK_cnt[ALLOC_BUCKETS];
|
||||
|
||||
#define TRKH(_ptr) (((((u32)(_ptr)) >> 16) ^ ((u32)(_ptr))) % ALLOC_BUCKETS)
|
||||
|
||||
/* Adds a new entry to the list of allocated objects. */
|
||||
|
||||
static inline void TRK_alloc_buf(void* ptr, const char* file, const char* func,
|
||||
u32 line) {
|
||||
|
||||
u32 i, bucket;
|
||||
|
||||
if (!ptr) return;
|
||||
|
||||
bucket = TRKH(ptr);
|
||||
|
||||
for (i = 0; i < TRK_cnt[bucket]; i++)
|
||||
|
||||
if (!TRK[bucket][i].ptr) {
|
||||
|
||||
TRK[bucket][i].ptr = ptr;
|
||||
TRK[bucket][i].file = (char*)file;
|
||||
TRK[bucket][i].func = (char*)func;
|
||||
TRK[bucket][i].line = line;
|
||||
return;
|
||||
|
||||
}
|
||||
|
||||
/* No space available. */
|
||||
|
||||
if (!(i % ALLOC_TRK_CHUNK)) {
|
||||
|
||||
TRK[bucket] = DFL_ck_realloc(TRK[bucket],
|
||||
(TRK_cnt[bucket] + ALLOC_TRK_CHUNK) * sizeof(struct TRK_obj));
|
||||
|
||||
}
|
||||
|
||||
TRK[bucket][i].ptr = ptr;
|
||||
TRK[bucket][i].file = (char*)file;
|
||||
TRK[bucket][i].func = (char*)func;
|
||||
TRK[bucket][i].line = line;
|
||||
|
||||
TRK_cnt[bucket]++;
|
||||
|
||||
}
|
||||
|
||||
|
||||
/* Removes entry from the list of allocated objects. */
|
||||
|
||||
static inline void TRK_free_buf(void* ptr, const char* file, const char* func,
|
||||
u32 line) {
|
||||
|
||||
u32 i, bucket;
|
||||
|
||||
if (!ptr) return;
|
||||
|
||||
bucket = TRKH(ptr);
|
||||
|
||||
for (i = 0; i < TRK_cnt[bucket]; i++)
|
||||
|
||||
if (TRK[bucket][i].ptr == ptr) {
|
||||
|
||||
TRK[bucket][i].ptr = 0;
|
||||
return;
|
||||
|
||||
}
|
||||
|
||||
WARN("ALLOC: Attempt to free non-allocated memory in %s (%s:%u)",
|
||||
func, file, line);
|
||||
|
||||
}
|
||||
|
||||
|
||||
/* Does a final report on all non-deallocated objects. */
|
||||
|
||||
static inline void TRK_report(void) {
|
||||
|
||||
u32 i, bucket;
|
||||
|
||||
fflush(0);
|
||||
|
||||
for (bucket = 0; bucket < ALLOC_BUCKETS; bucket++)
|
||||
for (i = 0; i < TRK_cnt[bucket]; i++)
|
||||
if (TRK[bucket][i].ptr)
|
||||
WARN("ALLOC: Memory never freed, created in %s (%s:%u)",
|
||||
TRK[bucket][i].func, TRK[bucket][i].file, TRK[bucket][i].line);
|
||||
|
||||
}
|
||||
|
||||
|
||||
/* Simple wrappers for non-debugging functions: */
|
||||
|
||||
static inline void* TRK_ck_alloc(u32 size, const char* file, const char* func,
|
||||
u32 line) {
|
||||
|
||||
void* ret = DFL_ck_alloc(size);
|
||||
TRK_alloc_buf(ret, file, func, line);
|
||||
return ret;
|
||||
|
||||
}
|
||||
|
||||
|
||||
static inline void* TRK_ck_realloc(void* orig, u32 size, const char* file,
|
||||
const char* func, u32 line) {
|
||||
|
||||
void* ret = DFL_ck_realloc(orig, size);
|
||||
TRK_free_buf(orig, file, func, line);
|
||||
TRK_alloc_buf(ret, file, func, line);
|
||||
return ret;
|
||||
|
||||
}
|
||||
|
||||
|
||||
static inline void* TRK_ck_realloc_kb(void* orig, u32 size, const char* file,
|
||||
const char* func, u32 line) {
|
||||
|
||||
void* ret = DFL_ck_realloc_kb(orig, size);
|
||||
TRK_free_buf(orig, file, func, line);
|
||||
TRK_alloc_buf(ret, file, func, line);
|
||||
return ret;
|
||||
|
||||
}
|
||||
|
||||
|
||||
static inline void* TRK_ck_strdup(u8* str, const char* file, const char* func,
|
||||
u32 line) {
|
||||
|
||||
void* ret = DFL_ck_strdup(str);
|
||||
TRK_alloc_buf(ret, file, func, line);
|
||||
return ret;
|
||||
|
||||
}
|
||||
|
||||
|
||||
static inline void* TRK_ck_memdup(void* mem, u32 size, const char* file,
|
||||
const char* func, u32 line) {
|
||||
|
||||
void* ret = DFL_ck_memdup(mem, size);
|
||||
TRK_alloc_buf(ret, file, func, line);
|
||||
return ret;
|
||||
|
||||
}
|
||||
|
||||
|
||||
static inline void* TRK_ck_memdup_str(void* mem, u32 size, const char* file,
|
||||
const char* func, u32 line) {
|
||||
|
||||
void* ret = DFL_ck_memdup_str(mem, size);
|
||||
TRK_alloc_buf(ret, file, func, line);
|
||||
return ret;
|
||||
|
||||
}
|
||||
|
||||
|
||||
static inline void TRK_ck_free(void* ptr, const char* file,
|
||||
const char* func, u32 line) {
|
||||
|
||||
TRK_free_buf(ptr, file, func, line);
|
||||
DFL_ck_free(ptr);
|
||||
|
||||
}
|
||||
|
||||
/* Alias user-facing names to tracking functions: */
|
||||
|
||||
#define ck_alloc(_p1) \
|
||||
TRK_ck_alloc(_p1, __FILE__, __FUNCTION__, __LINE__)
|
||||
|
||||
#define ck_realloc(_p1, _p2) \
|
||||
TRK_ck_realloc(_p1, _p2, __FILE__, __FUNCTION__, __LINE__)
|
||||
|
||||
#define ck_realloc_kb(_p1, _p2) \
|
||||
TRK_ck_realloc_kb(_p1, _p2, __FILE__, __FUNCTION__, __LINE__)
|
||||
|
||||
#define ck_strdup(_p1) \
|
||||
TRK_ck_strdup(_p1, __FILE__, __FUNCTION__, __LINE__)
|
||||
|
||||
#define ck_memdup(_p1, _p2) \
|
||||
TRK_ck_memdup(_p1, _p2, __FILE__, __FUNCTION__, __LINE__)
|
||||
|
||||
#define ck_memdup_str(_p1, _p2) \
|
||||
TRK_ck_memdup_str(_p1, _p2, __FILE__, __FUNCTION__, __LINE__)
|
||||
|
||||
#define ck_free(_p1) \
|
||||
TRK_ck_free(_p1, __FILE__, __FUNCTION__, __LINE__)
|
||||
|
||||
#endif /* ^!DEBUG_BUILD */
|
||||
|
||||
#define alloc_printf(_str...) ({ \
|
||||
u8* _tmp; \
|
||||
s32 _len = snprintf(NULL, 0, _str); \
|
||||
if (_len < 0) FATAL("Whoa, snprintf() fails?!"); \
|
||||
_tmp = ck_alloc(_len + 1); \
|
||||
snprintf((char*)_tmp, _len + 1, _str); \
|
||||
_tmp; \
|
||||
})
|
||||
|
||||
#endif /* ! _HAVE_ALLOC_INL_H */
|
||||
106
docker/p0f/api.c
Normal file
106
docker/p0f/api.c
Normal file
|
|
@ -0,0 +1,106 @@
|
|||
/*
|
||||
p0f - API query code
|
||||
--------------------
|
||||
|
||||
Copyright (C) 2012 by Michal Zalewski <lcamtuf@coredump.cx>
|
||||
|
||||
Distributed under the terms and conditions of GNU LGPL.
|
||||
|
||||
*/
|
||||
|
||||
#define _FROM_API
|
||||
|
||||
#include <stdio.h>
|
||||
#include <stdlib.h>
|
||||
#include <unistd.h>
|
||||
|
||||
#include "types.h"
|
||||
#include "config.h"
|
||||
#include "debug.h"
|
||||
#include "alloc-inl.h"
|
||||
#include "p0f.h"
|
||||
#include "api.h"
|
||||
#include "process.h"
|
||||
#include "readfp.h"
|
||||
|
||||
/* Process API queries. */
|
||||
|
||||
void handle_query(struct p0f_api_query* q, struct p0f_api_response* r) {
|
||||
|
||||
struct host_data* h;
|
||||
|
||||
memset(r, 0, sizeof(struct p0f_api_response));
|
||||
|
||||
r->magic = P0F_RESP_MAGIC;
|
||||
|
||||
if (q->magic != P0F_QUERY_MAGIC) {
|
||||
|
||||
WARN("Query with bad magic (0x%x).", q->magic);
|
||||
|
||||
r->status = P0F_STATUS_BADQUERY;
|
||||
|
||||
return;
|
||||
|
||||
}
|
||||
|
||||
switch (q->addr_type) {
|
||||
|
||||
case P0F_ADDR_IPV4:
|
||||
case P0F_ADDR_IPV6:
|
||||
h = lookup_host(q->addr, q->addr_type);
|
||||
break;
|
||||
|
||||
default:
|
||||
|
||||
WARN("Query with unknown address type %u.\n", q->addr_type);
|
||||
r->status = P0F_STATUS_BADQUERY;
|
||||
return;
|
||||
|
||||
}
|
||||
|
||||
if (!h) {
|
||||
r->status = P0F_STATUS_NOMATCH;
|
||||
return;
|
||||
}
|
||||
|
||||
r->status = P0F_STATUS_OK;
|
||||
r->first_seen = h->first_seen;
|
||||
r->last_seen = h->last_seen;
|
||||
r->total_conn = h->total_conn;
|
||||
|
||||
if (h->last_name_id != -1) {
|
||||
|
||||
strncpy((char*)r->os_name, (char*)fp_os_names[h->last_name_id],
|
||||
P0F_STR_MAX + 1);
|
||||
|
||||
if (h->last_flavor)
|
||||
strncpy((char*)r->os_flavor, (char*)h->last_flavor, P0F_STR_MAX + 1);
|
||||
|
||||
}
|
||||
|
||||
if (h->http_name_id != -1) {
|
||||
|
||||
strncpy((char*)r->http_name, (char*)fp_os_names[h->http_name_id],
|
||||
P0F_STR_MAX + 1);
|
||||
|
||||
if (h->http_flavor)
|
||||
strncpy((char*)r->http_flavor, (char*)h->http_flavor, P0F_STR_MAX + 1);
|
||||
|
||||
}
|
||||
|
||||
if (h->link_type)
|
||||
strncpy((char*)r->link_type, (char*)h->link_type, P0F_STR_MAX + 1);
|
||||
|
||||
if (h->language)
|
||||
strncpy((char*)r->language, (char*)h->language, P0F_STR_MAX + 1);
|
||||
|
||||
r->bad_sw = h->bad_sw;
|
||||
r->last_nat = h->last_nat;
|
||||
r->last_chg = h->last_chg;
|
||||
r->up_mod_days = h->up_mod_days;
|
||||
r->distance = h->distance;
|
||||
r->os_match_q = h->last_quality;
|
||||
|
||||
if (h->last_up_min != -1) r->uptime_min = h->last_up_min;
|
||||
|
||||
}
|
||||
79
docker/p0f/api.h
Normal file
79
docker/p0f/api.h
Normal file
|
|
@ -0,0 +1,79 @@
|
|||
/*
|
||||
p0f - API query code
|
||||
--------------------
|
||||
|
||||
Copyright (C) 2012 by Michal Zalewski <lcamtuf@coredump.cx>
|
||||
|
||||
Distributed under the terms and conditions of GNU LGPL.
|
||||
|
||||
*/
|
||||
|
||||
#ifndef _HAVE_API_H
|
||||
#define _HAVE_API_H
|
||||
|
||||
#include "types.h"
|
||||
|
||||
#define P0F_QUERY_MAGIC 0x50304601
|
||||
#define P0F_RESP_MAGIC 0x50304602
|
||||
|
||||
#define P0F_STATUS_BADQUERY 0x00
|
||||
#define P0F_STATUS_OK 0x10
|
||||
#define P0F_STATUS_NOMATCH 0x20
|
||||
|
||||
#define P0F_ADDR_IPV4 0x04
|
||||
#define P0F_ADDR_IPV6 0x06
|
||||
|
||||
#define P0F_STR_MAX 31
|
||||
|
||||
#define P0F_MATCH_FUZZY 0x01
|
||||
#define P0F_MATCH_GENERIC 0x02
|
||||
|
||||
/* Keep these structures aligned to avoid architecture-specific padding. */
|
||||
|
||||
struct p0f_api_query {
|
||||
|
||||
u32 magic; /* Must be P0F_QUERY_MAGIC */
|
||||
u8 addr_type; /* P0F_ADDR_* */
|
||||
u8 addr[16]; /* IP address (big endian left align) */
|
||||
|
||||
} __attribute__((packed));
|
||||
|
||||
struct p0f_api_response {
|
||||
|
||||
u32 magic; /* Must be P0F_RESP_MAGIC */
|
||||
u32 status; /* P0F_STATUS_* */
|
||||
|
||||
u32 first_seen; /* First seen (unix time) */
|
||||
u32 last_seen; /* Last seen (unix time) */
|
||||
u32 total_conn; /* Total connections seen */
|
||||
|
||||
u32 uptime_min; /* Last uptime (minutes) */
|
||||
u32 up_mod_days; /* Uptime modulo (days) */
|
||||
|
||||
u32 last_nat; /* NAT / LB last detected (unix time) */
|
||||
u32 last_chg; /* OS chg last detected (unix time) */
|
||||
|
||||
s16 distance; /* System distance */
|
||||
|
||||
u8 bad_sw; /* Host is lying about U-A / Server */
|
||||
u8 os_match_q; /* Match quality */
|
||||
|
||||
u8 os_name[P0F_STR_MAX + 1]; /* Name of detected OS */
|
||||
u8 os_flavor[P0F_STR_MAX + 1]; /* Flavor of detected OS */
|
||||
|
||||
u8 http_name[P0F_STR_MAX + 1]; /* Name of detected HTTP app */
|
||||
u8 http_flavor[P0F_STR_MAX + 1]; /* Flavor of detected HTTP app */
|
||||
|
||||
u8 link_type[P0F_STR_MAX + 1]; /* Link type */
|
||||
|
||||
u8 language[P0F_STR_MAX + 1]; /* Language */
|
||||
|
||||
} __attribute__((packed));
|
||||
|
||||
#ifdef _FROM_P0F
|
||||
|
||||
void handle_query(struct p0f_api_query* q, struct p0f_api_response* r);
|
||||
|
||||
#endif /* _FROM_API */
|
||||
|
||||
#endif /* !_HAVE_API_H */
|
||||
357
docker/p0f/build.sh
Executable file
357
docker/p0f/build.sh
Executable file
|
|
@ -0,0 +1,357 @@
|
|||
#!/bin/bash
|
||||
#
|
||||
# p0f - build script
|
||||
# ------------------
|
||||
#
|
||||
# Copyright (C) 2012 by Michal Zalewski <lcamtuf@coredump.cx>
|
||||
#
|
||||
# Distributed under the terms and conditions of GNU LGPL.
|
||||
#
|
||||
|
||||
PROGNAME="p0f"
|
||||
VERSION="3.09b"
|
||||
|
||||
test "$CC" = "" && CC="gcc"
|
||||
|
||||
BASIC_CFLAGS="-Wall -Wno-format -I/usr/local/include/ \
|
||||
-I/opt/local/include/ -DVERSION=\"$VERSION\" $CFLAGS"
|
||||
|
||||
BASIC_LDFLAGS="-L/usr/local/lib/ -L/opt/local/lib $LDFLAGS"
|
||||
|
||||
USE_CFLAGS="-fstack-protector-all -fPIE -D_FORTIFY_SOURCE=2 -g -ggdb \
|
||||
$BASIC_CFLAGS"
|
||||
|
||||
USE_LDFLAGS="-Wl,-z,relro -pie $BASIC_LDFLAGS"
|
||||
|
||||
if [ "$OSTYPE" = "cygwin" ]; then
|
||||
USE_LIBS="-lwpcap $LIBS"
|
||||
elif [ "$OSTYPE" = "solaris" ]; then
|
||||
USE_LIBS="-lsocket -lnsl $LIBS"
|
||||
else
|
||||
USE_LIBS="-lpcap -ljansson $LIBS"
|
||||
fi
|
||||
|
||||
OBJFILES="api.c process.c fp_tcp.c fp_mtu.c fp_http.c readfp.c"
|
||||
|
||||
echo "Welcome to the build script for $PROGNAME $VERSION!"
|
||||
echo "Copyright (C) 2012 by Michal Zalewski <lcamtuf@coredump.cx>"
|
||||
echo
|
||||
|
||||
if [ "$#" -gt "1" ]; then
|
||||
|
||||
echo "[-] Please specify one build target at a time."
|
||||
exit 1
|
||||
|
||||
fi
|
||||
|
||||
if [ "$1" = "clean" -o "$1" = "publish" ]; then
|
||||
|
||||
echo "[*] Cleaning up build environment..."
|
||||
rm -f -- "$PROGNAME" *.exe *.o a.out *~ core core.[1-9][0-9]* *.stackdump COMPILER-WARNINGS 2>/dev/null
|
||||
|
||||
( cd tools && make clean ) &>/dev/null
|
||||
|
||||
if [ "$1" = "publish" ]; then
|
||||
|
||||
if [ ! "`basename -- \"$PWD\"`" = "$PROGNAME" ]; then
|
||||
echo "[-] Invalid working directory."
|
||||
exit 1
|
||||
fi
|
||||
|
||||
if [ ! "$HOSTNAME" = "raccoon" ]; then
|
||||
echo "[-] You are not my real dad!"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
TARGET="/var/www/lcamtuf/p0f3/$PROGNAME-devel.tgz"
|
||||
|
||||
echo "[*] Creating $TARGET..."
|
||||
|
||||
cd ..
|
||||
rm -rf "$PROGNAME-$VERSION"
|
||||
cp -pr "$PROGNAME" "$PROGNAME-$VERSION"
|
||||
tar cfvz "$TARGET" "$PROGNAME-$VERSION"
|
||||
|
||||
fi
|
||||
|
||||
echo "[+] All done!"
|
||||
|
||||
exit 0
|
||||
|
||||
elif [ "$1" = "all" -o "$1" = "" ]; then
|
||||
|
||||
echo "[+] Configuring production build."
|
||||
BASIC_CFLAGS="$BASIC_CFLAGS -O3"
|
||||
USE_CFLAGS="$USE_CFLAGS -O3"
|
||||
|
||||
elif [ "$1" = "debug" ]; then
|
||||
|
||||
echo "[+] Configuring debug build."
|
||||
BASIC_CFLAGS="$BASIC_CFLAGS -DDEBUG_BUILD=1"
|
||||
USE_CFLAGS="$USE_CFLAGS -DDEBUG_BUILD=1"
|
||||
|
||||
else
|
||||
|
||||
echo "[-] Unrecognized build target '$1', sorry."
|
||||
exit 1
|
||||
|
||||
fi
|
||||
|
||||
rm -f COMPILER-WARNINGS 2>/dev/null
|
||||
|
||||
echo -n "[*] Checking for a sane build environment... "
|
||||
|
||||
if ls -ld ./ | grep -q '^d.......w'; then
|
||||
|
||||
echo "FAIL (bad permissions)"
|
||||
echo
|
||||
echo "Duuude, don't build stuff in world-writable directories."
|
||||
echo
|
||||
exit 1
|
||||
|
||||
fi
|
||||
|
||||
TMP=".build-$$"
|
||||
|
||||
rm -f "$TMP" 2>/dev/null
|
||||
|
||||
if [ -f "$TMP" ]; then
|
||||
|
||||
echo "FAIL (can't delete)"
|
||||
echo
|
||||
echo "Check directory permissions and try again."
|
||||
echo
|
||||
exit 1
|
||||
|
||||
fi
|
||||
|
||||
touch "$TMP" 2>/dev/null
|
||||
|
||||
if [ ! -f "$TMP" ]; then
|
||||
|
||||
echo "FAIL (can't create)"
|
||||
echo
|
||||
echo "Check directory permissions and try again."
|
||||
echo
|
||||
exit 1
|
||||
|
||||
fi
|
||||
|
||||
if [ ! -s "$PROGNAME.c" ]; then
|
||||
|
||||
echo "FAIL (no source)"
|
||||
echo
|
||||
echo "I'm no doctor, but I think the source code is missing from CWD."
|
||||
echo
|
||||
exit 1
|
||||
|
||||
fi
|
||||
|
||||
echo "OK"
|
||||
|
||||
echo -n "[*] Checking for working GCC... "
|
||||
|
||||
rm -f "$TMP" || exit 1
|
||||
|
||||
echo "int main() { return 0; }" >"$TMP.c" || exit 1
|
||||
$CC $BASIC_CFLAGS $BASIC_LDFLAGS "$TMP.c" -o "$TMP" &>"$TMP.log"
|
||||
|
||||
if [ ! -x "$TMP" ]; then
|
||||
|
||||
echo "FAIL"
|
||||
echo
|
||||
echo "Your compiler can't produce working binaries. You need a functioning install of"
|
||||
echo "GCC and libc (including development headers) to continue. If you have these,"
|
||||
echo "try setting CC, CFLAGS, and LDFLAGS appropriately."
|
||||
echo
|
||||
echo "Output from an attempt to execute GCC:"
|
||||
cat "$TMP.log" | head -10
|
||||
echo
|
||||
rm -f "$TMP" "$TMP.log" "$TMP.c"
|
||||
exit 1
|
||||
|
||||
fi
|
||||
|
||||
echo "OK"
|
||||
|
||||
echo -n "[*] Checking for *modern* GCC... "
|
||||
|
||||
rm -f "$TMP" "$TMP.c" "$TMP.log" || exit 1
|
||||
|
||||
echo "int main() { return 0; }" >"$TMP.c" || exit 1
|
||||
$CC $USE_CFLAGS $USE_LDFLAGS "$TMP.c" -o "$TMP" &>"$TMP.log"
|
||||
|
||||
if [ ! -x "$TMP" ]; then
|
||||
|
||||
echo "FAIL (but we can live with it)"
|
||||
USE_CFLAGS="$BASIC_CFLAGS"
|
||||
USE_LDFLAGS="$BASIC_LDFLAGS"
|
||||
|
||||
else
|
||||
|
||||
echo "OK"
|
||||
|
||||
fi
|
||||
|
||||
echo -n "[*] Checking if memory alignment is required... "
|
||||
|
||||
rm -f "$TMP" "$TMP.c" "$TMP.log" || exit 1
|
||||
|
||||
echo -e "#include \"types.h\"\nvolatile u8 tmp[6]; int main() { printf(\"%d\x5cn\", *(u32*)(tmp+1)); return 0; }" >"$TMP.c" || exit 1
|
||||
$CC $USE_CFLAGS $USE_LDFLAGS "$TMP.c" -o "$TMP" &>"$TMP.log"
|
||||
|
||||
if [ ! -x "$TMP" ]; then
|
||||
|
||||
echo "FAIL"
|
||||
echo
|
||||
echo "Well, something went horribly wrong, sorry. Here's the output from GCC:"
|
||||
echo
|
||||
cat "$TMP.log"
|
||||
echo
|
||||
echo "Sorry! You may want to ping <lcamtuf@coredump.cx> about this."
|
||||
echo
|
||||
rm -f "$TMP.log"
|
||||
exit 1
|
||||
|
||||
else
|
||||
|
||||
ulimit -c 0 &>/dev/null
|
||||
./"$TMP" &>/dev/null
|
||||
|
||||
if [ "$?" = "0" ]; then
|
||||
|
||||
echo "nope"
|
||||
|
||||
else
|
||||
|
||||
echo "yes"
|
||||
USE_CFLAGS="$USE_CFLAGS -DALIGN_ACCESS=1"
|
||||
|
||||
fi
|
||||
|
||||
fi
|
||||
|
||||
|
||||
echo -n "[*] Checking for working libpcap... "
|
||||
|
||||
rm -f "$TMP" "$TMP.c" "$TMP.log" || exit 1
|
||||
|
||||
echo -e "#include <pcap.h>\nint main() { char i[PCAP_ERRBUF_SIZE]; pcap_lookupdev(i); return 0; }" >"$TMP.c" || exit 1
|
||||
$CC $USE_CFLAGS $USE_LDFLAGS "$TMP.c" -o "$TMP" $USE_LIBS &>"$TMP.log"
|
||||
|
||||
if [ ! -x "$TMP" ]; then
|
||||
echo "FAIL"
|
||||
echo
|
||||
|
||||
if [ "$OSTYPE" = "cygwin" ]; then
|
||||
|
||||
echo "You need a functioning install of winpcap. Download both of those:"
|
||||
echo
|
||||
echo " Main library : http://www.winpcap.org/install/default.htm"
|
||||
echo " Developer tools : http://www.winpcap.org/devel.htm"
|
||||
echo
|
||||
echo "Under cygwin, copy the contents of wpdpack/include to /usr/include/, and"
|
||||
echo "wpdpack/lib to /lib/. At that point, you should be able to build p0f."
|
||||
echo
|
||||
|
||||
else
|
||||
|
||||
echo "You need a functioning installation of libpcap (including development headers)."
|
||||
echo "You can download it from here:"
|
||||
echo
|
||||
echo " http://www.tcpdump.org/#latest-release"
|
||||
echo
|
||||
|
||||
fi
|
||||
|
||||
echo "If you have the library installed at an unorthodox location, try setting CFLAGS"
|
||||
echo "and LDFLAGS to point us in the right direction."
|
||||
echo
|
||||
echo "Output from an attempt to compile sample program:"
|
||||
cat "$TMP.log" | head -10
|
||||
echo
|
||||
rm -f "$TMP" "$TMP.log" "$TMP.c"
|
||||
exit 1
|
||||
|
||||
fi
|
||||
|
||||
echo "OK"
|
||||
|
||||
echo -n "[*] Checking for working BPF... "
|
||||
|
||||
rm -f "$TMP" "$TMP.c" "$TMP.log" || exit 1
|
||||
|
||||
echo -e "#include <pcap.h>\n#include <pcap-bpf.h>\nint main() { return 0; }" >"$TMP.c" || exit 1
|
||||
$CC $USE_CFLAGS $USE_LDFLAGS "$TMP.c" -o "$TMP" $USE_LIBS &>"$TMP.log"
|
||||
|
||||
if [ ! -x "$TMP" ]; then
|
||||
|
||||
rm -f "$TMP" "$TMP.c" "$TMP.log" || exit 1
|
||||
|
||||
echo -e "#include <pcap.h>\n#include <net/bpf.h>\nint main() { return 0; }" >"$TMP.c" || exit 1
|
||||
$CC $USE_CFLAGS $USE_LDFLAGS "$TMP.c" -o "$TMP" $USE_LIBS &>"$TMP.log"
|
||||
|
||||
if [ ! -x "$TMP" ]; then
|
||||
echo "FAIL"
|
||||
echo
|
||||
echo "Could not find a working version of pcap-bpf.h or net/bpf.h on your system."
|
||||
echo "If it's available in a non-standard directory, set CFLAGS accordingly; if it"
|
||||
echo "lives under a different name, you may need to edit the source and recompile."
|
||||
echo
|
||||
|
||||
rm -f "$TMP" "$TMP.log" "$TMP.c"
|
||||
exit 1
|
||||
|
||||
fi
|
||||
|
||||
USE_CFLAGS="$USE_CFLAGS -DNET_BPF=1"
|
||||
|
||||
fi
|
||||
|
||||
echo "OK"
|
||||
|
||||
rm -f "$TMP" "$TMP.log" "$TMP.c" || exit 1
|
||||
|
||||
echo "[+] Okay, you seem to be good to go. Fingers crossed!"
|
||||
|
||||
echo -n "[*] Compiling $PROGNAME... "
|
||||
|
||||
rm -f "$PROGNAME" || exit 1
|
||||
|
||||
$CC $USE_CFLAGS $USE_LDFLAGS "$PROGNAME.c" $OBJFILES -o "$PROGNAME" $USE_LIBS &>"$TMP.log"
|
||||
|
||||
if [ ! -x "$PROGNAME" ]; then
|
||||
|
||||
echo "FAIL"
|
||||
echo
|
||||
echo "Well, something went horribly wrong, sorry. Here's the output from GCC:"
|
||||
echo
|
||||
cat "$TMP.log"
|
||||
echo
|
||||
echo "Sorry! You may want to ping <lcamtuf@coredump.cx> about this."
|
||||
echo
|
||||
rm -f "$TMP.log"
|
||||
exit 1
|
||||
|
||||
fi
|
||||
|
||||
if [ -s "$TMP.log" ]; then
|
||||
|
||||
echo "OK (see COMPILER-WARNINGS)"
|
||||
mv "$TMP.log" COMPILER-WARNINGS
|
||||
|
||||
test "$1" = "debug" && cat COMPILER-WARNINGS
|
||||
|
||||
else
|
||||
|
||||
rm -f "$TMP.log"
|
||||
echo "OK"
|
||||
|
||||
fi
|
||||
|
||||
echo
|
||||
echo "Well, that's it. Be sure to review README. If you run into any problems, you"
|
||||
echo "can reach the author at <lcamtuf@coredump.cx>."
|
||||
echo
|
||||
|
||||
exit 0
|
||||
271
docker/p0f/config.h
Normal file
271
docker/p0f/config.h
Normal file
|
|
@ -0,0 +1,271 @@
|
|||
/*
|
||||
p0f - vaguely configurable bits
|
||||
-------------------------------
|
||||
|
||||
Copyright (C) 2012 by Michal Zalewski <lcamtuf@coredump.cx>
|
||||
|
||||
Distributed under the terms and conditions of GNU LGPL.
|
||||
|
||||
*/
|
||||
|
||||
#ifndef _HAVE_CONFIG_H
|
||||
#define _HAVE_CONFIG_H
|
||||
|
||||
#include "types.h"
|
||||
|
||||
/********************************************
|
||||
* Things you may reasonably want to change *
|
||||
********************************************/
|
||||
|
||||
/* Default location of p0f.fp: */
|
||||
|
||||
#ifndef FP_FILE
|
||||
# define FP_FILE "p0f.fp"
|
||||
#endif /* !FP_FILE */
|
||||
|
||||
/* Initial permissions on log files: */
|
||||
|
||||
#ifndef LOG_MODE
|
||||
# define LOG_MODE 0600
|
||||
#endif /* !LOG_MODE */
|
||||
|
||||
/* Initial permissions on API sockets: */
|
||||
|
||||
#ifndef API_MODE
|
||||
# define API_MODE 0666
|
||||
#endif /* !API_MODE */
|
||||
|
||||
/* Default connection and host cache sizes (adjustable via -m): */
|
||||
|
||||
#ifndef MAX_HOSTS
|
||||
# define MAX_CONN 1000
|
||||
# define MAX_HOSTS 10000
|
||||
#endif /* !MAX_HOSTS */
|
||||
|
||||
/* Default connection and host time limits (adjustable via -t): */
|
||||
|
||||
#ifndef HOST_IDLE_LIMIT
|
||||
# define CONN_MAX_AGE 30 /* seconds */
|
||||
# define HOST_IDLE_LIMIT 120 /* minutes */
|
||||
#endif /* !HOST_IDLE_LIMIT */
|
||||
|
||||
/* Default number of API connections permitted (adjustable via -c): */
|
||||
|
||||
#ifndef API_MAX_CONN
|
||||
# define API_MAX_CONN 20
|
||||
#endif /* !API_MAX_CONN */
|
||||
|
||||
/* Maximum TTL distance for non-fuzzy signature matching: */
|
||||
|
||||
#ifndef MAX_DIST
|
||||
# define MAX_DIST 35
|
||||
#endif /* !MAX_DIST */
|
||||
|
||||
/* Detect use-after-free, at the expense of some performance cost: */
|
||||
|
||||
#define CHECK_UAF 1
|
||||
|
||||
/************************
|
||||
* Really obscure stuff *
|
||||
************************/
|
||||
|
||||
/* Maximum allocator request size (keep well under INT_MAX): */
|
||||
|
||||
#define MAX_ALLOC 0x40000000
|
||||
|
||||
/* Percentage of host entries / flows to prune when limits exceeded: */
|
||||
|
||||
#define KILL_PERCENT 10
|
||||
|
||||
/* PCAP snapshot length: */
|
||||
|
||||
#define SNAPLEN 65535
|
||||
|
||||
/* Maximum request, response size to keep per flow: */
|
||||
|
||||
#define MAX_FLOW_DATA 8192
|
||||
|
||||
/* Maximum number of TCP options we will process (< 256): */
|
||||
|
||||
#define MAX_TCP_OPT 24
|
||||
|
||||
/* Minimum and maximum frequency for timestamp clock (Hz). Note that RFC
|
||||
1323 permits 1 - 1000 Hz . At 1000 Hz, the 32-bit counter overflows
|
||||
after about 50 days. */
|
||||
|
||||
#define MIN_TSCALE 0.7
|
||||
#define MAX_TSCALE 1500
|
||||
|
||||
/* Minimum and maximum interval (ms) for measuring timestamp progrssion. This
|
||||
is used to make sure the timestamps are fresh enough to be of any value,
|
||||
and that the measurement is not affected by network performance too
|
||||
severely. */
|
||||
|
||||
#define MIN_TWAIT 25
|
||||
#define MAX_TWAIT (1000 * 60 * 10)
|
||||
|
||||
/* Time window in which to tolerate timestamps going back slightly or
|
||||
otherwise misbehaving during NAT checks (ms): */
|
||||
|
||||
#define TSTAMP_GRACE 100
|
||||
|
||||
/* Maximum interval between packets used for TS-based NAT checks (ms): */
|
||||
|
||||
#define MAX_NAT_TS (1000 * 60 * 60 * 24)
|
||||
|
||||
/* Minimum port drop to serve as a NAT detection signal: */
|
||||
|
||||
#define MIN_PORT_DROP 64
|
||||
|
||||
/* Threshold before letting NAT detection make a big deal out of TTL change
|
||||
for remote hosts (this is to account for peering changes): */
|
||||
|
||||
#define SMALL_TTL_CHG 2
|
||||
|
||||
/* The distance up to which the system is considered to be local, and therefore
|
||||
the SMALL_TTL_CHG threshold should not be taken account: */
|
||||
|
||||
#define LOCAL_TTL_LIMIT 5
|
||||
|
||||
/* The distance past which the system is considered to be really distant,
|
||||
and therefore, changes within SMALL_TTL_CHG should be completely ignored: */
|
||||
|
||||
#define NEAR_TTL_LIMIT 9
|
||||
|
||||
/* Number of packet scores to keep for NAT detection (< 256): */
|
||||
|
||||
#define NAT_SCORES 32
|
||||
|
||||
/* Number of hash buckets for p0f.fp signatures: */
|
||||
|
||||
#define SIG_BUCKETS 64
|
||||
|
||||
/* Number of hash buckets for active connections: */
|
||||
|
||||
#define FLOW_BUCKETS 256
|
||||
|
||||
/* Number of hash buckets for host data: */
|
||||
|
||||
#define HOST_BUCKETS 1024
|
||||
|
||||
/* Cache expiration interval (every n packets received): */
|
||||
|
||||
#define EXPIRE_INTERVAL 50
|
||||
|
||||
/* Non-alphanumeric chars to permit in OS names. This is to allow 'sys' syntax
|
||||
to be used unambiguously, yet allow some freedom: */
|
||||
|
||||
#define NAME_CHARS " ./-_!?()"
|
||||
|
||||
/* Special window size and MSS used by p0f-sendsyn, and detected by p0f: */
|
||||
|
||||
#define SPECIAL_MSS 1331
|
||||
#define SPECIAL_WIN 1337
|
||||
|
||||
/* Maximum length of an HTTP URL line we're willing to entertain. The same
|
||||
limit is also used for the first line of a response: */
|
||||
|
||||
#define HTTP_MAX_URL 1024
|
||||
|
||||
/* Maximum number of HTTP headers: */
|
||||
|
||||
#define HTTP_MAX_HDRS 32
|
||||
|
||||
/* Maximum length of a header name: */
|
||||
|
||||
#define HTTP_MAX_HDR_NAME 32
|
||||
|
||||
/* Maximum length of a header value: */
|
||||
|
||||
#define HTTP_MAX_HDR_VAL 1024
|
||||
|
||||
/* Maximum length of a header value for display purposes: */
|
||||
|
||||
#define HTTP_MAX_SHOW 200
|
||||
|
||||
/* Maximum HTTP 'Date' progression jitter to overlook (s): */
|
||||
|
||||
#define HTTP_MAX_DATE_DIFF 10
|
||||
|
||||
#ifdef _FROM_FP_HTTP
|
||||
|
||||
#include "fp_http.h"
|
||||
|
||||
/* Headers that should be tagged as optional by the HTTP fingerprinter in any
|
||||
generated signatures: */
|
||||
|
||||
static struct http_id req_optional[] = {
|
||||
{ "Cookie", 0 },
|
||||
{ "Referer", 0 },
|
||||
{ "Origin", 0 },
|
||||
{ "Range", 0 },
|
||||
{ "If-Modified-Since", 0 },
|
||||
{ "If-None-Match", 0 },
|
||||
{ "Via", 0 },
|
||||
{ "X-Forwarded-For", 0 },
|
||||
{ "Authorization", 0 },
|
||||
{ "Proxy-Authorization", 0 },
|
||||
{ "Cache-Control", 0 },
|
||||
{ 0, 0 }
|
||||
};
|
||||
|
||||
static struct http_id resp_optional[] = {
|
||||
{ "Set-Cookie", 0 },
|
||||
{ "Last-Modified", 0 },
|
||||
{ "ETag", 0 },
|
||||
{ "Content-Length", 0 },
|
||||
{ "Content-Disposition", 0 },
|
||||
{ "Cache-Control", 0 },
|
||||
{ "Expires", 0 },
|
||||
{ "Pragma", 0 },
|
||||
{ "Location", 0 },
|
||||
{ "Refresh", 0 },
|
||||
{ "Content-Range", 0 },
|
||||
{ "Vary", 0 },
|
||||
{ 0, 0 }
|
||||
};
|
||||
|
||||
/* Common headers that are expected to be present at all times, and deserve
|
||||
a special mention if absent in a signature: */
|
||||
|
||||
static struct http_id req_common[] = {
|
||||
{ "Host", 0 },
|
||||
{ "User-Agent", 0 },
|
||||
{ "Connection", 0 },
|
||||
{ "Accept", 0 },
|
||||
{ "Accept-Encoding", 0 },
|
||||
{ "Accept-Language", 0 },
|
||||
{ "Accept-Charset", 0 },
|
||||
{ "Keep-Alive", 0 },
|
||||
{ 0, 0 }
|
||||
};
|
||||
|
||||
static struct http_id resp_common[] = {
|
||||
{ "Content-Type", 0 },
|
||||
{ "Connection", 0 },
|
||||
{ "Keep-Alive", 0 },
|
||||
{ "Accept-Ranges", 0 },
|
||||
{ "Date", 0 },
|
||||
{ 0, 0 }
|
||||
};
|
||||
|
||||
/* Headers for which values change depending on the context, and therefore
|
||||
should not be included in proposed signatures. This is on top of the
|
||||
"optional" header lists, which already implies skipping the value. */
|
||||
|
||||
static struct http_id req_skipval[] = {
|
||||
{ "Host", 0 },
|
||||
{ "User-Agent", 0 },
|
||||
{ 0, 0 }
|
||||
};
|
||||
|
||||
static struct http_id resp_skipval[] = {
|
||||
{ "Date", 0 },
|
||||
{ "Content-Type", 0 },
|
||||
{ "Server", 0 },
|
||||
{ 0, 0 }
|
||||
};
|
||||
|
||||
#endif /* _FROM_FP_HTTP */
|
||||
|
||||
#endif /* ! _HAVE_CONFIG_H */
|
||||
54
docker/p0f/debug.h
Normal file
54
docker/p0f/debug.h
Normal file
|
|
@ -0,0 +1,54 @@
|
|||
/*
|
||||
p0f - debug / error handling macros
|
||||
-----------------------------------
|
||||
|
||||
Copyright (C) 2012 by Michal Zalewski <lcamtuf@coredump.cx>
|
||||
|
||||
Distributed under the terms and conditions of GNU LGPL.
|
||||
|
||||
*/
|
||||
|
||||
#ifndef _HAVE_DEBUG_H
|
||||
#define _HAVE_DEBUG_H
|
||||
|
||||
#include "types.h"
|
||||
#include "config.h"
|
||||
|
||||
#ifdef DEBUG_BUILD
|
||||
# define DEBUG(x...) fprintf(stderr, x)
|
||||
#else
|
||||
# define DEBUG(x...) do {} while (0)
|
||||
#endif /* ^DEBUG_BUILD */
|
||||
|
||||
#define ERRORF(x...) fprintf(stderr, x)
|
||||
#define SAYF(x...) printf(x)
|
||||
|
||||
#define WARN(x...) do { \
|
||||
ERRORF("[!] WARNING: " x); \
|
||||
ERRORF("\n"); \
|
||||
} while (0)
|
||||
|
||||
#define FATAL(x...) do { \
|
||||
ERRORF("[-] PROGRAM ABORT : " x); \
|
||||
ERRORF("\n Location : %s(), %s:%u\n\n", \
|
||||
__FUNCTION__, __FILE__, __LINE__); \
|
||||
exit(1); \
|
||||
} while (0)
|
||||
|
||||
#define ABORT(x...) do { \
|
||||
ERRORF("[-] PROGRAM ABORT : " x); \
|
||||
ERRORF("\n Location : %s(), %s:%u\n\n", \
|
||||
__FUNCTION__, __FILE__, __LINE__); \
|
||||
abort(); \
|
||||
} while (0)
|
||||
|
||||
#define PFATAL(x...) do { \
|
||||
ERRORF("[-] SYSTEM ERROR : " x); \
|
||||
ERRORF("\n Location : %s(), %s:%u\n", \
|
||||
__FUNCTION__, __FILE__, __LINE__); \
|
||||
perror(" OS message "); \
|
||||
ERRORF("\n"); \
|
||||
exit(1); \
|
||||
} while (0)
|
||||
|
||||
#endif /* ! _HAVE_DEBUG_H */
|
||||
498
docker/p0f/docs/COPYING
Normal file
498
docker/p0f/docs/COPYING
Normal file
|
|
@ -0,0 +1,498 @@
|
|||
|
||||
GNU LESSER GENERAL PUBLIC LICENSE
|
||||
Version 2.1, February 1999
|
||||
|
||||
Copyright (C) 1991, 1999 Free Software Foundation, Inc.
|
||||
59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
||||
Everyone is permitted to copy and distribute verbatim copies
|
||||
of this license document, but changing it is not allowed.
|
||||
|
||||
Preamble
|
||||
|
||||
The licenses for most software are designed to take away your
|
||||
freedom to share and change it. By contrast, the GNU General Public
|
||||
Licenses are intended to guarantee your freedom to share and change
|
||||
free software--to make sure the software is free for all its users.
|
||||
|
||||
This license, the Lesser General Public License, applies to some
|
||||
specially designated software packages--typically libraries--of the
|
||||
Free Software Foundation and other authors who decide to use it. You
|
||||
can use it too, but we suggest you first think carefully about whether
|
||||
this license or the ordinary General Public License is the better
|
||||
strategy to use in any particular case, based on the explanations below.
|
||||
|
||||
When we speak of free software, we are referring to freedom of use,
|
||||
not price. Our General Public Licenses are designed to make sure that
|
||||
you have the freedom to distribute copies of free software (and charge
|
||||
for this service if you wish); that you receive source code or can get
|
||||
it if you want it; that you can change the software and use pieces of
|
||||
it in new free programs; and that you are informed that you can do
|
||||
these things.
|
||||
|
||||
To protect your rights, we need to make restrictions that forbid
|
||||
distributors to deny you these rights or to ask you to surrender these
|
||||
rights. These restrictions translate to certain responsibilities for
|
||||
you if you distribute copies of the library or if you modify it.
|
||||
|
||||
For example, if you distribute copies of the library, whether gratis
|
||||
or for a fee, you must give the recipients all the rights that we gave
|
||||
you. You must make sure that they, too, receive or can get the source
|
||||
code. If you link other code with the library, you must provide
|
||||
complete object files to the recipients, so that they can relink them
|
||||
with the library after making changes to the library and recompiling
|
||||
it. And you must show them these terms so they know their rights.
|
||||
|
||||
We protect your rights with a two-step method: (1) we copyright the
|
||||
library, and (2) we offer you this license, which gives you legal
|
||||
permission to copy, distribute and/or modify the library.
|
||||
|
||||
To protect each distributor, we want to make it very clear that
|
||||
there is no warranty for the free library. Also, if the library is
|
||||
modified by someone else and passed on, the recipients should know
|
||||
that what they have is not the original version, so that the original
|
||||
author's reputation will not be affected by problems that might be
|
||||
introduced by others.
|
||||
|
||||
Finally, software patents pose a constant threat to the existence of
|
||||
any free program. We wish to make sure that a company cannot
|
||||
effectively restrict the users of a free program by obtaining a
|
||||
restrictive license from a patent holder. Therefore, we insist that
|
||||
any patent license obtained for a version of the library must be
|
||||
consistent with the full freedom of use specified in this license.
|
||||
|
||||
Most GNU software, including some libraries, is covered by the
|
||||
ordinary GNU General Public License. This license, the GNU Lesser
|
||||
General Public License, applies to certain designated libraries, and
|
||||
is quite different from the ordinary General Public License. We use
|
||||
this license for certain libraries in order to permit linking those
|
||||
libraries into non-free programs.
|
||||
|
||||
When a program is linked with a library, whether statically or using
|
||||
a shared library, the combination of the two is legally speaking a
|
||||
combined work, a derivative of the original library. The ordinary
|
||||
General Public License therefore permits such linking only if the
|
||||
entire combination fits its criteria of freedom. The Lesser General
|
||||
Public License permits more lax criteria for linking other code with
|
||||
the library.
|
||||
|
||||
We call this license the "Lesser" General Public License because it
|
||||
does Less to protect the user's freedom than the ordinary General
|
||||
Public License. It also provides other free software developers Less
|
||||
of an advantage over competing non-free programs. These disadvantages
|
||||
are the reason we use the ordinary General Public License for many
|
||||
libraries. However, the Lesser license provides advantages in certain
|
||||
special circumstances.
|
||||
|
||||
For example, on rare occasions, there may be a special need to
|
||||
encourage the widest possible use of a certain library, so that it becomes
|
||||
a de-facto standard. To achieve this, non-free programs must be
|
||||
allowed to use the library. A more frequent case is that a free
|
||||
library does the same job as widely used non-free libraries. In this
|
||||
case, there is little to gain by limiting the free library to free
|
||||
software only, so we use the Lesser General Public License.
|
||||
|
||||
In other cases, permission to use a particular library in non-free
|
||||
programs enables a greater number of people to use a large body of
|
||||
free software. For example, permission to use the GNU C Library in
|
||||
non-free programs enables many more people to use the whole GNU
|
||||
operating system, as well as its variant, the GNU/Linux operating
|
||||
system.
|
||||
|
||||
Although the Lesser General Public License is Less protective of the
|
||||
users' freedom, it does ensure that the user of a program that is
|
||||
linked with the Library has the freedom and the wherewithal to run
|
||||
that program using a modified version of the Library.
|
||||
|
||||
The precise terms and conditions for copying, distribution and
|
||||
modification follow. Pay close attention to the difference between a
|
||||
"work based on the library" and a "work that uses the library". The
|
||||
former contains code derived from the library, whereas the latter must
|
||||
be combined with the library in order to run.
|
||||
|
||||
GNU LESSER GENERAL PUBLIC LICENSE
|
||||
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
|
||||
|
||||
0. This License Agreement applies to any software library or other
|
||||
program which contains a notice placed by the copyright holder or
|
||||
other authorized party saying it may be distributed under the terms of
|
||||
this Lesser General Public License (also called "this License").
|
||||
Each licensee is addressed as "you".
|
||||
|
||||
A "library" means a collection of software functions and/or data
|
||||
prepared so as to be conveniently linked with application programs
|
||||
(which use some of those functions and data) to form executables.
|
||||
|
||||
The "Library", below, refers to any such software library or work
|
||||
which has been distributed under these terms. A "work based on the
|
||||
Library" means either the Library or any derivative work under
|
||||
copyright law: that is to say, a work containing the Library or a
|
||||
portion of it, either verbatim or with modifications and/or translated
|
||||
straightforwardly into another language. (Hereinafter, translation is
|
||||
included without limitation in the term "modification".)
|
||||
|
||||
"Source code" for a work means the preferred form of the work for
|
||||
making modifications to it. For a library, complete source code means
|
||||
all the source code for all modules it contains, plus any associated
|
||||
interface definition files, plus the scripts used to control compilation
|
||||
and installation of the library.
|
||||
|
||||
Activities other than copying, distribution and modification are not
|
||||
covered by this License; they are outside its scope. The act of
|
||||
running a program using the Library is not restricted, and output from
|
||||
such a program is covered only if its contents constitute a work based
|
||||
on the Library (independent of the use of the Library in a tool for
|
||||
writing it). Whether that is true depends on what the Library does
|
||||
and what the program that uses the Library does.
|
||||
|
||||
1. You may copy and distribute verbatim copies of the Library's
|
||||
complete source code as you receive it, in any medium, provided that
|
||||
you conspicuously and appropriately publish on each copy an
|
||||
appropriate copyright notice and disclaimer of warranty; keep intact
|
||||
all the notices that refer to this License and to the absence of any
|
||||
warranty; and distribute a copy of this License along with the
|
||||
Library.
|
||||
|
||||
You may charge a fee for the physical act of transferring a copy,
|
||||
and you may at your option offer warranty protection in exchange for a
|
||||
fee.
|
||||
|
||||
2. You may modify your copy or copies of the Library or any portion
|
||||
of it, thus forming a work based on the Library, and copy and
|
||||
distribute such modifications or work under the terms of Section 1
|
||||
above, provided that you also meet all of these conditions:
|
||||
|
||||
a) The modified work must itself be a software library.
|
||||
|
||||
b) You must cause the files modified to carry prominent notices
|
||||
stating that you changed the files and the date of any change.
|
||||
|
||||
c) You must cause the whole of the work to be licensed at no
|
||||
charge to all third parties under the terms of this License.
|
||||
|
||||
d) If a facility in the modified Library refers to a function or a
|
||||
table of data to be supplied by an application program that uses
|
||||
the facility, other than as an argument passed when the facility
|
||||
is invoked, then you must make a good faith effort to ensure that,
|
||||
in the event an application does not supply such function or
|
||||
table, the facility still operates, and performs whatever part of
|
||||
its purpose remains meaningful.
|
||||
|
||||
(For example, a function in a library to compute square roots has
|
||||
a purpose that is entirely well-defined independent of the
|
||||
application. Therefore, Subsection 2d requires that any
|
||||
application-supplied function or table used by this function must
|
||||
be optional: if the application does not supply it, the square
|
||||
root function must still compute square roots.)
|
||||
|
||||
These requirements apply to the modified work as a whole. If
|
||||
identifiable sections of that work are not derived from the Library,
|
||||
and can be reasonably considered independent and separate works in
|
||||
themselves, then this License, and its terms, do not apply to those
|
||||
sections when you distribute them as separate works. But when you
|
||||
distribute the same sections as part of a whole which is a work based
|
||||
on the Library, the distribution of the whole must be on the terms of
|
||||
this License, whose permissions for other licensees extend to the
|
||||
entire whole, and thus to each and every part regardless of who wrote
|
||||
it.
|
||||
|
||||
Thus, it is not the intent of this section to claim rights or contest
|
||||
your rights to work written entirely by you; rather, the intent is to
|
||||
exercise the right to control the distribution of derivative or
|
||||
collective works based on the Library.
|
||||
|
||||
In addition, mere aggregation of another work not based on the Library
|
||||
with the Library (or with a work based on the Library) on a volume of
|
||||
a storage or distribution medium does not bring the other work under
|
||||
the scope of this License.
|
||||
|
||||
3. You may opt to apply the terms of the ordinary GNU General Public
|
||||
License instead of this License to a given copy of the Library. To do
|
||||
this, you must alter all the notices that refer to this License, so
|
||||
that they refer to the ordinary GNU General Public License, version 2,
|
||||
instead of to this License. (If a newer version than version 2 of the
|
||||
ordinary GNU General Public License has appeared, then you can specify
|
||||
that version instead if you wish.) Do not make any other change in
|
||||
these notices.
|
||||
|
||||
Once this change is made in a given copy, it is irreversible for
|
||||
that copy, so the ordinary GNU General Public License applies to all
|
||||
subsequent copies and derivative works made from that copy.
|
||||
|
||||
This option is useful when you wish to copy part of the code of
|
||||
the Library into a program that is not a library.
|
||||
|
||||
4. You may copy and distribute the Library (or a portion or
|
||||
derivative of it, under Section 2) in object code or executable form
|
||||
under the terms of Sections 1 and 2 above provided that you accompany
|
||||
it with the complete corresponding machine-readable source code, which
|
||||
must be distributed under the terms of Sections 1 and 2 above on a
|
||||
medium customarily used for software interchange.
|
||||
|
||||
If distribution of object code is made by offering access to copy
|
||||
from a designated place, then offering equivalent access to copy the
|
||||
source code from the same place satisfies the requirement to
|
||||
distribute the source code, even though third parties are not
|
||||
compelled to copy the source along with the object code.
|
||||
|
||||
5. A program that contains no derivative of any portion of the
|
||||
Library, but is designed to work with the Library by being compiled or
|
||||
linked with it, is called a "work that uses the Library". Such a
|
||||
work, in isolation, is not a derivative work of the Library, and
|
||||
therefore falls outside the scope of this License.
|
||||
|
||||
However, linking a "work that uses the Library" with the Library
|
||||
creates an executable that is a derivative of the Library (because it
|
||||
contains portions of the Library), rather than a "work that uses the
|
||||
library". The executable is therefore covered by this License.
|
||||
Section 6 states terms for distribution of such executables.
|
||||
|
||||
When a "work that uses the Library" uses material from a header file
|
||||
that is part of the Library, the object code for the work may be a
|
||||
derivative work of the Library even though the source code is not.
|
||||
Whether this is true is especially significant if the work can be
|
||||
linked without the Library, or if the work is itself a library. The
|
||||
threshold for this to be true is not precisely defined by law.
|
||||
|
||||
If such an object file uses only numerical parameters, data
|
||||
structure layouts and accessors, and small macros and small inline
|
||||
functions (ten lines or less in length), then the use of the object
|
||||
file is unrestricted, regardless of whether it is legally a derivative
|
||||
work. (Executables containing this object code plus portions of the
|
||||
Library will still fall under Section 6.)
|
||||
|
||||
Otherwise, if the work is a derivative of the Library, you may
|
||||
distribute the object code for the work under the terms of Section 6.
|
||||
Any executables containing that work also fall under Section 6,
|
||||
whether or not they are linked directly with the Library itself.
|
||||
|
||||
6. As an exception to the Sections above, you may also combine or
|
||||
link a "work that uses the Library" with the Library to produce a
|
||||
work containing portions of the Library, and distribute that work
|
||||
under terms of your choice, provided that the terms permit
|
||||
modification of the work for the customer's own use and reverse
|
||||
engineering for debugging such modifications.
|
||||
|
||||
You must give prominent notice with each copy of the work that the
|
||||
Library is used in it and that the Library and its use are covered by
|
||||
this License. You must supply a copy of this License. If the work
|
||||
during execution displays copyright notices, you must include the
|
||||
copyright notice for the Library among them, as well as a reference
|
||||
directing the user to the copy of this License. Also, you must do one
|
||||
of these things:
|
||||
|
||||
a) Accompany the work with the complete corresponding
|
||||
machine-readable source code for the Library including whatever
|
||||
changes were used in the work (which must be distributed under
|
||||
Sections 1 and 2 above); and, if the work is an executable linked
|
||||
with the Library, with the complete machine-readable "work that
|
||||
uses the Library", as object code and/or source code, so that the
|
||||
user can modify the Library and then relink to produce a modified
|
||||
executable containing the modified Library. (It is understood
|
||||
that the user who changes the contents of definitions files in the
|
||||
Library will not necessarily be able to recompile the application
|
||||
to use the modified definitions.)
|
||||
|
||||
b) Use a suitable shared library mechanism for linking with the
|
||||
Library. A suitable mechanism is one that (1) uses at run time a
|
||||
copy of the library already present on the user's computer system,
|
||||
rather than copying library functions into the executable, and (2)
|
||||
will operate properly with a modified version of the library, if
|
||||
the user installs one, as long as the modified version is
|
||||
interface-compatible with the version that the work was made with.
|
||||
|
||||
c) Accompany the work with a written offer, valid for at
|
||||
least three years, to give the same user the materials
|
||||
specified in Subsection 6a, above, for a charge no more
|
||||
than the cost of performing this distribution.
|
||||
|
||||
d) If distribution of the work is made by offering access to copy
|
||||
from a designated place, offer equivalent access to copy the above
|
||||
specified materials from the same place.
|
||||
|
||||
e) Verify that the user has already received a copy of these
|
||||
materials or that you have already sent this user a copy.
|
||||
|
||||
For an executable, the required form of the "work that uses the
|
||||
Library" must include any data and utility programs needed for
|
||||
reproducing the executable from it. However, as a special exception,
|
||||
the materials to be distributed need not include anything that is
|
||||
normally distributed (in either source or binary form) with the major
|
||||
components (compiler, kernel, and so on) of the operating system on
|
||||
which the executable runs, unless that component itself accompanies
|
||||
the executable.
|
||||
|
||||
It may happen that this requirement contradicts the license
|
||||
restrictions of other proprietary libraries that do not normally
|
||||
accompany the operating system. Such a contradiction means you cannot
|
||||
use both them and the Library together in an executable that you
|
||||
distribute.
|
||||
|
||||
7. You may place library facilities that are a work based on the
|
||||
Library side-by-side in a single library together with other library
|
||||
facilities not covered by this License, and distribute such a combined
|
||||
library, provided that the separate distribution of the work based on
|
||||
the Library and of the other library facilities is otherwise
|
||||
permitted, and provided that you do these two things:
|
||||
|
||||
a) Accompany the combined library with a copy of the same work
|
||||
based on the Library, uncombined with any other library
|
||||
facilities. This must be distributed under the terms of the
|
||||
Sections above.
|
||||
|
||||
b) Give prominent notice with the combined library of the fact
|
||||
that part of it is a work based on the Library, and explaining
|
||||
where to find the accompanying uncombined form of the same work.
|
||||
|
||||
8. You may not copy, modify, sublicense, link with, or distribute
|
||||
the Library except as expressly provided under this License. Any
|
||||
attempt otherwise to copy, modify, sublicense, link with, or
|
||||
distribute the Library is void, and will automatically terminate your
|
||||
rights under this License. However, parties who have received copies,
|
||||
or rights, from you under this License will not have their licenses
|
||||
terminated so long as such parties remain in full compliance.
|
||||
|
||||
9. You are not required to accept this License, since you have not
|
||||
signed it. However, nothing else grants you permission to modify or
|
||||
distribute the Library or its derivative works. These actions are
|
||||
prohibited by law if you do not accept this License. Therefore, by
|
||||
modifying or distributing the Library (or any work based on the
|
||||
Library), you indicate your acceptance of this License to do so, and
|
||||
all its terms and conditions for copying, distributing or modifying
|
||||
the Library or works based on it.
|
||||
|
||||
10. Each time you redistribute the Library (or any work based on the
|
||||
Library), the recipient automatically receives a license from the
|
||||
original licensor to copy, distribute, link with or modify the Library
|
||||
subject to these terms and conditions. You may not impose any further
|
||||
restrictions on the recipients' exercise of the rights granted herein.
|
||||
You are not responsible for enforcing compliance by third parties with
|
||||
this License.
|
||||
|
||||
11. If, as a consequence of a court judgment or allegation of patent
|
||||
infringement or for any other reason (not limited to patent issues),
|
||||
conditions are imposed on you (whether by court order, agreement or
|
||||
otherwise) that contradict the conditions of this License, they do not
|
||||
excuse you from the conditions of this License. If you cannot
|
||||
distribute so as to satisfy simultaneously your obligations under this
|
||||
License and any other pertinent obligations, then as a consequence you
|
||||
may not distribute the Library at all. For example, if a patent
|
||||
license would not permit royalty-free redistribution of the Library by
|
||||
all those who receive copies directly or indirectly through you, then
|
||||
the only way you could satisfy both it and this License would be to
|
||||
refrain entirely from distribution of the Library.
|
||||
|
||||
If any portion of this section is held invalid or unenforceable under any
|
||||
particular circumstance, the balance of the section is intended to apply,
|
||||
and the section as a whole is intended to apply in other circumstances.
|
||||
|
||||
It is not the purpose of this section to induce you to infringe any
|
||||
patents or other property right claims or to contest validity of any
|
||||
such claims; this section has the sole purpose of protecting the
|
||||
integrity of the free software distribution system which is
|
||||
implemented by public license practices. Many people have made
|
||||
generous contributions to the wide range of software distributed
|
||||
through that system in reliance on consistent application of that
|
||||
system; it is up to the author/donor to decide if he or she is willing
|
||||
to distribute software through any other system and a licensee cannot
|
||||
impose that choice.
|
||||
|
||||
This section is intended to make thoroughly clear what is believed to
|
||||
be a consequence of the rest of this License.
|
||||
|
||||
12. If the distribution and/or use of the Library is restricted in
|
||||
certain countries either by patents or by copyrighted interfaces, the
|
||||
original copyright holder who places the Library under this License may add
|
||||
an explicit geographical distribution limitation excluding those countries,
|
||||
so that distribution is permitted only in or among countries not thus
|
||||
excluded. In such case, this License incorporates the limitation as if
|
||||
written in the body of this License.
|
||||
|
||||
13. The Free Software Foundation may publish revised and/or new
|
||||
versions of the Lesser General Public License from time to time.
|
||||
Such new versions will be similar in spirit to the present version,
|
||||
but may differ in detail to address new problems or concerns.
|
||||
|
||||
Each version is given a distinguishing version number. If the Library
|
||||
specifies a version number of this License which applies to it and
|
||||
"any later version", you have the option of following the terms and
|
||||
conditions either of that version or of any later version published by
|
||||
the Free Software Foundation. If the Library does not specify a
|
||||
license version number, you may choose any version ever published by
|
||||
the Free Software Foundation.
|
||||
|
||||
14. If you wish to incorporate parts of the Library into other free
|
||||
programs whose distribution conditions are incompatible with these,
|
||||
write to the author to ask for permission. For software which is
|
||||
copyrighted by the Free Software Foundation, write to the Free
|
||||
Software Foundation; we sometimes make exceptions for this. Our
|
||||
decision will be guided by the two goals of preserving the free status
|
||||
of all derivatives of our free software and of promoting the sharing
|
||||
and reuse of software generally.
|
||||
|
||||
NO WARRANTY
|
||||
|
||||
15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO
|
||||
WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
|
||||
EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
|
||||
OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY
|
||||
KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
|
||||
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
||||
PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
|
||||
LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME
|
||||
THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
|
||||
|
||||
16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
|
||||
WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY
|
||||
AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU
|
||||
FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
|
||||
CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
|
||||
LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
|
||||
RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
|
||||
FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
|
||||
SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
|
||||
DAMAGES.
|
||||
|
||||
END OF TERMS AND CONDITIONS
|
||||
|
||||
How to Apply These Terms to Your New Libraries
|
||||
|
||||
If you develop a new library, and you want it to be of the greatest
|
||||
possible use to the public, we recommend making it free software that
|
||||
everyone can redistribute and change. You can do so by permitting
|
||||
redistribution under these terms (or, alternatively, under the terms of the
|
||||
ordinary General Public License).
|
||||
|
||||
To apply these terms, attach the following notices to the library. It is
|
||||
safest to attach them to the start of each source file to most effectively
|
||||
convey the exclusion of warranty; and each file should have at least the
|
||||
"copyright" line and a pointer to where the full notice is found.
|
||||
|
||||
<one line to give the library's name and a brief idea of what it does.>
|
||||
Copyright (C) <year> <name of author>
|
||||
|
||||
This library is free software; you can redistribute it and/or
|
||||
modify it under the terms of the GNU Lesser General Public
|
||||
License as published by the Free Software Foundation; either
|
||||
version 2 of the License, or (at your option) any later version.
|
||||
|
||||
This library is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
||||
Lesser General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU Lesser General Public
|
||||
License along with this library; if not, write to the Free Software
|
||||
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
||||
|
||||
Also add information on how to contact you by electronic and paper mail.
|
||||
|
||||
You should also get your employer (if you work as a programmer) or your
|
||||
school, if any, to sign a "copyright disclaimer" for the library, if
|
||||
necessary. Here is a sample; alter the names:
|
||||
|
||||
Yoyodyne, Inc., hereby disclaims all copyright interest in the
|
||||
library `Frob' (a library for tweaking knobs) written by James Random Hacker.
|
||||
|
||||
<signature of Ty Coon>, 1 April 1990
|
||||
Ty Coon, President of Vice
|
||||
|
||||
128
docker/p0f/docs/ChangeLog
Normal file
128
docker/p0f/docs/ChangeLog
Normal file
|
|
@ -0,0 +1,128 @@
|
|||
Version 3.09b:
|
||||
--------------
|
||||
|
||||
- Fixed a likely only cosmetic bug with a one-byte overread of the pcap
|
||||
packet buffer, which would cause an error under ASAN. Spotted by
|
||||
Xavid Pretzer.
|
||||
|
||||
- Added a new signature for Chrome.
|
||||
|
||||
- Updated another signature for Chrome.
|
||||
|
||||
Version 3.08b:
|
||||
--------------
|
||||
|
||||
- An awful fix for a packet loss bug (probably kernel or libpcap-related)
|
||||
with some VMs.
|
||||
|
||||
- Improvement to avoid warnings with -r.
|
||||
|
||||
Version 3.07b:
|
||||
--------------
|
||||
|
||||
Bug fixes:
|
||||
|
||||
- Improvement to API handling to avoid FATAL() on short API reads & writes.
|
||||
|
||||
- Minor bug fix to IP parsing in one of the companion utilities.
|
||||
|
||||
Improvements:
|
||||
|
||||
- New signatures.
|
||||
|
||||
Version 3.06b:
|
||||
--------------
|
||||
|
||||
Bug fixes:
|
||||
|
||||
- Made os_match_q actually functional in api.c (thanks to Anthony Howe).
|
||||
|
||||
- Fixed api.c struct packing issue (thanks to Tomoyuki Murakami).
|
||||
|
||||
- Improved logic around the vlan behavior (thanks to Anthony Howe).
|
||||
|
||||
Version 3.05b:
|
||||
--------------
|
||||
|
||||
Bug fixes:
|
||||
|
||||
- Cleaned up hash.h to avoid pointless OOB reads, alignment issues.
|
||||
|
||||
- Fixed divide-by-zero in MSS calculations
|
||||
|
||||
Version 3.04b:
|
||||
--------------
|
||||
|
||||
Bug fixes:
|
||||
|
||||
- Fixed a realloc bug (not normally triggered in p0f)
|
||||
|
||||
Version 3.03b:
|
||||
--------------
|
||||
|
||||
Bug fixes:
|
||||
|
||||
- Potential NULL ptr in p0f-client on some 64-bit systems.
|
||||
|
||||
Version 3.02b:
|
||||
--------------
|
||||
|
||||
Bug fixes:
|
||||
|
||||
- Cygwin compile issue fixed.
|
||||
|
||||
Improvements:
|
||||
|
||||
- New signatures.
|
||||
|
||||
Version 3.01b (2012-01-17):
|
||||
---------------------------
|
||||
|
||||
Bug fixes:
|
||||
|
||||
- 'Date' comparisons for server sigs now work as expected.
|
||||
|
||||
- Bad TS reading now allowed on initial SYN (improves uptime detection).
|
||||
|
||||
Improvements:
|
||||
|
||||
- New signatures.
|
||||
|
||||
- Solaris support (in theory).
|
||||
|
||||
Version 3.00b (2012-01-17):
|
||||
---------------------------
|
||||
|
||||
Bug fixes:
|
||||
|
||||
- Alignment-related SIGBUS non-x86 fixed.
|
||||
|
||||
- Cache expiration algorithm now works as expected.
|
||||
|
||||
- p0f -L no longer leads to NULL ptr when no interfaces visible.
|
||||
|
||||
- Greppable output format no longer mixes up cli and srv fields.
|
||||
|
||||
- Added '|' to banned characters in reported header values.
|
||||
|
||||
Improvements:
|
||||
|
||||
- Multiple new HTTP and TCP signatures.
|
||||
|
||||
- Improved MSS/MTU matching to account for peer MTU.
|
||||
|
||||
- New HTTP fingerprinting logic with optional headers (? prefix).
|
||||
|
||||
- Memory leak detection added (but nothing found).
|
||||
|
||||
- API now indicates the value of 'generic' / 'fuzzy' fields and several
|
||||
other parameters.
|
||||
|
||||
- General style improvements.
|
||||
|
||||
- Delay added to p0f-sendsyn to aid with packet ordering.
|
||||
|
||||
Version 3.00-rc0 (2012-01-10):
|
||||
------------------------------
|
||||
|
||||
- Initial public release, complete rewrite.
|
||||
916
docker/p0f/docs/README
Normal file
916
docker/p0f/docs/README
Normal file
|
|
@ -0,0 +1,916 @@
|
|||
=============================
|
||||
p0f v3: passive fingerprinter
|
||||
=============================
|
||||
|
||||
http://lcamtuf.coredump.cx/p0f3.shtml
|
||||
|
||||
Copyright (C) 2012 by Michal Zalewski <lcamtuf@coredump.cx>
|
||||
|
||||
|
||||
---------------
|
||||
1. What's this?
|
||||
---------------
|
||||
|
||||
P0f is a tool that utilizes an array of sophisticated, purely passive traffic
|
||||
fingerprinting mechanisms to identify the players behind any incidental TCP/IP
|
||||
communications (often as little as a single normal SYN) without interfering in
|
||||
any way.
|
||||
|
||||
Some of its capabilities include:
|
||||
|
||||
- Highly scalable and extremely fast identification of the operating system
|
||||
and software on both endpoints of a vanilla TCP connection - especially in
|
||||
settings where NMap probes are blocked, too slow, unreliable, or would
|
||||
simply set off alarms,
|
||||
|
||||
- Measurement of system uptime and network hookup, distance (including
|
||||
topology behind NAT or packet filters), and so on.
|
||||
|
||||
- Automated detection of connection sharing / NAT, load balancing, and
|
||||
application-level proxying setups.
|
||||
|
||||
- Detection of dishonest clients / servers that forge declarative statements
|
||||
such as X-Mailer or User-Agent.
|
||||
|
||||
The tool can be operated in the foreground or as a daemon, and offers a simple
|
||||
real-time API for third-party components that wish to obtain additional
|
||||
information about the actors they are talking to.
|
||||
|
||||
Common uses for p0f include reconnaissance during penetration tests; routine
|
||||
network monitoring; detection of unauthorized network interconnects in corporate
|
||||
environments; providing signals for abuse-prevention tools; and miscellanous
|
||||
forensics.
|
||||
|
||||
A snippet of typical p0f output may look like this:
|
||||
|
||||
.-[ 1.2.3.4/1524 -> 4.3.2.1/80 (syn) ]-
|
||||
|
|
||||
| client = 1.2.3.4
|
||||
| os = Windows XP
|
||||
| dist = 8
|
||||
| params = none
|
||||
| raw_sig = 4:120+8:0:1452:65535,0:mss,nop,nop,sok:df,id+:0
|
||||
|
|
||||
`----
|
||||
|
||||
.-[ 1.2.3.4/1524 -> 4.3.2.1/80 (syn+ack) ]-
|
||||
|
|
||||
| server = 4.3.2.1
|
||||
| os = Linux 3.x
|
||||
| dist = 0
|
||||
| params = none
|
||||
| raw_sig = 4:64+0:0:1460:mss*10,0:mss,nop,nop,sok:df:0
|
||||
|
|
||||
`----
|
||||
|
||||
.-[ 1.2.3.4/1524 -> 4.3.2.1/80 (mtu) ]-
|
||||
|
|
||||
| client = 1.2.3.4
|
||||
| link = DSL
|
||||
| raw_mtu = 1492
|
||||
|
|
||||
`----
|
||||
|
||||
.-[ 1.2.3.4/1524 -> 4.3.2.1/80 (uptime) ]-
|
||||
|
|
||||
| client = 1.2.3.4
|
||||
| uptime = 0 days 11 hrs 16 min (modulo 198 days)
|
||||
| raw_freq = 250.00 Hz
|
||||
|
|
||||
`----
|
||||
|
||||
A live demonstration can be seen here:
|
||||
|
||||
http://lcamtuf.coredump.cx/p0f3/
|
||||
|
||||
--------------------
|
||||
2. How does it work?
|
||||
--------------------
|
||||
|
||||
A vast majority of metrics used by p0f were invented specifically for this tool,
|
||||
and include data extracted from IPv4 and IPv6 headers, TCP headers, the dynamics
|
||||
of the TCP handshake, and the contents of application-level payloads.
|
||||
|
||||
For TCP/IP, the tool fingerprints the client-originating SYN packet and the
|
||||
first SYN+ACK response from the server, paying attention to factors such as the
|
||||
ordering of TCP options, the relation between maximum segment size and window
|
||||
size, the progression of TCP timestamps, and the state of about a dozen possible
|
||||
implementation quirks (e.g. non-zero values in "must be zero" fields).
|
||||
|
||||
The metrics used for application-level traffic vary from one module to another;
|
||||
where possible, the tool relies on signals such as the ordering or syntax of
|
||||
HTTP headers or SMTP commands, rather than any declarative statements such as
|
||||
User-Agent. Application-level fingerprinting modules currently support HTTP.
|
||||
Before the tool leaves "beta", I want to add SMTP and FTP. Other protocols,
|
||||
such as FTP, POP3, IMAP, SSH, and SSL, may follow.
|
||||
|
||||
The list of all the measured parameters is reviewed in section 5 later on.
|
||||
Some of the analysis also happens on a higher level: inconsistencies in the
|
||||
data collected from various sources, or in the data from the same source
|
||||
obtained over time, may be indicative of address translation, proxying, or
|
||||
just plain trickery. For example, a system where TCP timestamps jump back
|
||||
and forth, or where TTLs and MTUs change subtly, is probably a NAT device.
|
||||
|
||||
-------------------------------
|
||||
3. How do I compile and use it?
|
||||
-------------------------------
|
||||
|
||||
To compile p0f, try running './build.sh'; if that fails, you will be probably
|
||||
given some tips about the probable cause. If the tips are useless, send me a
|
||||
mean-spirited mail.
|
||||
|
||||
It is also possible to build a debug binary ('./build.sh debug'), in which case,
|
||||
verbose packet parsing and signature matching information will be written to
|
||||
stderr. This is useful when troubleshooting problems, but that's about it.
|
||||
|
||||
The tool should compile cleanly under any reasonably new version of Linux,
|
||||
FreeBSD, OpenBSD, MacOS X, and so forth. You can also builtdit on Windows using
|
||||
cygwin and winpcap. I have not tested it on all possible varieties of un*x, but
|
||||
if there are issues, they should be fairly superficial.
|
||||
|
||||
Once you have the binary compiled, you should be aware of the following
|
||||
command-line options:
|
||||
|
||||
-f fname - reads fingerprint database (p0f.fp) from the specified location.
|
||||
See section 5 for more information about the contents of this
|
||||
file.
|
||||
|
||||
The default location is ./p0f.fp. If you want to install p0f, you
|
||||
may want to change FP_FILE in config.h to /etc/p0f.fp.
|
||||
|
||||
-i iface - asks p0f to listen on a specific network interface. On un*x, you
|
||||
should reference the interface by name (e.g., eth0). On Windows,
|
||||
you can use adapter index instead (0, 1, 2...).
|
||||
|
||||
Multiple -i parameters are not supported; you need to run
|
||||
separate instances of p0f for that. On Linux, you can specify
|
||||
'any' to access a pseudo-device that combines the traffic on
|
||||
all other interfaces; the only limitation is that libpcap will
|
||||
not recognize VLAN-tagged frames in this mode, which may be
|
||||
an issue in some of the more exotic setups.
|
||||
|
||||
If you do not specify an interface, libpcap will probably pick
|
||||
the first working interface in your system.
|
||||
|
||||
-L - lists all available network interfaces, then quits. Particularly
|
||||
useful on Windows, where the system-generated interface names
|
||||
are impossible to memorize.
|
||||
|
||||
-r fname - instead of listening for live traffic, reads pcap captures from
|
||||
the specified file. The data can be collected with tcpdump or any
|
||||
other compatible tool. Make sure that snapshot length (-s
|
||||
option in tcpdump) is large enough not to truncate packets; the
|
||||
default may be too small.
|
||||
|
||||
As with -i, only one -r option can be specified at any given
|
||||
time.
|
||||
|
||||
-o fname - appends grep-friendly log data to the specified file. The log
|
||||
contains all observations made by p0f about every matching
|
||||
connection, and may grow large; plan accordingly.
|
||||
|
||||
Only one instance of p0f should be writing to a particular file
|
||||
at any given time; where supported, advisory locking is used to
|
||||
avoid problems.
|
||||
|
||||
-s fname - listens for API queries on the specified filesystem socket. This
|
||||
allows other programs to ask p0f about its current thoughts about
|
||||
a particular host. More information about the API protocol can be
|
||||
found in section 4 below.
|
||||
|
||||
Only one instance of p0f can be listening on a particular socket
|
||||
at any given time. The mode is also incompatible with -r.
|
||||
|
||||
-d - runs p0f in daemon mode: the program will fork into background
|
||||
and continue writing to the specified log file or API socket. It
|
||||
will continue running until killed, until the listening interface
|
||||
is shut down, or until some other fatal error is encountered.
|
||||
|
||||
This mode requires either -o or -s to be specified.
|
||||
|
||||
To continue capturing p0f debug output and error messages (but
|
||||
not signatures), redirect stderr to another non-TTY destination,
|
||||
e.g.:
|
||||
|
||||
./p0f -o /var/log/p0f.log -d 2>>/var/log/p0f.error
|
||||
|
||||
Note that if -d is specified and stderr points to a TTY, error
|
||||
messages will be lost.
|
||||
|
||||
-u user - causes p0f to drop privileges, switching to the specified user
|
||||
and chroot()ing itself to said user's home directory.
|
||||
|
||||
This mode is *highly* advisable (but not required) on un*x
|
||||
systems, especially in daemon mode. See section 7 for more info.
|
||||
|
||||
More arcane settings (you probably don't need to touch these):
|
||||
|
||||
-j - Log in JSON format.
|
||||
|
||||
-l - Line buffered mode for logging to output file.
|
||||
|
||||
-p - puts the interface specified with -i in promiscuous mode. If
|
||||
supported by the firmware, the card will also process frames not
|
||||
addressed to it.
|
||||
|
||||
-S num - sets the maximum number of simultaneous API connections. The
|
||||
default is 20; the upper cap is 100.
|
||||
|
||||
-m c,h - sets the maximum number of connections (c) and hosts (h) to be
|
||||
tracked at the same time (default: c = 1,000, h = 10,000). Once
|
||||
the limit is reached, the oldest 10% entries gets pruned to make
|
||||
room for new data.
|
||||
|
||||
This setting effectively controls the memory footprint of p0f.
|
||||
The cost of tracking a single host is under 400 bytes; active
|
||||
connections have a worst-case footprint of about 18 kB. High
|
||||
limits have some CPU impact, too, by the virtue of complicating
|
||||
data lookups in the cache.
|
||||
|
||||
NOTE: P0f tracks connections only until the handshake is done,
|
||||
and if protocol-level fingerprinting is possible, until few
|
||||
initial kilobytes of data have been exchanged. This means that
|
||||
most connections are dropped from the cache in under 5 seconds;
|
||||
consequently, the 'c' variable can be much lower than the real
|
||||
number of parallel connections happening on the wire.
|
||||
|
||||
-t c,h - sets the timeout for collecting signatures for any connection
|
||||
(c); and for purging idle hosts from in-memory cache (h). The
|
||||
first parameter is given in seconds, and defaults to 30 s; the
|
||||
second one is in minutes, and defaults to 120 min.
|
||||
|
||||
The first value must be just high enough to reliably capture
|
||||
SYN, SYN+ACK, and the initial few kB of traffic. Low-performance
|
||||
sites may want to increase it slightly.
|
||||
|
||||
The second value governs for how long API queries about a
|
||||
previously seen host can be made; and what's the maximum interval
|
||||
between signatures to still trigger NAT detection and so on.
|
||||
Raising it is usually not advisable; lowering it to 5-10 minutes
|
||||
may make sense for high-traffic servers, where it is possible to
|
||||
see several unrelated visitors subsequently obtaining the same
|
||||
dynamic IP from their ISP.
|
||||
|
||||
Well, that's about it. You probably need to run the tool as root. Some of the
|
||||
most common use cases:
|
||||
|
||||
# ./p0f -i eth0
|
||||
|
||||
# ./p0f -i eth0 -d -u p0f-user -o /var/log/p0f.log
|
||||
|
||||
# ./p0f -r some_capture.cap
|
||||
|
||||
The greppable log format (-o) uses pipe ('|') as a delimiter, with name=value
|
||||
pairs describing the signature in a manner very similar to the pretty-printed
|
||||
output generated on stdout:
|
||||
|
||||
[2012/01/04 10:26:14] mod=mtu|cli=1.2.3.4/1234|srv=4.3.2.1/80|subj=cli|link=DSL|raw_mtu=1492
|
||||
|
||||
The 'mod' parameter identifies the subsystem that generated the entry; the
|
||||
'cli' and 'srv' parameters always describe the direction in which the TCP
|
||||
session is established; and 'subj' describes which of these two parties is
|
||||
actually being fingerprinted.
|
||||
|
||||
Command-line options may be followed by a single parameter containing a
|
||||
pcap-style traffic filtering rule. This allows you to reject some of the less
|
||||
interesting packets for performance or privacy reasons. Simple examples include:
|
||||
|
||||
'dst net 10.0.0.0/8 and port 80'
|
||||
|
||||
'not src host 10.1.2.3'
|
||||
|
||||
'port 22 or port 443'
|
||||
|
||||
You can read more about the supported syntax by doing 'man pcap-fiter'; if
|
||||
that fails, try this URL:
|
||||
|
||||
http://www.manpagez.com/man/7/pcap-filter/
|
||||
|
||||
Filters work both for online capture (-i) and for previously collected data
|
||||
produced by any other tool (-r).
|
||||
|
||||
-------------
|
||||
4. API access
|
||||
-------------
|
||||
|
||||
The API allows other applications running on the same system to get p0f's
|
||||
current opinion about a particular host. This is useful for integrating it with
|
||||
spam filters, web apps, and so on.
|
||||
|
||||
Clients are welcome to connect to the unix socket specified with -s using the
|
||||
SOCK_STREAM protocol, and may issue any number of fixed-length queries. The
|
||||
queries will be answered in the order they are received.
|
||||
|
||||
Note that there is no response caching, nor any software limits in place on p0f
|
||||
end, so it is your responsibility to write reasonably well-behaved clients.
|
||||
|
||||
Queries have exactly 21 bytes. The format is:
|
||||
|
||||
- Magic dword (0x50304601), in native endian of the platform.
|
||||
|
||||
- Address type byte: 4 for IPv4, 6 for IPv6.
|
||||
|
||||
- 16 bytes of address data, network endian. IPv4 addresses should be
|
||||
aligned to the left.
|
||||
|
||||
To such a query, p0f responds with:
|
||||
|
||||
- Another magic dword (0x50304602), native endian.
|
||||
|
||||
- Status dword: 0x00 for 'bad query', 0x10 for 'OK', and 0x20 for 'no match'.
|
||||
|
||||
- Host information, valid only if status is 'OK' (byte width in square
|
||||
brackets):
|
||||
|
||||
[4] first_seen - unix time (seconds) of first observation of the host.
|
||||
|
||||
[4] last_seen - unix time (seconds) of most recent traffic.
|
||||
|
||||
[4] total_conn - total number of connections seen.
|
||||
|
||||
[4] uptime_min - calculated system uptime, in minutes. Zero if not known.
|
||||
|
||||
[4] up_mod_days - uptime wrap-around interval, in days.
|
||||
|
||||
[4] last_nat - time of the most recent detection of IP sharing (NAT,
|
||||
load balancing, proxying). Zero if never detected.
|
||||
|
||||
[4] last_chg - time of the most recent individual OS mismatch (e.g.,
|
||||
due to multiboot or IP reuse).
|
||||
|
||||
[2] distance - system distance (derived from TTL; -1 if no data).
|
||||
|
||||
[1] bad_sw - p0f thinks the User-Agent or Server strings aren't
|
||||
accurate. The value of 1 means OS difference (possibly
|
||||
due to proxying), while 2 means an outright mismatch.
|
||||
|
||||
NOTE: If User-Agent is not present at all, this value
|
||||
stays at 0.
|
||||
|
||||
[1] os_match_q - OS match quality: 0 for a normal match; 1 for fuzzy
|
||||
(e.g., TTL or DF difference); 2 for a generic signature;
|
||||
and 3 for both.
|
||||
|
||||
[32] os_name - NUL-terminated name of the most recent positively matched
|
||||
OS. If OS not known, os_name[0] is NUL.
|
||||
|
||||
NOTE: If the host is first seen using an known system and
|
||||
then switches to an unknown one, this field is not
|
||||
reset.
|
||||
|
||||
[32] os_flavor - OS version. May be empty if no data.
|
||||
|
||||
[32] http_name - most recent positively identified HTTP application
|
||||
(e.g. 'Firefox').
|
||||
|
||||
[32] http_flavor - version of the HTTP application, if any.
|
||||
|
||||
[32] link_type - network link type, if recognized.
|
||||
|
||||
[32] language - system language, if recognized.
|
||||
|
||||
A simple reference implementation of an API client is provided in p0f-client.c.
|
||||
Implementations in C / C++ may reuse api.h from p0f source code, too.
|
||||
|
||||
Developers using the API should be aware of several important constraints:
|
||||
|
||||
- The maximum number of simultaneous API connections is capped to 20. The
|
||||
limit may be adjusted with the -S parameter, but rampant parallelism may
|
||||
lead to poorly controlled latency; consider a single query pipeline,
|
||||
possibly with prioritization and caching.
|
||||
|
||||
- The maximum number of hosts and connections tracked at any given time is
|
||||
subject to configurable limits. You should look at your traffic stats and
|
||||
see if the defaults are suitable.
|
||||
|
||||
You should also keep in mind that whenever you are subject to an ongoing
|
||||
DDoS or SYN spoofing DoS attack, p0f may end up dropping entries faster
|
||||
than you could query for them. It's that or running out of memory, so
|
||||
don't fret.
|
||||
|
||||
- Cache entries with no activity for more than 120 minutes will be dropped
|
||||
even if the cache is nearly empty. The timeout is adjustable with -t, but
|
||||
you should not use the API to obtain ancient data; if you routinely need to
|
||||
go back hours or days, parse the logs instead of wasting RAM.
|
||||
|
||||
-----------------------
|
||||
5. Fingerprint database
|
||||
-----------------------
|
||||
|
||||
Whenever p0f obtains a fingerprint from the observed traffic, it defers to
|
||||
the data read from p0f.fp to identify the operating system and obtain some
|
||||
ancillary data needed for other analysis tasks. The fingerprint database is a
|
||||
simple text file where lines starting with ; are ignored.
|
||||
|
||||
== Module specification ==
|
||||
|
||||
The file is split into sections based on the type of traffic the fingerprints
|
||||
apply to. Section identifiers are enclosed in square brackets, like so:
|
||||
|
||||
[module:direction]
|
||||
|
||||
module - the name of the fingerprinting module (e.g. 'tcp' or 'http').
|
||||
|
||||
direction - the direction of fingerprinted traffic: 'request' (from client to
|
||||
server) or 'response' (from server to client).
|
||||
|
||||
For the TCP module, 'client' matches the initial SYN; and
|
||||
'server' matches SYN+ACK.
|
||||
|
||||
The 'direction' part is omitted for MTU signatures, as they work equally well
|
||||
both ways.
|
||||
|
||||
== Signature groups ==
|
||||
|
||||
The actual signatures must be preceeded by an 'label' line, describing the
|
||||
fingerprinted software:
|
||||
|
||||
label = type:class:name:flavor
|
||||
|
||||
type - some signatures in p0f.fp offer broad, last-resort matching for
|
||||
less researched corner cases. The goal there is to give an
|
||||
answer slightly better than "unknown", but less precise than
|
||||
what the user may be expecting.
|
||||
|
||||
Normal, reasonably specific signatures that can't be radically
|
||||
improved should have their type specified as 's'; while generic,
|
||||
last-resort ones should be tagged with 'g'.
|
||||
|
||||
Note that generic signatures are considered only if no specific
|
||||
matches are found in the database.
|
||||
|
||||
class - the tool needs to distinguish between OS-identifying signatures
|
||||
(only one of which should be matched for any given host) and
|
||||
signatures that just identify user applications (many of which
|
||||
may be seen concurrently).
|
||||
|
||||
To assist with this, OS-specific signatures should specify the
|
||||
OS architecture family here (e.g., 'win', 'unix', 'cisco'); while
|
||||
application-related sigs (NMap, MSIE, Apache) should use a
|
||||
special value of '!'.
|
||||
|
||||
Most TCP signatures are OS-specific, and should have OS family
|
||||
defined. Other signatures, such as HTTP, should use '!' unless
|
||||
the fingerprinted component is deeply intertwined with the
|
||||
platform (e.g., Windows Update).
|
||||
|
||||
NOTE: To avoid variations (e.g. 'win' and 'windows' or 'unix'
|
||||
and 'linux'), all classes need to be pre-registered using a
|
||||
'classes' directive, seen near the beginning of p0f.fp.
|
||||
|
||||
name - a human-readable short name for what the fingerprint actually
|
||||
helps identify - say, 'Linux', 'Sendmail', or 'NMap'. The tool
|
||||
doesn't care about the exact value, but requires consistency - so
|
||||
don't switch between 'Internet Explorer' and 'MSIE', or 'MacOS'
|
||||
and 'Mac OS'.
|
||||
|
||||
flavor - anything you want to say to further qualify the observation. Can
|
||||
be the version of the identified software, or a description of
|
||||
what the application seems to be doing (e.g. 'SYN scan' for NMap).
|
||||
|
||||
NOTE: Don't be too specific: if you have a signature for Apache
|
||||
2.2.16, but have no reason to suspect that other recent versions
|
||||
behave in a radically different way, just say '2.x'.
|
||||
|
||||
P0f uses labels to group similar signatures that may be plausibly generated by
|
||||
the same system or application, and should not be considered a strong signal for
|
||||
NAT detection.
|
||||
|
||||
To further assist the tool in deciding which OS and application combinations are
|
||||
reasonable, and which ones are indicative of foul play, any 'label' line for
|
||||
applications (class '!') should be followed by a comma-delimited list of OS
|
||||
names or @-prefixed OS architecture classes on which this software is known to
|
||||
be used on. For example:
|
||||
|
||||
label = s:!:Uncle John's Networked ls Utility:2.3.0.1
|
||||
sys = Linux,FreeBSD,OpenBSD
|
||||
|
||||
...or:
|
||||
|
||||
label = s:!:Mom's Homestyle Browser:1.x
|
||||
sys = @unix,@win
|
||||
|
||||
The label can be followed by any number of module-specific signatures; all of
|
||||
them will be linked to the most recent label, and will be reported the same
|
||||
way.
|
||||
|
||||
All sections except for 'name' are omitted for [mtu] signatures, which do not
|
||||
convey any OS-specific information, and just describe link types.
|
||||
|
||||
== MTU signatures ==
|
||||
|
||||
Many operating systems derive the maximum segment size specified in TCP options
|
||||
from the MTU of their network interface; that value, in turn, normally depends
|
||||
on the design of the link-layer protocol. A different MTU is associated with
|
||||
PPPoE, a different one with IPSec, and a different one with Juniper VPN.
|
||||
|
||||
The format of the signatures in the [mtu] section is exceedingly simple,
|
||||
consisting just of a description and a list of values:
|
||||
|
||||
label = Ethernet
|
||||
sig = 1500
|
||||
|
||||
These will be matched for any wildcard MSS TCP packets (see below) not generated
|
||||
by userspace TCP tools.
|
||||
|
||||
== TCP signatures ==
|
||||
|
||||
For TCP traffic, signature layout is as follows:
|
||||
|
||||
sig = ver:ittl:olen:mss:wsize,scale:olayout:quirks:pclass
|
||||
|
||||
ver - signature for IPv4 ('4'), IPv6 ('6'), or both ('*').
|
||||
|
||||
NEW SIGNATURES: P0f documents the protocol observed on the wire,
|
||||
but you should replace it with '*' unless you have observed some
|
||||
actual differences between IPv4 and IPv6 traffic, or unless the
|
||||
software supports only one of these versions to begin with.
|
||||
|
||||
ittl - initial TTL used by the OS. Almost all operating systems use
|
||||
64, 128, or 255; ancient versions of Windows sometimes used
|
||||
32, and several obscure systems sometimes resort to odd values
|
||||
such as 60.
|
||||
|
||||
NEW SIGNATURES: P0f will usually suggest something, using the
|
||||
format of 'observed_ttl+distance' (e.g. 54+10). Consider using
|
||||
traceroute to check that the distance is accurate, then sum up
|
||||
the values. If initial TTL can't be guessed, p0f will output
|
||||
'nnn+?', and you need to use traceroute to estimate the '?'.
|
||||
|
||||
A handful of userspace tools will generate random TTLs. In these
|
||||
cases, determine maximum initial TTL and then add a - suffix to
|
||||
the value to avoid confusion.
|
||||
|
||||
olen - length of IPv4 options or IPv6 extension headers. Usually zero
|
||||
for normal IPv4 traffic; always zero for IPv6 due to the
|
||||
limitations of libpcap.
|
||||
|
||||
NEW SIGNATURES: Copy p0f output literally.
|
||||
|
||||
mss - maximum segment size, if specified in TCP options. Special value
|
||||
of '*' can be used to denote that MSS varies depending on the
|
||||
parameters of sender's network link, and should not be a part of
|
||||
the signature. In this case, MSS will be used to guess the
|
||||
type of network hookup according to the [mtu] rules.
|
||||
|
||||
NEW SIGNATURES: Use '*' for any commodity OSes where MSS is
|
||||
around 1300 - 1500, unless you know for sure that it's fixed.
|
||||
If the value is outside that range, you can probably copy it
|
||||
literally.
|
||||
|
||||
wsize - window size. Can be expressed as a fixed value, but many
|
||||
operating systems set it to a multiple of MSS or MTU, or a
|
||||
multiple of some random integer. P0f automatically detects these
|
||||
cases, and allows notation such as 'mss*4', 'mtu*4', or '%8192'
|
||||
to be used. Wilcard ('*') is possible too.
|
||||
|
||||
NEW SIGNATURES: Copy p0f output literally. If frequent variations
|
||||
are seen, look for obvious patterns. If there are no patterns,
|
||||
'*' is a possible alternative.
|
||||
|
||||
scale - window scaling factor, if specified in TCP options. Fixed value
|
||||
or '*'.
|
||||
|
||||
NEW SIGNATURES: Copy literally, unless the value varies randomly.
|
||||
Many systems alter between 2 or 3 scaling factors, in which case,
|
||||
it's better to have several 'sig' lines, rather than a wildcard.
|
||||
|
||||
olayout - comma-delimited layout and ordering of TCP options, if any. This
|
||||
is one of the most valuable TCP fingerprinting signals. Supported
|
||||
values:
|
||||
|
||||
eol+n - explicit end of options, followed by n bytes of padding
|
||||
nop - no-op option
|
||||
mss - maximum segment size
|
||||
ws - window scaling
|
||||
sok - selective ACK permitted
|
||||
sack - selective ACK (should not be seen)
|
||||
ts - timestamp
|
||||
?n - unknown option ID n
|
||||
|
||||
NEW SIGNATURES: Copy this string literally.
|
||||
|
||||
quirks - comma-delimited properties and quirks observed in IP or TCP
|
||||
headers:
|
||||
|
||||
df - "don't fragment" set (probably PMTUD); ignored for IPv6
|
||||
id+ - DF set but IPID non-zero; ignored for IPv6
|
||||
id- - DF not set but IPID is zero; ignored for IPv6
|
||||
ecn - explicit congestion notification support
|
||||
0+ - "must be zero" field not zero; ignored for IPv6
|
||||
flow - non-zero IPv6 flow ID; ignored for IPv4
|
||||
|
||||
seq- - sequence number is zero
|
||||
ack+ - ACK number is non-zero, but ACK flag not set
|
||||
ack- - ACK number is zero, but ACK flag set
|
||||
uptr+ - URG pointer is non-zero, but URG flag not set
|
||||
urgf+ - URG flag used
|
||||
pushf+ - PUSH flag used
|
||||
|
||||
ts1- - own timestamp specified as zero
|
||||
ts2+ - non-zero peer timestamp on initial SYN
|
||||
opt+ - trailing non-zero data in options segment
|
||||
exws - excessive window scaling factor (> 14)
|
||||
bad - malformed TCP options
|
||||
|
||||
If a signature scoped to both IPv4 and IPv6 contains quirks valid
|
||||
for just one of these protocols, such quirks will be ignored for
|
||||
on packets using the other protocol. For example, any combination
|
||||
of 'df', 'id+', and 'id-' is always matched by any IPv6 packet.
|
||||
|
||||
NEW SIGNATURES: Copy literally.
|
||||
|
||||
pclass - payload size classification: '0' for zero, '+' for non-zero,
|
||||
'*' for any. The packets we fingerprint right now normally have
|
||||
no payloads, but some corner cases exist.
|
||||
|
||||
NEW SIGNATURES: Copy literally.
|
||||
|
||||
NOTE: The TCP module allows some fuzziness when an exact match can't be found:
|
||||
'df' and 'id+' quirks are allowed to disappear; 'id-' or 'ecn' may appear; and
|
||||
TTLs can change.
|
||||
|
||||
To gather new SYN ('request') signatures, simply connect to the fingerprinted
|
||||
system, and p0f will provide you with the necessary data. To gather SYN+ACK
|
||||
('response') signatures, you should use the bundled p0f-sendsyn utility while p0f
|
||||
is running in the background; creating them manually is not advisable.
|
||||
|
||||
== HTTP signatures ==
|
||||
|
||||
A special directive should appear at the beginning of the [http:request]
|
||||
section, structured the following way:
|
||||
|
||||
ua_os = Linux,Windows,iOS=[iPad],iOS=[iPhone],Mac OS X,...
|
||||
|
||||
This list should specify OS names that should be looked for within the
|
||||
User-Agent string if the string is otherwise deemed to be honest. This input
|
||||
is not used for fingerprinting, but aids NAT detection in some useful ways.
|
||||
|
||||
The names have to match the names used in 'sig' specifiers across p0f.fp. If a
|
||||
particular name used by p0f differs from what typically appears in User-Agent,
|
||||
the name=[string] syntax may be used to define any number of aliases.
|
||||
|
||||
Other than that, HTTP signatures for GET and HEAD requests have the following
|
||||
layout:
|
||||
|
||||
sig = ver:horder:habsent:expsw
|
||||
|
||||
ver - 0 for HTTP/1.0, 1 for HTTP/1.1, or '*' for any.
|
||||
|
||||
NEW SIGNATURES: Copy the value literally, unless you have a
|
||||
specific reason to do otherwise.
|
||||
|
||||
horder - comma-separated, ordered list of headers that should appear in
|
||||
matching traffic. Substrings to match within each of these
|
||||
headers may be specified using a name=[value] notation.
|
||||
|
||||
The signature will be matched even if other headers appear in
|
||||
between, as long as the list itself is matched in the specified
|
||||
sequence.
|
||||
|
||||
Headers that usually do appear in the traffic, but may go away
|
||||
(e.g. Accept-Language if the user has no languages defined, or
|
||||
Referer if no referring site exists) should be prefixed with '?',
|
||||
e.g. "?Referer". P0f will accept their disappearance, but will
|
||||
not allow them to appear at any other location.
|
||||
|
||||
NEW SIGNATURES: Review the list and remove any headers that
|
||||
appear to be irrelevant to the fingerprinted software, and mark
|
||||
transient ones with '?'. Remove header values that do not add
|
||||
anything to the signature, or are request- or user-specific.
|
||||
In particular, pay attention to Accept, Accept-Language, and
|
||||
Accept-Charset, as they are highly specific to request type
|
||||
and user settings.
|
||||
|
||||
P0f automatically removes some headers, prefixes others with '?',
|
||||
and inhibits the value of fields such as 'Referer' or 'Cookie' -
|
||||
but this is not a substitute for manual review.
|
||||
|
||||
NOTE: Server signatures may differ depending on the request
|
||||
(HTTP/1.1 versus 1.0, keep-alive versus one-shot, etc) and on the
|
||||
returned resource (e.g., CGI versus static content). Play around,
|
||||
browse to several URLs, also try curl and wget.
|
||||
|
||||
habsent - comma-separated list of headers that must *not* appear in
|
||||
matching traffic. This is particularly useful for noting the
|
||||
absence of standard headers (e.g. 'Host'), or for differentiating
|
||||
between otherwise very similar signatures.
|
||||
|
||||
NEW SIGNATURES: P0f will automatically highlight the absence of
|
||||
any normally present headers; other entries may be added where
|
||||
necessary.
|
||||
|
||||
expsw - expected substring in 'User-Agent' or 'Server'. This is not
|
||||
used to match traffic, and merely serves to detect dishonest
|
||||
software. If you want to explicitly match User-Agent, you need
|
||||
to do this in the 'horder' section, e.g.:
|
||||
|
||||
User-Agent=[Firefox]
|
||||
|
||||
Any of these sections sections except for 'ver' may be blank.
|
||||
|
||||
There are many protocol-level quirks that p0f could be detecting - for example,
|
||||
the use of non-standard newlines, or missing or extra spacing between header
|
||||
field names and values. There is also some information to be gathered from
|
||||
responses to OPTIONS or POST. That said, it does not seem to be worth the
|
||||
effort: the protocol is so verbose, and implemented so arbitrarily, that we are
|
||||
getting more than enough information just with a simple GET / HEAD fingerprint.
|
||||
|
||||
== SMTP signatures ==
|
||||
|
||||
*** NOT IMPLEMENTED YET ***
|
||||
|
||||
== FTP signatures ==
|
||||
|
||||
*** NOT IMPLEMENTED YET ***
|
||||
|
||||
----------------
|
||||
6. NAT detection
|
||||
----------------
|
||||
|
||||
In addition to fairly straightforward measurements of intrinsic properties of
|
||||
a single TCP session, p0f also tries to compare signatures across sessions to
|
||||
detect client-side connection sharing (NAT, HTTP proxies) or server-side load
|
||||
balancing.
|
||||
|
||||
This is done in two steps: the first significant deviation usually prompts a
|
||||
"host change" entry (which may be also indicative of multi-boot, address reuse,
|
||||
or other one-off events); and a persistent pattern of changes prompts an
|
||||
"ip sharing" notification later on.
|
||||
|
||||
All of these messages are accompanied by a set of reason codes:
|
||||
|
||||
os_sig - the OS detected right now doesn't match the OS detected earlier
|
||||
on.
|
||||
|
||||
sig_diff - no definite OS detection data available, but protocol-level
|
||||
characteristics have changed drastically (e.g., different
|
||||
TCP option layout).
|
||||
|
||||
app_vs_os - the application detected running on the host is not supposed
|
||||
to work on the host's operating system.
|
||||
|
||||
x_known - the signature progressed from known to unknown, or vice versa.
|
||||
|
||||
The following additional codes are specific to TCP:
|
||||
|
||||
tstamp - TCP timestamps went back or jumped forward.
|
||||
|
||||
ttl - TTL values have changed.
|
||||
|
||||
port - source port number has decreased.
|
||||
|
||||
mtu - system MTU has changed.
|
||||
|
||||
fuzzy - the precision with which a TCP signature is matched has
|
||||
changed.
|
||||
|
||||
The following code is also issued by the HTTP module:
|
||||
|
||||
via - data explicitly includes Via / X-Forwarded-For.
|
||||
|
||||
us_vs_os - OS fingerprint doesn't match User-Agent data, and the
|
||||
User-Agent value otherwise looks honest.
|
||||
|
||||
app_srv_lb - server application signatures change, suggesting load
|
||||
balancing.
|
||||
|
||||
date - server-advertised date changes inconsistently.
|
||||
|
||||
Different reasons have different weights, balanced to keep p0f very sensitive
|
||||
even to very homogenous environments behind NAT. If you end up seeing false
|
||||
positives or other detection problems in your environment, please let me know!
|
||||
|
||||
-----------
|
||||
7. Security
|
||||
-----------
|
||||
|
||||
You should treat the output from this tool as advisory; the fingerprinting can
|
||||
be gambled with some minor effort, and it's also possible to evade it altogether
|
||||
(e.g. with excessive IP fragmentation or bad TCP checksums). Plan accordingly.
|
||||
|
||||
P0f should to be reasonably secure to operate as a daemon. That said, un*x
|
||||
users should employ the -u option to drop privileges and chroot() when running
|
||||
the tool continuously. This greatly minimizes the consequences of any mishaps -
|
||||
and mishaps in C just tend to happen.
|
||||
|
||||
To make this step meaningful, the user you are running p0f as should be
|
||||
completely unprivileged, and should have an empty, read-only home directory. For
|
||||
example, you can do:
|
||||
|
||||
# useradd -d /var/empty/p0f -M -r -s /bin/nologin p0f-user
|
||||
# mkdir -p -m 755 /var/empty/p0f
|
||||
|
||||
Please don't put the p0f binary itself, or any other valuable assets, inside
|
||||
that user's home directory; and certainly do not use any generic locations such
|
||||
as / or /bin/ in lieu of a proper home.
|
||||
|
||||
P0f running in the background should be fairly difficult to DoS, especially
|
||||
compared to any real TCP services it will be watching. Nevertheless, there are
|
||||
so many deployment-specific factors at play that you should always preemptively
|
||||
stress-test your setup, and see how it behaves.
|
||||
|
||||
Other than that, let's talk filesystem security. When using the tool in the
|
||||
API mode (-s), the listening socket is always re-created created with 666
|
||||
permissions, so that applications running as other uids can query it at will.
|
||||
If you want to preserve the privacy of captured traffic in a multi-user system,
|
||||
please ensure that the socket is created in a directory with finer-grained
|
||||
permissions; or change API_MODE in config.h.
|
||||
|
||||
The default file mode for binary log data (-o) is 600, on the account that
|
||||
others probably don't need access to historical data; if you need to share logs,
|
||||
you can pre-create the file or change LOG_MODE in config.h.
|
||||
|
||||
Don't build p0f, and do not store its source, binary, configuration files, logs,
|
||||
or query sockets in world-writable locations such as /tmp (or any
|
||||
subdirectories created therein).
|
||||
|
||||
Last but not least, please do not attempt to make p0f setuid, or otherwise
|
||||
grant it privileges higher than these of the calling user. Neither the tool
|
||||
itself, nor the third-party components it depends on, are designed to keep rogue
|
||||
less-privileged callers at bay. If you use /etc/sudoers to list p0f as the only
|
||||
program that user X should be able to run as root, that user will probably be
|
||||
able to compromise your system. The same goes for many other uses of sudo, by
|
||||
the way.
|
||||
|
||||
--------------
|
||||
8. Limitations
|
||||
--------------
|
||||
|
||||
Here are some of the known issues you may run into:
|
||||
|
||||
== General ==
|
||||
|
||||
1) RST, ACK, and other experimental fingerprinting modes offered in p0f v2 are
|
||||
no longer supported in v3. This is because they proved to have very low
|
||||
specificity. The consequence is that you can no longer fingerprint
|
||||
"connection refused" responses.
|
||||
|
||||
2) API queries or daemon execution are not supported when reading offline pcaps.
|
||||
While there may be some fringe use cases for that, offline pcaps use a
|
||||
much simpler event loop, and so supporting these features would require some
|
||||
extra effort.
|
||||
|
||||
3) P0f needs to observe at least about 25 milliseconds worth of qualifying
|
||||
traffic to estimate system uptime. This means that if you're testing it over
|
||||
loopback or LAN, you may need to let it see more than one connection.
|
||||
|
||||
Systems with extremely slow timestamp clocks may need longer acquisition
|
||||
periods (up to several seconds); very fast clocks (over 1.5 kHz) are rejected
|
||||
completely on account of being prohibited by the RFC. Almost all OSes are
|
||||
between 100 Hz and 1 kHz, which should work fine.
|
||||
|
||||
4) Some systems vary SYN+ACK responses based on the contents of the initial SYN,
|
||||
sometimes removing TCP options not supported by the other endpoint.
|
||||
Unfortunately, there is no easy way to account for this, so several SYN+ACK
|
||||
signatures may be required per system. The bundled p0f-sendsyn utility helps
|
||||
with collecting them.
|
||||
|
||||
Another consequence of this is that you will sometimes see server uptime only
|
||||
if your own system has RFC1323 timestamps enabled. Linux does that since
|
||||
version 2.2; on Windows, you need version 7 or newer. Client uptimes are not
|
||||
affected.
|
||||
|
||||
== Windows port ==
|
||||
|
||||
1) API sockets do not work on Windows. This is due to a limitation of winpcap;
|
||||
see live_event_loop(...) in p0f.c for more info.
|
||||
|
||||
2) The chroot() jail (-u) on Windows doesn't offer any real security. This is
|
||||
due to the limitations of cygwin.
|
||||
|
||||
3) The p0f-sendsyn utility doesn't work because of the limited capabilities of
|
||||
Windows raw sockets (this should be relatively easy to fix if there are any
|
||||
users who care).
|
||||
|
||||
---------------------------
|
||||
9. Acknowledgments and more
|
||||
---------------------------
|
||||
|
||||
P0f is made possible thanks to the contributions of several good souls,
|
||||
including:
|
||||
|
||||
Phil Ames
|
||||
Jannich Brendle
|
||||
Matthew Dempsky
|
||||
Jason DePriest
|
||||
Dalibor Dukic
|
||||
Mark Martinec
|
||||
Damien Miller
|
||||
Josh Newton
|
||||
Nibbler
|
||||
Bernhard Rabe
|
||||
Chris John Riley
|
||||
Sebastian Roschke
|
||||
Peter Valchev
|
||||
Jeff Weisberg
|
||||
Anthony Howe
|
||||
Tomoyuki Murakami
|
||||
Michael Petch
|
||||
|
||||
If you wish to help, the most immediate way to do so is to simply gather new
|
||||
signatures, especially from less popular or older platforms (servers, networking
|
||||
equipment, portable / embedded / specialty OSes, etc).
|
||||
|
||||
Problems? Suggestions? Complaints? Compliments? You can reach the author at
|
||||
<lcamtuf@coredump.cx>. The author is very lonely and appreciates your mail.
|
||||
26
docker/p0f/docs/TODO
Normal file
26
docker/p0f/docs/TODO
Normal file
|
|
@ -0,0 +1,26 @@
|
|||
Signatures:
|
||||
|
||||
- More SYN sigs,
|
||||
|
||||
- A lot more SYN+ACK signatures,
|
||||
|
||||
- A lot more server signatures - maybe write a tool.
|
||||
|
||||
Modules:
|
||||
|
||||
- SMTP
|
||||
|
||||
- FTP
|
||||
|
||||
- POP3
|
||||
|
||||
- IMAP
|
||||
|
||||
- SSH
|
||||
|
||||
- SSL
|
||||
|
||||
Misc:
|
||||
|
||||
- Manpage.
|
||||
|
||||
29
docker/p0f/docs/existential-notes.txt
Normal file
29
docker/p0f/docs/existential-notes.txt
Normal file
|
|
@ -0,0 +1,29 @@
|
|||
-----------------------------
|
||||
Some random food for thought:
|
||||
-----------------------------
|
||||
|
||||
1) If you run p0f on any reasonably popular server, you will probably see quite
|
||||
a few systems that seem to be leaking memory in TCP headers (e.g. ACK number
|
||||
or second timestamp set on SYN packets, URG pointer without URG flag, etc).
|
||||
You will also see HTTP traffic with non-stripped Proxy-Authorization headers
|
||||
and other hilarious abnormalities.
|
||||
|
||||
Unfortunately, pinpointing the sources of many of these leaks is pretty hard;
|
||||
they often trace to proprietary corporate proxies and firewalls, and unless
|
||||
it's *your* proxy or firewall, you won't be finding out more. If you wish to
|
||||
put some investigative effort into this, there are quite a few bugs waiting
|
||||
to be tracked down, though :-)
|
||||
|
||||
2) After some hesitation, I decided *against* the inclusion of encrypted traffic
|
||||
classification features into p0f. Timing, packet size, and direction
|
||||
information lets you, for example, reliably differentiate between interactive
|
||||
SSH sessions and SFTP uploads or downloads; automated and human password
|
||||
entry attemps; or failed and successful auth.
|
||||
|
||||
The same goes for SSL: you can tell normal HTTPS browsing from file uploads,
|
||||
from attempts to smuggle, say, PPP over SSL. In the end, however, it seems
|
||||
like stretch to cram it into p0f; one day, I might improve my ancient 'fl0p'
|
||||
tool, instead:
|
||||
|
||||
http://lcamtuf.coredump.cx/soft/fl0p-devel.tgz
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show more
Loading…
Reference in a new issue