智能合约与以太坊 / 系统课时

构造跨账户调用检验访问控制

构造跨账户调用检验访问控制

访问控制缺陷往往不是函数完全没有权限检查,而是检查了错误的账户、遗漏某条操作路径,或者让普通授权者获得管理员能力。本课使用 Foundry 构造管理员、授权用户和攻击者三种身份,通过模糊测试验证资产转移与权限变更,并检查拒绝非法调用后合约状态是否保持不变。

学习目标

  • 使用 vm.prank 模拟不同账户发起合约调用,建立可验证的角色权限矩阵。
  • 编写 Foundry Fuzz Test,覆盖合法操作、越权调用和状态不变性。
  • 识别 tx.origin、调用者混淆和权限检查遗漏造成的安全风险。

定义账户与操作权限

假设一个资产金库合约存在三种角色:管理员 Admin、授权操作员 Operator、未授权攻击者 Attacker。合约提供 withdraw 提取 ETH 和 setOperator 修改操作员两个敏感入口。

首先将预期行为写成权限矩阵,后续测试直接以它作为判定依据。

调用者 withdraw setOperator
Admin 允许 允许
Operator 允许 拒绝
Attacker 拒绝 拒绝

其中,Operator 能转移金库资产,但不能授予自己或其他人新的权限。Attacker 即使知道函数签名、目标地址和金额,也不应绕过限制。

测试初始资金设置为 10 ETH,单次提取金额限制在 1 wei 至 1 ETH。这样正常调用不会因为余额不足而失败,避免将资金错误误判为访问控制正常。

必须分别检查两个结果:非法调用是否按照预期的权限错误回滚,以及回滚之后金库余额、收款人余额和授权账户是否保持原值。

编写可测试的金库合约

使用已经安装 Foundry 的项目,在项目根目录创建 test/RoleVault.t.sol。下面将演示合约与测试放在同一个 Solidity 文件中,便于独立运行。实际项目应分别维护生产合约和测试文件。

示例适用于 Solidity 0.8.20 及兼容版本,使用 Foundry 的 forge-std/Test.sol。

solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

import {Test} from "forge-std/Test.sol";

contract RoleVault {
    error Unauthorized(address caller);
    error TransferFailed();

    address public owner;
    address public operator;

    constructor(address initialOperator) {
        owner = msg.sender;
        operator = initialOperator;
    }

    // 管理员和操作员都能提取资产。
    function withdraw(address payable to, uint256 amount) external {
        if (msg.sender != owner && msg.sender != operator) {
            revert Unauthorized(msg.sender);
        }
        (bool success, ) = to.call{value: amount}("");
        if (!success) revert TransferFailed();
    }

    // 变更权限只能由管理员执行。
    function setOperator(address nextOperator) external {
        if (msg.sender != owner) {
            revert Unauthorized(msg.sender);
        }
        operator = nextOperator;
    }

    receive() external payable {}
}

这里使用 msg.sender 判断直接调用者,owner 和 operator 分别承载不同权限。withdraw 的外部转账发生在权限检查之后。

这是用于访问控制测试的精简合约,不是可直接投入生产的金库实现。生产版本还需要考虑零地址校验、角色事件、收款方重入风险和资产操作审计等要求。

使用模糊测试交叉执行敏感操作

继续在同一个 test/RoleVault.t.sol 文件末尾添加以下测试合约。roleSeed 由 Foundry 生成,再映射成三种固定身份;amountSeed 用于生成不同的合法提取金额。

solidity
contract RoleVaultTest is Test {
    RoleVault vault;

    address admin = makeAddr("admin");
    address operatorUser = makeAddr("operator");
    address attacker = makeAddr("attacker");
    address recipient = makeAddr("recipient");

    function setUp() public {
        // 使用管理员身份部署,避免测试合约意外成为所有者。
        vm.prank(admin);
        vault = new RoleVault(operatorUser);
        vm.deal(address(vault), 10 ether);
    }

    function actorAt(uint8 roleSeed) internal view returns (address) {
        uint8 index = roleSeed % 3;
        if (index == 0) return admin;
        if (index == 1) return operatorUser;
        return attacker;
    }

    function testFuzz_WithdrawAccess(
        uint8 roleSeed,
        uint96 amountSeed
    ) public {
        address actor = actorAt(roleSeed);
        uint256 amount = bound(uint256(amountSeed), 1, 1 ether);
        uint256 vaultBefore = address(vault).balance;
        uint256 recipientBefore = recipient.balance;

        if (actor == attacker) {
            // 指定错误选择器及账户,防止其他回滚掩盖权限缺陷。
            vm.expectRevert(
                abi.encodeWithSelector(RoleVault.Unauthorized.selector, actor)
            );
            vm.prank(actor);
            vault.withdraw(payable(recipient), amount);

            assertEq(address(vault).balance, vaultBefore);
            assertEq(recipient.balance, recipientBefore);
        } else {
            vm.prank(actor);
            vault.withdraw(payable(recipient), amount);

            assertEq(address(vault).balance, vaultBefore - amount);
            assertEq(recipient.balance, recipientBefore + amount);
        }
    }

    function testFuzz_SetOperatorAccess(uint8 roleSeed) public {
        address actor = actorAt(roleSeed);
        address replacement = makeAddr("replacement");
        address original = vault.operator();
        uint256 vaultBefore = address(vault).balance;

        if (actor != admin) {
            vm.expectRevert(
                abi.encodeWithSelector(RoleVault.Unauthorized.selector, actor)
            );
        }

        vm.prank(actor);
        vault.setOperator(replacement);

        assertEq(
            vault.operator(),
            actor == admin ? replacement : original
        );
        assertEq(address(vault).balance, vaultBefore);
    }
}

两组测试分别覆盖不同的安全条件:

  • testFuzz_WithdrawAccess:允许 Admin 和 Operator 转账,要求 Attacker 回滚且资产余额不变。
  • testFuzz_SetOperatorAccess:只允许 Admin 修改授权账户,Operator 和 Attacker 必须被拒绝。

vm.prank(actor) 只作用于下一次符合条件的调用,不会永久修改测试环境的身份。需要连续使用同一身份调用多个函数时,可以使用 vm.startPrank(actor) 和 vm.stopPrank(),并确保测试结束前恢复。

vm.expectRevert 使用完整编码的自定义错误,而不是只判断是否发生任意回滚,因此能够避免把余额不足等其他异常当成正确的权限拒绝。

执行测试并判断覆盖结果

在项目根目录运行以下命令。该命令针对测试合约执行,每个 Fuzz Test 默认使用配置中的模糊测试次数;未修改默认配置时通常为 256 次。

bash
forge test --match-contract RoleVaultTest -vv

预期结果:两项模糊测试通过,终端会显示类似下面的摘要。具体运行次数、Gas 数值和执行耗时可能因配置与版本不同而变化。

text
[PASS] testFuzz_SetOperatorAccess(uint8) (... runs, ...)
[PASS] testFuzz_WithdrawAccess(uint8,uint96) (... runs, ...)
Suite result: ok. 2 passed; 0 failed

其中省略号代表实际统计信息,并非需要逐字匹配的输出。

还可以通过提高测试轮数扩大金额和账户选择的输入覆盖范围:

bash
forge test --match-contract RoleVaultTest --fuzz-runs 1000

预期结果:两项测试均通过,且各自显示 1000 次 Fuzz Runs。若发现失败,Foundry 会提供失败输入和相关信息,可使用 -vvvv 查看调用轨迹。

注入缺陷验证测试是否有效

一项重要的测试验收标准是:故意破坏权限逻辑之后,测试必须能够发现问题。

可以尝试以下两种变更,每次只引入一种,再恢复原实现。

缺陷注入 错误行为 应当失败的测试
从 withdraw 删除权限判断 Attacker 能提取资金 testFuzz_WithdrawAccess
将 setOperator 的管理员检查改成允许 Operator Operator 能修改授权账户 testFuzz_SetOperatorAccess

第一种缺陷可能导致攻击者直接转走 ETH。如果测试只检查函数是否执行成功,而不模拟攻击者身份,就很容易漏掉。

第二种缺陷属于权限提升:Operator 原本只有提取权,却能够修改授权角色。攻击者一旦控制 Operator 账户,就可能通过授权变更扩大后续影响。

还需要特别注意 tx.origin。它表示交易最初的外部账户,而不是当前函数的直接调用者。若用它代替 msg.sender 授权,攻击者可能通过中间合约诱导管理员发起交易,使目标合约误认为调用已经获得管理员授权。

对于涉及合约转发的系统,应该补充管理员、中间调用合约和目标金库三方协作的测试;必要时使用支持设置 tx.origin 的 vm.prank(sender, origin) 构造交易上下文。直接调用账户的测试不能代替这种跨合约攻击测试。

检查剩余安全边界

当前示例证明了两个敏感入口在三种固定身份下的基本权限行为,但覆盖范围仍有边界。

  1. 新 Operator 生效后,应确认旧 Operator 立即失去提取权,新 Operator 获得预期权限。
  2. 收款账户如果是恶意合约,需要另外测试回调与重入,不应将转账成功等同于整体安全。
  3. 对零地址、重复授权和权限撤销等业务约束,应根据合约需求补充明确的不变量。
  4. 对代理合约或可升级系统,还应测试升级前后权限存储是否保持正确。

实际项目可以把权限矩阵扩展成确定性测试,再以 Fuzz Test 改变调用顺序、金额和账户组合。最终验收不能只看 PASS 数量,还必须确认所有非法调用都被正确拒绝,并且任何失败操作都没有造成未经授权的状态变化。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

构造跨账户调用检验访问控制

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通