Skip to content

feat(soc): enrol garuda in odin's Wazuh and Velociraptor (ADR-0092) - #1163

Merged
Gerrrt merged 4 commits into
mainfrom
gerrrt/garuda-soc-enrol-921
Oct 10, 2026
Merged

Gerrrt merged 4 commits into
mainfrom
gerrrt/garuda-soc-enrol-921

Conversation

@Gerrrt

@Gerrrt Gerrrt commented Oct 10, 2026

Copy link
Copy Markdown
Owner

Refs #921 (phase 2).

garuda becomes the first Linux guest enrolled in odin's Wazuh and Velociraptor. ADR-0092 records the decision that ADR-0091 deferred.

What changes

  • stacks/soc/Caddyfile: 8448 now also answers 10.0.30.62/32.

  • stacks/soc/linux-agents.yaml: pins the Wazuh agent .deb at 4.14.8, the manager's version, by sha256 6ed202e2…8967.

    • That hash matches what Wazuh's apt index lists for wazuh-agent 4.14.8-1.
    • The index is covered by dists/stable/InRelease, which has a good signature from the Wazuh Signing Key (0DCF CA55 47B1 9D2A 6099 5060 96B3 EE5F 2911 1145).
  • scripts/stage-agent-msis.sh: besides the six's MSIs, it now stages:

    • that Wazuh .deb, refused if it doesn't match the pin;
    • a Velociraptor client .deb built by the server, config client then debian client. A trial build in soc-velociraptor produced velociraptor_client_0.77.3_amd64.deb. Builds aren't reproducible, so one already staged for the running server version is kept, and its sha256 is printed for the install to check against.
  • WazuhAgentsNotConnected: up{job=~"windows|garuda-alloy"} is now the set of guests that must have an Active agent. garuda's Alloy stands in for its missing windows_exporter, and the match is still by name.

    • The description no longer assumes Windows.
    • There are three new promtool cases: garuda up with no agent fires, garuda Active stays quiet, and eden's Alloy alone stays quiet.
  • Garuda's runbook §12, phase 2:

    • check both packages' hashes;
    • install the Wazuh agent without the password, then write authd.pass from stdin, restart, and remove the file once enrolled;
    • install the Velociraptor .deb.

    The teardown section becomes §13.

  • Docs: ADR-0030's port table, security.md's 8448 row, the SOC README, the roadmap, architecture.md, network.md, the changelog and a note on ADR-0091.

Checks

  • Local: check_docs.py, lint, check_sops_rules.py, and bash -n on the staging script all pass. The pin parser reads both pin files correctly.
  • promtool 3.15.0 (the pinned image's version): check rules and test rules on soc pass.

Deploy, after merge

  1. On odin: git pull, then make up STACK=soc to reload Caddy, then sudo scripts/stage-agent-msis.sh.
  2. On alexander: make up STACK=lab, so the lab Prometheus loads the changed rule.
  3. On garuda: runbook §12, then check that the agent is Active on odin and the client appears in Velociraptor.

🤖 Generated with Claude Code

Phase 2 of the analyst workstation, the first Linux guest in either.

- ADR-0092: two Debian packages staged on odin and served on 8448, which
  now also answers garuda (.62); enrolment by garuda's runbook, as ADR-0077
  keeps Linux guests out of ansible/.
- stacks/soc/linux-agents.yaml: the Wazuh agent 4.14.8 .deb, pinned by
  version and sha256. The hash agrees with Wazuh's apt index, covered by a
  good signature on InRelease from the Wazuh Signing Key.
- stage-agent-msis.sh: also stages that .deb, and a Velociraptor client .deb
  the server builds with its config inside (kept per server version, its
  sha256 printed).
- WazuhAgentsNotConnected: garuda's agent is expected while garuda's Alloy
  is up; three promtool cases.
- garuda's runbook section 12, phase 2: fetch, check both hashes, install,
  enrol with the password on standard input only. Teardown becomes section 13.
- ADR-0030's port table, security.md's 8448 row, the SOC README, roadmap,
  architecture, network and changelog say who is served now.

Refs #921.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Copilot AI balanced review requested due to automatic review settings October 10, 2026 21:57
@Gerrrt
Gerrrt enabled auto-merge (squash) October 10, 2026 21:59

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Changes recommended

Reused Debian packages bypass validation, and several documentation and ADR inconsistencies remain.

5 open findings
What changed in this PR

Enrols garuda in odin’s Wazuh and Velociraptor services as issue #921 phase 2.

Changes:

  • Stages and serves pinned Linux agent packages.
  • Extends Wazuh monitoring to garuda.
  • Adds ADR-0092 and deployment documentation.
File Description
stacks/​soc/​README.md Documents Linux agent packages.
stacks/​soc/​linux-agents.yaml Pins the Wazuh Debian package.
stacks/​soc/​Caddyfile Allows garuda to fetch packages.
stacks/​lab/​prometheus/​tests/​soc.test.yaml Tests garuda agent alerts.
stacks/​lab/​prometheus/​rules/​soc.rules.yaml Monitors garuda through Alloy.
scripts/​stage-agent-msis.sh Stages Debian agent packages.
README.md Updates the ADR count.
docs/​security.md Updates the package threat model.
docs/​runbooks/​provision-lab-guests.md Corrects the teardown section reference.
docs/​runbooks/​build-the-analyst-workstation.md Adds agent installation instructions.
docs/​roadmap.md Records phase 2’s ADR.
docs/​network.md Documents SOC traffic from garuda.
docs/​changelog.md Records the authored change.
docs/​architecture.md Records garuda’s enrolment.
docs/​adr/​0092-enrol-garuda-in-odins-soc-with-debian-packages-staged-on-odin.md Defines the enrolment decision.
docs/​adr/​0091-put-a-kali-purple-analyst-workstation-on-saruman.md Links the deferred phase to ADR-0092.
docs/​adr/​0030-give-the-security-tooling-its-own-guest-and-its-own-stack.md Updates historical port consumers.

🧠 Review effort: Balanced


💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread scripts/stage-agent-msis.sh Resolved
Comment thread docs/security.md Resolved
Comment thread stacks/soc/Caddyfile Resolved
Gerrrt and others added 2 commits October 10, 2026 15:04
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- stage-agent-msis.sh: a Velociraptor .deb kept from an earlier run gets the
  same checks as a fresh build (non-empty, a Debian package, and version
  equal to the server's) before it is served and its hash printed.
- ADR-0030: its port table is back as accepted; a dated note points to
  ADR-0092, per ADR-0001.
- The first-start claim that Velociraptor built "MSI, deb and rpm" is
  corrected in compose.yaml and build-the-soc-guest.md to what odin's
  datastore holds: an MSI and an RPM, no Debian package.
- security.md's 8448 row: the ADR link is relative to docs/, the row covers
  both Velociraptor packages and the seven addresses, and rotation includes
  rebuilding the staged .deb.
- build-the-soc-guest.md section 11, scripts/README.md and group_vars say
  8448 answers garuda and that staging includes the two .debs.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Gerrrt
Gerrrt merged commit b5e7e4b into main Oct 10, 2026
8 checks passed
@Gerrrt
Gerrrt deleted the gerrrt/garuda-soc-enrol-921 branch October 10, 2026 22:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants