https://github.com/fireflyframework/fireflyframework-idp-keycloak
Keycloak adapter for Firefly IDP. Implements authentication, user management, and token operations via the Keycloak Admin API.
https://github.com/fireflyframework/fireflyframework-idp-keycloak
Last synced: 4 months ago
JSON representation
Keycloak adapter for Firefly IDP. Implements authentication, user management, and token operations via the Keycloak Admin API.
- Host: GitHub
- URL: https://github.com/fireflyframework/fireflyframework-idp-keycloak
- Owner: fireflyframework
- License: apache-2.0
- Created: 2026-02-06T12:33:22.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-02-10T19:48:19.000Z (4 months ago)
- Last Synced: 2026-02-10T20:49:16.902Z (4 months ago)
- Language: Java
- Size: 74.2 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Firefly Framework - IDP - Keycloak
[](https://github.com/fireflyframework/fireflyframework-idp-keycloak/actions/workflows/ci.yml)
[](LICENSE)
[](https://openjdk.org)
[](https://spring.io/projects/spring-boot)
> Keycloak implementation of the Firefly IDP adapter with admin API integration and REST controller.
---
## Table of Contents
- [Overview](#overview)
- [Features](#features)
- [Requirements](#requirements)
- [Installation](#installation)
- [Quick Start](#quick-start)
- [Configuration](#configuration)
- [Documentation](#documentation)
- [Contributing](#contributing)
- [License](#license)
## Overview
Firefly Framework IDP Keycloak implements the `IdpAdapter` interface using Keycloak as the identity provider. It provides user management, authentication, token operations, and administrative functions through both the Keycloak Admin REST API and the token endpoint.
The module includes `IdpAdapterImpl` as the main adapter, backed by `IdpUserService` for user-facing operations, `IdpAdminService` for administrative functions, and `TokenService` for token management. It features a built-in `IdpController` REST endpoint for direct IDP operations and a `KeycloakExceptionHandler` for standardized error responses.
Auto-configuration is provided via `KeycloakAutoConfiguration` with configurable connection properties through `KeycloakProperties`.
## Features
- Full `IdpAdapter` implementation using Keycloak Admin API
- Built-in `IdpController` REST endpoint for IDP operations
- User service for authentication, registration, and profile management
- Admin service for realm and user administration
- Token service for token exchange, refresh, and introspection
- `KeycloakClientFactory` and `KeycloakAPIFactory` for API connection management
- CORS configuration for cross-origin requests
- Keycloak-specific exception handler
- Spring Boot auto-configuration via `KeycloakAutoConfiguration`
- Configurable via `KeycloakProperties`
## Requirements
- Java 21+
- Spring Boot 3.x
- Maven 3.9+
- Keycloak server instance
## Installation
```xml
org.fireflyframework
fireflyframework-idp-keycloak
26.02.06
```
## Quick Start
```xml
org.fireflyframework
fireflyframework-idp
org.fireflyframework
fireflyframework-idp-keycloak
```
## Configuration
```yaml
firefly:
idp:
keycloak:
server-url: http://localhost:8080
realm: my-realm
client-id: my-app
client-secret: my-secret
```
## Documentation
No additional documentation available for this project.
## Contributing
Contributions are welcome. Please read the [CONTRIBUTING.md](CONTRIBUTING.md) guide for details on our code of conduct, development process, and how to submit pull requests.
## License
Copyright 2024-2026 Firefly Software Solutions Inc.
Licensed under the Apache License, Version 2.0. See [LICENSE](LICENSE) for details.