حل مشكلات توقيع 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 لـ 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. ال pass_phrase يستخدم لتشفير المفتاح الخاص. يجب أن يتم ضبطه بشكل صحيح في متغيرات البيئة الخاصة بك حتى يتمكن Symfony من استخدامه أثناء إنشاء الرمز المميز.
11. كيف أقوم بتكوين مسار تسجيل الدخول JSON؟
12. في ال security.yaml، تعيين check_path إلى نقطة نهاية تسجيل الدخول الخاصة بك، عادةً /api/login_check.
13. ماذا يكون ال token_ttl المعلمة تفعل؟
14. ال token_ttl تحدد المعلمة مدة بقاء JWT، وتحدد المدة التي يظل فيها الرمز صالحًا.
15. لماذا أحتاج إلى كل من المفتاح السري والمفتاح العام؟
16. يتم استخدام المفتاح السري لتوقيع JWT، بينما يتم استخدام المفتاح العام للتحقق من توقيع الرمز المميز.
17. كيف يمكنني التأكد من أن lexik/jwt-authentication-bundle تم تثبيته بشكل صحيح؟
18. افحص bundles.php للتأكد من تسجيل الحزمة وتحميل جميع ملفات التكوين بشكل صحيح.
19. ما هو دور جدران الحماية في مصادقة JWT؟
20. جدران الحماية في security.yaml تحديد كيفية تعامل الأجزاء المختلفة من تطبيقك مع المصادقة والترخيص، مما يضمن أن المستخدمين المصادق عليهم فقط هم من يمكنهم الوصول إلى نقاط نهاية معينة.