跳转到正文

UmiUDI 客户端敏感信息与硬编码防明码混淆开发指南 ​

本指南旨在指导开发人员在进行客户端桌面端(Windows Forms)开发时,如何避免在源码或配置文件中明码存储关键敏感信息(如 API 地址、第三方支付回调地址、私有密钥等),以防止静态反编译分析(如使用 dnSpy/ILSpy 检索明文字符串字面量)。


🛡️ 核心技术架构:Obfuscator (去混淆器) ​

我们在项目中引入了 [Core/Obfuscator.cs](file:///e:/backup/UmiUDI&Drug/UmiUDI&Drug_1.0.0.0/Core/Obfuscator.cs),采用 内存异或(XOR)字节旋转掩码 + Base64 编解码 的轻量高效方案,实现硬编码字符串的运行时瞬时还原。

1. 技术指标 ​

  • 密钥掩码 (Key):{ 0x55, 0x4D, 0x49, 0x55, 0x44, 0x49, 0x5F, 0x49, 0x4D } (对应 ASCII "UMIUDI_IM")
  • 静态检索阻断:反编译工具检索 http 等敏感域名,均无法查找到任何匹配项。
  • 低内存占用:通过 UTF8 字节流瞬时按位运算,无任何大段堆内存开销。

🛠️ 如何为新的硬编码字符串生成密文 ​

我们提供了一个轻量级的辅助生成脚本 [scratch/obfuscate_test.py](file:///C:/Users/Administrator/.gemini/antigravity/brain/ddd66f40-81fa-41d0-a0f4-7c6f4d5b66ed/scratch/obfuscate_test.py)。

1. 使用 Python 计算密文 ​

在 Python 环境下运行混淆计算:

python
import base64

def encrypt(plain_text):
    key = b"UMIUDI_IM"
    data = plain_text.encode('utf-8')
    result = bytearray()
    for i in range(len(data)):
        result.append(data[i] ^ key[i % len(key)])
    return base64.b64encode(result).decode('utf-8')

# 输出您所需要硬编码的敏感字符串密文
print(encrypt("https://api.yourdomain.com/secret-key"))

2. 在 C# 源码中使用去混淆加载 ​

将生成的 Base64 密文填入代码,并通过 Obfuscator.Decrypt 动态加载:

csharp
// 静态混淆存储
private static string SecretKey = Obfuscator.Decrypt("密文Base64");

🌐 动态 API 地址智能发现与容灾模式 ​

对于像 IM 客服微服务这类可能经常在“本地联调调试”与“线上生产环境”切换的敏感地址,我们设计了动态探测架构:

mermaid
graph TD
    Start[打开IM工作台] --> DetectLocal{快速探测本地 5136 端口}
    DetectLocal -- "在线 (250ms内响应)" --> SetLocal[baseUrl = localhost:5136]
    DetectLocal -- "离线 (超时/无响应)" --> DetectProd{快速探测生产 1031 端口}
    DetectProd -- "在线 (350ms内响应)" --> SetProd[baseUrl = umiudi.cn:1031]
    DetectProd -- "离线" --> Fallback[baseUrl = 线上默认值]
    SetLocal --> LoadUI[加载真实联系人与气泡流]
    SetProd --> LoadUI
    Fallback --> OfflineDiag[加载 API 智能诊断助手]

最佳实践细节: ​

  1. 去明文探测:在 [DetectActiveApiUrl](file:///e:/backup/UmiUDI&Drug/UmiUDI&Drug_1.0.0.0/Forms/ChatWindow.cs#L83) 中,即使是本地测试端口与线上正式端口的域名及探测路径,也全部以 Obfuscator.Decrypt 保护,防止在反编译时暴露生产环境 IP 和接口路径。
  2. 轻量与静默自动重连:使用超低超时阈值(本地 250ms,线上 350ms)保护 UI 线程,彻底消除由于连接阻塞引起的软件假死或未响应。

📝 敏感信息保护分级标准指南 ​

敏感级别信息类型推荐安全存储方案
高危敏感支付宝/微信支付私钥、商户秘钥、SmsAccessKeySecretLevel 1:必须由后台 API 承载,严禁下发至客户端源码;若必须本地存储,应存入 App.config 并使用操作系统级 DPAPI 加密。
中度敏感数据库连接字符串、ERP 集成凭证、SMTP 密码Level 2:保存在客户端 App.config 中,生产部署时使用 aspnet_regiis -pef 命令进行物理段加密保护。
普通敏感后台接口子域名、微服务端口、非机密参数Level 3:硬编码在客户端源码中,必须使用 Obfuscator.Decrypt 混淆包装,防止静态检索。

© 2026 南通南联软件有限公司. 保留所有安全技术标准权利。

UmiUDI & Drug 医疗器械与药品唯一标识全生命周期追溯系统