Keycloak, An Optimized Image Proven Through The Admin API
Keycloak 26 (SHA-256 pinned) on Java 21, an image the service cannot write to, on EL 10 from the upstream release, as a hardened systemd service on loopback; the live test takes an admin token, sees a wrong password and an anonymous admin request refused, creates a realm (201), duplicates it (409), reads its OpenID discovery document and deletes it. Original role, live-tested on Rocky Linux 10.
Verification
Live-testedReally deployed to a container sandbox, proven idempotent (a second run changes nothing), verified against the role’s assertions, then torn down.
Conformance
- Static validation (yamllint · ansible-lint)
Provenance
- SHA-256 checksum
- Signature (pending)
Functional
- Live-tested - applied, verified, destroyed
Last verified 2026-09-21 · podman 4.9.3 · ansible 2.21.4 · how we verify
Cite it in your README
badge · attributionPaste this beside the module in the repository that uses it. The badge is rendered from this artifact's verification record, so it reads live-tested because the record says so, and the link lands on this page.
[](https://www.iac-bazaar.com/catalog/ansible-keycloak?utm_source=syndication&utm_medium=readme&utm_campaign=artifact)
Ansible role 1.0.0, live-tested on IaC Bazaar: [Keycloak, An Optimized Image Proven Through The Admin API](https://www.iac-bazaar.com/catalog/ansible-keycloak?utm_source=syndication&utm_medium=readme&utm_campaign=artifact)
```yaml
# Keycloak, An Optimized Image Proven Through The Admin API: https://www.iac-bazaar.com/catalog/ansible-keycloak (download from your IaC Bazaar account)
```Preview:
Documentation
keycloak
Keycloak from the upstream release (SHA-256 pinned), on Java 21 from AppStream, built once into an optimized server image the service cannot write to, as a hardened system service on loopback with health and metrics on the management port. Original role for EL 10, live-tested with podman on Rocky Linux 10.
No package, and the release is run in place. EL 10 carries no
Keycloak; the vendor publishes a PGP signature beside the release and no
checksum file, so this role pins the SHA-256 beside the version and has
Ansible's get_url refuse the asset unless it matches. The tree is
unpacked under /usr/local/src, root-owned, and the unit runs bin/kc.sh
from inside it: nothing is copied into the PATH. A new release is a new
pair, on purpose.
A service account, a hardened unit, a loopback listener. keycloak
is a system user with no shell that owns the data directory and nothing
else; the unit runs with NoNewPrivileges, PrivateTmp, ProtectHome and
ProtectSystem=strict. The listener is 127.0.0.1 by default,
for a proxy that authenticates or a client on the same host; the live test
reads the listening sockets and expects loopback only.
Proven through the admin API. The live test waits for
/health/ready on the management port, takes an admin token with the
password grant, sees a wrong password refused and an anonymous admin
request answered 401, creates a realm (201), creates it again (409),
reads the realm's OpenID discovery document, deletes it (204) and reads
the JVM metrics.
The tree stays root-owned. kc.sh build runs as root whenever
keycloak.conf changes (it is the template's validate step, so a build
the server refuses fails the render before the file lands) and the unit
starts the optimized image; the only path Keycloak writes at runtime, <home>/data,
is a link into /var/lib/keycloak. The live test runs on the embedded
dev-file store; set keycloak_db and the connection variables for a
PostgreSQL, MariaDB or MySQL, and keycloak_hostname plus
keycloak_proxy_headers behind the proxy that terminates TLS.
License
Commercial - IaC Bazaar EULA. (c) IaC Bazaar.
Usage code & full reference need an account
The complete copy-paste usage, the full input/output reference, and operational notes are free with an account - shown here and bundled in the download. Sign in and this section fills in.
- Variables
- Test
Related modules
ansible-lynis
Lynis from EPEL on a systemd timer, with the units the package keeps only in its docs, your skipped tests in custom.prf, and a minimum hardening index below which the audit unit fails, so a falling score shows as a failed unit. The live test runs the audit, reads the index and the tests that ran, and finds the timer enabled. Original role, live-tested on Rocky Linux 10.
ansible-suricata
Suricata from EPEL watching the default-route interface as the suricata user, ET Open fetched at install and refreshed daily, plus a canary rule that proves the sensor is alive. A root-run check left root-owned logs and a daemon recording nothing; the role prevents it. The live test raises the canary alert while a second lookup is logged, not alerted. Original role, live-tested on Rocky Linux 10.
ansible-aide
AIDE from AppStream on EL 10: a watched tree, a baseline database built once, and the oneshot unit and timer the package does not ship. The live test passes on an unchanged host, FAILS when a file appears inside a watched path and names it, ignores one inside an excluded path, and passes again once the change is gone. Original role, live-tested on Rocky Linux 10.
ansible-389-ds
389 Directory Server from AppStream. A fresh instance listens on every interface and lets anonymous clients read the tree; this role binds both listeners to loopback and limits anonymous clients to the rootDSE. The live test adds a user who binds, sees a wrong password and an anonymous search refused, and reads the LDAPS certificate. Original role, live-tested on Rocky Linux 10.
ansible-krb5-kdc
An MIT Kerberos KDC: the realm created once with a stash, kadmind behind an ACL, a default policy that locks an account after five wrong passwords, every listener on loopback. The KDC starts on a broken config without a word, so the live test proves each setting by behaviour: the ticket lifetime, the refusals, the lockout. Original role, live-tested on Rocky Linux 10.
ansible-authelia
Authelia from the upstream release (sha256-verified) as a hardened system service on loopback with file users and sqlite; its secrets are generated once on the host and reach the service as AUTHELIA_*_FILE variables. The live test hashes a password with Authelia's hasher, logs in, sees a wrong password refused and an anonymous visitor sent to the portal. Original role, live-tested on Rocky 10.