Metadata-Version: 2.4
Name: kcwarden
Version: 0.18.0rc3
Summary: Keycloak auditor
Project-URL: Homepage, https://iteratec.github.io/kcwarden/
Project-URL: Repository, https://github.com/iteratec/kcwarden
Project-URL: Documentation, https://iteratec.github.io/kcwarden/
Project-URL: Bug Tracker, https://github.com/iteratec/kcwarden/issues
Project-URL: Sponsor, https://www.iteratec.com/
Author-email: Max Maass <max.maass@iteratec.com>, Tim Walter <tim.walter@iteratec.com>
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: keycloak,oauth2,oidc,security-scanner
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Security
Classifier: Topic :: Software Development :: Testing
Requires-Python: <4,>=3.11
Requires-Dist: pyyaml<7,>=6.0.2
Requires-Dist: requests<3,>=2.32.3
Requires-Dist: rich<16,>=14
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>
