Another Useless Tool Zero – Cyber Hygiene
AUT0-CH is a self-hosted web tool for managing DISA STIG checklists, SCAP results and ACAS/Nessus scans, and for producing RMF artifacts (compliance listing, POA&M, Test Plan, RAR). It is built for closed and air-gapped networks.
It is a modified version of OpenRMF® OSS (GPLv3) and is not affiliated with or endorsed by its authors. See NOTICE for attribution and the list of changes.
| Folder | What it is | Upstream |
|---|---|---|
docs/ |
Install docs, docker-compose.yml, nginx/Prometheus/Grafana config, Keycloak setup scripts |
Cingulara/openrmf-docs |
api-read/ |
Main API: upload/parse CKL, SCAP and Nessus; editing; Excel exports (checklist, POA&M, Test Plan) | Cingulara/openrmf-api-read |
api-reports/ |
Reporting API | Cingulara/openrmf-api-reports |
msg-reports/ |
NATS client that builds the reporting data (includes the second Nessus parser) | Cingulara/openrmf-msg-reports |
web/ |
NGINX + static web UI | Cingulara/openrmf-web |
tools/ |
build-images.sh, airgap-bundle.sh |
— |
docs/branding/ |
Logo SVGs (mark, wordmark, reverse), PNG exports, social preview, original concept images | — |
All other services (scoring, template, controls, audit APIs; score/compliance/controls/template/system/audit message clients; MongoDB; NATS; Keycloak; Postgres; Prometheus; Grafana) run as stock upstream images. DISA template updates therefore still arrive by pulling newer upstream api-template / msg-template images.
Connected staging machine (Docker or Podman, network access to NuGet and Docker Hub):
tools/build-images.sh # builds localhost/aut0-ch/{api-read,api-reports,msg-reports,web}:0.1.0
tools/airgap-bundle.sh save docs/scripts/docker-compose.yml # saves all 23 images + config + SHA256SUMSAir-gapped host:
tools/airgap-bundle.sh load <bundle-dir>
cd <bundle-dir>/aut0-ch-release
# set host IP/DNS in .env and .grafana, then:
./start.sh
# after 2–3 minutes:
sudo keycloak/setup-realm-linux.shThen follow docs/step-by-step.md steps 5–7 (Keycloak redirect URIs and first user) and docs/securing-openrmf.md (change every default password).
Every pull request and every push to main is tested automatically on GitHub (Actions tab, workflow CI). No local setup is needed.
| Check | What it proves |
|---|---|
Unit tests (api-read, api-reports, msg-reports) |
The services compile and their dotnet test suites pass, including the CKLB converter tests |
End-to-end smoke test (tools/e2e/smoke-test.sh) |
The four AUT0-CH images build. The full 23-container stack starts and Keycloak is configured by the realm script. A user logs in, and a DISA RHEL 9 CKLB is uploaded. The test then checks the checklist record, the asynchronous scoring (10 open / 20 NaF / 5 N/A of 445), the CKL download, that a re-upload updates in place, and that a bogus .cklb is rejected. |
| Export images (main, or Run workflow with export_images) | Produces aut0-ch-images.tar.gz plus SHA256SUMS as a downloadable artifact, ready for docker load on the air-gapped side |
To run the smoke test yourself on any Linux box with Docker: tools/build-images.sh && sudo tools/e2e/smoke-test.sh (set KEEP=1 to leave the stack running and browse to http://<host>:8080, user ci-admin).
These identifiers are shared with the stock upstream services or with existing data, so they keep their openrmf names:
- NATS subjects (
openrmf.checklist.save.new, …) - MongoDB database and user names, and
docs/scripts/initialize*.js - Keycloak realm and client id
openrmf, and role names - Compose service/container names (
checklistdb,natsserver,openrmfapi-*,openrmf-web,openrmf-keycloak) - C# namespaces and Prometheus metric names
Each folder is a git subtree with an upstream-<folder> remote:
git fetch upstream-api-read master
git subtree pull --prefix=api-read upstream-api-read master --squash -m "Merge upstream openrmf-api-read"(The same applies to docs, api-reports, msg-reports, and web.) Re-check NOTICE and the compose image tags after each upstream merge.
.cklbimport (CKLB → CKL at upload), with.cklbadded to the web upload filter- Nessus: better host identity than masked IPs, credentialed vs. uncredentialed separation, auth-failure flags, POA&M control numbers
- Excel exports driven by templates mounted from a volume instead of hardcoded C#
- Multiple scans per system package (GridFS); CKLB export with UUIDs preserved
GPLv3 — see LICENSE. Every upstream source file keeps its original notices.