智能合约与以太坊 / 系统课时
构造跨账户调用检验访问控制
构造跨账户调用检验访问控制
访问控制缺陷往往不是函数完全没有权限检查,而是检查了错误的账户、遗漏某条操作路径,或者让普通授权者获得管理员能力。本课使用 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。
// 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 用于生成不同的合法提取金额。
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 次。
forge test --match-contract RoleVaultTest -vv预期结果:两项模糊测试通过,终端会显示类似下面的摘要。具体运行次数、Gas 数值和执行耗时可能因配置与版本不同而变化。
[PASS] testFuzz_SetOperatorAccess(uint8) (... runs, ...)
[PASS] testFuzz_WithdrawAccess(uint8,uint96) (... runs, ...)
Suite result: ok. 2 passed; 0 failed其中省略号代表实际统计信息,并非需要逐字匹配的输出。
还可以通过提高测试轮数扩大金额和账户选择的输入覆盖范围:
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) 构造交易上下文。直接调用账户的测试不能代替这种跨合约攻击测试。
检查剩余安全边界
当前示例证明了两个敏感入口在三种固定身份下的基本权限行为,但覆盖范围仍有边界。
- 新 Operator 生效后,应确认旧 Operator 立即失去提取权,新 Operator 获得预期权限。
- 收款账户如果是恶意合约,需要另外测试回调与重入,不应将转账成功等同于整体安全。
- 对零地址、重复授权和权限撤销等业务约束,应根据合约需求补充明确的不变量。
- 对代理合约或可升级系统,还应测试升级前后权限存储是否保持正确。
实际项目可以把权限矩阵扩展成确定性测试,再以 Fuzz Test 改变调用顺序、金额和账户组合。最终验收不能只看 PASS 数量,还必须确认所有非法调用都被正确拒绝,并且任何失败操作都没有造成未经授权的状态变化。