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(rotators): Vault dynamic-secrets rotator + thin Vault client
CarterPerez-devd431e9014e68
diff --git a/PROJECTS/intermediate/credential-rotation-enforcer/spec/unit/rotators/vault_dynamic_spec.cr b/PROJECTS/intermediate/credential-rotation-enforcer/spec/unit/rotators/vault_dynamic_spec.crnew file mode 100644index 00000000..1571e890--- /dev/null+++ b/PROJECTS/intermediate/credential-rotation-enforcer/spec/unit/rotators/vault_dynamic_spec.cr@@ -0,0 +1,95 @@+# ===================+# ©AngelaMos | 2026+# vault_dynamic_spec.cr+# ===================++require "../../spec_helper"+require "webmock"+require "../../../src/cre/rotators/vault_dynamic"++WebMock.allow_net_connect = false++private def vault_credential(current_lease : String? = nil)+ tags = {"role_path" => "database/creds/myrole"} of String => String+ tags["current_lease_id"] = current_lease if current_lease+ CRE::Domain::Credential.new(+ id: UUID.random,+ external_id: "database/creds/myrole",+ kind: CRE::Domain::CredentialKind::VaultDynamic,+ name: "myrole",+ tags: tags,+ )+end++private def vault_client+ CRE::Vault::Client.new(addr: "http://vault.test", token: "tok")+end++describe CRE::Rotators::VaultDynamicRotator do+ before_each { WebMock.reset }++ it "executes the full 4-step contract with lease revocation on commit" do+ cred = vault_credential(current_lease: "database/creds/myrole/old")++ WebMock.stub(:get, "http://vault.test/v1/database/creds/myrole")+ .to_return(body: %({"lease_id":"database/creds/myrole/new","lease_duration":3600,"data":{"username":"u","password":"p"}}))++ rotator = CRE::Rotators::VaultDynamicRotator.new(vault_client)+ rotator.can_rotate?(cred).should be_true++ new_secret = rotator.generate(cred)+ new_secret.metadata["lease_id"].should eq "database/creds/myrole/new"+ new_secret.metadata["old_lease_id"].should eq "database/creds/myrole/old"++ rotator.apply(cred, new_secret) # no-op++ WebMock.stub(:put, "http://vault.test/v1/sys/leases/renew")+ .to_return(body: %({"lease_id":"database/creds/myrole/new","lease_duration":3600}))+ rotator.verify(cred, new_secret).should be_true++ revoked = false+ WebMock.stub(:put, "http://vault.test/v1/sys/leases/revoke")+ .with(body: %({"lease_id":"database/creds/myrole/old"}))+ .to_return { |_| revoked = true; HTTP::Client::Response.new(200, body: "{}") }+ rotator.commit(cred, new_secret)+ revoked.should be_true+ end++ it "verify returns false on Vault error" do+ cred = vault_credential+ WebMock.stub(:put, "http://vault.test/v1/sys/leases/renew")+ .to_return(status: 403, body: %({"errors":["denied"]}))+ rotator = CRE::Rotators::VaultDynamicRotator.new(vault_client)+ s = CRE::Domain::NewSecret.new(+ ciphertext: "{}".to_slice,+ metadata: {"lease_id" => "x"},+ )+ rotator.verify(cred, s).should be_false+ end++ it "rollback_apply revokes the new lease" do+ cred = vault_credential+ rotator = CRE::Rotators::VaultDynamicRotator.new(vault_client)+ s = CRE::Domain::NewSecret.new(+ ciphertext: "{}".to_slice,+ metadata: {"lease_id" => "new-lease-id"},+ )+ revoked = false+ WebMock.stub(:put, "http://vault.test/v1/sys/leases/revoke")+ .with(body: %({"lease_id":"new-lease-id"}))+ .to_return { |_| revoked = true; HTTP::Client::Response.new(200, body: "{}") }+ rotator.rollback_apply(cred, s)+ revoked.should be_true+ end++ it "skips lease revocation when no current_lease_id" do+ cred = vault_credential # no current_lease_id+ WebMock.stub(:get, "http://vault.test/v1/database/creds/myrole")+ .to_return(body: %({"lease_id":"new","lease_duration":3600,"data":{"username":"u","password":"p"}}))+ rotator = CRE::Rotators::VaultDynamicRotator.new(vault_client)+ s = rotator.generate(cred)+ # commit should be a no-op (no old lease to revoke)+ rotator.commit(cred, s)+ # If a stub was missing webmock would have raised; absence proves no PUT happened.+ end+enddiff --git a/PROJECTS/intermediate/credential-rotation-enforcer/spec/unit/vault/client_spec.cr b/PROJECTS/intermediate/credential-rotation-enforcer/spec/unit/vault/client_spec.crnew file mode 100644index 00000000..0f8ae663--- /dev/null+++ b/PROJECTS/intermediate/credential-rotation-enforcer/spec/unit/vault/client_spec.cr@@ -0,0 +1,57 @@+# ===================+# ©AngelaMos | 2026+# client_spec.cr+# ===================++require "../../spec_helper"+require "webmock"+require "../../../src/cre/vault/client"++WebMock.allow_net_connect = false++private def fresh_client+ CRE::Vault::Client.new(addr: "http://vault.test", token: "test-token")+end++describe CRE::Vault::Client do+ before_each { WebMock.reset }++ it "reads a dynamic secret" do+ WebMock.stub(:get, "http://vault.test/v1/database/creds/myrole")+ .with(headers: {"X-Vault-Token" => "test-token"})+ .to_return(body: %({+ "lease_id":"database/creds/myrole/abc",+ "lease_duration":3600,+ "data":{"username":"v-token-myrole-xyz","password":"hunter2"}+ }))++ secret = fresh_client.read_dynamic("database/creds/myrole")+ secret.lease_id.should eq "database/creds/myrole/abc"+ secret.lease_duration.should eq 3600+ secret.username.should eq "v-token-myrole-xyz"+ secret.password.should eq "hunter2"+ end++ it "revokes a lease" do+ called = false+ WebMock.stub(:put, "http://vault.test/v1/sys/leases/revoke")+ .with(body: %({"lease_id":"database/creds/myrole/abc"}))+ .to_return { |_| called = true; HTTP::Client::Response.new(200, body: "{}") }+ fresh_client.revoke_lease("database/creds/myrole/abc")+ called.should be_true+ end++ it "renews a lease" do+ WebMock.stub(:put, "http://vault.test/v1/sys/leases/renew")+ .to_return(body: %({"lease_id":"x","lease_duration":7200}))+ fresh_client.renew_lease("x").should eq 7200+ end++ it "raises VaultError on non-2xx" do+ WebMock.stub(:get, "http://vault.test/v1/database/creds/missing")+ .to_return(status: 404, body: %({"errors":["role missing"]}))+ expect_raises(CRE::Vault::VaultError) do+ fresh_client.read_dynamic("database/creds/missing")+ end+ end+enddiff --git a/PROJECTS/intermediate/credential-rotation-enforcer/src/cre/rotators/vault_dynamic.cr b/PROJECTS/intermediate/credential-rotation-enforcer/src/cre/rotators/vault_dynamic.crnew file mode 100644index 00000000..9648eb21--- /dev/null+++ b/PROJECTS/intermediate/credential-rotation-enforcer/src/cre/rotators/vault_dynamic.cr@@ -0,0 +1,85 @@+# ===================+# ©AngelaMos | 2026+# vault_dynamic.cr+# ===================++require "json"+require "../vault/client"+require "./rotator"++module CRE::Rotators+ # VaultDynamicRotator manages dynamic-secrets-engine credentials in HashiCorp+ # Vault. Vault itself is the secret factory: we ask it for fresh creds and+ # revoke old leases on commit.+ #+ # Required Credential.tags:+ # "role_path" - e.g. "database/creds/my-postgres-role"+ # Optional "current_lease_id" - the lease to revoke on commit; if absent+ # the rotator only revokes the NEW lease on rollback (apply step).+ class VaultDynamicRotator < Rotator+ register_as :vault_dynamic++ def initialize(@client : Vault::Client)+ end++ def kind : Symbol+ :vault_dynamic+ end++ def can_rotate?(c : Domain::Credential) : Bool+ c.kind.vault_dynamic? && !c.tag("role_path").nil?+ end++ def generate(c : Domain::Credential) : Domain::NewSecret+ raise RotatorError.new("missing 'role_path' tag") unless can_rotate?(c)+ role_path = c.tag("role_path").not_nil!+ ds = @client.read_dynamic(role_path)++ payload = {+ "username" => ds.username,+ "password" => ds.password,+ }.to_json++ Domain::NewSecret.new(+ ciphertext: payload.to_slice,+ metadata: {+ "lease_id" => ds.lease_id,+ "lease_duration" => ds.lease_duration.to_s,+ "old_lease_id" => c.tag("current_lease_id") || "",+ "username" => ds.username,+ },+ )+ end++ def apply(c : Domain::Credential, s : Domain::NewSecret) : Nil+ _ = {c, s}+ # Vault already issued the new credentials and they're live. No-op.+ end++ def verify(c : Domain::Credential, s : Domain::NewSecret) : Bool+ _ = c+ lease_id = s.metadata["lease_id"]?+ return false if lease_id.nil? || lease_id.empty?+ # Lease renewal acts as a liveness check: if the lease is invalid Vault+ # will return non-2xx and we get an exception.+ @client.renew_lease(lease_id, increment: 0)+ true+ rescue+ false+ end++ def commit(c : Domain::Credential, s : Domain::NewSecret) : Nil+ _ = c+ old = s.metadata["old_lease_id"]?+ return if old.nil? || old.empty?+ @client.revoke_lease(old)+ end++ def rollback_apply(c : Domain::Credential, s : Domain::NewSecret) : Nil+ _ = c+ lease_id = s.metadata["lease_id"]?+ return if lease_id.nil? || lease_id.empty?+ @client.revoke_lease(lease_id) rescue nil+ end+ end+enddiff --git a/PROJECTS/intermediate/credential-rotation-enforcer/src/cre/vault/client.cr b/PROJECTS/intermediate/credential-rotation-enforcer/src/cre/vault/client.crnew file mode 100644index 00000000..329628c6--- /dev/null+++ b/PROJECTS/intermediate/credential-rotation-enforcer/src/cre/vault/client.cr@@ -0,0 +1,75 @@+# ===================+# ©AngelaMos | 2026+# client.cr+# ===================++require "http/client"+require "json"++module CRE::Vault+ class VaultError < Exception+ getter status : Int32++ def initialize(message : String, @status : Int32)+ super(message)+ end+ end++ class Client+ record DynamicSecret,+ lease_id : String,+ lease_duration : Int32,+ username : String,+ password : String++ def initialize(@addr : String, @token : String)+ end++ def read_dynamic(role_path : String) : DynamicSecret+ json = http_get("/v1/#{role_path}")+ data = json["data"]+ lease_id = json["lease_id"].as_s+ lease_duration = json["lease_duration"].as_i+ DynamicSecret.new(+ lease_id: lease_id,+ lease_duration: lease_duration,+ username: data["username"].as_s,+ password: data["password"].as_s,+ )+ end++ def revoke_lease(lease_id : String) : Nil+ http_put("/v1/sys/leases/revoke", {"lease_id" => lease_id}.to_json)+ end++ def renew_lease(lease_id : String, increment : Int32 = 0) : Int32+ payload = increment > 0 ? {"lease_id" => lease_id, "increment" => increment} : {"lease_id" => lease_id}+ json = http_put("/v1/sys/leases/renew", payload.to_json)+ json["lease_duration"].as_i+ end++ def health : Hash(String, JSON::Any)+ json = http_get("/v1/sys/health")+ json.as_h+ end++ private def http_get(path : String) : JSON::Any+ uri = URI.parse(@addr + path)+ headers = HTTP::Headers{"X-Vault-Token" => @token}+ response = HTTP::Client.get(uri.to_s, headers: headers)+ raise VaultError.new("vault GET #{path}: #{response.body[0, 200]?}", response.status_code) unless response.status_code < 300+ JSON.parse(response.body)+ end++ private def http_put(path : String, body : String) : JSON::Any+ uri = URI.parse(@addr + path)+ headers = HTTP::Headers{+ "X-Vault-Token" => @token,+ "Content-Type" => "application/json",+ }+ response = HTTP::Client.put(uri.to_s, headers: headers, body: body)+ raise VaultError.new("vault PUT #{path}: #{response.body[0, 200]?}", response.status_code) unless response.status_code < 300+ response.body.empty? ? JSON::Any.new(Hash(String, JSON::Any).new) : JSON.parse(response.body)+ end+ end+end