OfficeAdalKeyIsolator

专为微软 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”问题。


问题背景

微软 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)(若存在)及 AndroidAuthSdkStorageEncryptionManager
    • KeyStoreBackedSecretKeyProvider 构造函数及 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):

  1. 按已安装应用计算的作用域状态:通过 XposedService.getScope() 与 XposedService.getRunningTargets() 仅针对设备上已安装的 Office 应用统计作用域勾选比例与进程注入状态,支持一键发起 requestScope 申请缺失作用域;未安装应用折叠收纳于底部。
  2. 多变体静态兼容检查:利用目标应用的 ClassLoader 扫描 4 组关键入口(同时兼容标准 MSAL 与 R8 内联后的 getAlias() 变体),升级后若有签名变动可直接定位缺失项。
  3. 跨进程有序广播实测回执:模块页通过 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

使用步骤

  1. 构建或下载 Release APK 并安装(模块默认不显示桌面图标,仅通过 LSPosed 模块界面打开)。
  2. 在 LSPosed 管理器中启用 OfficeAdalKeyIsolator,确认推荐作用域中的 Office 应用均已勾选(无需重启手机)。
  3. 强行停止已开启作用域的 Office 应用各一次。
  4. 重新打开各 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 文件。

Releases