SymfonyのRememberMeとはなんぞや？今まで雰囲気で使ってたので調べてみた。
- RembemerMeとは？
- どのように実現しているのか？
RememberMeとは？
公式ドキュメントによると以下のように記載されている。
ユーザーが認証されると、通常、ユーザーの資格情報がセッションに保存されます。つまり、セッションが終了すると、ユーザーはログアウトされ、次回アプリケーションにアクセスするときに再度ログイン詳細を提供する必要があります。remember_meファイアウォールオプション付きのCookieを使用して、セッションが継続する期間よりも長い間ログインしたままにすることをユーザーが選択できるようにすることができます。
https://symfony.com/doc/current/security/remember_me.html
つまり、セッションが切れてもログイン状態を継続することが出来る。
設定方法について
基本的には security.yaml に設定を記述していく
1
2
3
4
|
main:
remember_me:
secret: '%kernel.secret%'
lifetime: 31536000
|
ベースはこんな感じ。
パラーメータの種類ついて
- secret(必須)
- name
- lifetime
- path
- domain
- secure
- httponly
- samesite
- remember_me_parameter
- always_remember_me
- token_provider
secret
Coookieコンテンツを暗号化するのに使う。
TokenBasedRememberMeServices::generateCookieHash()で利用されている
name
ユーザーのログインを維持するために使用されるCookieの名前。
デフォルトだと REMEMBERME
lifetime
ユーザーがログインし続ける秒数。デフォルトでは、1年間ログイン。
(cookieの有効期限)
path
Cookieパスの指定用。
デフォルトは /
domain
Cookieのドメイン設定。
secure
セキュアCookieかどうかの設定。
デフォルトは false
(ほぼHTTPSな世界だし、trueにするのが良さそう)
httponly
cookieのhttponlyの設定。
デフォルトは false
(ほぼHTTPSな世界だし、trueにするのが良さそう)
remember_me_parameter
RememberMeを有効にするかどうかの、フラグ用のフォームのinput名。
デフォルトは _remember_me
always_remember_me
強制的にRememberMeを有効にする。
つまりremember_me_parameterは無視される。
token_provider
トークンを保存するためのプロバイダを指定することが出来る。
デフォルトではCookieに保存されるが、DBに保存することもできる DoctrineTokenProvider
どのように仕組になっているのか？
RememberMe用の情報の保存について
基本的にはログインとは別にセッションを発行して、そこで管理していることになる。
基本的には認証後にRememberMeに関する情報をcookieに保存する形になっている。
GuardAuthenticationListener::triggerRememberMe() あたりを読んでみるとよく分かる。
token_providerを設定してないとTokenBasedRememberMeServices::onLoginSuccess()が呼び出されて、そこでユーザー名UserInterface::getUsername() とパスワード UserInterface::getPassword() の情報を暗号化してcookieに保存される仕組みになっている。
RememberMeでログインする処理について
RememberMeListener::authenticate() あたりで処理書かれている。
ログイン認証が続いているようなら、RememberMe処理をしないで、そうでなければRememberMeの情報をもとにログイン処理を行うという流れ。
デフォルトでは最終的には TokenBasedRememberMeServices::processAutoLoginCookie() が実行されて、security.yamlで設定しているUserProvider::loadUserByUsername() でユーザー情報が取得される。
TokenBasedRememberMeServicesを差し替えたい
今回は様々な事情でTokenBasedRememberMeServicesを差し替えたい。
どのようにDIに登録されているか調べる
Xdebugでコンストラクタにブレークポイント貼ったら security.authentication.rememberme.services.simplehash.main という名前でDIに登録されている。
ちなみに RememberMeFactory 見てみるとわかるが、 実際は ChildDefinitionとしてsecurity.authentication.rememberme.services.simplehashと登録しているなら全体的に差し替えるならこっちの名前で差し替えるのはありかも。
実際に差し替える
ここまで来ればあとはラップしたClassと、差し替えるようのCompilerPassを用意すればいい。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
|
<?php
namespace App\DependencyInjection\Compiler;
use App\Security\Http\RememberMe\CustomTokenBasedRememberMeServices;
use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
use Symfony\Component\DependencyInjection\ContainerBuilder;
class TokenBasedRememberMePass implements CompilerPassInterface
{
public function process(ContainerBuilder $container): void
{
$definition = $container->getDefinition('security.authentication.rememberme.services.simplehash');
$definition->setClass(CustomTokenBasedRememberMeServices::class);
}
}
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
<?php
namespace App\Security\Http\RememberMe;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\Security\Http\RememberMe\TokenBasedRememberMeServices;
class CustomTokenBasedRememberMeServices extends TokenBasedRememberMeServices
{
protected function processAutoLoginCookie(array $cookieParts, Request $request)
{
return parent::processAutoLoginCookie($cookieParts, $request); // TODO: Change the autogenerated stub
}
}
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
<?php
declare(strict_types=1);
namespace App;
use App\DependencyInjection\Compiler\TokenBasedRememberMePass;
use Symfony\Component\HttpKernel\Kernel as BaseKernel;
class Kernel extends BaseKernel
{
...
protected function build(ContainerBuilder $container)
{
$container->addCompilerPass(new TokenBasedRememberMePass());
}
}
|
RememberMeListenerを差し替えたい
今回はちょっといろいろな事情でRememberMeListenerも変えたくなったので以下のように対応した。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
|
<?php
declare(strict_types=1);
namespace App\Security\Http\Firewall;
use Psr\Log\LoggerInterface;
use Symfony\Component\HttpKernel\Event\RequestEvent;
use Symfony\Component\Security\Core\Authentication\AuthenticationManagerInterface;
use Symfony\Component\Security\Core\Authentication\Token\Storage\TokenStorageInterface;
use Symfony\Component\Security\Http\Firewall\RememberMeListener;
use Symfony\Component\Security\Http\RememberMe\RememberMeServicesInterface;
use Symfony\Component\Security\Http\Session\SessionAuthenticationStrategyInterface;
use Symfony\Contracts\EventDispatcher\EventDispatcherInterface;
use Symfony\Component\Routing\RouterInterface;
class AppRememberMeListener extends RememberMeListener
{
/**
* @var RouterInterface
*/
private $router;
public function __construct(
RouterInterface $router,
TokenStorageInterface $tokenStorage,
RememberMeServicesInterface $rememberMeServices,
AuthenticationManagerInterface $authenticationManager,
LoggerInterface $logger = null,
EventDispatcherInterface $dispatcher = null,
bool $catchExceptions = true,
SessionAuthenticationStrategyInterface $sessionStrategy = null
) {
parent::__construct(
$tokenStorage,
$rememberMeServices,
$authenticationManager,
$logger,
$dispatcher,
$catchExceptions,
$sessionStrategy
);
$this->router = $router;
}
public function authenticate(RequestEvent $event): void
{
// TODO カスタム処理
parent::authenticate($event);
}
}
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
|
<?php
declare(strict_types=1);
namespace App\DependencyInjection\Compiler;
use App\Security\Http\Firewall\CustomRememberMeListener;
use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
use Symfony\Component\DependencyInjection\ContainerBuilder;
use Symfony\Component\DependencyInjection\Definition;
use Symfony\Component\DependencyInjection\Reference;
use Symfony\Component\Routing\RouterInterface;
class CustomRememberMeListenerPass implements CompilerPassInterface
{
public function process(ContainerBuilder $container): void
{
$definition = new Definition(CustomRememberMeListener::class);
$definition->setArguments(array_values(array_merge([new Reference(RouterInterface::class)], $container->getDefinition('security.authentication.listener.rememberme')->getArguments())));
$definition->setShared(true);
$definition->replaceArgument(2, new Reference('security.authentication.rememberme.services.simplehash.main'));
$container->setDefinition(AppRememberMeListener::class, $definition);
$container->setDefinition('security.authentication.listener.rememberme.main', $definition);
}
}
|
ポイントとしては replaceArgument しているところだと思っていて、ここで security.authentication.rememberme.services.simplehash.main を設定していること。
もともと入っている値 security.authentication.rememberme のままにしていると以下のエラーが出てしまう。
1
|
The service "security.authentication.listener.rememberme.main" has a dependency on a non-existent service "security.authentication.rememberme".
|
ここはちょっと調査不足なんだけど、原因わからなかったから security.authentication.rememberme.services.simplehash.main に差し替えちゃえという感じ。
※ Firewall名はmainを想定しています。
