Files
kefu/deploy/perm-menu-20261007/server-bundle/remote_server_guard.py
T
2026-11-16 09:39:42 +08:00

175 lines
9.4 KiB
Python

"""Read-only checks for perm-menu-20261007: baseline / candidate / deployed / backup.
Prints hashes, counts and status only; never reads chat content, patients, users or credentials.
`backup` dumps the three RBAC tables (role codes/names, permission codes, grants) to rbac-before.json.
"""
from pathlib import Path
import argparse, hashlib, json, os, subprocess, urllib.error, urllib.request
parser = argparse.ArgumentParser()
parser.add_argument('mode', choices=['baseline', 'candidate', 'deployed', 'backup'])
args = parser.parse_args()
RELEASE = 'perm-menu-20261007'
folder = Path(__file__).resolve().parent
project = Path('/opt/im-admin')
base = json.loads((folder / 'server-baseline.json').read_text())
plan = json.loads((folder / 'release-plan.json').read_text())
manifest = json.loads((folder / 'manifest.json').read_text())
payload_rows = [row for row in manifest if row['path'].startswith('payload/')]
frontend = plan['frontendDir']
added = [frontend + '/' + rel for rel in plan['frontendAdded']]
sha = lambda data: hashlib.sha256(data).hexdigest()
image = lambda ref: subprocess.check_output(['docker', 'image', 'inspect', ref, '--format', '{{.Id}}'], text=True).strip()
SERVICES = {'api': 'im-admin-api-1', 'gateway': 'im-admin-gateway-1', 'knowledge-worker': 'im-admin-knowledge-worker-1'}
HEALTHCHECKED = {'api', 'gateway'}
# The unpacked bundle itself must be intact.
for row in manifest:
path = (folder / row['path']).resolve()
assert path.is_relative_to(folder), row['path']
assert path.stat().st_size == row['bytes'] and sha(path.read_bytes()) == row['sha256'], row['path']
# project-relative path -> expected sha256
if args.mode == 'baseline':
expected = dict(base['expected'])
else:
expected = {row['path'][len('payload/'):]: row['sha256'] for row in payload_rows}
backend_expected = {k: v for k, v in expected.items() if k.startswith('wechat_rpa/')}
HASHES = ('from pathlib import Path;import hashlib,json,sys;names=json.load(sys.stdin);'
'print(json.dumps({n:(hashlib.sha256((Path("/app")/n).read_bytes()).hexdigest() '
'if (Path("/app")/n).is_file() else None) for n in names}))')
def in_container(code, target, container=None, ref=None):
command = (['docker', 'run', '--rm', '-i', '--network=none', '--entrypoint', 'python', ref, '-c', code]
if ref else ['docker', 'exec', '-i', container, 'python', '-c', code])
return json.loads(subprocess.check_output(command, input=json.dumps(target).encode()))
def inspect(container):
raw = json.loads(subprocess.check_output(['docker', 'inspect', container]))[0]
return {'id': raw['Id'], 'image': raw['Image'], 'running': raw['State']['Running'],
'restarts': raw['RestartCount'], 'health': raw['State'].get('Health', {}).get('Status', 'not_configured')}
def healthy(name, state):
return state['running'] and (state['health'] == 'healthy' if name in HEALTHCHECKED else True)
# RBAC 表的只读快照/统计(只碰 roles、permissions、role_permissions 三张表)
RBAC_DUMP = r'''
import json, sqlite3
db = sqlite3.connect("file:/data/backend.db?mode=ro", uri=True)
def rows(sql):
cur = db.execute(sql); cols = [c[0] for c in cur.description]
return [dict(zip(cols, r)) for r in cur.fetchall()]
print(json.dumps({"roles": rows("SELECT * FROM roles"), "permissions": rows("SELECT * FROM permissions"),
"role_permissions": rows("SELECT * FROM role_permissions")}, ensure_ascii=False))
'''
RBAC_STATS = r'''
import json, sqlite3
db = sqlite3.connect("file:/data/backend.db?mode=ro", uri=True)
one = lambda sql, *a: db.execute(sql, a).fetchone()[0]
holders = lambda code: {r[0] for r in db.execute("SELECT role_code FROM role_permissions WHERE permission_code=?", (code,))}
cols = {r[1] for r in db.execute("PRAGMA table_info(permissions)")}
sources = dict(db.execute("SELECT source, COUNT(*) FROM permissions GROUP BY source").fetchall())
all_codes = {r[0] for r in db.execute("SELECT code FROM permissions")}
print(json.dumps({
"columns": sorted(cols), "sources": sources,
"review_codes": one("SELECT COUNT(*) FROM permissions WHERE code LIKE 'review:%'"),
"config_read_roles": len(holders("config:read")), "release_read_roles": len(holders("release:read")),
"config_read_without_release_read": len(holders("config:read") - holders("release:read")),
"user_read_roles": len(holders("user:read")), "role_read_roles": len(holders("role:read")),
"user_read_without_role_read": len(holders("user:read") - holders("role:read")),
"admin_missing": len(all_codes - {r[0] for r in db.execute(
"SELECT permission_code FROM role_permissions WHERE role_code='admin'")}),
"orphan_grants": one("SELECT COUNT(*) FROM role_permissions WHERE permission_code NOT IN (SELECT code FROM permissions)"),
}))
'''
current = image('zyt/wecom-admin:current')
result = {'mode': args.mode, 'release': RELEASE, 'image': current}
if args.mode == 'backup':
target = folder / 'rbac-before.json'
assert not target.exists(), 'backup already taken'
raw = subprocess.check_output(['docker', 'exec', '-i', SERVICES['api'], 'python', '-c', RBAC_DUMP])
data = json.loads(raw)
fd = os.open(target, os.O_WRONLY | os.O_CREAT | os.O_EXCL, 0o600)
with os.fdopen(fd, 'wb') as handle:
handle.write(raw)
result['backup'] = {key: len(value) for key, value in data.items()}
result['backup_sha256'] = sha(raw)
result['status'] = 'passed'
print(json.dumps(result, ensure_ascii=False))
raise SystemExit(0)
if args.mode == 'baseline':
states = {name: inspect(container) for name, container in SERVICES.items()}
for name, state in states.items():
assert state['image'] == base['images'][name], f'{name} is not on the recorded image'
assert healthy(name, state), 'Not healthy: ' + name
assert states['api']['image'] == current, 'current tag moved'
result['services'] = states
for name in added:
assert not (project / name).exists(), 'Would overwrite an existing file: ' + name
if args.mode in ('baseline', 'deployed'):
for name, wanted in expected.items():
assert sha((project / name).read_bytes()) == wanted, 'Host drift: ' + name
actual = in_container(HASHES, sorted(expected), container=SERVICES['api'])
assert actual == expected, 'Running api container differs from expected code'
if args.mode == 'deployed':
for service in ('gateway', 'knowledge-worker'):
actual = in_container(HASHES, sorted(backend_expected), container=SERVICES[service])
assert actual == backend_expected, f'Running {service} container differs from expected code'
result['files'] = len(expected)
if args.mode == 'candidate':
candidate = 'zyt/wecom-admin:' + RELEASE
actual = in_container(HASHES, sorted(expected), ref=candidate)
assert actual == expected, 'Candidate image differs from manifest'
result['candidate'] = image(candidate)
result['files'] = len(expected)
if args.mode == 'deployed':
wanted = image('zyt/wecom-admin:' + RELEASE)
assert current == wanted, 'current tag does not point at the release image'
for service, container in SERVICES.items():
state = inspect(container)
assert state['image'] == wanted and state['restarts'] == 0 and healthy(service, state), (service, state)
for url in ['http://127.0.0.1:18766/api/v2/health', 'http://127.0.0.1:18770/health']:
with urllib.request.urlopen(url, timeout=15) as response:
assert response.status == 200, url
entry = next(rel for rel in plan['frontendAdded'] if rel.startswith('jse/index-index-'))
with urllib.request.urlopen('http://127.0.0.1:18766/', timeout=15) as response:
assert entry.encode() in response.read(), 'admin index.html is not the new build'
# 新接口不登录一律 401。不尝试登录。
for method, path in [('GET', '/api/v2/permissions'), ('GET', '/api/v2/custom-menus'),
('POST', '/api/v2/permissions'), ('DELETE', '/api/v2/permissions/x:y')]:
request = urllib.request.Request('http://127.0.0.1:18766' + path, method=method, data=b'{}' if method == 'POST' else None,
headers={'Content-Type': 'application/json'})
try:
urllib.request.urlopen(request, timeout=15)
except urllib.error.HTTPError as exc:
assert exc.code == 401, (path, exc.code)
else:
raise AssertionError('Accessible without authentication: ' + path)
code = ("import json,rbac;c=rbac.PERMISSION_CODES;"
"print(json.dumps({'release_read':'release:read' in c,'role_read':'role:read' in c,'review':'review:read' in c,"
"'total':len(c)}))")
behaviour = json.loads(subprocess.check_output(['docker', 'exec', '-i', SERVICES['api'], 'python', '-c', code]))
assert behaviour == {'release_read': True, 'role_read': True, 'review': False, 'total': 28}, behaviour
stats = json.loads(subprocess.check_output(['docker', 'exec', '-i', SERVICES['api'], 'python', '-c', RBAC_STATS]))
assert {'page_name', 'kind', 'source', 'link_url', 'enabled'} <= set(stats['columns']), stats
assert stats['sources'].get('builtin') == 28 and 'discovered' not in stats['sources'], stats
assert stats['review_codes'] == 0 and stats['orphan_grants'] == 0 and stats['admin_missing'] == 0, stats
assert stats['config_read_without_release_read'] == 0, stats
assert stats['user_read_without_role_read'] == 0, stats
result['behaviour'] = behaviour
result['rbac'] = stats
result['status'] = 'passed'
print(json.dumps(result, ensure_ascii=False))