返回资讯中心
外部精选
软件工程
#开发者实时流

Symfony 通过 login_throttling 限制登录失败次数防暴力破解

来源标题:Protect your Symfony login against brute force with login_throttling

Symfony 可通过在 firewall 中配置 login_throttling 限制失败登录次数,抵御暴力破解。该功能依赖 symfony/rate-limiter 组件,按用户名加 IP 以及单独按 IP 限流。默认 1 分钟间隔过短,建议改用更长间隔如 15 分钟,并可自定义 limiter 增加按用户名限制以应对僵尸网络。

Hacker News 最新metfan2026/11/10 · 7 天前26 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

作者 Ulrich · 发布于 2026 年 11 月 10 日 在 PHP 8.4 上使用 Symfony 7.3 和 Symfony 8.1 测试(2026 年 11 月)。各版本之间的差异写在各功能旁边。 简而言之:安装 symfony/rate-limiter,并在 firewall 中添加 login_throttling,配置 max_attempts 和 interval(默认的 1 分钟太短了)。随后 Symfony 会按用户名 + IP 以及按 IP 限制失败登录次数。面对僵尸网络,需要用你自己的 limiter(limiter 选项)添加一个按用户名的限制。 限流依赖 Rate Limiter 组件,所以如果尚未安装,你需要先安装它: composer require symfony/rate-limiter 它在 firewall 中启用,位于 authenticator(form_login、json_login,或设置 UserBadge 的自定义 authenticator)旁边: security: firewalls: main: form_login: login_path: login check_path: login

或者,对于 API:

json_login:

check_path: /login

login_throttling: max_attempts: 5 interval: '15 minutes' 不配置选项时,max_attempts 为 5,interval 为 1 分钟:机器人每小时可以针对一个账户尝试 300 个密码。为了缓解这一点,你应该使用更长的 interval;15 分钟对于真正输错密码的用户来说是一个不错的折中。 一旦达到限制,即使密码正确,登录也会被拒绝。Symfony 会抛出 TooManyLoginAttemptsAuthenticationException:使用 json_login 时,API 返回 401(不是 429),响应体为 {"error":"Too many failed login attempts, please try again in 15 minutes."};使用 form_login 时,错误会像其他登录错误一样显示。Symfony 在 security 域中提供了该消息的翻译: {% if error %}

<div class="alert alert-danger">{{ error.messageKey|trans(error.messageData, 'security') }}</div> {% endif %} login_throttling 实际做了什么 Symfony 会为 firewall 创建两个 fixed_window 限流器: 只有失败才计数,Symfony 在认证前检查限制而不消耗令牌,只有在登录失败时才消耗一个。键会用密钥进行哈希:用户名和 IP 都不会以明文形式存储在缓存中。 成功登录会重置用户名 + IP 计数器,但不会重置按 IP 的计数器。请注意:这只在 Symfony 6.4.46、7.4.19 和 8.1.7 及之后版本中成立。在更早的版本中,包括已不再维护的 7.3 和 8.0,成功登录不会重置任何内容。 如果攻击者拥有许多 IP(僵尸网络),按 IP 的限制就毫无用处。两个默认限流器都有同样的弱点,因为每个 IP 只做几次尝试。解决办法是增加第三个限制,按用户名限制,无论 IP 是什么。我们需要在 security 配置中使用 limiter 选项,该选项接受你自己的服务。 我们需要声明默认的 rate limiter 和一个新的 limiter,以抵御僵尸网络: framework: rate_limiter: login_ip: policy: 'fixed_window' limit: 50 interval: '15 minutes' login_user_ip: policy: 'fixed_window' limit: 5 interval: '15 minutes' login_user: policy: 'fixed_window' limit: 20 interval: '1 hour' 然后我们需要编写完成这项工作的类,我们可以使用 AbstractRequestRateLimiter 类。它会对 getLimiters() 返回的每个限流器进行消耗,并保留限制最严格的那个。 <?php declare(strict_types=1); namespace App\Security\RateLimiting; use Symfony\Component\DependencyInjection\Attribute\Autowire; use Symfony\Component\HttpFoundation\RateLimiter\AbstractRequestRateLimiter; use Symfony\Component\HttpFoundation\Request; use Symfony\Component\RateLimiter\LimiterInterface; use Symfony\Component\RateLimiter\RateLimiterFactoryInterface; use Symfony\Component\Security\Http\SecurityRequestAttributes; final class LoginRateLimiter extends AbstractRequestRateLimiter public function __construct( // Symfony 7.3+:RateLimiterFactoryInterface。Symfony 5.2 到 7.2:RateLimiterFactory private readonly RateLimiterFactoryInterface $loginIpLimiter, private readonly RateLimiterFactoryInterface $loginUserIpLimiter, private readonly RateLimiterFactoryInterface $loginUserLimiter, #[Autowire('%kernel.secret%')] private readonly string $secret, ) { protected function getLimiters(Request $request): array $ip = $request->getClientIp() ?? ''; $username = mb_strtolower((string) $request->attributes->get(SecurityRequestAttributes::LAST_USERNAME, '')); return [ $this->loginIpLimiter->create($this->hash($ip)), // 一个 IP 对应多个用户名 $this->loginUserIpLimiter->create($this->hash($username.'-'.$ip)), // 一个 IP 对应一个用户名 $this->loginUserLimiter->create($this->hash($username)), // 多个 IP 对应一个用户名(僵尸网络) ]; // 成功登录时,只忘记此 IP 下此用户名的失败记录 public function reset(Request $request): void $ip = $request->getClientIp() ?? ''; $username = mb_strtolower((string) $request->attributes->get(SecurityRequestAttributes::LAST_USERNAME, '')); $this->loginUserIpLimiter->create($this->hash($username.'-'.$ip))->reset(); // 键经过哈希处理,因此用户名和 IP 不会以明文形式存储在缓存中 private function hash(string $data): string return hash_hmac('sha256', $data, $this->secret); 工厂按名称注入(login_ip 对应 $loginIpLimiter,以此类推)。在 Symfony 7.3 之前,请将 RateLimiterFactoryInterface 替换为 RateLimiterFactory。与默认限流器一样,reset() 方法仅从 6.4.46、7.4.19 和 8.1.7 起才会被调用。然后将该服务接入 firewall,取代 max_attempts 和 interval: security: firewalls: main: form_login: login_path: login check_path: login login_throttling: limiter: App\Security\RateLimiting\LoginRateLimiter 在 Symfony 7.3 和 8.1 上测试,从 25 个不同 IP 对同一账户发送错误密码:前 20 次尝试返回 Invalid credentials,接下来 5 次返回 Too many failed login attempts, please try again in 60 minutes。另一个账户从相同的 IP 登录则正常。从单个 IP 对 55 个不同用户名尝试,则在 50 次尝试后开始阻止。

(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →