在撰写文章 / 页面的右侧栏增加图片上传窗口,选图后上传到自建 TinyImg
图床,并把 Markdown 链接插入编辑器光标处。
主要功能
1. 侧栏卡片 + 弹窗上传
- 挂在 admin/write-post.php 与 write-page.php 的 option 钩子
- 支持点选、拖入、Ctrl+V 粘贴,上传前可预览
- 用 getSelection / replaceSelection 插入光标处并触发 input 事件,
草稿自动保存与实时预览都能同步
2. 三种图床鉴权方式
- token(默认):X-TinyImg-Token 请求头,未配置则明确拒绝
- admin:模拟图床后台登录 Cookie(无需改图床,但凭证等价于后台密码)
- guest:游客上传,图片进 temp/ 并受每日配额限制
- token / admin 两种模式强制服务端代理,凭证绝不下发浏览器
3. 「测试连接」按钮
- 读取输入框当前值,无需先保存
- 经博客同源 Action(带 CSRF)调用图床 functions/upload.php?ping=1
- 返回图床版本、鉴权方式与管理员目录,并比对是否落在 upload/
4. 为什么必须走服务端代理
- 实测图床 upload.php 不返回 Access-Control-Allow-Origin,
浏览器从博客后台直接 POST 会被同源策略拦截
5. 服务端校验
- 登录态 + 用户组(可选「仅管理员」) + CSRF 令牌
- 上传大小上限、getimagesize 真实图片头校验(拦 SVG / 伪装脚本)
- 未认出管理员身份时返回 warn,前端不自动关闭弹窗
6. 附带工具与测试
- tools/probe.php:命令行连通性自检(只读探测 / 真实上传 / 目录判定)
- tools/cookie.php:本地计算图床管理员 Cookie 值,不联网
- tests/:六组共 207 项,含故意错误实现的反证
版本:2.0.0
203 lines
10 KiB
PHP
203 lines
10 KiB
PHP
<?php
|
||
|
||
/**
|
||
* TinyImg 2.0 API Token 契约测试(无需 Typecho、无需联网、不上传任何图片)。
|
||
* 运行:php tests/token_test.php
|
||
*
|
||
* 覆盖:
|
||
* 1. 直接加载图床 functions/token.php,测真实纯函数;
|
||
* 2. 源码级断言 functions/upload.php 的 Token 门与 ?ping=1 自检;
|
||
* 3. 源码级断言后台 Token 设置页的 CSRF / 四种操作 / 守卫说明;
|
||
* 4. 三个「故意写错的实现」反证:证明测试集能抓到真实漏洞。
|
||
*/
|
||
|
||
$stat = ['pass' => 0, 'fail' => 0];
|
||
|
||
$check = function ($name, $ok, $detail = '') use (&$stat) {
|
||
if ($ok) {
|
||
$stat['pass']++;
|
||
echo ' [PASS] ' . $name . PHP_EOL;
|
||
} else {
|
||
$stat['fail']++;
|
||
echo ' [FAIL] ' . $name . ($detail === '' ? '' : ' -> ' . $detail) . PHP_EOL;
|
||
}
|
||
};
|
||
|
||
$host = dirname(__DIR__, 2) . '/TinyImg';
|
||
$tokenFile = $host . '/functions/token.php';
|
||
$uploadFile = $host . '/functions/upload.php';
|
||
$settingFile = $host . '/admin/setting.php';
|
||
$adminClass = $host . '/functions/class/class.admin.php';
|
||
|
||
echo PHP_EOL . '1. 交付文件完整性' . PHP_EOL;
|
||
foreach (['Token 存储模块' => $tokenFile, '上传端点' => $uploadFile, '后台设置页' => $settingFile] as $label => $path) {
|
||
$check($label . '存在', is_file($path), $path);
|
||
}
|
||
|
||
require_once $tokenFile;
|
||
|
||
echo PHP_EOL . '2. Token 存储文件:编解码与守卫' . PHP_EOL;
|
||
|
||
$state = [
|
||
'token' => 'Abc_123-XYZ789abcdef',
|
||
'enabled' => 1,
|
||
'created_at' => '2026-11-04 10:00:00',
|
||
'updated_at' => '2026-11-04 11:00:00',
|
||
];
|
||
$raw = tinyimg_token_encode($state);
|
||
$decoded = tinyimg_token_decode($raw);
|
||
|
||
$check('编码首行是 <?php exit; 守卫(直接访问 URL 不会输出 Token)',
|
||
strpos($raw, '<?php exit;') === 0);
|
||
$check('JSON 载荷在第二行', count(explode("\n", trim($raw))) >= 2);
|
||
$check('解码还原 token / enabled / 时间戳',
|
||
is_array($decoded) && $decoded['token'] === $state['token']
|
||
&& $decoded['enabled'] === 1 && $decoded['created_at'] === $state['created_at']);
|
||
$check('解码拒绝没有守卫的裸 JSON', tinyimg_token_decode('{"token":"x"}') === null);
|
||
$check('解码拒绝损坏的 JSON', tinyimg_token_decode("<?php exit; ?>\n{not json") === null);
|
||
$check('解码拒绝缺少 token 字段', tinyimg_token_decode("<?php exit; ?>\n{\"enabled\":1}") === null);
|
||
$check('encode 对 enabled=0 输出 0',
|
||
strpos(tinyimg_token_encode(['token' => 'x', 'enabled' => 0]), '"enabled":0') !== false);
|
||
|
||
echo PHP_EOL . '3. Token 校验:正例 / 反例 / fail closed' . PHP_EOL;
|
||
|
||
$enabled = ['token' => 'S3cr3tTokenValue_123456', 'enabled' => 1];
|
||
$check('正确 Token -> 通过', tinyimg_token_verify($enabled, 'S3cr3tTokenValue_123456') === true);
|
||
$check('错误 Token -> 拒绝', tinyimg_token_verify($enabled, 'wrong') === false);
|
||
$check('空请求 -> 拒绝', tinyimg_token_verify($enabled, '') === false);
|
||
$check('未配置 Token + 空请求 -> 拒绝(不能提权)',
|
||
tinyimg_token_verify(['token' => '', 'enabled' => 1], '') === false);
|
||
$check('未配置 Token + 任意请求 -> 拒绝',
|
||
tinyimg_token_verify(['token' => '', 'enabled' => 1], 'anything') === false);
|
||
$check('已停用 -> 即使 Token 正确也拒绝',
|
||
tinyimg_token_verify(['token' => 'S3cr3tTokenValue_123456', 'enabled' => 0], 'S3cr3tTokenValue_123456') === false);
|
||
$check('真实实现使用 hash_equals 恒定时间比较',
|
||
strpos(file_get_contents($tokenFile), 'hash_equals($stored, $provided)') !== false);
|
||
|
||
echo PHP_EOL . '4. 生成 / 格式 / 脱敏 / 旧配置兼容' . PHP_EOL;
|
||
|
||
$generated = tinyimg_token_generate(32);
|
||
$check('生成 64 位十六进制 Token', (bool) preg_match('/^[a-f0-9]{64}$/', $generated), $generated);
|
||
$check('两次生成不相同', tinyimg_token_generate(32) !== tinyimg_token_generate(32));
|
||
$check('格式校验接受 16~128 位合法字符', tinyimg_token_valid_format(str_repeat('a', 16)));
|
||
$check('格式校验拒绝过短', !tinyimg_token_valid_format('abc'));
|
||
$check('格式校验拒绝空格 / 引号等危险字符', !tinyimg_token_valid_format('abc def"123456') && !tinyimg_token_valid_format("a'b123456789012"));
|
||
$check('脱敏保留首尾且不含完整 Token',
|
||
strpos(tinyimg_token_mask('abcdefghijklmnopqrstuvwxyz'), '************') !== false
|
||
&& strpos(tinyimg_token_mask('abcdefghijklmnopqrstuvwxyz'), 'abcdefghijklmnopqrstuvwxyz') === false);
|
||
$check('脱敏空值给出「未设置」', tinyimg_token_mask('') === '(未设置)');
|
||
|
||
$fromConfig = tinyimg_token_default(['api_token' => 'legacy-token-value']);
|
||
$check('旧版 config.php 的 api_token 会被自动接管',
|
||
$fromConfig['token'] === 'legacy-token-value' && $fromConfig['enabled'] === 1
|
||
&& $fromConfig['source'] === 'config');
|
||
$noConfig = tinyimg_token_default([]);
|
||
$check('无旧配置时默认停用(fail closed)',
|
||
$noConfig['enabled'] === 0 && $noConfig['source'] === 'none');
|
||
|
||
echo PHP_EOL . '5. 上传端点源码契约' . PHP_EOL;
|
||
|
||
$u = is_file($uploadFile) ? file_get_contents($uploadFile) : '';
|
||
$check('读取 X-TinyImg-Token 请求头', strpos($u, 'HTTP_X_TINYIMG_TOKEN') !== false);
|
||
$check('兼容 POST 字段 token', strpos($u, "\$_POST['token']") !== false);
|
||
$check('调用 tinyimg_token_load / tinyimg_token_verify',
|
||
strpos($u, 'tinyimg_token_load($config)') !== false
|
||
&& strpos($u, 'tinyimg_token_verify($tokenState, $reqToken)') !== false);
|
||
$check('校验失败明确报错,不静默回落',
|
||
strpos($u, "\$basis->re_error(") !== false && strpos($u, "'API Token 无效!'") !== false);
|
||
$check('未配置 / 已停用分别给出可诊断的报错',
|
||
strpos($u, 'API Token 未配置') !== false && strpos($u, 'API Token 上传已停用') !== false);
|
||
$check('?ping=1 缺少 Token 时直接拒绝', strpos($u, "缺少 API Token") !== false);
|
||
$check('?ping=1 成功返回版本与管理员目录',
|
||
strpos($u, "'version' => TINYIMG_VERSION") !== false
|
||
&& strpos($u, "'admin_dir'") !== false);
|
||
$check('校验通过才置 islogin', strpos($u, "\$status = 'islogin';") !== false);
|
||
$check('不带 Token 时保留原 Referer + Cookie 逻辑',
|
||
strpos($u, 'HTTP_REFERER') !== false && strpos($u, '$basis->check($config)') !== false);
|
||
$check('原有上传主体未被改写',
|
||
strpos($u, '$basis->limitnum();') !== false
|
||
&& strpos($u, "\$handle->file_max_size = '2097152'") !== false
|
||
&& strpos($u, "\$handle->process('../'.\$updir") !== false);
|
||
$check('上传端点不含旧品牌字符串', strpos(strtolower($u), 'img' . 'url') === false);
|
||
|
||
echo PHP_EOL . '6. 后台设置页与权限边界' . PHP_EOL;
|
||
|
||
$s = is_file($settingFile) ? file_get_contents($settingFile) : '';
|
||
$check('设置页复用后台登录鉴权', strpos($s, 'class.admin.php') !== false);
|
||
$check('写操作校验 Session CSRF', strpos($s, "hash_equals(\$csrf, \$_POST['csrf'])") !== false);
|
||
$check('提供重新生成 / 自定义保存 / 启停 / 清空四种操作',
|
||
strpos($s, "=== 'regenerate'") !== false && strpos($s, "=== 'save'") !== false
|
||
&& strpos($s, "=== 'toggle'") !== false && strpos($s, "=== 'clear'") !== false);
|
||
$check('页面显示 Token 且可显示/隐藏/复制',
|
||
strpos($s, 'id="ti-token"') !== false && strpos($s, 'ti-reveal') !== false
|
||
&& strpos($s, 'ti-copy') !== false);
|
||
$check('页面给出连接信息与 ping 自检示例',
|
||
strpos($s, 'X-TinyImg-Token') !== false && strpos($s, 'ping=1') !== false);
|
||
$check('后台管理类不认识 Token(Token 泄露无法进后台)',
|
||
is_file($adminClass) && strpos(file_get_contents($adminClass), 'api_token') === false);
|
||
|
||
echo PHP_EOL . '7. 测试集有效性反证(故意写错的实现)' . PHP_EOL;
|
||
|
||
// 错误实现 A:漏掉 enabled 检查 —— 管理员在后台停用 Token 后,旧 Token 仍能上传
|
||
$badNoEnabledCheck = function ($state, $provided) {
|
||
$stored = isset($state['token']) ? $state['token'] : '';
|
||
return $stored !== '' && $provided !== '' && hash_equals($stored, $provided);
|
||
};
|
||
$disabled = ['token' => 'S3cr3tTokenValue_123456', 'enabled' => 0];
|
||
$check('错误实现 A 在「已停用」状态下仍放行(真实漏洞)',
|
||
$badNoEnabledCheck($disabled, 'S3cr3tTokenValue_123456') === true);
|
||
$check('真实实现在同样输入下必须拒绝',
|
||
tinyimg_token_verify($disabled, 'S3cr3tTokenValue_123456') === false);
|
||
|
||
// 错误实现 B:用 == 松散比较且不检查空值 —— 空配置 + 空请求直接提权
|
||
$badLooseCompare = function ($state, $provided) {
|
||
return $state['token'] == $provided;
|
||
};
|
||
$check('错误实现 B 在「空配置 + 空请求」下放行(真实漏洞)',
|
||
$badLooseCompare(['token' => '', 'enabled' => 1], '') === true);
|
||
$check('真实实现在同样输入下必须拒绝',
|
||
tinyimg_token_verify(['token' => '', 'enabled' => 1], '') === false);
|
||
|
||
// 错误实现 C:子串匹配当校验
|
||
$badSubstring = function ($state, $provided) {
|
||
return $provided !== '' && strpos($state['token'], $provided) !== false;
|
||
};
|
||
$check('错误实现 C 让短前缀冒充 Token 通过',
|
||
$badSubstring($enabled, substr($enabled['token'], 0, 4)) === true);
|
||
$check('真实实现必须拒绝短前缀',
|
||
tinyimg_token_verify($enabled, substr($enabled['token'], 0, 4)) === false);
|
||
|
||
echo PHP_EOL . '8. 真实文件读写(临时目录,不碰线上数据)' . PHP_EOL;
|
||
|
||
$tmp = sys_get_temp_dir() . '/tinyimg-token-test-' . bin2hex(random_bytes(4));
|
||
@mkdir($tmp . '/db', 0700, true);
|
||
|
||
if (!defined('APP')) {
|
||
define('APP', $tmp . '/');
|
||
}
|
||
|
||
$saved = tinyimg_token_save('RealFileToken_123456', true, []);
|
||
$check('保存成功', $saved[0] === true, $saved[1]);
|
||
$path = tinyimg_token_file();
|
||
$check('存储文件落在 db/ 目录', is_file($path) && basename($path) === 'tinyimg-token.php', $path);
|
||
$check('存储文件首行是 PHP exit 守卫',
|
||
strpos(file_get_contents($path), '<?php exit;') === 0);
|
||
$loaded = tinyimg_token_load([]);
|
||
$check('读回 Token 且来源标记为 file',
|
||
$loaded['token'] === 'RealFileToken_123456' && $loaded['enabled'] === 1
|
||
&& $loaded['source'] === 'file', json_encode($loaded));
|
||
$check('读回状态能通过校验', tinyimg_token_verify($loaded, 'RealFileToken_123456') === true);
|
||
$check('停用后读回状态不再放行', (function () use ($tmp) {
|
||
tinyimg_token_save('RealFileToken_123456', false, []);
|
||
return tinyimg_token_verify(tinyimg_token_load([]), 'RealFileToken_123456') === false;
|
||
})());
|
||
$check('自定义非法 Token 不会被写入', !tinyimg_token_valid_format('bad token!'));
|
||
|
||
@unlink($path);
|
||
@rmdir($tmp . '/db');
|
||
@rmdir($tmp);
|
||
|
||
echo PHP_EOL . str_repeat('-', 56) . PHP_EOL;
|
||
echo '结果:' . $stat['pass'] . ' 通过 / ' . $stat['fail'] . ' 失败' . PHP_EOL;
|
||
exit($stat['fail'] === 0 ? 0 : 1);
|