# Symfony Security 2026: Voter, Firewall va Cau Hoi Phong Van Ky Thuat > Phan tich toan dien kien truc bao mat Symfony 7.4 LTS: firewall, voter, Access Token Handler, IsGranted attribute, chien luoc quyet dinh va cau hoi phong van ky thuat cho lap trinh vien PHP. - Published: 2026-06-18 - Updated: 2026-06-18 - Author: Anthony Fillion-Maillet - Tags: symfony, security, php, voters, firewalls, authentication, interview - Reading time: 12 min --- Thanh phan Security cua Symfony hoat dong dua tren hai co che cot loi: **firewall** dam nhiem xac thuc (ban la ai?) va **voter** dam nhiem phan quyen (ban duoc phep lam gi?). Hieu ro cach hai thanh phan nay tuong tac voi nhau la dieu kien tien quyet de xay dung ung dung Symfony an toan, dong thoi giup ung vien tu tin tra loi cac cau hoi phong van ky thuat lien quan den bao mat. > **Symfony 7.4 LTS Security Stack** > > Symfony 7.4 (phien ban LTS hien tai, duoc ho tro den thang 11 nam 2029) da gioi thieu tinh nang giai thich quyet dinh cua voter, cac ham phan quyen moi trong Twig (`access_decision()` va `access_decision_for_user()`), va ky so thong diep cho Messenger handler. Tat ca vi du trong bai viet nay ap dung cho Symfony 7.4 tro len. ## Firewall trong Symfony kiem soat xac thuc nhu the nao Firewall la tuyen phong thu dau tien trong kien truc bao mat Symfony. Moi firewall duoc khai bao trong file `security.yaml` va dinh nghia pham vi bao ve cho mot nhom URL cu the, kem theo cac quy tac xac thuc rieng. Dieu quan trong can luu y la thu tu khai bao cac firewall mang tinh quyet dinh: Symfony duyet lan luot tung firewall tu tren xuong va ap dung firewall dau tien co `pattern` khop voi URL cua request. ```yaml # config/packages/security.yaml security: firewalls: dev: pattern: ^/(_(profiler|wdt))/ security: false api: pattern: ^/api/ stateless: true custom_authenticators: - App\Security\ApiTokenHandler main: lazy: true provider: app_user_provider form_login: login_path: app_login check_path: app_login logout: path: app_logout access_control: - { path: ^/api/public, roles: PUBLIC_ACCESS } - { path: ^/api/, roles: ROLE_API_USER } - { path: ^/admin, roles: ROLE_ADMIN } - { path: ^/dashboard, roles: ROLE_USER } ``` Cau hinh tren dinh nghia ba firewall song song. Firewall `dev` vo hieu hoa hoan toan bao mat cho cac route cua Profiler va Web Debug Toolbar, loai bo moi can tro trong moi truong phat trien. Firewall `api` bao ve cac endpoint API bang xac thuc stateless dua tren token tuy chinh. Firewall `main` xu ly xac thuc truyen thong bang bieu mau dang nhap (form login) ket hop session cho giao dien web. Phan `access_control` thiet lap cac quy tac truy cap toan cuc, duoc danh gia sau khi xac thuc hoan tat. Thu tu cac quy tac cung rat quan trong: quy tac dau tien khop se duoc ap dung. Quy tac `PUBLIC_ACCESS` tren `/api/public` cho phep truy cap khong can xac thuc, ke ca khi firewall `api` dang hoat dong. Day la mot diem tinh te thuong xuat hien trong cac cau hoi phong van. ## Stateless va Stateful: Hai mo hinh xac thuc Viec lua chon giua xac thuc stateless va stateful anh huong truc tiep den kien truc bao mat cua ung dung. Trong mo hinh stateful (firewall `main`), Symfony luu tru token xac thuc trong session PHP. Moi request tiep theo se tai lai ngu canh bao mat tu session ma khong can xac thuc lai. Co `lazy: true` toi uu qua trinh nay bang cach chi tai session khi ung dung thuc su can kiem tra quyen truy cap. Trong mo hinh stateless (firewall `api`), moi request phai tu mang theo thong tin xac thuc cua rieng minh -- token Bearer, khoa API, chu ky JWT. Khong co session nao duoc tao phia server. Mo hinh nay phu hop tu nhien voi kien truc phan tan, microservices va cac ung dung di dong, nhung doi hoi moi request phai tu cung cap day du thong tin xac thuc. Viec lua chon giua hai mo hinh nay khong phai la van de so thich ca nhan ma la rang buoc kien truc. Ung dung monolithic voi giao dien web nen su dung stateful de don gian hoa viec quan ly. API phuc vu nhieu loai client khac nhau can stateless de dam bao kha nang mo rong ngang. ## Xay dung Access Token Handler tuy chinh Symfony 6.2 da gioi thieu he thong Access Token Handler, thong nhat viec quan ly token xac thuc thong qua mot interface ro rang. Co che nay thay the cac Guard Authenticator cu, mang lai su tich hop truc tiep hon voi thanh phan Security. ```php // src/Security/ApiTokenHandler.php namespace App\Security; use App\Repository\ApiTokenRepository; use Symfony\Component\Security\Core\Exception\BadCredentialsException; use Symfony\Component\Security\Http\AccessToken\AccessTokenHandlerInterface; use Symfony\Component\Security\Http\Authenticator\Passport\Badge\UserBadge; final readonly class ApiTokenHandler implements AccessTokenHandlerInterface { public function __construct( private ApiTokenRepository $repository, ) {} public function getUserBadgeFrom(#[\SensitiveParameter] string $accessToken): UserBadge { $token = $this->repository->findOneByValue($accessToken); if ($token === null || !$token->isValid()) { throw new BadCredentialsException('Invalid or expired token.'); } return new UserBadge($token->getUser()->getUserIdentifier()); } } ``` Interface `AccessTokenHandlerInterface` chi yeu cau mot phuong thuc duy nhat: `getUserBadgeFrom`. Phuong thuc nay nhan token tho duoc trich xuat tu request (mac dinh la header `Authorization: Bearer xxx`) va phai tra ve mot `UserBadge` chua dinh danh cua nguoi dung tuong ung. Attribute `#[\SensitiveParameter]` danh dau token la thong tin nhay cam, ngan chan no xuat hien trong stack trace va log -- mot thuc hanh bao mat tot duoc gioi thieu tu PHP 8.2. Pattern nay duoc thiet ke co y don gian: viec xac minh token (ton tai, het han, thu hoi) thuoc ve repository hoac mot service chuyen biet. Handler chi co nhiem vu chuyen doi token thanh danh tinh nguoi dung. Su phan tach trach nhiem nay giup viec viet unit test tro nen de dang va tuan thu nguyen tac don trach nhiem (Single Responsibility Principle). ## Voter trong Symfony: Logic phan quyen chi tiet Voter la co che phan quyen trung tam trong Symfony. Khac voi cac role tinh duoc dinh nghia trong `access_control`, voter cho phep logic quyet dinh dong dua tren ngu canh: nguoi dung hien tai, doi tuong muc tieu va hanh dong duoc yeu cau. Moi voter tra loi mot cau hoi cu the: "Nguoi dung nay co duoc phep thuc hien hanh dong nay tren doi tuong nay khong?" ```php // src/Security/Voter/PostVoter.php namespace App\Security\Voter; use App\Entity\Post; use Symfony\Component\Security\Core\Authentication\Token\TokenInterface; use Symfony\Component\Security\Core\Authorization\Voter\Vote; use Symfony\Component\Security\Core\Authorization\Voter\Voter; use Symfony\Component\Security\Core\User\UserInterface; final class PostVoter extends Voter { public const EDIT = 'POST_EDIT'; public const DELETE = 'POST_DELETE'; public const PUBLISH = 'POST_PUBLISH'; protected function supports(string $attribute, mixed $subject): bool { return in_array($attribute, [self::EDIT, self::DELETE, self::PUBLISH]) && $subject instanceof Post; } protected function voteOnAttribute( string $attribute, mixed $subject, TokenInterface $token, ?Vote $vote = null, ): bool { $user = $token->getUser(); if (!$user instanceof UserInterface) { $vote?->addReason('User is not authenticated.'); return false; } /** @var Post $post */ $post = $subject; return match ($attribute) { self::EDIT => $this->canEdit($post, $user, $vote), self::DELETE => $this->canDelete($post, $user, $vote), self::PUBLISH => $this->canPublish($post, $user, $vote), default => false, }; } private function canEdit(Post $post, UserInterface $user, ?Vote $vote): bool { if ($post->getAuthor() === $user) { $vote?->addReason('User is the author of the post.'); return true; } $vote?->addReason('User is not the author.'); return false; } private function canDelete(Post $post, UserInterface $user, ?Vote $vote): bool { if (in_array('ROLE_ADMIN', $user->getRoles())) { $vote?->addReason('User has ROLE_ADMIN.'); return true; } if ($post->getAuthor() === $user && !$post->isPublished()) { $vote?->addReason('Author can delete unpublished posts.'); return true; } $vote?->addReason('Only admins or authors of unpublished posts can delete.'); return false; } private function canPublish(Post $post, UserInterface $user, ?Vote $vote): bool { if (in_array('ROLE_EDITOR', $user->getRoles())) { $vote?->addReason('User has ROLE_EDITOR.'); return true; } $vote?->addReason('Only editors can publish posts.'); return false; } } ``` Mot so diem dang chu y trong voter nay. Tham so `Vote` (duoc gioi thieu tu Symfony 7.1) cho phep dinh kem ly do giai thich vao moi quyet dinh, ho tro viec debug trong moi truong phat trien va audit trong moi truong production. Phuong thuc `supports` loc cac loi goi: voter chi hoat dong khi attribute la `POST_EDIT`, `POST_DELETE` hoac `POST_PUBLISH` va subject la mot instance cua `Post`. Bieu thuc `match` trong `voteOnAttribute` uy quyen logic cho cac phuong thuc private chuyen biet, moi phuong thuc dong goi quy tac nghiep vu cua mot hanh dong. Cau truc nay giup voter de doc va de mo rong: them mot hanh dong moi chi can khai bao hang so, them mot case trong `match` va viet mot phuong thuc private. Logic cua `canDelete` minh hoa mot pattern pho bien: ket hop kiem tra role va kiem tra quyen so huu. Quan tri vien co the xoa bat ky bai viet nao, nhung tac gia chi co the xoa bai viet cua minh khi bai viet chua duoc xuat ban. Loai quy tac theo ngu canh nay khong the dien dat chi bang role trong `access_control`. ## Su dung Attribute IsGranted trong Controller Attribute `#[IsGranted]` ap dung kiem soat truy cap truc tiep tai cap controller hoac phuong thuc, thuc hien cung chuc nang nhu cac annotation bao mat nhung voi cu phap PHP goc. Symfony danh gia bieu thuc truoc khi thuc thi phuong thuc va tra ve response 403 neu kiem tra that bai. ```php // src/Controller/PostController.php namespace App\Controller; use App\Entity\Post; use App\Security\Voter\PostVoter; use Symfony\Bundle\FrameworkBundle\Controller\AbstractController; use Symfony\Component\HttpFoundation\Response; use Symfony\Component\Routing\Attribute\Route; use Symfony\Component\Security\Http\Attribute\IsGranted; #[Route('/post')] final class PostController extends AbstractController { #[Route('/{id}/edit', methods: ['GET', 'POST'])] #[IsGranted(PostVoter::EDIT, subject: 'post', message: 'You cannot edit this post.')] public function edit(Post $post): Response { // User is guaranteed to have edit permission at this point return $this->render('post/edit.html.twig', [ 'post' => $post, ]); } #[Route('/{id}/publish', methods: ['POST'])] #[IsGranted(PostVoter::PUBLISH, subject: 'post')] public function publish(Post $post): Response { // Only editors reach this code $post->setPublished(true); // ... return $this->redirectToRoute('post_show', ['id' => $post->getId()]); } } ``` Tham so `subject: 'post'` lien ket attribute voi tham so cua phuong thuc cung ten. Symfony tu dong phan giai entity thong qua ParamConverter va truyen no vao voter lam subject cua phep kiem tra. Tham so `message` tuy chinh thong bao loi 403, huu ich cho viec debug va ghi nhat ky kiem tra. Phong cach khai bao nay mang lai loi the lon ve kha nang doc hieu: cac quy tac truy cap hien thi ngay tai cung vi tri voi chu ky phuong thuc, khong can phai doc than phuong thuc de biet quyen truy cap nao duoc yeu cau. Trong phong van ky thuat, kha nang giai thich day du luong xu ly -- tu attribute den voter thong qua `AccessDecisionManager` -- the hien su hieu biet sau sac ve thanh phan Security. ## Chien luoc quyet dinh va su phoi hop giua cac Voter Khi nhieu voter cung bieu quyet cho mot phep kiem tra truy cap, `AccessDecisionManager` ap dung mot chien luoc quyet dinh de tong hop cac phieu bau. Symfony cung cap ba chien luoc, co the cau hinh trong `security.yaml`. | Chien luoc | Hanh vi | Truong hop su dung | |---|---|---| | `affirmative` (mac dinh) | Cap quyen khi it nhat mot voter dong y | Phu hop da so ung dung | | `unanimous` | Cap quyen khi tat ca voter deu dong y | He thong yeu cau bao mat cao | | `consensus` | Cap quyen khi da so voter dong y | Hiem khi su dung trong thuc te | ```yaml # config/packages/security.yaml security: access_decision_manager: strategy: unanimous allow_if_all_abstain: false ``` Chien luoc `affirmative` (mac dinh) cap quyen truy cap ngay khi chi mot voter bo phieu thuan. Chien luoc `unanimous` yeu cau tat ca cac voter khong bo phieu trang deu phai bo phieu thuan. Chien luoc `consensus` cap quyen khi da so voter bo phieu thuan. Tham so `allow_if_all_abstain` xac dinh hanh vi khi tat ca voter deu bo phieu trang (khong voter nao ho tro attribute duoc yeu cau). Trong thuc te, chien luoc mac dinh `affirmative` phu hop voi da so ung dung. Chien luoc `unanimous` duoc ap dung trong cac ngu canh bao mat nghiem ngat: ung dung tai chinh, du lieu y te, he thong trong yeu. No dam bao rang khong voter nao phan doi quyen truy cap, tao them mot lop phong thu sau. Mot voter kiem tra IP, mot voter kiem tra role va mot voter kiem tra quyen so huu deu phai chap thuan thi quyen truy cap moi duoc cap. ## Debug Voter trong Twig voi Symfony 7.4 Symfony 7.4 nang cap kha nang debug he thong bao mat bang cach hien thi ly do quyet dinh truy cap truc tiep trong cac template Twig. Tham so `Vote` duoc them vao voter phat huy tac dung tai day: cac ly do duoc khai bao qua `$vote->addReason()` xuat hien trong Profiler va co the hien thi co dieu kien trong template. ```twig {# templates/post/show.html.twig #} {% if is_granted('POST_EDIT', post) %} Edit {% endif %} {% if is_granted('POST_DELETE', post) %}
{% endif %} {% if app.debug %} {# Symfony 7.4: access decision debugging in Twig #} {% set decision = is_granted_debug('POST_EDIT', post) %}