diff --git a/.secrets.baseline b/.secrets.baseline index 085c5b6..2d342b3 100644 --- a/.secrets.baseline +++ b/.secrets.baseline @@ -167,5 +167,5 @@ } ] }, - "generated_at": "2026-11-03T03:57:50Z" + "generated_at": "2026-11-05T23:33:58Z" } diff --git a/CHANGELOG.md b/CHANGELOG.md index b246c90..c3dcdcc 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,6 +1,6 @@ --- title: Changelog -last_updated: 2026-10-27 +last_updated: 2026-11-05 owner: TBD audience: all status: active @@ -10,21 +10,36 @@ status: active ## [Unreleased] +## [8.0.0] - 2026-11-05 + ### Added + +- **Zero Trust Developer Workstation Baseline**: Published `docs/security/DEVELOPER_WORKSTATION_GUIDE.md` establishing a vendor-agnostic Zero Trust client architecture (NIST SP 800-207) with full-disk encryption (FileVault, BitLocker, LUKS), hardware-backed keys (`ed25519-sk`), and MFA-enforced perimeter access. - **Deterministic Make Toolchain Contract**: Standardized developer and automation entrypoints with `make doctor`, `make tools`, `make test-security`, and `make release-ready`. -- **Operational Scale & Sizing Boundaries**: Documented capacity ceilings for Bare Metal / VPS topologies (Brain: 1–3 High-Spec, 3–5 Low-Spec; Muscle: 50–100 workers) prior to hyperscale K8s orchestration. +- **Operational Scale & Sizing Boundaries**: Documented capacity ceilings for Bare Metal / VPS topologies (Brain: 1–3 High-Spec, 3–5 Low-Spec; Muscle: 50–100 workers) prior to hyperscale K8s orchestration in `docs/architecture/ARCHITECTURE.md`. +- **Automated Tailscale Serve UI Activation**: Integrated dynamic Tailscale Serve activation for Caddy WAF UI based on host group membership (`muscle`), eliminating per-host variable configuration. ### Changed + +- **Unified NFTables Firewall Engine (Breaking)**: Standardized entire cluster exclusively on native `nftables`, completely purging legacy `ufw` and iptables wrappers across L1 OS baseline and L2 compliance. Added strict Molecule TDD assertions verifying `ufw` package removal and active `nftables.service`. - **Ingress & Secrets Decoupling**: Decoupled `ingress_services` catalog from SOPS encryption into tracked `ingress.yml.example` and gitignored `ingress.yml` to prevent merge conflict friction and protect client domain confidentiality without encrypting non-secret routing topology. - **Unified Caddyfile SSOT**: Removed `.example.j2` copy requirement in favor of a single tracked `Caddyfile.j2` incorporating global `metrics` directive aligned with upstream. - **Upstream Caddy WAF Upgrade**: Pinned `ghcr.io/developmi/caddy-waf:v3.6.2` (Coraza v3.8.1, CRS v4) with cryptographic multi-arch sha256 digest validation. +- **Tailscale Configuration Centralization**: Consolidated Tailscale variables strictly under `inventory/group_vars/all/tailscale.yml` and SOPS secrets, eliminating redundant per-host overrides. + +### Removed + +- **Local Endpoint Hardening & Pop!\_OS Conditioning (Breaking)**: Completely purged `playbooks/ops/local-devices.yml` (-596 lines), `make deploy-local` target, `[local]` inventory groups, and Pop!\_OS desktop normalization hacks (`_os_family`) across Docker, Tailscale, and firewall rules in accordance with YAGNI and server-only scope. ### Fixed + - **Preflight Toolchain Compliance**: Replaced legacy `pip` reference in roadmap with `uv tool run` and documented upstream container entrypoint requirement in Twenty CRM compose worker. +- **Ansible Facts Consistency**: Standardized `ansible_date_time` references in Caddy roles to prevent undefined variable evaluations under gathered facts. ## [7.0.0] - 2026-10-27 ### Added + - **Platform Hardening v2**: - Configured post-quantum SSH key exchange algorithms (`sntrup761x25519-sha512@openssh.com`) alongside strict Curve25519 primitives. - Implemented passwordless `sudo` privileges scoped strictly to `dev_admin`. @@ -55,6 +70,7 @@ status: active - Native Makefile targets: `sops-init`, `sops-edit`, `sops-encrypt`, and `sops-view`. ### Changed + - **Toolchain Modernization**: Upgraded runtime floor to Python `>=3.14`, pinned `ansible-core==2.21.1`, and aligned `ansible-lint==26.6.0`. - **Backup Stack Pinning**: Pinned Restic binary and container image to `0.19.1` with per-architecture sha256 verification on AMD64 and ARM64. - **CI/CD Hardening**: @@ -64,12 +80,14 @@ status: active - Pinned Gitleaks scanner to license-safe release `v8.23.3` with verified SHA256 checksums. ### Security + - **Supply Chain Vulnerability Eradication**: - Regenerated lockfile dependencies (`uv.lock`) resolving 17 known vulnerabilities (1 CRITICAL, 6 HIGH) across transitive dependencies (`certifi`, `black`, `filelock`, `virtualenv`). - Integrated `pip-audit==2.10.1` into `dev` dependency group and aligned local validation with GitHub Actions (`uv run pip-audit --path .venv`). - Enforced pre-commit and CI secrets scanning baseline to guarantee zero plaintext credentials or unencrypted `.sops.yml` files enter version control. ### Removed + - Retired legacy `backup-db` role in favor of the unified L6 backup engine. - Purged dead and orphaned secrets from templates and inventories (`portainer_url`, `portainer_username`, `portainer_password`, redundant observability network keys). - Eliminated legacy unpinned `uvx` invocations in security workflows. diff --git a/README.md b/README.md index 4a21afe..2d52075 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@ _A layered infrastructure stack built with Ansible, Docker and Zero Trust principles._ -![Version 7.0.0](https://img.shields.io/badge/Version-7.0.0-0A84FF?style=for-the-badge&logo=semver&logoColor=white) +![Version 8.0.0](https://img.shields.io/badge/Version-8.0.0-0A84FF?style=for-the-badge&logo=semver&logoColor=white) ![Python 3.14](https://img.shields.io/badge/Python-3.14-3776AB?style=for-the-badge&logo=python&logoColor=white) ![Ansible Core 2.21.1](https://img.shields.io/badge/Ansible_Core-2.21.1-EE0000?style=for-the-badge&logo=ansible&logoColor=white) ![Docker Ready](https://img.shields.io/badge/Docker-Ready-2496ED?style=for-the-badge&logo=docker&logoColor=white) @@ -374,6 +374,7 @@ Current quality gates include: This project enforces end-to-end quality and compliance verification through a multi-tiered test pipeline spanning static validation, pre-commit hygiene, idempotency checks, and automated role/layer integration testing via **Molecule**: ### 1. Quality Gates & Linting + Validate syntax, role structure, YAML formatting, and GitHub Actions security workflows locally: ```bash @@ -388,6 +389,7 @@ make precommit-run ``` ### 2. Integration Testing with Molecule + Automated role and layer testing is executed via [Molecule](https://molecule.readthedocs.io/) using the Docker driver against systemd-enabled Debian 12 (`bookworm`) and Ubuntu 22.04 (`jammy`) containers. Each scenario exercises the complete verification lifecycle (`dependency` → `destroy` → `syntax` → `create` → `prepare` → `converge` → `idempotence` → `verify` → `cleanup` → `destroy`): ```bash @@ -403,6 +405,7 @@ make test-layer LAYER=L4_networking ``` ### 3. CI/CD & Security Audit Pipelines + - **Pull Request Gates:** [GitHub Actions](.github/workflows/ci.yml) validates playbook syntax, role directories, `ansible-lint`, `yamllint`, `gitleaks` credential scans, and workflow security audits via `zizmor` on every commit. - **Security Audit Gates:** A dedicated [security-audit.yml](.github/workflows/security-audit.yml) workflow runs on PRs and release tags (`v*`), executing credential pattern scans, SOPS value leak checks, and dependency vulnerability scans (`uv run pip-audit --path .venv`). diff --git a/docs/operations/DEVELOPER_SETUP.md b/docs/operations/DEVELOPER_SETUP.md index 5db699c..5cfa0e4 100644 --- a/docs/operations/DEVELOPER_SETUP.md +++ b/docs/operations/DEVELOPER_SETUP.md @@ -3,14 +3,14 @@ title: Developer Onboarding type: operations owner: maintainers audience: maintainer -version: v7.0.0 -last-reviewed: 2026-10-27 +version: v8.0.0 +last-reviewed: 2026-11-05 status: active project: developmi-hardened repo: github.com/Developmi/hardened --- -# Developer Onboarding - Developmi Hardened v7.0.0 +# Developer Onboarding - Developmi Hardened v8.0.0 5-step developer setup sequence to go from zero to running your first Ansible playbook. diff --git a/docs/project/RELEASE.md b/docs/project/RELEASE.md index d0a97dc..71231ff 100644 --- a/docs/project/RELEASE.md +++ b/docs/project/RELEASE.md @@ -3,8 +3,8 @@ title: Release Procedure type: project owner: maintainers audience: maintainer -version: v7.0.0 -last-reviewed: 2026-10-27 +version: v8.0.0 +last-reviewed: 2026-11-05 status: active project: developmi-hardened repo: github.com/Developmi/hardened @@ -12,7 +12,7 @@ repo: github.com/Developmi/hardened # Release Procedure -Current latest release: `v7.0.0` (see [CHANGELOG.md](../../CHANGELOG.md) for the full history). +Current latest release: `v8.0.0` (see [CHANGELOG.md](../../CHANGELOG.md) for the full history). This document defines the standard process for all future releases. diff --git a/docs/project/ROADMAP.md b/docs/project/ROADMAP.md index 6dc5234..39add2e 100644 --- a/docs/project/ROADMAP.md +++ b/docs/project/ROADMAP.md @@ -3,8 +3,8 @@ title: Development Roadmap type: project owner: maintainers audience: all -version: v6.0.0-dev -last-reviewed: 2026-07-23 +version: v8.0.0 +last-reviewed: 2026-11-05 status: active project: developmi-hardened repo: github.com/Developmi/hardened @@ -182,7 +182,7 @@ This project starts at v6.0.0. Prior development history (v1.0.0 - v5.5.0) is ma ### Planned Release Target -- `v7.0.0` - Policy maturity, scale readiness, and automation infrastructure. +- `v8.0.0` - Production-ready bare metal & VPS hardening suite with native nftables, unified restic backup engine, decoupled ingress catalog, and zero-trust workstation baseline. ## Future Implementations (Backlog) diff --git a/inventory/group_vars/all/main.yml b/inventory/group_vars/all/main.yml index 3d6cecd..1a84e53 100644 --- a/inventory/group_vars/all/main.yml +++ b/inventory/group_vars/all/main.yml @@ -1,7 +1,7 @@ --- # Platform metadata platform_name: "Developmi Hardened" -platform_version: "v7.0.0-dev" +platform_version: "v8.0.0" # Shared external Docker network (L3 observability stack, L4 caddy, L6 portainer) shared_network_name: "public_net" diff --git a/pyproject.toml b/pyproject.toml index 0d9f095..1a326aa 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,6 +1,6 @@ [project] name = "developmi-hardened" -version = "7.0.0" +version = "8.0.0" description = "Ansible-driven hardening suite for Bare Metal infrastructure" readme = "README.md" requires-python = ">=3.14" diff --git a/roles/L1_os_baseline/defaults/main.yml b/roles/L1_os_baseline/defaults/main.yml index 8ccf9a9..814e3f2 100644 --- a/roles/L1_os_baseline/defaults/main.yml +++ b/roles/L1_os_baseline/defaults/main.yml @@ -11,7 +11,7 @@ l1_apt_lock_timeout: 600 l1_file_mode: "0644" platform_name: "Developmi Hardened" -platform_version: "v7.0.0-dev" +platform_version: "v8.0.0" motd_clean_ads: true systemd_nofile_soft: 1024 diff --git a/roles/L1_os_baseline/general/tasks/motd_banner.yml b/roles/L1_os_baseline/general/tasks/motd_banner.yml index 620a7c5..cbf3839 100644 --- a/roles/L1_os_baseline/general/tasks/motd_banner.yml +++ b/roles/L1_os_baseline/general/tasks/motd_banner.yml @@ -41,7 +41,7 @@ content: | ============================================================================== Stack Developmi - {{ platform_version | default('v7.0.0-dev') }} + {{ platform_version | default('v8.0.0') }} ============================================================================== Authorized access only. All activities are monitored and logged. mode: "0644" @@ -55,7 +55,7 @@ content: | ****************************************************************************** * DEVELOPMI PLATFORM HARDENED * - * {{ platform_version | default('v7.0.0-dev') }} * + * {{ platform_version | default('v8.0.0') }} * * * * UNAUTHORIZED ACCESS TO THIS SYSTEM IS STRICTLY PROHIBITED BY LAW. * * ALL CONNECTIONS AND ACTIVITIES ARE LOGGED AND MONITORED. * diff --git a/uv.lock b/uv.lock index cf9e013..623deef 100644 --- a/uv.lock +++ b/uv.lock @@ -332,7 +332,7 @@ wheels = [ [[package]] name = "developmi-hardened" -version = "7.0.0" +version = "8.0.0" source = { virtual = "." } dependencies = [ { name = "ansible-core" },