ronin-payloads 0.1.4 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 22dcc9ea244534bd659de580c4ef0576401bf480055ad9b0a6a05787e7375c1b
-  data.tar.gz: f3ce8d4f1e8b1c80610c9de6d860514d9a3d5ef4eb6840d7f888d12fc6621f4c
+  metadata.gz: 23ed6234ba68bb63d9e7e909987b1b4c3b5f8f75048cb9cef20c61d2a5769bcc
+  data.tar.gz: de32a35122ac1e6452b3d1a0148fcb0d4089a9fefa951084cc51cd36bd27c98c
 SHA512:
-  metadata.gz: 8449b2f43b09fd2bf49b29417f8004e24c970b4e797a65430fdfd9df8c7132daa8d4112c36f3a5bb6569efc92e4ada98a0de624a1eb209e50eeadaa245750536
-  data.tar.gz: 02b8ae12c4b29dbd3987067d429919a4bbc883ff562dd8228b93b2eef8ed80fbf8f82c366d43d9a00c92f48570afe480186a2f7cd2ec80d2d35e56312160546e
+  metadata.gz: b5dfda82e5c0fcda3da9d48093921b5bcc6935460f9a6bc434b0891a60bfb08995526a3b39f540d6515faddcfc6d882d7f3f27cb64107300c1bbc0e575f43c3b
+  data.tar.gz: 5457d1110e9cd8b544e95cdb890a0d135e6e01b3a4f6b7e3fedacdd84bf9cb12005ee695a6b5b6061d824f3f631c31d75b4a1fd44aabe2f8a343b1cd6fab9c93

data/.github/workflows/ruby.yml

@@ -12,11 +12,12 @@ jobs:
           - '3.0'
           - '3.1'
           - '3.2'
+          - '3.3'
           - jruby
           - truffleruby
     name: Ruby ${{ matrix.ruby }}
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
         with:
@@ -35,7 +36,7 @@ jobs:
   rubocop:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
         with:

data/ChangeLog.md

@@ -1,3 +1,20 @@
+### 0.1.5 / 2024-06-19
+
+* Fixed order of arguments passed to `TCPServer.new` in
+  {Ronin::Payloads::Mixins::ReverseShell#perform_prelaunch} which was preventing
+  reverse shells from opening a local TCP server socket.
+
+#### Payloads
+
+* Fixed the module namespace for the {Ronin::Payloads::CMD::Node::ReverseShell}
+  payload (aka `cmd/node/reverse_shell`).
+
+#### CLI
+
+* Automatically create the parent directory of the new payload file,
+  if it doesn't exist, when running `ronin-payloads new path/to/new_payload.rb`.
+* Fixed typo in `ronin-payloads encode` man-page for the `-E,--encoder` option.
+
 ### 0.1.4 / 2023-09-19
 
 #### CLI

data/README.md

@@ -18,7 +18,9 @@ payloads. ronin-payloads allows one to write payloads as plain old Ruby classes.
 ronin-payloads can be distributed as Ruby files or in git repositories that can
 be installed with [ronin-repos].
 
-ronin-exploits is part of the [ronin-rb] project, a [Ruby] toolkit for security
+**tl;dr** It's like `msfvenom` but simpler and more modular.
+
+ronin-payloads is part of the [ronin-rb] project, a [Ruby] toolkit for security
 research and development.
 
 ## Features
@@ -27,7 +29,7 @@ research and development.
   possible.
 * Supports defining Payloads as plain old Ruby classes.
 * Provides base classes for a variety of languages and payload types
- (ASM, Shellcode, C, Go, Rust, Java, JSP, PHP, Python, Ruby, NodeJS, Shell,
+  (ASM, Shellcode, C, Go, Rust, Java, JSP, PHP, Python, Ruby, NodeJS, Shell,
   PowerShell, SQL, XML, HTML, URL).
 * Provides built-in common payloads:
   * Command-line reverse shells:
@@ -194,8 +196,8 @@ $ ronin-payloads new example_payload.rb \
 Generate a ronin repository of your own payloads (or exploits):
 
 ```shell
-$ ronin-repos new my-payloads
-$ cd my-payloads/
+$ ronin-repos new my-repo
+$ cd my-repo/
 $ mkdir payloads
 $ ronin-payloads new payloads/my_payload.rb \
                       --name MyPayload --arch i686 --os Linux \

data/gemspec.yml

@@ -6,6 +6,8 @@ description:
   classes. ronin-payloads can be distributed as Ruby files or in git
   repositories that can be installed with ronin-repos.
 
+  It's like `msfvenom` but simpler and more modular.
+
 license: LGPL-3.0
 authors: Postmodern
 email: postmodern.mod3@gmail.com

data/lib/ronin/payloads/builtin/cmd/node/reverse_shell.rb

@@ -25,7 +25,7 @@ require 'ronin/payloads/mixins/reverse_shell'
 module Ronin
   module Payloads
     module CMD
-      module NodeJS
+      module Node
         #
         # A basic `node` (Node.js) reverse shell command.
         #

data/lib/ronin/payloads/cli/commands/new.rb

@@ -25,7 +25,6 @@ require 'ronin/core/cli/generator/options/author'
 require 'ronin/core/cli/generator/options/summary'
 require 'ronin/core/cli/generator/options/description'
 require 'ronin/core/cli/generator/options/reference'
-require 'ronin/core/git'
 
 require 'command_kit/inflector'
 
@@ -81,11 +80,6 @@ module Ronin
 
           man_page 'ronin-payloads-new.1'
 
-          # The references to add to the payload.
-          #
-          # @return [Array<String>]
-          attr_reader :references
-
           #
           # Initializes the `ronin-payloads new` command.
           #
@@ -105,9 +99,12 @@ module Ronin
           #   The path to the new payload file.
           #
           def run(file)
+            @directory  = File.dirname(file)
             @file_name  = File.basename(file,File.extname(file))
             @class_name = CommandKit::Inflector.camelize(@file_name)
 
+            mkdir @directory unless @directory == '.'
+
             erb "payload.rb.erb", file
             chmod '+x', file
           end

data/lib/ronin/payloads/mixins/reverse_shell.rb

@@ -72,7 +72,7 @@ module Ronin
         # additional pre-launch steps.
         #
         def perform_prelaunch
-          @server = TCPServer.new(port,host)
+          @server = TCPServer.new(host,port)
           @server.listen(1)
 
           super

data/lib/ronin/payloads/version.rb

@@ -22,6 +22,6 @@
 module Ronin
   module Payloads
     # ronin-payloads version
-    VERSION = '0.1.4'
+    VERSION = '0.1.5'
   end
 end

data/man/ronin-payloads-build.1

@@ -1,10 +1,10 @@
-.\" Generated by kramdown-man 0.1.8
+.\" Generated by kramdown-man 0.1.9
 .\" https://github.com/postmodern/kramdown-man#readme
 .TH ronin-payloads-build 1 "2023-02-01" Ronin "User Manuals"
 .LP
 .SH SYNOPSIS
 .LP
-.HP
+.PP
 \fBronin-payloads build\fR \[lB]\fIoptions\fP\[rB] \[lC]\fB--file\fR \fIFILE\fP \[or] \fINAME\fP\[rC]
 .LP
 .SH DESCRIPTION

data/man/ronin-payloads-encode.1

@@ -1,10 +1,10 @@
-.\" Generated by kramdown-man 0.1.8
+.\" Generated by kramdown-man 0.1.9
 .\" https://github.com/postmodern/kramdown-man#readme
 .TH ronin-payloads-encoder 1 "2023-02-01" Ronin "User Manuals"
 .LP
 .SH SYNOPSIS
 .LP
-.HP
+.PP
 \fBronin-payloads encoder\fR \[lB]\fIoptions\fP\[rB] \[lC]\fB--string\fR \fISTRING\fP \[or] \fIFILE\fP\[rC]
 .LP
 .SH DESCRIPTION
@@ -25,7 +25,7 @@ The optional file to read the data to encode from\.
 Formats the encoded data\.
 .LP
 .TP
-\fB-E\fR, \fB--encode\fR \fIENCODER\fP
+\fB-E\fR, \fB--encoder\fR \fIENCODER\fP
 Loads the encoder with the given name\.
 .LP
 .TP

data/man/ronin-payloads-encode.1.md

@@ -18,7 +18,7 @@ Encodes data using one or more encoders.
 `-F`, `--format` `hex`\|`c`\|`shell`\|`powershell`\|`xml`\|`html`\|`js`\|`ruby`
   Formats the encoded data.
 
-`-E`, `--encode` *ENCODER*
+`-E`, `--encoder` *ENCODER*
   Loads the encoder with the given name.
 
 `-p`, `--param` *ENCODER*`.`*NAME*`=`*VALUE*

data/man/ronin-payloads-encoder.1

@@ -1,10 +1,10 @@
-.\" Generated by kramdown-man 0.1.8
+.\" Generated by kramdown-man 0.1.9
 .\" https://github.com/postmodern/kramdown-man#readme
 .TH ronin-payloads-encoder 1 "2023-02-01" Ronin "User Manuals"
 .LP
 .SH SYNOPSIS
 .LP
-.HP
+.PP
 \fBronin-payloads encoder\fR \[lB]\fIoptions\fP\[rB] \fINAME\fP
 .LP
 .SH DESCRIPTION

data/man/ronin-payloads-encoders.1

@@ -1,10 +1,10 @@
-.\" Generated by kramdown-man 0.1.8
+.\" Generated by kramdown-man 0.1.9
 .\" https://github.com/postmodern/kramdown-man#readme
 .TH ronin-payloads-encoders 1 "2023-02-01" Ronin "User Manuals"
 .LP
 .SH SYNOPSIS
 .LP
-.HP
+.PP
 \fBronin-payloads encoders\fR \[lB]\fIoptions\fP\[rB] \fIDIR\fP
 .LP
 .SH DESCRIPTION

data/man/ronin-payloads-irb.1

@@ -1,10 +1,10 @@
-.\" Generated by kramdown-man 0.1.8
+.\" Generated by kramdown-man 0.1.9
 .\" https://github.com/postmodern/kramdown-man#readme
 .TH ronin-payloads-irb 1 "2023-02-01" Ronin "User Manuals"
 .LP
 .SH SYNOPSIS
 .LP
-.HP
+.PP
 \fBronin-payloads irb\fR \[lB]\fIoptions\fP\[rB]
 .LP
 .SH DESCRIPTION

data/man/ronin-payloads-launch.1

@@ -1,10 +1,10 @@
-.\" Generated by kramdown-man 0.1.8
+.\" Generated by kramdown-man 0.1.9
 .\" https://github.com/postmodern/kramdown-man#readme
 .TH ronin-payloads-launch 1 "2023-02-01" Ronin "User Manuals"
 .LP
 .SH SYNOPSIS
 .LP
-.HP
+.PP
 \fBronin-payloads launch\fR \[lB]\fIoptions\fP\[rB] \[lC]\fB--file\fR \fIFILE\fP \[or] \fINAME\fP\[rC]
 .LP
 .SH DESCRIPTION

data/man/ronin-payloads-list.1

@@ -1,10 +1,10 @@
-.\" Generated by kramdown-man 0.1.8
+.\" Generated by kramdown-man 0.1.9
 .\" https://github.com/postmodern/kramdown-man#readme
 .TH ronin-payloads-list 1 "2023-02-01" Ronin "User Manuals"
 .LP
 .SH SYNOPSIS
 .LP
-.HP
+.PP
 \fBronin-payloads list\fR \[lB]\fIoptions\fP\[rB] \fIDIR\fP
 .LP
 .SH DESCRIPTION

data/man/ronin-payloads-new.1.md

@@ -2,7 +2,7 @@
 
 ## SYNOPSIS
 
-`ronin-payloads new` [*options*] *FILE*
+`ronin-payloads new` [*options*] *PATH*
 
 ## DESCRIPTION
 
@@ -10,7 +10,7 @@ Generates a new payload file.
 
 ## ARGUMENTS
 
-*FILE*
+*PATH*
   The path to the new payload file to generate.
 
 ## OPTIONS

data/man/ronin-payloads-show.1

@@ -1,10 +1,10 @@
-.\" Generated by kramdown-man 0.1.8
+.\" Generated by kramdown-man 0.1.9
 .\" https://github.com/postmodern/kramdown-man#readme
 .TH ronin-payloads-show 1 "May 2022" Ronin "User Manuals"
 .LP
 .SH SYNOPSIS
 .LP
-.HP
+.PP
 \fBronin-payloads show\fR \[lB]\fIoptions\fP\[rB] \[lC]\fB--file\fR \fIFILE\fP \[or] \fINAME\fP\[rC]
 .LP
 .SH DESCRIPTION

data/man/ronin-payloads.1

@@ -1,10 +1,10 @@
-.\" Generated by kramdown-man 0.1.8
+.\" Generated by kramdown-man 0.1.9
 .\" https://github.com/postmodern/kramdown-man#readme
 .TH ronin-payloads 1 "2023-02-01" Ronin "User Manuals"
 .LP
 .SH SYNOPSIS
 .LP
-.HP
+.PP
 \fBronin-payloads\fR \[lB]\fIoptions\fP\[rB] \[lB]\fICOMMAND\fP \[lB]\.\.\.\[rB]\[rB]
 .LP
 .SH DESCRIPTION

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ronin-payloads
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.5
 platform: ruby
 authors:
 - Postmodern
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-09-19 00:00:00.000000000 Z
+date: 2024-06-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ronin-support
@@ -94,10 +94,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.0'
-description: ronin-payloads is a Ruby micro-framework for writing and running exploit
-  payloads. ronin-payloads allows one to write payloads as plain old Ruby classes.
-  ronin-payloads can be distributed as Ruby files or in git repositories that can
-  be installed with ronin-repos.
+description: |-
+  ronin-payloads is a Ruby micro-framework for writing and running exploit payloads. ronin-payloads allows one to write payloads as plain old Ruby classes. ronin-payloads can be distributed as Ruby files or in git repositories that can be installed with ronin-repos.
+  It's like `msfvenom` but simpler and more modular.
 email: postmodern.mod3@gmail.com
 executables:
 - ronin-payloads
@@ -284,7 +283,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.26
+rubygems_version: 3.3.27
 signing_key:
 specification_version: 4
 summary: A Ruby micro-framework for writing and running exploit payloads