ZYT/zyt
2
0
Fork 0
Code Issues Actions Packages Projects Releases Wiki Activity

更新

Browse Source
This commit is contained in:
gr
2026-09-30 14:35:46 +08:00
parent 3cdc812f2b
commit 5543f45850
3 changed files with 152 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
server/.env.wecom-rpa.example
+25
View File
@@ -0,0 +1,25 @@
; 企业微信客服（桌面软件 / 手机远程控制台）对接配置
; 把下面的 [WECOM_RPA] 段追加到 server/.env 末尾使用（勿提交真实 .env）。
; php-fpm 每个请求都会重新读取 .env，保存即生效；常驻进程（如 php think run）需重启。
;
; 背景：员工在自己电脑上用客服桌面软件登录 ZYT（终端 7），令牌交给客服后台，
; 由客服后台服务器代查患者、订单。后台令牌默认绑定登录 IP，服务器出口 IP 与员工
; 电脑不同，会被判为「ip地址发生变化，请重新登录」，桌面端表现为「ZYT 患者查询
; 登录已过期」，重新验证后下一次查询仍然失败。
;
; SERVER_IPS：客服后台服务器的公网出口 IP，多个用英文逗号或空格分隔，逐个精确匹配
; （IPv4/IPv6 字面量，不支持网段）。以 ZYT 看到的来源 IP（REMOTE_ADDR）为准，
; 可在 ZYT 访问日志里核对客服后台请求的来源地址；出口 IP 变更后须同步修改。
; 只有终端 7（桌面）/ 9（手机控制台）的令牌、且请求来自这些 IP 时才跳过登录 IP
; 绑定；网页后台、APP 等其他终端令牌不受影响，菜单权限照常校验。
; 留空或不配置 = 保持原有 IP 绑定行为。
;
; 生产环境客服后台出口 IP（2026-09 核对）：123.14.175.249
; 即生产 .env 中填写：SERVER_IPS = 123.14.175.249
;
; 注意：本文件和 .env 都按 INI 解析，注释请用分号开头；以 # 开头且带等号的行
; 会被当成配置键读入。也可以不写分区，在所有 [分区] 之前写顶层键
; WECOM_RPA_SERVER_IPS，效果相同。
[WECOM_RPA]
SERVER_IPS =
server/app/adminapi/http/middleware/AuthMiddleware.php
+31 -1
View File
@@ -21,6 +21,7 @@ use app\common\service\pharmacy\PharmacyUploadPermissionAlias;
use app\common\service\qywx\QywxPromotionOperatorAccess;
use app\common\{
cache\AdminAuthCache,
enum\AdminTerminalEnum,
service\JsonService
};
use think\helper\Str;
@@ -47,7 +48,13 @@ class AuthMiddleware
return $next($request);
}
if ($request->adminInfo['login_ip'] != request()->ip()) {
// 登录 IP 绑定；客服后台服务器代查患者/订单的例外见 isTrustedRpaServerRequest
if ($request->adminInfo['login_ip'] != request()->ip()
&& !self::isTrustedRpaServerRequest(
(array) $request->adminInfo,
request()->ip(),
env('wecom_rpa.server_ips', '')
)) {
return JsonService::fail('ip地址发生变化，请重新登录', [], -1);
}
@@ -122,6 +129,29 @@ class AuthMiddleware
}, $data);
}
/**
* 企业微信客服桌面软件（7）/ 手机控制台（9）的令牌会交给客服后台，由客服后台服务器
* 代查患者、订单；服务器出口 IP 与员工电脑登录时绑定的 IP 不同，按原规则每次都会被判为
* 「ip地址发生变化」。DesktopController::session 出于同一原因已免登录。
* 这里只在「RPA 终端令牌 + 请求来自 .env [WECOM_RPA] SERVER_IPS 配置的客服后台服务器 IP」
* 时跳过 IP 绑定，网页端/APP 等其他终端令牌仍保留 IP 保护；未配置时与原逻辑完全一致。
* 只跳过 IP 校验，后续菜单权限校验照常执行，客服后台拿到的仍只是该账号角色允许的数据。
*
* @param mixed $configured 逗号/空白分隔的 IP 列表，逐个精确匹配（IPv4/IPv6 字面量）
*/
public static function isTrustedRpaServerRequest(array $adminInfo, string $ip, $configured): bool
{
if (!in_array((int) ($adminInfo['terminal'] ?? 0), AdminTerminalEnum::wecomRpaTerminals(), true)) {
return false;
}
if ($ip === '' || !is_string($configured)) {
return false;
}
$trustedIps = preg_split('/[\s,]+/', trim($configured), -1, PREG_SPLIT_NO_EMPTY) ?: [];
return in_array($ip, $trustedIps, true);
}
/**
* 日常记录权限域：前端统一收口到 tcm.diagnosis/dailyRecord，
* 但待办/跟踪备注接口仍保留历史路由名，故在鉴权层做精确别名映射。
server/tests/AdminWecomRpaServerIpTest.php
+96
View File
@@ -0,0 +1,96 @@
<?php
declare(strict_types=1);
namespace app\common\cache {
// 菜单权限数据在内存中，测试不连接缓存和业务数据库。
class AdminAuthCache
{
public static array $allUri = ['tcm.diagnosis/lists', 'tcm.prescriptionorder/lists'];
public static array $adminUri = ['tcm.diagnosis/lists'];
public function __construct(int $adminId)
{
if ($adminId !== 9) { throw new \RuntimeException('wrong permission identity'); }
}
public function getAllUri(): array { return self::$allUri; }
public function getAdminUri(): array { return self::$adminUri; }
}
}
namespace {
require dirname(__DIR__) . '/vendor/autoload.php';
require dirname(__DIR__) . '/vendor/topthink/framework/src/helper.php';
use app\adminapi\http\middleware\AuthMiddleware;
$app = new think\App();
function rpaIpCheck(bool $ok, string $message): void
{
if (!$ok) { throw new RuntimeException($message); }
}
// 桌面在员工电脑登录（198.51.100.10），客服后台服务器（203.0.113.20）拿同一令牌代查患者。
$desktop = ['admin_id' => 9, 'terminal' => 7, 'root' => 0, 'login_ip' => '198.51.100.10'];
$invoke = function (array $identity, string $ip, string $controller = 'tcm.diagnosis', string $action = 'lists') use ($app) {
$request = (new think\Request())->withServer(['REMOTE_ADDR' => $ip]);
$request->setController($controller);
$request->setAction($action);
$request->adminInfo = $identity;
$request->controllerObject = new class {
public function isNotNeedLogin(): bool { return false; }
};
$app->instance('request', $request);
$result = (new AuthMiddleware())->handle($request, static fn() => ['code' => 1, 'msg' => 'passed']);
return is_array($result) ? $result : $result->getData();
};
$ipChanged = static fn(array $r): bool => $r['code'] === -1 && str_contains($r['msg'], 'ip地址发生变化');
$setTrusted = static fn(string $value) => $app->env->set('wecom_rpa.server_ips', $value);
rpaIpCheck(env('wecom_rpa.server_ips') === null, 'test process must not inherit WECOM_RPA_SERVER_IPS');
rpaIpCheck($ipChanged($invoke($desktop, '203.0.113.20')), 'missing config keeps the login IP check');
$setTrusted('');
rpaIpCheck($ipChanged($invoke($desktop, '203.0.113.20')), 'empty config keeps the login IP check');
// [WECOM_RPA] SERVER_IPS 在 .env 里是逗号/空白分隔的列表
$setTrusted(' 192.0.2.1,203.0.113.20 2001:db8::20 ');
rpaIpCheck(env('wecom_rpa.server_ips') === ' 192.0.2.1,203.0.113.20 2001:db8::20 ', 'section key maps to env');
rpaIpCheck($invoke($desktop, '203.0.113.20')['code'] === 1, 'desktop token from the kefu server passes');
rpaIpCheck($invoke(array_replace($desktop, ['terminal' => 9]), '203.0.113.20')['code'] === 1,
'mobile console token from the kefu server passes');
rpaIpCheck($invoke(array_replace($desktop, ['terminal' => '7']), '2001:db8::20')['code'] === 1,
'IPv6 server address and string terminal from cache pass');
rpaIpCheck($invoke($desktop, '198.51.100.10')['code'] === 1, 'desktop token from the login IP still passes');
rpaIpCheck($ipChanged($invoke($desktop, '198.51.100.99')), 'desktop token from an untrusted IP is rejected');
rpaIpCheck($ipChanged($invoke($desktop, '203.0.113.2')), 'trusted IP must match exactly, not by prefix');
rpaIpCheck($ipChanged($invoke($desktop, '2001:db8::2')), 'trusted IPv6 must match exactly');
rpaIpCheck($ipChanged($invoke(array_replace($desktop, ['terminal' => 1]), '203.0.113.20')),
'web token from the kefu server keeps IP protection');
rpaIpCheck($ipChanged($invoke(array_replace($desktop, ['terminal' => 2]), '203.0.113.20')),
'admin mobile web token keeps IP protection');
rpaIpCheck($ipChanged($invoke(array_replace($desktop, ['terminal' => 8]), '203.0.113.20')),
'AI browser console token keeps IP protection');
rpaIpCheck($ipChanged($invoke(array_diff_key($desktop, ['terminal' => 0]), '203.0.113.20')),
'token without terminal keeps IP protection');
// 跳过的只有 IP 校验：客服后台仍只能访问该账号角色允许的接口
$denied = $invoke($desktop, '203.0.113.20', 'tcm.prescriptionOrder', 'lists');
rpaIpCheck($denied['code'] === 0 && str_contains($denied['msg'], '权限不足'), 'menu permissions still apply');
rpaIpCheck($invoke(array_replace($desktop, ['root' => 1]), '203.0.113.20', 'tcm.prescriptionOrder', 'lists')['code'] === 1,
'root bypass is unchanged');
$setTrusted('true');
rpaIpCheck(env('wecom_rpa.server_ips') === true, 'think Env converts true to bool');
rpaIpCheck($ipChanged($invoke($desktop, '203.0.113.20')), 'non-list config keeps the login IP check');
rpaIpCheck(!AuthMiddleware::isTrustedRpaServerRequest($desktop, '', ','), 'empty request IP never trusted');
rpaIpCheck(!AuthMiddleware::isTrustedRpaServerRequest($desktop, '203.0.113.20', " ,\n\t"), 'separators only');
rpaIpCheck(AuthMiddleware::isTrustedRpaServerRequest($desktop, '203.0.113.20', "192.0.2.1\n203.0.113.20"),
'newline separated list');
// 示例配置能按 .env 规则解析且默认留空；生产 IP 只写在运维配置里，不硬编码进代码
$exampleEnv = new think\Env();
$exampleEnv->load(dirname(__DIR__) . '/.env.wecom-rpa.example');
rpaIpCheck($exampleEnv->get('wecom_rpa.server_ips') === '', 'env example parses and ships an empty list');
$middlewareSource = file_get_contents(dirname(__DIR__) . '/app/adminapi/http/middleware/AuthMiddleware.php');
rpaIpCheck(is_string($middlewareSource) && !str_contains($middlewareSource, '123.14.'),
'kefu server IP is not hard-coded in the middleware');
echo "AdminWecomRpaServerIpTest passed\n";
}