tarbit 1.0.9 → 1.0.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 117fb55a177b3ee42523343f68f5dd0cfb703748ce912fab803b200c416e41d3
-  data.tar.gz: bf004f4ee1b84ba682ea5c5b3d8011181ec464cc8b945ab721cd81bb92fe7215
+  metadata.gz: 1574446bdae0127464b1b8e067a14cbc3e55a74cf5b9d35aa81d133715a5f093
+  data.tar.gz: 1dfddc4c58650c09b3b19fe1721aa755b60285484aade4ca74eb76c44006e463
 SHA512:
-  metadata.gz: a5595aac91a471e9916c77060c549481213a814ea13a0879f553df1e4d3240ac2a78b792fa0e8b36b679ddfbb4715f14a0dc8a08bc33a9f0298bd9a2293e4a55
-  data.tar.gz: 4974b6a89e9c0e007d70f908311f029bc97342d9a80f46111bdf8411114d271b0defe81cf4b8ae61c0f98def606cd08a89fa0ba91ddf0a1fb2b2a3a54b306e58
+  metadata.gz: b5959104833e64e3f58aec8ce6dd9e75a602f23aeda1a22053951c6b0f70246ad0ab743152abef845397e77312db918cee524eb9ceb30412d3e9cc23e8f8580e
+  data.tar.gz: b12add83ed57bc6101c83b01fc6902b387b063f7453dd8a483b6a49b7b47bde529b1780c4ee2b03240afc059933b0aab89adc08a64c2c98d132b7f9fb03044c4

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    tarbit (1.0.8)
+    tarbit (1.0.9)
       async-io
       commander
       gruff

data/LICENSE

@@ -0,0 +1,7 @@
+Copyright (c) 2020 Niklas Helge Hanft
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,92 @@
+# Tarbit - A async ruby tcp tarpit
+
+## Introduction
+
+Tarbit is a tcp tarpit written in ruby. It can slow down automated ssh/http/tcp "attacks" or bot connections. 
+It is designed to consume a very little amount of cpu and memory. Tarbit can also generate statistic images.
+
+*"Red Wood Cutting", Vladimir Kush*
+
+!["Red Wood Cutting", Vladimir Kush](.assets/red-wood-cutting_vladimir-kush.jpg)
+
+Tarbit is heaviliy inspired by endlessh, the python version, feel free to take a look: https://nullprogram.com/blog/2019/03/22/
+
+## Installation
+
+```
+gem install tarbit
+```
+
+You can now run tarbit manually (you can also omit the default params):
+
+The interval option marks the seconds until the statistics are written to disk.
+
+```
+tarbit serve --port 22 --interval 1800
+```
+
+## Advanced
+
+Create a systemd service
+
+Verify your tarbit executable: (change the path `bin` to `wrapper` within the systemd `ExecStart` )
+
+```
+which tarbit
+```
+
+```bash
+[Unit]
+Description=Tarbit - ruby ssh tarpit
+
+[Service]
+Type=simple
+ExecStart=/usr/local/rvm/gems/ruby-2.6.5/wrappers/tarbit serve
+AmbientCapabilities=CAP_NET_BIND_SERVICE
+
+[Install]
+WantedBy=multi-user.target
+```
+
+Create a cron job for making statistic snapshots:
+
+Again make sure the path has changed `bin` with `wrapper`
+
+```
+* */2 * * * /usr/local/rvm/gems/ruby-2.6.5/wrappers/tarbit snapshot
+```
+
+It is recommended to cleanup the statistics folder. You can use a cron job too.
+(It will remove all statistics every 12 hours)
+
+```
+* */12 * * * rm /etc/tarbit/statistics/*.json
+```
+
+Enjoy statistics like these:
+
+![A simple line graph showin connections over time](.assets/1582830001.png)
+
+
+## Troubleshooting
+
+Native extensions: Imagemagick can not find `MagickWand.h`
+
+On Ubuntu, you can run:
+```
+sudo apt-get install libmagickwand-dev
+```
+
+On Centos, you can run:
+```
+sudo yum install gcc ImageMagick-devel make which
+```
+
+On Macos, you can run: 
+
+```
+brew install imagemagick@6
+brew link --force imagemagick@6
+```
+
+On Windoes, you can install Linux instead.

data/lib/tarbit/server.rb

@@ -23,7 +23,7 @@ module Tarbit
       Async do |task|
         endpoint.accept do |peer|
           stream = Async::IO::Stream.new(peer)
-          Async.logger.info "New connection: #{stream}"
+          Async.logger.info "New connection: #{stream}, #{@connections.size + 1} connections active"
 
           id = SecureRandom.uuid
 
@@ -42,7 +42,7 @@ module Tarbit
           end
         rescue StandardError => e
           @connections = @connections.reject { |stats| stats.fetch(:id) == id }
-          Async.logger.info "Connection closed: #{stream}"
+          Async.logger.info "Connection closed: #{stream}, #{@connections.size} connections active"
         end
       end
     end

data/lib/tarbit/statistic_watcher.rb

@@ -7,8 +7,7 @@ module Tarbit
 
     def initialize(server, interval)
       @server = server
-      @interval = interval.nil? ? 600 : interval.to_i
-      @history = []
+      @interval = interval.nil? ? 1800 : interval.to_i
       Async.logger.info "SatisticWatcher - Starting watcher with interval #{@interval}"
     end
 
@@ -26,7 +25,7 @@ module Tarbit
     def create_point_in_time
       # Add point in time
       statistic_point = {
-          created_at: Time.now.to_i,
+          created_at: Time.new.strftime("%H:%M"),
           connections: @server.connections.clone
       }
 

data/lib/tarbit/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tarbit
-  VERSION = "1.0.9"
+  VERSION = "1.0.10"
 end

data/tarbit.gemspec

@@ -12,8 +12,8 @@ Gem::Specification.new do |s|
 
   s.authors = ['Niklas Hanft']
   s.email = 'hello@niklashanft.com'
-  s.homepage = 'https://github.com/nhh/apollo'
-  s.license = 'ISC'
+  s.homepage = 'https://github.com/nhh/tarbit'
+  s.license = 'MIT'
 
   s.files = `git ls-files`.split("\n")
   s.executables << 'tarbit'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tarbit
 version: !ruby/object:Gem::Version
-  version: 1.0.9
+  version: 1.0.10
 platform: ruby
 authors:
 - Niklas Hanft
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-02-27 00:00:00.000000000 Z
+date: 2020-03-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async-io
@@ -73,9 +73,13 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- ".assets/1582830001.png"
+- ".assets/red-wood-cutting_vladimir-kush.jpg"
 - ".gitignore"
 - Gemfile
 - Gemfile.lock
+- LICENSE
+- README.md
 - bin/tarbit
 - lib/tarbit.rb
 - lib/tarbit/server.rb
@@ -83,9 +87,9 @@ files:
 - lib/tarbit/statistic_watcher.rb
 - lib/tarbit/version.rb
 - tarbit.gemspec
-homepage: https://github.com/nhh/apollo
+homepage: https://github.com/nhh/tarbit
 licenses:
-- ISC
+- MIT
 metadata: {}
 post_install_message: 
 rdoc_options: []