Skip to content

An Encoder for the LexikJWTAuthenticationBundle that uses web-token/jwt-framework

License

Notifications You must be signed in to change notification settings

Spomky-Labs/lexik-jose-bridge

Repository files navigation

Jose Bridge for the LexikJWTAuthenticationBundle

Build Status Build Status Build Status

Build Status

Latest Stable Version Total Downloads Latest Unstable Version License

This Symfony Bundle provides a JWT Encoder for the LexikJWTAuthenticationBundle that uses the web-token/jwt-framework as JWT Creator/Loader.

The Release Process

The release process is described here.

Prerequisites

This library needs at least:

  • PHP 8.1+
  • Symfony 6.0+.

Installation

Symfony Flex

The preferred way to install this bundle is to rely on Symfony Flex and composer. Before installing the bundle, it is mandatory to declare specific Flex servers into your composer.json file.

composer config --json extra.symfony.endpoint '["https://api.github.com/repos/Spomky-Labs/recipes/contents/index.json?ref=main", "flex://defaults"]'

Or if you prefer, you can directly update your composer.json file.

{
    "name": "acme/application",
    "description": "ACME Application",
    "extra": {
        "symfony": {
            "endpoint": [
                "https://api.github.com/repos/Spomky-Labs/recipes/contents/index.json?ref=main",
                "flex://defaults"
            ]
        }
    }
}

Then, you can install the bundle. It will be automatically configured with the default configuration.

composer require spomky-labs/lexik-jose-bridge

Manual Installation

If you do not use Symfony Flex, then use Composer and install the bundle manually. Then, add this bundle and the web-token/jwt-framework bundles into your kernel:

<?php

use Symfony\Component\Config\Loader\LoaderInterface;
use Symfony\Component\HttpKernel\Kernel;

class AppKernel extends Kernel
{
    public function registerBundles()
    {
        $bundles = [
            ...
            new Jose\Bundle\JoseFramework\JoseFrameworkBundle(),
            new SpomkyLabs\LexikJoseBundle\SpomkyLabsLexikJoseBundle(),
        ];

        return $bundles;
    }
}

Signature/Encryption Algorithms

This bundle only installs the RSA based signature algorithms (RS256, RS384 and RS512). If you need other signature algorithms (e.g EC based, HMAC) or if you want to use the encryption feature, you must install the corresponding packages:

  • Signature Algorithms
    • All: composer require web-token/signature-pack (not recommended)
    • HMAC: composer require web-token/jwt-signature-algorithm-hmac
    • ECDSA: composer require web-token/jwt-signature-algorithm-ecdsa
    • EdDSA: composer require web-token/jwt-signature-algorithm-eddsa
    • None: composer require web-token/jwt-signature-algorithm-none (not recommended)
    • Experimental: composer require web-token/jwt-signature-algorithm-experimental (not recommended)
  • Encryption Algorithms
    • All: composer require web-token/encryption-pack (not recommended)
    • Key Encryption:
      • ECDH-ES: composer require web-token/jwt-encryption-algorithm-ecdh-es
      • AES Key Wrapping: composer require web-token/jwt-encryption-algorithm-aeskw
      • RSA: composer require web-token/jwt-encryption-algorithm-rsa
      • AES GCM Key Wrapping: composer require web-token/jwt-encryption-algorithm-aesgcmkw
      • Direct: composer require web-token/jwt-encryption-algorithm-dir (not recommended)
      • PBES 2: composer require web-token/jwt-encryption-algorithm-pbes2 (not recommended)
    • Content Encryption:
      • AES GCM: composer require web-token/jwt-encryption-algorithm-aesgcm
      • AES CBC: composer require web-token/jwt-encryption-algorithm-aescbc
    • Experimental: composer require web-token/jwt-encryption-algorithm-experimental (not recommended)

Configuration

This bundle needs to be configured. Please see this page to know how to configure it.

How to use

There is nothing to do. Just use your application as usual.

Support

I bring solutions to your problems and answer your questions.

If you really love that project and the work I have done or if you want I prioritize your issues, then you can help me out for a couple of 🍻 or more!

Become a sponsor

Or

Become a Patreon

Contributing

If you discover a security vulnerability within the project, please don't use the bug tracker and don't publish it publicly. Instead, all security issues must be sent to security [at] spomky-labs.com.

Licence

This project is release under MIT licence.