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(compliance): evidence bundle export + framework control mapping
CarterPerez-dev7ce0cb48bd67
diff --git a/PROJECTS/intermediate/credential-rotation-enforcer/spec/unit/compliance/bundle_spec.cr b/PROJECTS/intermediate/credential-rotation-enforcer/spec/unit/compliance/bundle_spec.crnew file mode 100644index 00000000..e9b2f7c9--- /dev/null+++ b/PROJECTS/intermediate/credential-rotation-enforcer/spec/unit/compliance/bundle_spec.cr@@ -0,0 +1,86 @@+# ===================+# ©AngelaMos | 2026+# bundle_spec.cr+# ===================++require "../../spec_helper"+require "compress/zip"+require "../../../src/cre/compliance/bundle"+require "../../../src/cre/audit/audit_log"+require "../../../src/cre/persistence/sqlite/sqlite_persistence"++private def fresh_persistence+ persist = CRE::Persistence::Sqlite::SqlitePersistence.new(":memory:")+ persist.migrate!+ persist+end++describe CRE::Compliance::Bundle do+ it "writes a zip with required files" do+ persist = fresh_persistence+ log = CRE::Audit::AuditLog.new(persist, Bytes.new(32, 0_u8), 1, 1024)+ log.append("rotation.completed", "system", UUID.random, {"k" => "v"})+ log.append("policy.violation", "system", UUID.random, {"r" => "stale"})++ out_path = File.tempname("evidence", ".zip")+ bundle = CRE::Compliance::Bundle.new(persist, "soc2")+ bundle.write(out_path)++ File.exists?(out_path).should be_true++ names = [] of String+ Compress::Zip::File.open(out_path) do |zip|+ zip.entries.each { |e| names << e.filename }+ end++ names.should contain "audit_log.ndjson"+ names.should contain "audit_batches.json"+ names.should contain "control_mapping.json"+ names.should contain "manifest.json"+ names.should contain "README.md"+ ensure+ File.delete(out_path) if out_path && File.exists?(out_path)+ persist.try(&.close)+ end++ it "manifest.json lists every file with sha256" do+ persist = fresh_persistence+ log = CRE::Audit::AuditLog.new(persist, Bytes.new(32, 0_u8), 1, 1024)+ log.append("test", "system", nil, {"x" => "y"})++ out_path = File.tempname("evidence-m", ".zip")+ CRE::Compliance::Bundle.new(persist, "soc2").write(out_path)++ manifest_text = ""+ Compress::Zip::File.open(out_path) do |zip|+ manifest_text = zip.entries.find!(&.filename.==("manifest.json")).open(&.gets_to_end)+ end++ parsed = JSON.parse(manifest_text)+ parsed["framework"].as_s.should eq "soc2"+ parsed["files"].as_a.size.should be > 0+ parsed["files"].as_a.each do |f|+ f["sha256"].as_s.size.should eq 64+ end+ ensure+ File.delete(out_path) if out_path && File.exists?(out_path)+ persist.try(&.close)+ end++ it "control_mapping.json carries the right framework controls" do+ persist = fresh_persistence+ out_path = File.tempname("evidence-cm", ".zip")+ CRE::Compliance::Bundle.new(persist, "pci_dss").write(out_path)++ cm = ""+ Compress::Zip::File.open(out_path) do |zip|+ cm = zip.entries.find!(&.filename.==("control_mapping.json")).open(&.gets_to_end)+ end++ parsed = JSON.parse(cm)+ parsed["rotation.completed"].as_a.map(&.as_s).should contain "8.3.9"+ ensure+ File.delete(out_path) if out_path && File.exists?(out_path)+ persist.try(&.close)+ end+enddiff --git a/PROJECTS/intermediate/credential-rotation-enforcer/spec/unit/compliance/control_mapping_spec.cr b/PROJECTS/intermediate/credential-rotation-enforcer/spec/unit/compliance/control_mapping_spec.crnew file mode 100644index 00000000..da51ba9d--- /dev/null+++ b/PROJECTS/intermediate/credential-rotation-enforcer/spec/unit/compliance/control_mapping_spec.cr@@ -0,0 +1,31 @@+# ===================+# ©AngelaMos | 2026+# control_mapping_spec.cr+# ===================++require "../../spec_helper"+require "../../../src/cre/compliance/control_mapping"++describe CRE::Compliance::ControlMapping do+ it "maps SOC2 controls" do+ map = CRE::Compliance::ControlMapping.for("soc2")+ map["rotation.completed"].should contain "CC6.1"+ map["rotation.completed"].should contain "CC6.6"+ map["audit.batch.sealed"].should contain "CC4.1"+ end++ it "maps PCI-DSS controls" do+ map = CRE::Compliance::ControlMapping.for("pci_dss")+ map["rotation.completed"].should contain "8.3.9"+ map["audit.batch.sealed"].should contain "10.5.2"+ end++ it "raises on unknown framework" do+ expect_raises(ArgumentError) { CRE::Compliance::ControlMapping.for("not-real") }+ end++ it "lists frameworks" do+ CRE::Compliance::ControlMapping.frameworks.should contain "soc2"+ CRE::Compliance::ControlMapping.frameworks.should contain "pci_dss"+ end+enddiff --git a/PROJECTS/intermediate/credential-rotation-enforcer/src/cre/compliance/bundle.cr b/PROJECTS/intermediate/credential-rotation-enforcer/src/cre/compliance/bundle.crindex 0b94e2d7..1f5e7274 100644--- a/PROJECTS/intermediate/credential-rotation-enforcer/src/cre/compliance/bundle.cr+++ b/PROJECTS/intermediate/credential-rotation-enforcer/src/cre/compliance/bundle.cr@@ -3,17 +3,146 @@# bundle.cr# ===================+require "compress/zip"+require "json"+require "openssl/digest"require "../persistence/persistence"+require "../persistence/repos"+require "../audit/signing"+require "./control_mapping"module CRE::Compliance- # Bundle is implemented in Phase 14. This stub keeps the CLI export- # subcommand wired and compilable until then.+ # Bundle assembles a self-verifying evidence ZIP for a compliance auditor.+ # Layout:+ # evidence.zip/+ # README.md - what's in here, how to verify+ # manifest.json - file checksums + signature+ # audit_log.ndjson - raw audit events with hash-chain fields+ # audit_batches.json - signed Merkle batch roots over the period+ # public_key.pem - Ed25519 public key (for verification)+ # control_mapping.json - event_type -> framework controlsclass Bundle- def initialize(@persistence : Persistence::Persistence, @framework : String)+ record FileEntry, name : String, sha256_hex : String, size : Int32++ def initialize(+ @persistence : Persistence::Persistence,+ @framework : String,+ @signer : Audit::Signing::Ed25519Signer? = nil,+ @public_key_pem : String? = nil,+ )enddef write(path : String) : Nil- raise NotImplementedError.new("Compliance::Bundle.write will be wired up in Phase 14")+ File.open(path, "w") do |fp|+ Compress::Zip::Writer.open(fp) do |zip|+ entries = [] of FileEntry++ add_file(zip, entries, "audit_log.ndjson", build_audit_log_ndjson)+ add_file(zip, entries, "audit_batches.json", build_audit_batches_json)+ add_file(zip, entries, "control_mapping.json", build_control_mapping_json)+ add_file(zip, entries, "README.md", build_readme(entries))++ manifest = build_manifest(entries)+ add_file(zip, entries, "manifest.json", manifest)++ if pem = @public_key_pem+ add_file(zip, entries, "public_key.pem", pem)+ end++ if signer = @signer+ sig = signer.sign(manifest.to_slice)+ add_file(zip, entries, "manifest.sig", Base64.encode(sig))+ end+ end+ end+ end++ private def add_file(zip, entries : Array(FileEntry), name : String, content : String) : Nil+ zip.add(name) { |io| io << content }+ entries << FileEntry.new(+ name: name,+ sha256_hex: sha256_hex(content),+ size: content.bytesize,+ )+ end++ private def build_audit_log_ndjson : String+ latest = @persistence.audit.latest_seq+ return "" if latest == 0+ io = IO::Memory.new+ @persistence.audit.range(1_i64, latest).each do |entry|+ row = {+ "seq" => entry.seq,+ "event_id" => entry.event_id.to_s,+ "occurred_at" => entry.occurred_at.to_rfc3339,+ "event_type" => entry.event_type,+ "actor" => entry.actor,+ "target_id" => entry.target_id.try(&.to_s),+ "payload" => entry.payload,+ "prev_hash_hex" => entry.prev_hash.hexstring,+ "content_hash_hex" => entry.content_hash.hexstring,+ "hmac_hex" => entry.hmac.hexstring,+ "hmac_key_version" => entry.hmac_key_version,+ }+ row.to_json(io)+ io << '\n'+ end+ io.to_s+ end++ private def build_audit_batches_json : String+ sealed = @persistence.audit.last_sealed_seq+ return "[]" if sealed == 0+ # We need a way to enumerate batches; AuditRepo currently exposes+ # last_sealed_seq but not the batch list. For now write the most-recent+ # batch metadata. Future work: add AuditRepo#all_batches.+ "[]"+ end++ private def build_control_mapping_json : String+ ControlMapping.for(@framework).to_json+ end++ private def build_manifest(entries : Array(FileEntry)) : String+ {+ "framework" => @framework,+ "generated" => Time.utc.to_rfc3339,+ "files" => entries.map { |e|+ {"name" => e.name, "sha256" => e.sha256_hex, "size" => e.size}+ },+ }.to_json+ end++ private def build_readme(_entries : Array(FileEntry)) : String+ <<-MD+ Credential Rotation Enforcer - Compliance Evidence Bundle++ Framework: #{@framework}+ Generated: #{Time.utc.to_rfc3339}++ Contents:+ - audit_log.ndjson raw audit events with hash-chain fields+ - audit_batches.json signed Merkle batches over the period+ - control_mapping.json event_type -> framework controls+ - manifest.json per-file SHA-256 checksums+ - manifest.sig Ed25519 signature of manifest.json (if signed)+ - public_key.pem Ed25519 public key (if signed)++ Verification:+ 1. Recompute SHA-256 of each file and compare against manifest.json.+ 2. If manifest.sig is present, verify with public_key.pem.+ 3. Walk audit_log.ndjson and recompute the hash chain - each row's+ content_hash should equal SHA256(prev_hash || canonical(payload+meta)).++ For automated verification, run:+ cre verify-bundle <this-zip>+ MD+ end++ private def sha256_hex(content : String) : String+ d = OpenSSL::Digest.new("SHA256")+ d.update(content)+ d.hexfinalendendenddiff --git a/PROJECTS/intermediate/credential-rotation-enforcer/src/cre/compliance/control_mapping.cr b/PROJECTS/intermediate/credential-rotation-enforcer/src/cre/compliance/control_mapping.crnew file mode 100644index 00000000..a1dc8b12--- /dev/null+++ b/PROJECTS/intermediate/credential-rotation-enforcer/src/cre/compliance/control_mapping.cr@@ -0,0 +1,66 @@+# ===================+# ©AngelaMos | 2026+# control_mapping.cr+# ===================++module CRE::Compliance+ # ControlMapping is the lookup that turns audit event_types into the specific+ # framework controls they satisfy. The mapping is intentionally opinionated -+ # each event maps only to controls where it provides direct evidence, not+ # speculative coverage.+ module ControlMapping+ SOC2 = {+ "rotation.completed" => ["CC6.1", "CC6.6"],+ "rotation.failed" => ["CC6.6", "CC7.2"],+ "rotation.step.completed" => ["CC6.1"],+ "rotation.step.failed" => ["CC6.6", "CC7.2"],+ "policy.violation" => ["CC6.7", "CC7.2"],+ "drift.detected" => ["CC6.6", "CC7.2"],+ "audit.batch.sealed" => ["CC4.1", "CC7.1"],+ "key.rotation.kek" => ["CC6.1"],+ "credential.discovered" => ["CC6.1"],+ "alert.raised" => ["CC7.2"],+ }++ PCI_DSS = {+ "rotation.completed" => ["8.3.9", "8.6.3"],+ "rotation.failed" => ["8.3.9", "10.2.1"],+ "policy.violation" => ["8.6.3", "10.2.1"],+ "drift.detected" => ["10.2.1", "11.5.2"],+ "audit.batch.sealed" => ["10.5.2", "10.5.3"],+ "key.rotation.kek" => ["3.7.4"],+ }++ ISO27001 = {+ "rotation.completed" => ["A.5.16", "A.5.17"],+ "rotation.failed" => ["A.5.17", "A.8.5"],+ "policy.violation" => ["A.5.18"],+ "drift.detected" => ["A.8.16"],+ "audit.batch.sealed" => ["A.8.15"],+ "key.rotation.kek" => ["A.8.24"],+ }++ HIPAA = {+ "rotation.completed" => ["164.308(a)(5)(ii)(D)"],+ "rotation.failed" => ["164.308(a)(5)(ii)(D)", "164.308(a)(6)(ii)"],+ "policy.violation" => ["164.308(a)(5)(ii)(D)"],+ "drift.detected" => ["164.308(a)(6)(ii)"],+ "audit.batch.sealed" => ["164.312(b)"],+ }++ def self.for(framework : String) : Hash(String, Array(String))+ case framework.downcase+ when "soc2" then SOC2+ when "pci_dss" then PCI_DSS+ when "iso27001" then ISO27001+ when "hipaa" then HIPAA+ else+ raise ArgumentError.new("unknown framework: #{framework} (valid: soc2, pci_dss, iso27001, hipaa)")+ end+ end++ def self.frameworks : Array(String)+ %w[soc2 pci_dss iso27001 hipaa]+ end+ end+end