Вирішення проблем із підписанням JWT у Symfony: усунення несправностей конфігурації

Налаштування Symfony для автентифікації JWT

Конфігурація Symfony за допомогою YAML

# config/packages/lexik_jwt_authentication.yaml
lexik_jwt_authentication:
    secret_key: '%env(resolve:JWT_SECRET_KEY)%'
    public_key: '%env(resolve:JWT_PUBLIC_KEY)%'
    pass_phrase: '%env(JWT_PASSPHRASE)%'
    token_ttl: 3600

# config/packages/security.yaml
security:
    encoders:
        App\Entity\User:
            algorithm: auto

    providers:
        app_user_provider:
            entity:
                class: App\Entity\User
                property: email

    firewalls:
        login:
            pattern:  ^/api/login
            stateless: true
            json_login:
                check_path: /api/login_check
                success_handler: lexik_jwt_authentication.handler.authentication_success
                failure_handler: lexik_jwt_authentication.handler.authentication_failure
                username_path: email
                password_path: password

        api:
            pattern:   ^/api
            stateless: true
            provider: app_user_provider
            jwt: ~

    access_control:
        - { path: ^/api/login, roles: PUBLIC_ACCESS }
        - { path: ^/api,       roles: IS_AUTHENTICATED_FULLY }

Створення ключів JWT для Symfony

Сценарій командного рядка для OpenSSL

openssl genrsa -out config/jwt/private.pem -aes256 4096
openssl rsa -pubout -in config/jwt/private.pem -out config/jwt/public.pem

Конфігурація Symfony Entity для JWT

Сценарій PHP для сутності користувача

<?php
namespace App\Entity;

use App\Repository\UserRepository;
use Doctrine\ORM\Mapping as ORM;
use Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface;
use Symfony\Component\Security\Core\User\UserInterface;

#[ORM\Entity(repositoryClass: UserRepository::class)]
#[ORM\UniqueConstraint(name: 'UNIQ_IDENTIFIER_EMAIL', fields: ['email'])]
class User implements UserInterface, PasswordAuthenticatedUserInterface
{
    #[ORM\Id]
    #[ORM\GeneratedValue]
    #[ORM\Column]
    private ?int $id = null;

    #[ORM\Column(length: 180)]
    private ?string $email = null;

    #[ORM\Column]
    private array $roles = [];

    #[ORM\Column]
    private ?string $password = null;

    public function getId(): ?int
    {
        return $this->id;
    }

    public function getEmail(): ?string
    {
        return $this->email;
    }

    public function setEmail(string $email): static
    {
        $this->email = $email;
        return $this;
    }

    public function getUserIdentifier(): string
    {
        return (string) $this->email;
    }

    public function getRoles(): array
    {
        $roles = $this->roles;
        $roles[] = 'ROLE_USER';
        return array_unique($roles);
    }

    public function setRoles(array $roles): static
    {
        $this->roles = $roles;
        return $this;
    }

    public function getPassword(): string
    {
        return $this->password;
    }

    public function setPassword(string $password): static
    {
        $this->password = $password;
        return $this;
    }

    public function eraseCredentials(): void
    {
        // Clear temporary, sensitive data
    }
}

Поширені запитання щодо конфігурації JWT у Symfony

1. Як згенерувати ключі RSA для JWT?
2. Використовуйте команду openssl genrsa -out config/jwt/private.pem -aes256 4096 для створення закритого ключа та openssl rsa -pubout -in config/jwt/private.pem -out config/jwt/public.pem щоб отримати відкритий ключ.
3. Що робити, якщо я отримую помилку дозволу?
4. Переконайтеся, що ключові файли мають правильні дозволи. Використовуйте команду chmod 600 config/jwt/private.pem щоб встановити відповідні дозволи.
5. Чому моя конфігурація JWT не працює, незважаючи на дотримання документації?
6. Ще раз перевірте свої змінні середовища в .env файл і переконайтеся, що вони збігаються з ключами та парольною фразою, які використовувалися під час створення ключа.
7. Як я можу перевірити, чи правильна моя конфігурація JWT?
8. Виконайте команду php bin/console lexik:jwt:generate-token test@test.com щоб створити маркер і перевірити, чи він створений без помилок.
9. Яку роль відіграє pass_phrase грати в конфігурації JWT?
10. The pass_phrase використовується для шифрування закритого ключа. Він має бути правильно встановлений у змінних середовища, щоб Symfony використовував його під час створення маркера.
11. Як налаштувати шлях входу в JSON?
12. В security.yaml, встановити check_path до вашої кінцевої точки входу, як правило /api/login_check.
13. Що означає token_ttl параметр робити?
14. The token_ttl Параметр встановлює час життя для JWT, визначаючи, як довго маркер залишається дійсним.
15. Навіщо мені потрібен і секретний, і відкритий ключ?
16. Секретний ключ використовується для підпису JWT, тоді як відкритий ключ використовується для перевірки підпису маркера.
17. Як я можу переконатися, що lexik/jwt-authentication-bundle чи правильно встановлено?
18. Перевірте свій bundles.php файл, щоб переконатися, що комплект зареєстровано та що всі конфігураційні файли завантажено належним чином.
19. Яка роль брандмауерів в автентифікації JWT?
20. Брандмауери в security.yaml визначте, як різні частини вашої програми обробляють автентифікацію та авторизацію, гарантуючи, що лише автентифіковані користувачі можуть отримати доступ до певних кінцевих точок.