专为微软 Office Android 系列应用(sharedUserId="com.microsoft.office")设计的 LibXposed API 102 模块:在不修改原版 APK 签名与不破坏 Google Play 自动更新的前提下,为每个同 UID 组件隔离各自的 AndroidKeyStore "AdalKey" 主密钥别名,解决 Word、Excel、PowerPoint、OneNote、Microsoft 365 (Copilot) 之间互相覆盖凭证密钥导致的“偶尔首开掉登录 / 需要修复账户 / Failed to decrypt with key:AdalKey”问题。
- 仓库地址: https://github.com/Marukon/OfficeAdalKeyIsolator
- 应用名称:
OfficeAdalKeyIsolator(包名io.github.marukon.adalkeyisolator) - 最低系统要求: Android 13+(API 33+),LSPosed 1.9.3+(LibXposed API 102)
微软 Office Android 多件套在 AndroidManifest.xml 中历史沿用了相同的 android:sharedUserId="com.microsoft.office"(共享同一个 Linux UID 与同一个 AndroidKeyStore 密钥命名空间),同时却各自在私有数据目录下维护独立的 shared_prefs/com.microsoft.identity.client.account_credential_cache.xml 与 app_<packageName>/adalks 文件。
由于微软 ADAL / MSAL / OneAuth SDK(com.microsoft.aad.adal.StorageHelper 与 com.microsoft.identity.common.crypto.AndroidAuthSdkStorageEncryptionManager)将 KeyStore 主密钥别名固定硬编码为 "AdalKey",一旦其中任意一个应用触发密钥生成或重建(keyStore.deleteEntry("AdalKey")),就会直接覆盖同一个 UID 下正在被其他 Office 应用使用的 "AdalKey",导致其他组件冷启动时本地加密凭证解密失败(日志表现为 Failed to decrypt with key:AdalKey thumbprint : ... -> Loaded 0 Credentials / Found [0] Accounts...)。
1. 双层幂等隔离 Hook(MainHook.kt)
仅当目标密钥别名为精确字符串 "AdalKey" 时,将其按当前进程包名重写为 "AdalKey_<packageName>"(例如 AdalKey_com.microsoft.office.word):
- MSAL / OneAuth Provider 入口层(兼顾标准签名与 Copilot R8 精简签名):
KeyStoreBackedSecretKeyProviderFactory.create(String, String, Context)(若存在)及AndroidAuthSdkStorageEncryptionManagerKeyStoreBackedSecretKeyProvider构造函数及getAlias()AndroidWrappedKeyProvider构造函数及getAlias()
- AndroidKeyStore 系统接口层(覆盖内联常量的
StorageHelper及各类调用方):java.security.KeyStore涉及别名的 12 类方法(仅限KeyStore.type为"AndroidKeyStore"时改写:containsAlias、deleteEntry、getEntry、setEntry、getKey、setKeyEntry、getCertificate、getCertificateChain、setCertificateEntry、isKeyEntry、isCertificateEntry、getCreationDate)android.security.keystore.KeyGenParameterSpec$Builder构造函数android.security.KeyPairGeneratorSpec$Builder.setAlias
2. 三重可用性及升级兼容自检(MainActivity.kt & StatusProvider.kt)
为避免后续微软更新 Office 后改名或重构内部类而难以察觉,模块界面内置三重校验(无需 Root):
- 按已安装应用计算的作用域状态:通过
XposedService.getScope()与XposedService.getRunningTargets()仅针对设备上已安装的 Office 应用统计作用域勾选比例与进程注入状态,支持一键发起requestScope申请缺失作用域;未安装应用折叠收纳于底部。 - 多变体静态兼容检查:利用目标应用的
ClassLoader扫描 4 组关键入口(同时兼容标准 MSAL 与 R8 内联后的getAlias()变体),升级后若有签名变动可直接定位缺失项。 - 跨进程有序广播实测回执:模块页通过
sendOrderedBroadcast直接探测运行中的 Office 进程(绕开目标应用缺少<queries>对模块ContentProvider的包可见性限制),同步取回KeyStore/ MSAL Hook 挂载数与实际改写次数。列表卡片默认简洁显示“Hook 成功”等状态,点击卡片展开完整详情,异常或兼容缺失块支持点击一键复制诊断信息。
模块内置 scope.list 覆盖以下 5 个同 UID 微软 Office 组件:
| 应用 | 包名 | 隔离后 KeyStore 别名 |
|---|---|---|
| Microsoft Excel | com.microsoft.office.excel |
AdalKey_com.microsoft.office.excel |
| Microsoft Word | com.microsoft.office.word |
AdalKey_com.microsoft.office.word |
| Microsoft PowerPoint | com.microsoft.office.powerpoint |
AdalKey_com.microsoft.office.powerpoint |
| Microsoft OneNote | com.microsoft.office.onenote |
AdalKey_com.microsoft.office.onenote |
| Microsoft 365 (Copilot) | com.microsoft.office.officehubrow |
AdalKey_com.microsoft.office.officehubrow |
- 构建或下载 Release APK 并安装(模块默认不显示桌面图标,仅通过 LSPosed 模块界面打开)。
- 在 LSPosed 管理器中启用
OfficeAdalKeyIsolator,确认推荐作用域中的 Office 应用均已勾选(无需重启手机)。 - 强行停止已开启作用域的 Office 应用各一次。
- 重新打开各 Office 应用后,从 LSPosed 打开
OfficeAdalKeyIsolator模块界面,即可确认作用域、代码兼容检查 (4/4)与进程内 Hook 回执全部正常。
export ANDROID_HOME=/path/to/android-sdk
./gradlew assembleRelease --no-daemon输出文件路径:app/build/outputs/apk/release/app-release.apk。仓库内已配置 GitHub Actions 工作流(.github/workflows/ci.yml 与 .github/workflows/release.yml),可通过 Repository Secrets(KEYSTORE_BASE64、KEYSTORE_PASSWORD、KEY_ALIAS、KEY_PASSWORD、LSP_REPO_TOKEN)注入签名密钥与同步凭证,仓库本身不包含任何 .jks / .keystore 文件。