# Android 构建与单元测试验收记录 (P1 第六批收口终版) ## 构建环境 - **宿主机架构**:Windows 11 ARM64 (`aarch64`) / Oracle Cloud Infrastructure 虚拟机 (Red Hat VirtIO) - **JDK 版本**:Microsoft OpenJDK 17 (`17.0.20.101-hotspot`) - **Android SDK 路径**:`C:\Android` - **Compile SDK**:`34` (Android 14) - **Target SDK**:`34` - **Min SDK**:`26` - **Build Tools**:`34.0.0` - **Gradle 版本**:`Gradle 8.4` (通过自带 `gradlew.bat`) ## 单元测试命令与实测结果 ```cmd .\gradlew.bat testDebugUnitTest ``` - **Result**: `BUILD SUCCESSFUL` - **Actionable Tasks**: `88 actionable tasks: 88 executed` - **测试用例明细 (14 passed, 0 failed, 0 error, 100% pass rate)**: - `com.classnotify.app.AuthInterceptorTest` (3/3): - `intercept_addsBearerToken_whenTokenAvailable` (Passed) - `intercept_proceedsWithoutBearer_whenTokenNull` (Passed) - `intercept_on401Unauthorized_triggersSessionExpiredCallback` (Passed) - `com.classnotify.app.LoginViewModelTest` (4/4): - `login_withBlankFields_setsErrorStateImmediately` (Passed) - `login_withValidCredentials_transitionsToSuccessState` (Passed) - `login_withInvalidCredentials_transitionsToErrorState` (Passed) - `factory_createsLoginViewModelInstance` (Passed) - `com.classnotify.app.SecureTokenStoreTest` (1/1): - `cryptoFailure_neverFallsBackToPlaintextSharedPreferencesOnDisk` (Passed) - `com.classnotify.app.SignalRManagerTest` (6/6): - `testA_connectLifecycle_transitionsFromDisconnectedToConnected` (Passed) - `testB_onClosed_transitionsToReconnectingAndRecovers` (Passed) - `testC_duplicateConnect_onlyCreatesSingleActiveConnection` (Passed) - `testD_disconnectDuringReconnect_cancelsSupervisorAndResetsState` (Passed) - `testE_networkRecovery_triggersReconnectWhenDisconnected` (Passed - 真实模拟连接中断 -> 重试失败阻断 -> 网络恢复通知触发 -> 新建连接并恢复 Connected) - `testF_tokenDisappears_reconnectDoesNotLoopOrEstablishHub` (Passed) ## 插桩测试套件 (androidTest) - `com.classnotify.app.SecureTokenStoreInstrumentedTest`: 硬件 Keystore / EncryptedSharedPreferences (AES-256 GCM + SIV) 存取、清理与旧明文彻底清除验证 - `com.classnotify.app.StartupNavigationInstrumentedTest`: 无有效 Token 时冷启动停留在登录页面与 UI 控件断言 - **测试包编译状态**:`packageDebugAndroidTest` 成功生成 `app-debug-androidTest.apk` ## APK 构建命令与产物信息 ```cmd .\gradlew.bat assembleDebug assembleRelease ``` - **Debug APK**: - 路径: `src/Android/ClassNotify.Android/app/build/outputs/apk/debug/app-debug.apk` - 大小: `18,160,032` 字节 (`17.32 MB`) - SHA256: `5D2E96E2C50EA416690916DCA1C69980362FEE21851046B6EE1766BB76049FE4` - **Release APK**: - 路径: `src/Android/ClassNotify.Android/app/build/outputs/apk/release/app-release-unsigned.apk` - 大小: `12,082,091` 字节 (`11.52 MB`) - SHA256: `E79205B463A6A84CD864ABF72C9CE4F9CE03E889DFFC7A0937225AFE525485FB` - Release 签名: `NOT CONFIGURED` (当前为 unsigned 产物,未配置生产密钥库签名) ## 敏感信息扫描 (Release Source & APK) - `teacher123`: Source 0 matches, APK 0 matches - `admin888`: Source 0 matches, APK 0 matches - `Authorization: Bearer `: 0 matches - `JWT signing key / Secret`: 0 matches ## 宿主机设备与模拟器环境 - **adb devices**: `List of devices attached` (空) - **环境客观约束说明**: 宿主机为 Oracle Cloud Windows 11 ARM64 (`aarch64`) 虚拟服务器。Google Android SDK 官方未对 Windows ARM64 分发原生 emulator 二进制。由于云端虚拟机无本地物理 USB 直通,若需在真机执行 `connectedDebugAndroidTest` 与物理交互,需由客户端通过 ADB over TCP/IP (`adb connect`) 或反向 SSH 隧道接入。 --- # Windows 边缘凭据与 IPC 纵深防御验收记录 (P1 第八批收口终版) ## 构建与测试环境 - **宿主机架构**:Windows 11 ARM64 (`aarch64`) - **.NET SDK 版本**:.NET 8.0.425 - **构建配置**:Release / Any CPU & win-x64 - **受保护凭据路径**:`C:\ProgramData\ClassNotify\device_credentials.json` - **命名管道名称**:`\\.\pipe\ClassNotify_Ipc_Pipe` ## 一、P1 Batch 8 核心整改落地与防御矩阵 | 风险/攻击面 | 原有缺陷/脆弱点 | P1 Batch 8 落地防御措施 | 验收结果 | | :--- | :--- | :--- | :--- | | **设备凭据持久化** | 明文 JSON 存储在 `C:\ProgramData\ClassNotify\` 下,任何低权限本地用户均可读取 | 1. 采用 Windows DPAPI `LocalMachine` 对称加密存储
2. 首次读取自动平滑迁移旧明文并覆写为密文
3. 设置严格 NTFS ACL:仅 `SYSTEM` 与 `Administrators` 具备 FullControl,禁用继承,非特权用户 `Users` 组零权限 | **PASS** | | **跨身份安装与升级** | Setup(管理员)激活写盘与 Service(LocalSystem)读取身份不一致 | DPAPI `DataProtectionScope.LocalMachine` 确保管理员与服务均可解密;升级或重试不丢失凭据,免消耗新激活码 | **PASS** | | **同一登录用户伪造 IPC** | 命名管道虽有 Pipe ACL,但同处于交互式 Session 的恶意进程可用任意 PID 伪造 `hello` 握手 | 1. Service 在通过 `CreateProcessAsUser` 拉起 Client 时生成 128-bit 临时 Launch Token (`--ipc-token`)
2. Client 必须在 Protocol Version 2 发送对应 Token
3. Service 通过 Win32 `GetNamedPipeClientProcessId` 强校验对端 PID、会话及进程白名单 | **PASS** | | **旧协议向后兼容攻击** | 攻击者发送旧版 Protocol 1 hello(不带 Token)试图绕过验证 | Service 强制要求 Protocol Version >= 2 并携带有效 Token,立即断开并丢弃任何 Protocol 1 握手 | **PASS** | | **Client 崩溃/重启轮转** | 客户端被恶意终止或崩溃后,旧 Token 未失效导致重放风险 | Watchdog 重启或进程退出时原子轮转新 Token;旧 Token 立即从 Service 授权表注销;重新启动后无死锁且自动重连 | **PASS** | ## 二、测试套件实测命令与结果 ### 1. 边缘安全专用测试套件 (`ClassNotify.EdgeSecurityTests`) ```cmd dotnet run --project tests/ClassNotify.EdgeSecurityTests/ClassNotify.EdgeSecurityTests.csproj -c Release ``` - **Result**: `13 Passed, 0 Failed` (100% Pass Rate) 1. `[PASS]` Credential: Legacy Plaintext JSON Auto-Migration 2. `[PASS]` Credential: DPAPI LocalMachine Encryption Verification 3. `[PASS]` Credential: Hardened NTFS File ACL Protection 4. `[PASS]` Credential: ACL Fail-Closed & Temp Cleanup Verification 5. `[PASS]` Credential: Strict ACL Allowlist Invariant Rejects Arbitrary SIDs 6. `[PASS]` Setup: StartupManager Cleans Legacy Run & Scheduled Tasks 7. `[PASS]` NamedPipe: Rejects Legacy Protocol 1 Public Hello Without Token 8. `[PASS]` NamedPipe: Rejects Handshake With Invalid Launch Token 9. `[PASS]` NamedPipe: Rejects Handshake With Mismatched Process Name 10. `[PASS]` NamedPipe: Accepts Valid Protocol 2 Launch Token & PID 11. `[PASS]` NamedPipe: Token Rotation & Reconnection Verification 12. `[PASS]` NamedPipe: SessionLauncher Fallback Fail-Closed Verification 13. `[PASS]` NamedPipe: Zero Secret Token Leakage In Audit Logs ### 针对 ChatGPT 独立审查反馈的整改闭环 (Round 1 & Round 2 收口) 1. **Service 成为 Client 唯一可信启动者,彻底清除 Setup 自启动与计划任务竞争**: - Setup 移除 `EnableStartup(clientExe)` 与 `LaunchClientInCurrentSession(clientExe)`; - `StartupManager.CleanupLegacyStartupEntries()` 主动清理 `HKLM\Run`、`HKCU\Run` 及所有历史计划任务(`ClassNotifyClient`, `ClassNotify_Client_UI`, `ClassNotify`),避免无 Token 客户端提前抢占单例 Mutex 导致 IPC 握手异常与看门狗误杀; - 增加 `Test_Setup_StartupManager_CleansLegacyEntries` 实机测试。 2. **运维 PowerShell 脚本安全模型对齐与废弃收口**: - `src/Scripts/Install-ClassNotify.ps1` 彻底删除明文落盘参数 `DeviceToken` 与计划任务,仅注册服务,客户端统一由服务守护拉起; - `src/Scripts/Repair-ClassNotify.ps1` 不再直接调用 `Start-Process` 拉起无 Token 客户端,改为由守护服务看门狗恢复; - 历史原型 `WindowsClient/Install-ClassNotify.ps1` 标记为 `[DEPRECATED]` 并中止执行。 3. **字面意义上的“Zero Secret Token Leakage”**: - 移除 `SessionLauncher` 与 `NamedPipeServer` 中仅剩的 3 处 `TokenPrefix` 截断输出; - 日志严格仅输出 `PID` 与 `SessionId`,任何 Token、完整字符串或前缀均零出现; - `Test_NamedPipe_HandshakeLog_ZeroTokenLeakage` 强化断言:非法握手与合法授权均断言 Token 与其前缀零泄露。 4. **NTFS ACL Verifier 实施严格白名单不变量**: - `VerifyHardenedFileAcl` 强制断言每一个 Allow ACE 必须严格等于 `SYSTEM` 或 `Administrators`,且必须具备 `FileSystemRights.FullControl`; - 任何第三方未授权 SID(无论普通用户、Everyone 还是 AuthenticatedUsers)只要出现 Allow 即刻抛出异常拒绝; - 增加 `Test_NTFS_Acl_StrictAllowlist_RejectsArbitrarySid` 测试。 ### 2. 认证与密钥安全性回归测试 (`ClassNotify.AuthTests`) ```cmd dotnet run --project tests/ClassNotify.AuthTests/ClassNotify.AuthTests.csproj -c Release ``` - **Result**: `12 Passed, 0 Failed` (100% Pass Rate) ### 3. 速率限制与租户隔离回归测试 (`ClassNotify.RateLimitTests`) ```cmd dotnet run --project tests/ClassNotify.RateLimitTests/ClassNotify.RateLimitTests.csproj -c Release ``` - **Result**: `3 Passed, 0 Failed` (100% Pass Rate) ### 4. 解决方案全量编译检查 (`ClassNotify.sln`) ```cmd dotnet build ClassNotify.sln -c Release dotnet build src/Windows/ClassNotify.Setup/ClassNotify.Setup.csproj -c Release ``` - **Result**: `0 Warning(s), 0 Error(s)` --- # 消息挂起、TTL、补发与去重验收记录 (P1 第九批收口终版) ## 构建与测试环境 - **宿主机架构**:Windows 11 ARM64 (`aarch64`) - **.NET SDK 版本**:.NET 8.0.425 - **数据库**:PostgreSQL 16 (运行在远程 Oracle VPS,通过 SSH 隧道直连集成测试) - **构建配置**:Release / Any CPU ## 一、P1 Batch 9 核心整改落地与防御矩阵 | 模块 / 攻击面与风险 | 原有缺陷 / 脆弱点 | P1 Batch 9 落地防御与工程实现 | 验收结果 | | :--- | :--- | :--- | :--- | | **管道写入即时断开与缓冲丢包 (Reviewer R3 专项)** | Pipe `WriteUtf8Async` 返回 `bool`。若客户端在发送瞬间断开,旧逻辑直接忽略返回值导致消息丢失;Flush 过程中若第 2 条失败,后续消息全部丢弃 | 引入 `ClientNotificationBuffer` 生产级缓冲区,严格检查管道写入布尔值。写入失败 (`false`) 或未连接即刻回退至挂起队列;`FlushAsync` 遭遇断开时原子保留未发送项并中止冲刷,重连后保持消息顺序完整投递 | **PASS** | | **真实 PostgreSQL 迁移与历史数据兼容 (Reviewer R3 专项)** | 缺乏针对真实 PostgreSQL 的历史数据迁移集成测试,存在表结构或索引兼容性盲区 | 编写真实 PostgreSQL 迁移测试:新建隔离 DB,应用 Batch 8 初始迁移,灌入无 `ExpiresAt` 历史记录,执行 `Database.MigrateAsync()` 升级到 Batch 9,强校验 `ExpiresAt`/`Voice`/`Shake`/`DurationSeconds` 字段、复合索引、数据不丢、SQL 回填 (`ExpiresAt = CreatedAt`),并验证运行时 `SecurityService` 过滤抑制 | **PASS** | | **过期消息抑制与 TTL 边界** | 离线过久重连的设备可能收到大量已失效告警 | 引入 `ExpiresAt` 与服务端强时钟校验。离线补发与实时拉取严格过滤 `ExpiresAt <= DateTime.UtcNow` 记录,自动标记为 `Expired` 且绝不下发至客户端 | **PASS** | | **客户端与服务端双向幂等去重** | 网络重试或重连可能导致同一次广播被多次弹窗或重复入库 | 服务端以 `NotificationId` + `DeviceId` 为唯一 Receipt 约束;客户端与 Service 维护基于 Sliding Memory Cache 的消息去重,已消费消息直接 ACK 并不再重复弹出 Toast/弹窗 | **PASS** | ## 二、测试套件实测命令与结果 ### 1. 消息投递与挂起恢复测试套件 (`ClassNotify.DeliveryTests`) ```cmd dotnet run --project tests/ClassNotify.DeliveryTests/ClassNotify.DeliveryTests.csproj -c Release ``` - **Result**: `15 Passed, 0 Failed` (100% Pass Rate) 1. `[PASS]` Test_Online_ImmediateDelivery_And_Ack 2. `[PASS]` Test_Offline_EnqueuePending_And_CatchUp_On_Connect 3. `[PASS]` Test_Expired_Notification_Not_Delivered 4. `[PASS]` Test_Exact_TTL_Boundary_Behavior 5. `[PASS]` Test_Duplicate_Notification_Deduplication 6. `[PASS]` Test_Large_Message_Delivery_Integrity 7. `[PASS]` Test_Transient_Wpf_Unavailable_Does_Not_Drop_Message_And_Delivers_On_Connect (Direct ClientNotificationBuffer) 8. `[PASS]` Test_Concurrent_Notifications_Ordering_And_Delivery 9. `[PASS]` Test_Multi_Device_Independent_Receipt_State 10. `[PASS]` Test_Security_Service_Pending_CatchUp_Integration 11. `[PASS]` Test_Security_Service_Expired_Notification_Suppressed_Integration 12. `[PASS]` Test_EF_Migration_Script_Batch8_To_Batch9_Schema_Verification 13. `[PASS]` Test_Pipe_Send_Returns_False_Mid_Send_Recovers_And_Delivers_On_Next_Connect 14. `[PASS]` Test_PostgreSQL_Batch8_To_Batch9_Migration_Integration_With_Legacy_Data 15. `[PASS]` Test_Client_Side_Deduplication_And_Replay_Suppression ### 2. 安全与边缘凭据回归测试 (`ClassNotify.EdgeSecurityTests`) ```cmd dotnet run --project tests/ClassNotify.EdgeSecurityTests/ClassNotify.EdgeSecurityTests.csproj -c Release ``` - **Result**: `13 Passed, 0 Failed` (100% Pass Rate) ### 3. 认证与令牌回归测试 (`ClassNotify.AuthTests`) ```cmd dotnet run --project tests/ClassNotify.AuthTests/ClassNotify.AuthTests.csproj -c Release ``` - **Result**: `12 Passed, 0 Failed` (100% Pass Rate) ### 4. 速率限制回归测试 (`ClassNotify.RateLimitTests`) ```cmd dotnet run --project tests/ClassNotify.RateLimitTests/ClassNotify.RateLimitTests.csproj -c Release ``` - **Result**: `3 Passed, 0 Failed` (100% Pass Rate) ### 5. 解决方案全量 Release 编译 ```cmd dotnet build ClassNotify.sln -c Release ``` - **Result**: `0 Warning(s), 0 Error(s)` --- ## 三、针对 ChatGPT 审查员 Round 3 阻断项专项整改闭环 (Round 4 终版) ### 1. PostgreSQL 凭据泄露应急轮换与安全纵深防御 - **紧急轮换与旧密码作废**: - 远程 Oracle VPS 生产环境立即执行密码轮换,将泄露的旧密码 [REVOKED_DB_PASSWORD_REDACTED] 彻底作废; - 实测验证:使用旧密码连接立即返回 `FATAL: password authentication failed for user "classnotify"` (100% 拒绝); - 生成 256-bit 随机密码更新至 `/etc/classnotify/classnotify.env`(严格 600 权限),重启 `classnotify.service`,服务状态确认 `active (running)`。 - **权限最小化与测试隔离角色**: - 生产应用角色 `classnotify` 剥离 `CREATEDB` 权限 (`ALTER USER classnotify NOCREATEDB;`),实测 `CREATE DATABASE` 返回 `permission denied`; - 独立创建专用测试角色 `classnotify_test` 并赋予 `CREATEDB`,仅供集成测试动态建库。 - **源码与脚本零明文凭据**: - `tests/ClassNotify.DeliveryTests/Program.cs` 与 `tests/BenchmarkRunner/Program.cs` 彻底剔除硬编码连接串与密码,统一通过环境变量 `CLASSNOTIFY_TEST_DB_CONNECTION` 读取; - 全仓库深度 Grep 扫描:敏感凭据零出现; - 发布脚本 `Publish-AuditSnapshot.ps1` 增加自动正则脱敏(`Password=[^;\r\n"']+` -> `Password=` 与密钥特征消除),杜绝任何凭据进入公开快照。 ### 2. ClientNotificationBuffer 严格 FIFO 保序与单一调度器重构 - **单一并发锁**:引入 `SemaphoreSlim(1,1)` 确保 `Flush` 与 `DeliverOrBuffer` 串行原子操作,杜绝并发交叉; - **原子 Peek-then-Dequeue**:冲刷时改用 `TryPeek`,仅在管道写入确切返回 `true` 时才出队;若写入失败 (`false` / 破裂管道),首项保留在队首并立即中止冲刷,绝对不会把失败项错误塞入队尾破坏 FIFO 顺序; - **Backlog 阻塞屏障**:在 `DeliverOrBufferAsync` 中,若当前队列存在未投递积压 (`!_pendingQueue.IsEmpty`),新消息强制追加至队尾,绝不绕过旧消息插队直接发送; - **端到端断言测试强化**: - `Test_Pipe_Send_Returns_False_Mid_Send_Recovers_And_Delivers_On_Next_Connect` 全面升级: 1. 断言冲刷失败后快照精确保持 `[m2, m3]`; 2. 断言积压期间新通知 `m4` 到达后快照精确为 `[m2, m3, m4]`; 3. 断言跨断线/重连的全生命周期客户端接收事件序列精确严格等于 `[m1, m2, m3, m4]`!