Metadata-Version: 2.1
Name: kcwarden
Version: 0.13.0
Summary: Keycloak auditor
Home-page: https://iteratec.github.io/kcwarden/
License: Apache-2.0
Keywords: keycloak,security-scanner,oauth2,oidc
Author: Max Maass
Author-email: max.maass@iteratec.com
Requires-Python: >=3.11,<4.0
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Security
Classifier: Topic :: Software Development :: Testing
Requires-Dist: pyyaml (>=6.0.2,<7.0.0)
Requires-Dist: requests (>=2.32.3,<3.0.0)
Project-URL: Bug Tracker, https://github.com/iteratec/kcwarden/issues
Project-URL: Documentation, https://iteratec.github.io/kcwarden/
Project-URL: Repository, https://github.com/iteratec/kcwarden
Project-URL: Sponsor, https://www.iteratec.com/
Description-Content-Type: text/markdown

# kcwarden - Keycloak Configuration Auditor

![Python](https://img.shields.io/pypi/pyversions/kcwarden.svg)
[![PyPI version](https://img.shields.io/pypi/v/kcwarden.svg)](https://pypi.python.org/pypi/kcwarden)
[![Mkdocs](https://img.shields.io/badge/doc-mkdocs-845ed7.svg)](https://iteratec.github.io/kcwarden)
[![GitHub discussions](https://img.shields.io/badge/discuss-online-845ef7)](https://github.com/iteratec/kcwarden/discussions)
[![Downloads](https://pepy.tech/badge/kcwarden)](https://pepy.tech/project/kcwarden)
[![GitHub stars](https://img.shields.io/github/stars/iteratec/kcwarden?style=flat)](https://github.com/iteratec/kcwarden/stargazers)

[![last release status](https://github.com/iteratec/kcwarden/actions/workflows/publish.yaml/badge.svg)](https://github.com/iteratec/kcwarden/actions/workflows/publish.yaml)

**[kcwarden](https://iteratec.github.io/kcwarden/) checks your Keycloak configuration for common misconfigurations and security vulnerabilities.**

## 🚀 Getting started

Install it using Python:

```shell
pip install kcwarden
```

For details and other methods, see our [documentation](https://iteratec.github.io/kcwarden/installation/).

## ▶️ Usage

Download your Keycloak's config:

```shell
kcwarden download --realm $REALM --user admin --output config.json $KEYCLOAK_BASE_URL
```

and run the checks against it:

```shell
kcwarden audit config.json
```

For more information, see the [documentation on the project website](https://iteratec.github.io/kcwarden/).

## Sponsors

<a href="https://www.iteratec.com/"><img alt="Logo iteratec" src="./docs/assets/iteratec.svg" width="300"></a>

