acsystems/keycloak-authenticator-bundle

Keycloak connector for stateless JWT authentication

1.1.0 2024-01-10 14:18 UTC

Requires

• php: >=8.1
• ext-openssl: *
• firebase/php-jwt: ^6.10
• symfony/cache: >=6.1
• symfony/security-bundle: >=6.1
• symfony/yaml: >=6.1

Requires (Dev)

• codeception/codeception: ^5.0
• codeception/module-asserts: *
• codeception/module-phpbrowser: *

MIT

• ACSystems

README

The goal of this bundle is to provide a Keycloak token authenticator for Symfony.

Documentation

Quick start

Installation

Install the package from packagist using composer

composer require acsystems/keycloak-authenticator-bundle

Add the bundle.

config/bundles.php

return [
    ACSystems\KeycloakAuthenticatorBundle\ACSystemsKeycloakAuthenticatorBundle::class => ['all' => true]
];

Set up Symfony Security to use the custom authenticator.

config/packages/security.yaml

security:
  firewalls:
    main:
      stateless: true
      custom_authenticators:
        - ACSystems\KeycloakAuthenticatorBundle\Security\KeycloakTokenAuthenticator

  access_control:
    # ...

Add your keycloak base url and realm

config/packages/keycloak_authenticator.yaml:

acsystems_keycloak_authenticator:
  keycloak_authenticator:
    base_uri: 'https://example.com/'
    realm: 'example-realm'

Configurable parameters

Name	Type	Usage
base_uri	string	URL to your keycloak instance
realm	optional string	Realm name, will be derived if not present
client_id	optional string	Human readable client_id, will be derived if not present

Upgrading

For version migrations instructions see upgrade instructions.

Supported platforms

These are the platforms which are officially supported by this package. Any other versions might work but is not guaranteed.

Platform	Version
PHP	^8.1
Symfony	^6.1

Contributing

Please read our contribution guidelines before contributing.