PHP 会话登录中的 CSRF 防护:从令牌校验到会话轮换

文章目录

问题从哪里来

CSRF(跨站请求伪造)的核心不是攻击者窃取 Cookie,而是让受害者的浏览器带着目标站点已有的 Cookie 发起请求。浏览器在同站请求中会自动附带 Cookie,服务端只看到“已登录用户”的会话,很难区分这是用户主动提交还是被其他页面诱导提交。登录场景有两类风险:一是登录后的状态变更接口被伪造调用;二是登录表单本身被利用,把受害者登录进攻击者控制的账号,之后受害者的操作可能落到攻击者账号里。

Session Cookie 天然满足“自动携带”这个条件,所以只要用 PHP 会话做登录态,就需要考虑 CSRF。注意,CSRF 防护和 XSS 防护不是一回事:XSS 能读取页面内的令牌,令牌机制对它无效;反过来,CSRF 令牌也不能替代输出转义。

同步令牌的基本模型

最常用的是同步令牌模式:服务端在会话里保存一个随机令牌,表单或请求头携带同一个值,服务端用恒定时间比较函数校验。关键点如下。

令牌必须由密码学安全的随机源生成,例如 random_bytes(),不要用 mt_rand()、uniqid() 或时间戳。令牌应保存在 $_SESSION 中,不要放在 URL 查询参数里,因为 URL 可能进入访问日志、Referer 和浏览器历史。

比较时使用 hash_equals(),避免普通字符串比较带来的时序差异和类型转换问题。令牌可以按会话长期保存,也可以做成一次性;一次性令牌安全性略高,但多标签页、后退重试会造成失败,需要根据交互复杂度取舍。

SameSite Cookie 是有价值的纵深防御,但不是完整替代。Lax 能阻止多数跨站 POST 携带 Cookie,但同站不同子域、旧浏览器、部分跳转方式仍要单独评估。把 SameSite 当唯一防线,容易在边界变化时失效。服务端还可以校验 Origin 或 Referer 作为补充,但要注意代理、隐私设置和请求头缺失的情况,不能只依赖它们。

可操作步骤

先统一会话启动方式。会话必须在输出之前启动,并设置 Cookie 属性:HttpOnly、Secure(HTTPS 下)、SameSite=Lax。开启 session.use_strict_mode,减少攻击者指定会话 ID 的空间。

<?php
declare(strict_types=1);

function start_session(): void
{
    if (session_status() === PHP_SESSION_ACTIVE) {
        return;
    }

    $https = !empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off';
    session_set_cookie_params([
        'lifetime' => 0,
        'path' => '/',
        'secure' => $https,
        'httponly' => true,
        'samesite' => 'Lax',
    ]);
    ini_set('session.use_strict_mode', '1');
    ini_set('session.use_only_cookies', '1');
    session_start();
}

function csrf_token(): string
{
    start_session();
    if (empty($_SESSION['csrf_token']) || !is_string($_SESSION['csrf_token'])) {
        $_SESSION['csrf_token'] = base64_encode(random_bytes(32));
    }
    return $_SESSION['csrf_token'];
}

function csrf_check(?string $token): bool
{
    start_session();
    if (!is_string($token) || $token === '' || empty($_SESSION['csrf_token'])) {
        return false;
    }
    return hash_equals($_SESSION['csrf_token'], $token);
}

表单里输出隐藏字段。输出时使用 htmlspecialchars(),避免令牌值破坏 HTML 属性;如果模板引擎默认转义,也要确认它确实对属性上下文生效。

<?php start_session(); $token = csrf_token(); ?>
<form method='post' action='/login.php'>
    <input type='hidden' name='_csrf' value='<?= htmlspecialchars($token, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8') ?>'>
    <input type='text' name='username' autocomplete='username'>
    <input type='password' name='password' autocomplete='current-password'>
    <button type='submit'>登录</button>
</form>

登录处理脚本先校验请求方法和令牌,再校验账号密码。登录成功后调用 session_regenerate_id(true),并轮换 CSRF 令牌。这样即使攻击者事先固定了会话 ID,旧会话也不继续有效。

<?php
start_session();

if ($_SERVER['REQUEST_METHOD'] !== 'POST') {
    http_response_code(405);
    exit('Method Not Allowed');
}

if (!csrf_check($_POST['_csrf'] ?? null)) {
    http_response_code(403);
    exit('CSRF token 校验失败');
}

$username = (string)($_POST['username'] ?? '');
$password = (string)($_POST['password'] ?? '');

// 这里替换为真实的密码校验逻辑,例如 password_verify()
$loginOk = check_login($username, $password);

if (!$loginOk) {
    http_response_code(401);
    exit('用户名或密码错误');
}

session_regenerate_id(true);
$_SESSION['user_id'] = get_user_id($username);
$_SESSION['csrf_token'] = base64_encode(random_bytes(32));

header('Location: /account.php', true, 303);
exit;

退出登录也应使用 POST 加令牌,避免被跨站链接或图片触发。退出时清空会话数据、删除会话 Cookie,并调用 session_destroy()。如果业务允许 GET 退出,至少不要把它当作安全边界;GET 请求更适合只读操作。

对于 AJAX 请求,可以把令牌放在页面元信息中,再通过请求头发送。服务端同时接受表单字段和请求头时,要保证两条路径都做同样的校验,不能只在某个控制器里检查。

$token = $_SERVER['HTTP_X_CSRF_TOKEN'] ?? ($_POST['_csrf'] ?? null);
if (!csrf_check(is_string($token) ? $token : null)) {
    http_response_code(403);
    exit;
}

常见错误

只判断令牌是否存在,不比较值,等于没有校验。把令牌放在 GET 参数中,会扩大泄漏面。使用 == 比较令牌,或在令牌为空时直接放行,都是常见漏洞。

登录成功后不轮换会话 ID,会留下会话固定风险。只在登录表单加令牌,却忘记退出、改密码、绑定邮箱等状态变更接口,防护会不完整。把 CSRF 令牌写进 Cookie 再让前端读出来,属于双提交模式,若没有签名和严格校验,子域写入 Cookie 等问题会让它变弱。

另一个常见误区是认为 JSON 接口不需要 CSRF。只要接口依赖 Cookie 会话认证,并且浏览器会自动携带 Cookie,就仍然可能被跨站表单或 fetch 诱导。使用自定义请求头可以增加门槛,因为跨源请求会触发预检,但不能替代服务端令牌校验。

多标签页场景下,一次性令牌容易让用户困惑:一个标签页提交后,另一个标签页的旧令牌失效。若采用一次性令牌,需要前端在失败时刷新令牌并提示重试;否则更适合使用会话级令牌,再配合关键操作二次确认。

适用边界

CSRF 令牌的前提是攻击者不能读取页面内容。如果站点存在 XSS,攻击者可以直接读取令牌或代用户发请求,此时应先修 XSS。令牌也不能防止钓鱼、账号共享或恶意浏览器扩展。

SameSite 的行为依赖浏览器和站点定义。同站不同子域通常仍被视为 same-site,若某个子域不可信,Cookie 和 CSRF 假设都会变弱。使用 Strict 可能影响从外部链接进入后的首次请求体验,Lax 是常见折中,但不应把它当作唯一防线。

纯 Token API 如果把凭证放在 Authorization 头中,并且不依赖 Cookie,通常不满足浏览器自动携带凭证这一条件,CSRF 风险较低;但若同时支持 Cookie 认证,就要按 Cookie 场景处理。反向代理、CDN 和负载均衡环境下,要确认 HTTPS 判断、会话存储和 Cookie 域配置一致,否则可能出现令牌校验随机失败或会话丢失。

最后,CSRF 防护要与会话安全一起设计:登录前有会话、登录后轮换 ID、关键操作校验令牌、退出时销毁会话。把这些动作封装成统一入口,比在每个页面手工复制代码更可靠。