Files
terry 8ac51d3160 TinyImgUploader 2.0.0:Typecho 1.3 图片上传插件(对接 TinyImg 图床)
在撰写文章 / 页面的右侧栏增加图片上传窗口,选图后上传到自建 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
2026-11-05 17:33:44 +08:00

203 lines
10 KiB
PHP
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<?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);