shlink/module/Rest/src/Authentication/JWTService.php

<?php
declare(strict_types=1);

namespace Shlinkio\Shlink\Rest\Authentication;

use Firebase\JWT\JWT;
use Shlinkio\Shlink\Core\Options\AppOptions;
use Shlinkio\Shlink\Rest\Entity\ApiKey;
use Shlinkio\Shlink\Rest\Exception\AuthenticationException;

class JWTService implements JWTServiceInterface
{
    /**
     * @var AppOptions
     */
    private $appOptions;

    public function __construct(AppOptions $appOptions)
    {
        $this->appOptions = $appOptions;
    }

    /**
     * Creates a new JSON web token por provided API key
     *
     * @param ApiKey $apiKey
     * @param int $lifetime
     * @return string
     */
    public function create(ApiKey $apiKey, $lifetime = self::DEFAULT_LIFETIME): string
    {
        $currentTimestamp = time();

        return $this->encode([
            'iss' => $this->appOptions->__toString(),
            'iat' => $currentTimestamp,
            'exp' => $currentTimestamp + $lifetime,
            'sub' => 'auth',
            'key' => $apiKey->getId(), // The ID is opaque. Returning the key would be insecure
        ]);
    }

    /**
     * Refreshes a token and returns it with the new expiration
     *
     * @param string $jwt
     * @param int $lifetime
     * @return string
     * @throws AuthenticationException If the token has expired
     */
    public function refresh(string $jwt, $lifetime = self::DEFAULT_LIFETIME): string
    {
        $payload = $this->getPayload($jwt);
        $payload['exp'] = time() + $lifetime;
        return $this->encode($payload);
    }

    /**
     * Verifies that certain JWT is valid
     *
     * @param string $jwt
     * @return bool
     */
    public function verify(string $jwt): bool
    {
        try {
            // If no exception is thrown while decoding the token, it is considered valid
            $this->decode($jwt);
            return true;
        } catch (\UnexpectedValueException $e) {
            return false;
        }
    }

    /**
     * Decodes certain token and returns the payload
     *
     * @param string $jwt
     * @return array
     * @throws AuthenticationException If the token has expired
     */
    public function getPayload(string $jwt): array
    {
        try {
            return $this->decode($jwt);
        } catch (\UnexpectedValueException $e) {
            throw AuthenticationException::expiredJWT($e);
        }
    }

    /**
     * @param array $data
     * @return string
     */
    private function encode(array $data): string
    {
        return JWT::encode($data, $this->appOptions->getSecretKey(), self::DEFAULT_ENCRYPTION_ALG);
    }

    /**
     * @param string $jwt
     * @return array
     */
    private function decode(string $jwt): array
    {
        return (array) JWT::decode($jwt, $this->appOptions->getSecretKey(), [self::DEFAULT_ENCRYPTION_ALG]);
    }
}