pwn 0.5.127 → 0.5.129

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a48eb64d6b60c7d703bf51915a4ab652027a070a04eedf44ac9155c34df161bd
-  data.tar.gz: a1a298f9710a1162ebcddc006aa0a93f6d392e7d72b24ac559aa6aa06365a013
+  metadata.gz: 041b60ff7e7d85926a01fe639e900d83cf1e95a702960a14ca652af48cc8249b
+  data.tar.gz: dbba29721fc429bdc2a65ded91498486afe70810d26223023c8aadc61a4444eb
 SHA512:
-  metadata.gz: 5f47a7dbec9b9c6439edee6fd7bc93b7d4c00387b9063d1fcda59f87b72ba4d727cb88debf6a3afa24f292061b9b2ebdcc39e68f6b915206cdadfa40355d3e35
-  data.tar.gz: 52daf9816e032f0c23f482ddeac6e7d230b5796a1c952191bc93cd5c3268a79805e8eaa7fc3c5173df3966f6827c9682979a74a658766defd3cbaeca45117e30
+  metadata.gz: f48e7d733e857094fcf3a4495d0b8e4fdd8da1c0202ea71704439e85da8722700eb6c43584918c4c960da79649526d3d1874328416e1b0ba101cbba558e6072f
+  data.tar.gz: a658d909e8b85644f637ddc66eb8cc97d1eefdfe8e40335cbb6b0a5f76620e76497675ea8bb6d673e1c4695f152f7e1be3b13511200221ef44ca17b66f29f074

data/Gemfile

@@ -22,7 +22,6 @@ gem 'bson', '5.0.0'
 gem 'bundler', '>=2.5.10'
 gem 'bundler-audit', '0.9.1'
 gem 'bunny', '2.22.0'
-gem 'cinch', '2.3.4'
 gem 'colorize', '1.1.0'
 gem 'credit_card_validations', '6.2.0'
 gem 'eventmachine', '1.2.7'

data/README.md

@@ -37,7 +37,7 @@ $ cd /opt/pwn
 $ ./install.sh
 $ ./install.sh ruby-gem
 $ pwn
-pwn[v0.5.127]:001 >>> PWN.help
+pwn[v0.5.129]:001 >>> PWN.help
 ```
 
 [![Installing the pwn Security Automation Framework](https://raw.githubusercontent.com/0dayInc/pwn/master/documentation/pwn_install.png)](https://youtu.be/G7iLUY4FzsI)
@@ -52,7 +52,7 @@ $ rvm use ruby-3.3.1@pwn
 $ gem uninstall --all --executables pwn
 $ gem install --verbose pwn
 $ pwn
-pwn[v0.5.127]:001 >>> PWN.help
+pwn[v0.5.129]:001 >>> PWN.help
 ```
 
 If you're using a multi-user install of RVM do:
@@ -62,7 +62,7 @@ $ rvm use ruby-3.3.1@pwn
 $ rvmsudo gem uninstall --all --executables pwn
 $ rvmsudo gem install --verbose pwn
 $ pwn
-pwn[v0.5.127]:001 >>> PWN.help
+pwn[v0.5.129]:001 >>> PWN.help
 ```
 
 PWN periodically upgrades to the latest version of Ruby which is reflected in `/opt/pwn/.ruby-version`.  The easiest way to upgrade to the latest version of Ruby from a previous PWN installation is to run the following script:

data/lib/pwn/banner/f_society.rb

@@ -32,6 +32,7 @@ module PWN
         ⣿⠀⠀⠀⠀⠀⠻⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠿⠁⠀⠀⠀⠀⣿
         ⣿⠀⠀⠀⠀⠀⠀⠈⠙⢿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠟⠁⠀⠀⠀⠀⠀⠀⣿
         ⠛⠀⠀⠀⠀⠀⠀⠀⠀⠈⠛⠛⠛⠛⠉⠉⠛⠛⠛⠛⠁⠀⠀⠀⠀⠀⠀⠀⠀⠛
+        ⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛⠛
         '.red
       rescue StandardError => e
         raise e

data/lib/pwn/plugins/irc.rb

@@ -0,0 +1,133 @@
+# frozen_string_literal: true
+
+require 'openssl'
+
+module PWN
+  module Plugins
+    # This plugin was created to interact with IRC protocols
+    module IRC
+      @@logger = PWN::Plugins::PWNLogger.create
+
+      # Supported Method Parameters::
+      # irc_obj = PWN::Plugins::IRC.connect(
+      #   host: 'required - host or ip (defaults to "127.0.0.1")',
+      #   port: 'required - host port (defaults to 6667)',
+      #   nick: 'required - nickname',
+      #   real: 'optional - real name (defaults to value of nick)',
+      #   chan: 'required - channel',
+      #   tls: 'optional - boolean connect to host socket using TLS (defaults to false)'
+      # )
+
+      public_class_method def self.connect(opts = {})
+        host = opts[:host] ||= '127.0.0.1'
+        port = opts[:port] ||= 6667
+        nick = opts[:nick].to_s.scrub
+        real = opts[:real] ||= nick
+        chan = opts[:chan].to_s.scrub
+        tls = opts[:tls] || false
+
+        irc_obj = PWN::Plugins::Sock.connect(
+          target: host,
+          port: port,
+          tls: tls
+        )
+
+        send(irc_obj: irc_obj, message: "NICK #{nick}")
+        send(irc_obj: irc_obj, message: "USER #{nick} #{host} #{host} :#{real}")
+        send(irc_obj: irc_obj, message: "JOIN #{chan}")
+        send(irc_obj: irc_obj, message: "PRIVMSG #{chan} :#{nick} joined.")
+
+        irc_obj
+      rescue StandardError => e
+        irc_obj = disconnect(irc_obj: irc_obj) unless irc_obj.nil?
+        raise e
+      end
+
+      # Supported Method Parameters::
+      # PWN::Plugins::IRC.listen(
+      #   irc_obj: 'required - irc_obj returned from #connect method'
+      # )
+
+      public_class_method def self.listen(opts = {})
+        irc_obj = opts[:irc_obj]
+
+        loop do
+          message = irc_obj.gets
+          @@logger.info(message)
+          next unless block_given?
+
+          # Extract the message text from the message
+          message_text = message.split[3..-1].join(' ')[1..-1]
+          yield message_text
+        end
+      rescue StandardError => e
+        raise e
+      ensure
+        disconnect(irc_obj: irc_obj)
+      end
+
+      public_class_method def self.send(opts = {})
+        irc_obj = opts[:irc_obj]
+        message = opts[:message].to_s.scrub
+
+        irc_obj.puts message
+        # Wait for a response from the server
+        # This is a hack to ensure the message is processed by the server
+        # before sending another message
+        irc_obj.gets
+        irc_obj.flush
+      rescue StandardError => e
+        raise e
+      end
+
+      # Supported Method Parameters::
+      # PWN::Plugins::IRC.disconnect(
+      #   irc_obj: 'required - irc_obj returned from #connect method'
+      # )
+
+      public_class_method def self.disconnect(opts = {})
+        irc_obj = opts[:irc_obj]
+        PWN::Plugins::Sock.disconnect(sock_obj: irc_obj) unless irc_obj.nil?
+      rescue StandardError => e
+        raise e
+      end
+
+      # Author(s):: 0day Inc. <support@0dayinc.com>
+
+      public_class_method def self.authors
+        "AUTHOR(S):
+          0day Inc. <support@0dayinc.com>
+        "
+      end
+
+      # Display Usage for this Module
+
+      public_class_method def self.help
+        puts "USAGE:
+          irc_obj = #{self}.connect(
+            host: 'required - host or ip',
+            port: 'required - host port',
+            nick: 'required - nickname',
+            chan: 'required - channel',
+            tls: 'optional - boolean connect to host socket using TLS (defaults to false)'
+          )
+
+          #{self}.listen(
+            irc_obj: 'required - irc_obj returned from #connect method'
+          )
+
+          #{self}.send(
+            irc_obj: 'required - irc_obj returned from #connect method',
+            message: 'required - message to send'
+          )
+
+          irc_obj = #{self}.disconnect(
+            irc_obj: 'required - irc_obj returned from #connect method'
+          )
+
+          #{self}.authors
+        "
+      end
+    end
+  end
+end

data/lib/pwn/plugins.rb

@@ -32,6 +32,7 @@ module PWN
     autoload :HackerOne, 'pwn/plugins/hacker_one'
     autoload :IBMAppscan, 'pwn/plugins/ibm_appscan'
     autoload :IPInfo, 'pwn/plugins/ip_info'
+    autoload :IRC, 'pwn/plugins/irc'
     autoload :Jenkins, 'pwn/plugins/jenkins'
     autoload :JiraServer, 'pwn/plugins/jira_server'
     autoload :JSONPathify, 'pwn/plugins/json_pathify'

data/lib/pwn/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PWN
-  VERSION = '0.5.127'
+  VERSION = '0.5.129'
 end

data/spec/lib/pwn/plugins/irc_spec.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe PWN::Plugins::IRC do
+  it 'should display information for authors' do
+    authors_response = PWN::Plugins::IRC
+    expect(authors_response).to respond_to :authors
+  end
+
+  it 'should display information for existing help method' do
+    help_response = PWN::Plugins::IRC
+    expect(help_response).to respond_to :help
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pwn
 version: !ruby/object:Gem::Version
-  version: 0.5.127
+  version: 0.5.129
 platform: ruby
 authors:
 - 0day Inc.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-05-21 00:00:00.000000000 Z
+date: 2024-05-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -150,20 +150,6 @@ dependencies:
     - - '='
       - !ruby/object:Gem::Version
         version: 2.22.0
-- !ruby/object:Gem::Dependency
-  name: cinch
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - '='
-      - !ruby/object:Gem::Version
-        version: 2.3.4
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - '='
-      - !ruby/object:Gem::Version
-        version: 2.3.4
 - !ruby/object:Gem::Dependency
   name: colorize
   requirement: !ruby/object:Gem::Requirement
@@ -1819,6 +1805,7 @@ files:
 - lib/pwn/plugins/hacker_one.rb
 - lib/pwn/plugins/ibm_appscan.rb
 - lib/pwn/plugins/ip_info.rb
+- lib/pwn/plugins/irc.rb
 - lib/pwn/plugins/jenkins.rb
 - lib/pwn/plugins/jira_server.rb
 - lib/pwn/plugins/json_pathify.rb
@@ -2150,6 +2137,7 @@ files:
 - spec/lib/pwn/plugins/hacker_one_spec.rb
 - spec/lib/pwn/plugins/ibm_appscan_spec.rb
 - spec/lib/pwn/plugins/ip_info_spec.rb
+- spec/lib/pwn/plugins/irc_spec.rb
 - spec/lib/pwn/plugins/jenkins_spec.rb
 - spec/lib/pwn/plugins/jira_server_spec.rb
 - spec/lib/pwn/plugins/json_pathify_spec.rb