KeycloakApplication · Redhat

CVE-2021-20323

MEDIUM · 6.1 CVSS v3.1 Published 2022-03-25
Fix available
A fix is available. Upgrade to 17.0.0 or later.
See remediation →
68/100
Remediation priority · Elevated
Remotely reachable No privileges

Official description Straight from the sourceThe vendor's or NVD's own wording, published unedited. Authoritative, but often terse — it says what broke, rarely what to do.

NVD · unedited
A POST based reflected Cross Site Scripting vulnerability on has been identified in Keycloak.

Technical summary Written by usOur analysis, written from the advisory, the CVSS vector and the affected-version data. It adds context the advisory leaves out, and never invents facts that are not in the source.

dbcve analysis · moderate confidence

A POST-based reflected Cross-Site Scripting (XSS) vulnerability exists in Keycloak. The vulnerability allows attackers to inject malicious scripts through POST parameters that are reflected back in the server's response without proper sanitization, potentially leading to session hijacking or credential theft.

MitigationImplement robust input validation and output encoding for all user-supplied POST parameters. Apply context-appropriate escaping when rendering user input in HTML responses.

Verify against the referenced sources before acting — the references below are authoritative for this CVE, this summary is not.

Affected products & versions What the vendor confirmedThe version ranges the vendor confirmed as vulnerable. If your version sits inside a range here, treat yourself as exposed until you have upgraded.

NVD · CPE data
KeycloakApplication
Affected:< 17.0.0

CVSS breakdown How the score is builtThe industry scoring standard. It rates how the flaw is reached, what it takes to exploit, and what an attacker gains — the score is derived from those, not the other way round.

From the vector
Attack vector
Network
Complexity
Low
Privileges
None
User interaction
Required
Scope
Changed
Confidentiality
Low
Integrity
Low
Availability
None

CVSS:3.1/AV:N/AC:L/PR:N/UI:R/S:C/C:L/I:L/A:N

Am I affected? How to checkSteps we derive from the advisory and the affected-version data, so you can decide whether this CVE reaches your setup. They are a guide, not a scan — your own configuration is the authority.

dbcve checks

Work through these to decide whether this CVE applies to you.

  1. Identify Keycloak version
    Check the installed Keycloak version by reviewing the server startup logs, the 'product.version' in /opt/keycloak/bin/kc.sh --version (if CLI accessible), or the pom.xml/build.gradle if source is available
    Affected if The installed version is below 17.0.0 (e.g., 16.x, 15.x, 14.x, etc.)
  2. Confirm admin console is accessible
    Access the Keycloak admin console at /auth/admin/ or /admin/ and verify the login page loads without errors
    Affected if The admin console is reachable and running on an affected version
  3. Review custom themes for unsafe output
    Inspect any custom themes in the themes/ directory. Look for .ftl (FreeMarker) templates that directly render request parameters without using <@c.out> or equivalent escaping macros
    Affected if Custom themes render POST parameters directly in responses without proper encoding
  4. Check for reverse proxy configuration
    Examine any reverse proxy (nginx, Apache, HAProxy) in front of Keycloak that might normalize or pass through POST parameters without sanitization
    Affected if A reverse proxy passes POST parameters to Keycloak without filtering malicious input patterns
  5. Test for parameter reflection
    Submit a harmless test string like '<script>test</script>' in a POST request to common Keycloak endpoints (login, registration, account, admin). Inspect the HTTP response to see if the raw string appears unescaped
    Affected if The test string appears in the response body as '<script>test</script>' rather than '&lt;script&gt;test&lt;/script&gt;'

The environment is affected if Keycloak version is below 17.0.0 AND POST parameters are reflected in server responses without HTML encoding.

Generated from the published advisory. Verify against your own configuration.

Check your environment

Paste your version and any relevant configuration and it will be compared against the affected criteria above. Do not include secrets or credentials.

AI-assisted, checked against the advisory. Informational, not a guarantee.

Remediation Closing itWhat it takes to close this. Where a vendor fix exists we point at it; where none exists we say so plainly, and can build one. Effort estimates are scoped from the advisory, not from your codebase.

dbcve · scoped
Upgrade available Upgrade to 17.0.0 or later
Fixed in 17.0.0
Interim mitigation

Implement robust input validation and output encoding for all user-supplied POST parameters. Apply context-appropriate escaping when rendering user input in HTML responses.

Recommended fix High confidence

Keycloak 17.0.0

  1. Download Keycloak 17.0.0 or later from the official Keycloak releases page
  2. Review the Keycloak 17.0.0 migration guide for breaking changes from your current version
  3. Backup your existing Keycloak database and configuration
  4. Stop the current Keycloak instance
  5. Install Keycloak 17.0.0 in your target environment
  6. Run the database migration scripts if required by your database type
  7. Start the new Keycloak instance and verify all realms and clients are functioning correctly
  8. Test the application integrations to ensure authentication flows work properly
Caveat Keycloak 17.0.0 introduced Quarkus migration with significant architectural changes; legacy server distribution replaced by Quarkus-based distribution, may require configuration and migration adjustments

Generated from the published advisory — verify against the referenced sources before acting.

Fix this in Keycloak Scoped from the published advisory
  • Consultation4.0 h
  • Implementation8.0 h
  • Testing4.0 h
  • Review / QA2.0 h
18.0 hours of engineering $3,200
Get the upgrade done

An estimate, not a bill — we confirm scope with you before any work starts. Need it this week? Rush from $5,120.

Scan for this in your stack

Free · runs locally
dbcve dependency scanner

Check whether your project pulls in CVE-2021-20323 — or any other known-vulnerable package — straight from your lock files. Free and open source; it runs locally and uploads nothing.

References Go to the primary sourcePrimary sources — vendor advisories, patches and trackers. Where our summary and a reference disagree, the reference wins.

Primary sources

Practitioner notes

Contributed

Peer-ranked notes from engineers who’ve handled CVE-2021-20323 in production — separate from our analysis above.

No notes yet

Be the first to add a field note for this CVE — a mitigation you’ve verified, a version caveat, or a link to a working fix. Sign in above to contribute.

What this is

A place for practitioners to share what actually worked: a mitigation you’ve tested, a configuration change, a version- or environment-specific caveat, or a link to a verified patch. The most useful notes rise to the top as peers upvote them, so the signal stays high.

What belongs here
  • Verified mitigations, workarounds, and config changes
  • Version or environment caveats, and links to real fixes
  • No weaponised exploit code, or anything meant to cause harm
  • No spam, self-promotion, credentials, or personal data